Administering the Web Site

This section describes how to administer the Micro Webserver once it is functioning correctly. Topics described in this section include:

Attaching Comments to Paths

You can add or change comments to paths so that users can see the comments when they view the paths:

Select the General tab. The General Settings tabs appear.
Select the Comments tab. The Comments tab appears:

Enter the path you want to attach a comment to in the Path field. You can also browse to locate this path by clicking Browse.
Enter the comment that you want the user to see in the Comments field.
Click Add. The comment is added to the Path/Comment table. To save this configuration, click Save at the bottom of the frame.

Removing Comments from Paths

Select the General tab. The General Settings tabs appear.
Select the Comments tab. The Comments tab appears:

Select the comment that you want to delete from the Path/Comments table.
Click Remove. The comment is removed from the Path/Comments table. To save this configuration, click Save at the bottom of the frame.

Specifying Index Files

When a user browses a particular URL, the browser searches for particular files in that path to automatically load. These files are called index files. Typical index files are: home.html, home.htm, index.html, and index.,htm. If you want to specify any other index files than those listed, enter them in the Directory table of the Index Files tab:

Select the General tab. The General Settings tabs appear.
Select the Index Files tab. The Index Files tab appears:

Enter the Index file name you want to add in the File Name field.
Click Add. The file name is added to the Directory table.

Removing an Index File

Select the General tab. The General Settings tabs appear.
Select the Index Files tab. The Index Files tab appears:

Select the Index file name you want to delete from the Directory table.
Click Delete. The file name is deleted from the Directory table.

Disabling and Enabling Specific Protocols

By default, the Micro Webserver has all supported Protocols enabled. You may want to disable certain protocols either to protect your server from people trying to access it using specific protocols, or to disable the protocols while reconfiguring the server.

Select the General tab. The General Settings tabs appear.
Select the Protocols tab. The Protocol tabs appears:

Clear the check boxes to disable the corresponding protocol.
Check the check boxes to enable the corresponding protocol.
Click Apply to apply the changes.

Setting Logging Options

The Logging Options allow you to keep track of and record file access in access log files and events in event log files.This is helpful for tracking problems on the network and identifying potential security violations.

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the General tab. The General tabs appear.
Select the Logging tab. The Logging tab appears:

Enter the directory where you want to store the event log files in the File Name field in the Event Log group. You can click Browse to browse for the location as well.
Check the File Access box in the General Logs group to log when users access the server. Enter the directory where you want to store the access log files in the File Name field in the Access Log group. You can click Browse to browse for the location as well.
If you want to log when the server encounters a memory allocation failure, check the Memory Failures box in the General Logs group. This will help you to track situations that cause memory allocation failures.
Check the File Access box to enable access logging.
Check the protocols you want logged in the Protocol Logs group.

Note Although the server caches the logging information to memory, logging still adversely affects access speeds of the server as the server must write the logging information to the storage media after the cache is full. As a general rule, it is best to log and trace the minimum amounts of events and access conditions for maximum server performance.

Click Apply. To reset the options to the state they were in when you entered the tab, click Restore. To save this configuration, select Save at the bottom of the frame.

Setting Mapping Options

This section describes how to redirect or map requested documents, content, or icons. Topics in this section are:

Adding a New Document Mapping

When the Micro Webserver receives a request for a document, it can redirect that request to any file you specify using the Document Mapping tab.

Using your browser, log into the configuration application as described In the section, "Logging in to the Server".
Select the Maps tab. The Maps tabs appear.
Select the Document Map tab. The Document Map tab appears:

Enter the URL of the document that you want to map in the URL field.
Enter the path and filename that you want to map to the URL in the Path field. You can browse to find the file by selecting Browse.
Click Add to add the URL to filename mapping to the URL/ Document table. To save this configuration, click Save at the bottom of the frame.

Removing an Existing Document Mapping

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Maps tab. The Maps tabs appear.
Select the Document Map tab. The Document Map tab appears:

