Project Members
Home
Alganza, Angel Martin
Amerman, Richard
Angelacos, Nathan
   Webconf
Avants, Lynn
Barreto, Pedro
Batozech, Paul
Bernin, Arne
Best, Scott
Boonstra, Brian K.
Boulter, Shane
Capriotti, Luigi
Caron, Serge
Carr, Chad
Charlier, Etienne
Church, Julian
Clausen, Jon
Coates, Jack
Correia, Luis
Covel, Sean
de Thouars, Eric
Douthitt, David
Doyle, Richard
Dubler, Pete
Eastep, Tom
Erle, Schuyler
Ezrine, Paonia
Fink, Steve
Fino, Andrea
Fong, Nicholas
French, Jonathan
Fritz, Brad
Gibbs, Nigel
Giussani, Cristian
Hadley, Kenneth
Hejl, Martin
Hoying, Andrew
Ivaschenko, Vladimir
Iyer, Venki
Kimber, Lee
Kirchdörfer, KP
Kiser, Eric
Kozhedub, Sergey
Lee, Hendry D.
Leone, Michael
Lohman, Richard J.
Long, Dale
Metz, George
Minola, Sandro
Morgan, Greg
Mueller, Peter
Nanson, Brock
Nebrera, Jaime
Newmiller, Jeff
Niedermann, Hans Ulrich
Noyes, Mike
   Administration
Officer, Joey
Olszewski, Ray
Onanian, Rick
Oppalfens, Kim
Ousdal, Per Gustav
Padilla, Len
Peck, Steven
Pitz, Bill
Platzek, Larry
Pocius, Bob
Prieto, Juan J.
Psenicka, Henry
Reed, Morgan
Rhomberg, Alex
Ribeiro, Justin
Robinson, Peter
Schalit, Matt
Schleif, Michael D.
Sensney, Mike
Spakman, Eric
Speel, Hans Cees
Stanford, Robert
Steinkuehler, Charles
Sundaram, Mohan
Titl, Erich
Traina, Paul
Travis, Hilton
Ugander, Johan
Vuong, Anh
Wasscher, Ewald
Weaver, Gerry
Wegner, Timothy
Wolzak, Eric

Search Web Pages




Webconf

Web-Based Configuration with Webconf.lrp

Webconf is a framework for adding web-based configuration functions to a LEAF router. It is modular in nature, and so the features available are based on what you choose to install. The webconf.lrp package is made up of a cgi interpreter and a number of shell-based cgi scripts. Since webconf.lrp is only the cgi portion, you will need a web server in addition to webconf.lrp. mhttpd.lrp is a good choice.

The webconf framework has its own set of modules (plugins). Plugins are web-page material (.cgi scripts, graphic elements, style-sheets, etc.) packaged in a tar.gz file and given a ".lwp" extension. The list of plugins to load and other configuration items are defined in /etc/webconf/webconf.conf. If a plugin includes other material (such as binary programs, or configuration data that should be saved on the local media) then the standard .lrp packaging format is used.

Documentation for installing and configuring webconf.lrp is here: http://cvs.sourceforge.net/viewcvs.py/leaf/devel/nangel/webconf/doc/webconf-configuration.html?rev=HEAD.

Information for those interested in making their own webconf plugins is here: http://cvs.sourceforge.net/viewcvs.py/leaf/devel/nangel/webconf/doc/webconf-howto.html?rev=HEAD. Developers are welcome. As of Feb 2005, some work is being done on basic cgis for networking (interfaces file), dnsmasq and dhcp. Webconf discussion takes place on the leaf-devel mailing list.

If you want to try out the webconf packages available now, here is a description of some of the combinations possible.

webconf.lrp
A picture of the basic webconf package

Size: 31.2k

Menuset: all

Audience: End-user