Select the existing mapping from the URL/Document Map table.
Click Remove to delete the URL to filename mapping from the URL/ Document Map table. To save this configuration, click Save at the bottom of the frame.

Adding a New Mime Mapping

When the Micro Webserver transmits a document to the browser, it sends a mime type that the browser how to process the document. You can configure the mime type that is transmitted based on the file path using the Mime Map tab.

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Maps tab. The Maps tabs appear.
Select the Mime Map tab. The Mime Map tab appears:

Enter the complete filename of the file you want to map in the File field. You can also browse for the filename by clicking Browse.
Select a content Mime type from the Mime Type list.
Click Add to add the mapping to the File/Mime Type table. To save this configuration, click Save at the bottom of the frame.

Removing an Existing Mime Mapping

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Maps tab. The Maps tabs appear.
Select the Mime Map tab. The Mime Map tab appears:

Select the existing mapping from the File/Mime Type table.
Click Remove to delete the mapping from the File/Mime Type table. To save this configuration, click Save at the bottom of the frame.

Adding a New Icon Mapping

You can specify an icon to associate with specific file types using the Icon Map tab.

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Maps tab. The Maps tabs appear.
Select the Icon Map tab. The Icon Map tab appears:

Select a content Mime type from the Mime Type list.
Enter the complete filename of the icon file you want to map in the Icon field. You can also browse for the filename by clicking Browse.
Click Add to add the mapping to the Mime Type/Icon table. To save this configuration, click Save at the bottom of the frame.

Removing an Existing Icon Mapping

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Maps tab. The Maps tabs appear.
Select the Icon Map tab. The Icon Map tab appears:

Select the existing mapping from the Mime Type/Icon table.
Click Remove to delete the mapping from the Mime Type/Icon table.

Defining Users Groups

Often, you want to be able to define users groups that share a common level of access or a common resource that they access. This section describes:

Adding a New User

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Access Control tab. The Access Control tabs appear.
Select the Users tab. The Users tab appears:

Enter the Name of the user in the Name field.
Enter an initial password for the user in the Password field.
Enter the same initial password in the Confirm field.
Select a home directory the user views when they access the server by entering a path in the Home field. You can also click Browse to browse for the home page.
Check the Read check box if you want to allow others permission to read the user's home directory.
Check the Write check box if you want to allow others permission to write to the user's home directory.
Click Add. The new user and home page are added to the list. To save this configuration, click Save at the bottom of the frame.

Changing Passwords

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Access Control tab. The Access Control tabs appear.
Select the Users tab. The Users tab appears:

Enter the Name of the user in the Name field.
Enter a new password for the user in the Password field.
Enter the same password in the Confirm field.
Click Add. The new password is now set for the user. To save this configuration, click Save at the bottom of the frame.

Creating a Users Group

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Access Control tab. The Access Control tabs appear.
Select the Groups Access tab. The Groups Access tab appears:

Enter the name of the new group in the Group field.
Click Add Group. The new group is added to the list. To save this configuration, click Save at the bottom of the frame.

Note Whenever you put users the under Supervisor group, they have access to all configuration capabilities by default.

Removing a User

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Access Control tab. The Access Control tabs appear.
Select the Groups tab. The Groups tab appears:

Select the user you want to remove from the Users list.
Click Remove User to remove the user from the Users list. To save this configuration, click Save at the bottom of the frame.

Setting a Users Home Page

You can set a specific home page for each user that accesses the server. This is useful for allocating specific resources for different users. To set a home page for a user:

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Access Control tab. The Access Control tabs appear.
Select the Users tab. The Users tab appears:

Enter the name of the user you want to set a home page for in the Name field.
Enter the home page in the Home field or click Browse to locate it.
Click Add. Notice the Home Page column in the Name/Home Page table reflects the change. To save this configuration, click Save at the bottom of the frame.

Deleting a Users Group

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Access Control tab. The Access Control tabs appear.
Select the Groups tab. The Groups tab appears:

Select the group you want to remove from the Group list.
Click Remove Group to remove the group. To save this configuration, click Save at the bottom of the frame.

Setting Access Control

This section describes how to allow or deny access to groups or individual users. Topics include:

Allowing or Denying Group Access to a URL

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Access Control tab. The Access Control tab appears.
Select the Group Access tab. The Group Access tab appears:

Note This tab lets you allow or deny access to specific resources by groups that you have defined with the Groups tab. In order to set access privileges, you must first define groups for specific users, refer to the section "Defining Users Groups".

Enter the path of the resource you are setting the access for in the Path field.
Select the groups that you want to allow to access this path from the Group list.
Select the appropriate Access group radio button and check the Read or Write check boxes that you want to apply to the group for the resource. Selecting the Allow Only radio button allows only the specified group access and restricts all other groups from accessing the path. If two different groups are given allow only access to the same path, the conflict may cause no one to be able to get access to the path.

Note The access applied to the root (/) path is implicitly applied to every access. Cisco recommends that you follow the basic access control setup described in the Cisco Micro Webserver Quick Reference Guide. Click Add to add this group to the Path and Permission/Group tables. To save this configuration, click Save at the bottom of the frame.

Removing Access Privileges for a Group

Using your browser, log into the configuration application as described in the section, "Logging in to the Server".
Select the Access Control tab. The Access Control tabs appear.

Note This tab lets you allow or deny access to specific URLs by groups that you have defined with the Groups tab. In order to set access privileges, you must first define groups for specific users, refer to the section "Defining Users Groups".

Select the Group Access tab. The Group Access tab appears:

Select the Access you want to remove from the Path and Permission/Group tables.
Click Remove ACL. Notice it has been deleted from the Path and Permission/Group tables. To save this configuration, click Save at the bottom of the frame.

Rebooting Micro Webserver

If you make changes that require you to reboot the server, the diskette icon next to the Reboot button will be flashing red. To reboot the server, use the following procedure:

Enter your password in the Enter Password for Reboot field.
Click Reboot. The server reboots.

Updating the System Firmware

The Micro Webserver allows you to update the system firmware even from a remote location. To update the firmware:

Download the latest software to the server you are upgrading using the File Transfer Utility or an FTP client.
Log into the server using the Login tab.
Select the General tab. The General tabs appear.
Select the Upgrade tab. The Upgrade tab appears:

Enter the filename with the complete path of the .HEX file containing the latest firmware in the Firmware Location field. You can also browse to locate this file by clicking Browse.
Enter you password in the Reenter Password field.
Click OK. The firmware in the source file loads to the NVRAM in the Micro Webserver.

Upgrading the System Firmware Using TFTP

The Flash Update Program (FLUP) in the Micro Webserver is compatible with the TFTP client available on many UNIX systems. The following procedure works for BSD UNIX; consult your system manuals for local command variations.

Transfer the Micro Webserver flash update program file to your UNIX system, calling it MWUPDATE.HEX.
Place the Micro Webserver in Flash Update Mode by using a Telnet client to log into the Micro Webserver (host name = mywebserver): % telnet mywebserver

Cisco Micro Webserver ....

... login:

At the Micro Webserver prompt, type the command: .../ # diag l t

This command immediately places the server into flash update mode; the Telnet connection is now disconnected (it will not respond to the command).

Enter the Telnet escape character, control+], then enter close and press the Enter key.
Use TFTP to transfer the system image to the Micro Webserver: At the UNIX prompt, enter the TFTP command:

% tftp mywebserver

tftp> bin

tftp> put MWUPDATE.HEX

The file MWUPDATE.HEX is transferred to the server for updating. After the TFTP transfer completes, wait until the Micro Webserver reboots (it takes no more than 90 seconds). During this interval, the server is updating its NVRAM. Do not power off the Micro Webserver at this time.

Terminate the TFTP command: tftp> quit

Verify that the upgrade has been installed by connecting with Telnet and examining the login banner.