The basic webconf.lrp is the required package, and can replace weblet.lrp. It allows an end-user to view the General Health and Active Connections of the router. Log Files can be viewed, downloaded, or deleted. The Password for the web interface can be set, and the page for performing a backup of installed packages is included. This package provides a way to give an end-user some management functions of the router, but doesn't let them make changes. As an example, webconf.lrp might be used to give a customer "read-only" rights to web pages for monitoring; but the customer can't (from the web pages) modify the router configuration.

Note

The webconf.lrp package contains two programs that are compiled for the Intel architecture and are linked against the uClibc library. If you are using another LEAF branch, such as the original Bering with glibc 2.0.7, plugins are available to replace the binary programs.

The plugins have long names to identify them; you should rename the plugin to a qualifying 8.3 name (such as haserl.lwp or binaries.lwp and copy it to your boot media. Then edit the /etc/webconf/webconf.conf file to load the plugin. This allows the webconf.lrp to support multiple platforms and LEAF branches.

Architecture Specific Plugins

Package:

haserl-i386-static.lwp
Compiled for i386, statically linked against uClibc, so should work on any i386 platform
wc-207.lwp
(Offsite link) - Compiled for i386 linked against libc 2.0.7 (shared libraries), suitable for original bering. (Contributed by Erich Titl.)
webconf.lrp + webconf.lwp
A picture of the expert webconf package

Size: 31.2k + 4.4k

Menuset: all + expert

Audience: Administrator

In addition to the features above, the webconf.lwp add-on provides a universal page to edit config files for installed packages, change backup destination locations, start / stop daemons, and edit leaf.cfg. The webconf.lwp contains all the functionality necessary to manage a LEAF router via the web interface. You might want this package if you are setting up a router but aren't quite comfortable editing the configuration files with the e3 editor.

The combination of webconf.lrp + webconf.lwp is a basic start for the "do-it-yourself" SOHO user who's not afraid of experimenting with LEAF / Linux.

Basic Menu set packages

An example of the interface switch menu itemThe webconf.lwp package adds the "Expert" menu set to the webconf package. The packages below add the "Basic" menu set to the webconf package. Because webconf is a framework, it is possible to provide different "interfaces" to a user, based on his preference. If you install both "Expert" and "Basic" packages, a menu item allowing you to change the menu set is shown. If you have packages from just one of the menu sets installed, then just those menus are shown, and you will not see the item to switch the interface.

These packages are considered experimental. The current intent of the basic packages is to eventually provide a full web interface for a casual user.

Package:

dropbear.lwp
A picture of the dropbear webconf package

Size: 1.7k

Menuset: basic

Audience: Administrator

This package provides an easier management interface to the dropbear ssh daemon.

keyboard.lwp

A picture of the keyboard webconf packageSize: 1.5k

Menuset: basic

Audience: Administrator

This package allows the user to select the console keyboard mapping, and to delete unused keyboard maps.

Extra "Expert" add-on packages

Package:

lrpstat.lwp

A picture of the lrpstat webconf packageSize: 46.9k

Menuset: expert

Audience: Administrator

The lrpstat.lwp is an add-on to the lrpstat.lrp package. Note that lrpstat.lrp must be installed in addition to this package. This package provides a web-interface to change the items and graph types displayed in the Java application.

Foolishness

Package:

muwiki.lrp

A picture of the muwiki webconf packageSize: 4.8k

Menuset: all

Audience: Administrator

This is a micro-wiki. It uses sed as the rendering engine, and needs no database back-end. It was written as a proof-of-concept of how far one could go with simple tools. The only reason to install this is to be able to say you have a wiki on your router.

Screenshots

Clicking on the link will show a slightly larger image

  • General Health

    General Health

  • Logfile Management

    Logfile Management

  • General configuration

    General configuration of a daemon

  • Editing a configuration

    Editing a configuration file

  • Editing lrpstat

    Editing lrpstat graph options

  • Created on 2005-03-23 13:22:29 by mhnoyes
  • Updated on 2005-03-23 13:44:54 by mhnoyes

 Printable Version


What's Related

Hosted on Get LEAF Linux Embedded Appliance Framework at SourceForge.net. Fast, secure and Free Open Source software downloads, and powered by phpWebSite.