Release Notes for the Cisco Micro Webserver 200

The Release Notes for the Cisco Micro Webserver 200 describe system considerations and caveats for Cisco Micro Webserver 200, version 1.0.

The Cisco Micro Webserver 200 is a versatile Web server appliance that is easy to install and cost-effective. It can be used for entry-level World Wide Web (WWW) hosting, to set up a corporate workgroup intranet, as a network documentation server, or as an offline kiosk. See also http://www.cisco.com/microweb, or refer to your Using Cisco Micro Webserver 200 guide.

These release notes discuss the following topics:

Platform Support

Table 1 provides a matrix of Micro Webserver 200 applications support.

Note Apple Macintosh systems are not supported in this release.

Table 1: Micro Webserver 200 Support

Feature	Windows 95/ Windows NT 4.x
Network Wizard¹	yes
Administrative Wizard1	yes
Configuration Utility1	yes

¹ Requires Java-enabled browser.

HTTP Operations

This section describes how to enable log files and how to enable TCL-based CGI scripting.

HTTP Access Logs

The following command sequence will generate HTTP access in the Common Log Format under the /var/log/access.log and /var/log/error.log directories. First, enter configuration mode at the console:

mweb200#configure Enter configuration commands, one per line. End with CNTL/Z mweb200(config)#http logging enable

Note This command is in effect only after reboot.

mweb200(config)#end mweb200#write mweb200#reload

TCL-based CGI Scripting

This section describes how to enable TCL-based CGI scripts.

Step 1 Create a script alias. The script alias designates a certain directory as the container for your CGI scripts.

Note The README file in /local/cisco/mw200/software/cgi/tcl-examples/ provides additional information about CGI scripts.

Step 2 To show a CGI alias from the CGI examples directory, enter:

mweb200#show http scriptalias

Step 3 To set up a CGI script alias, use the following commands:

mweb200#configure Enter configuration commands, one per line. End with CNTL/Z mweb200(config)#http scriptalias /cgi-bin/ /local/cisco/mw200/software/cgi/tcl_examples/ mweb200(config)#end mweb200#write memory Building configuration ...[OK] mweb200#

Step 4 After you create the CGI script alias, execute CGI scripts using the following URL:

http://my-mweb200/cgi-bin/example.cgi

Restore Cisco-specific Data to Hard Disk Drive

If you format the /local drive and want to restore Cisco-specific data to your Micro Webserver 200 hard disk drive:

Note For this procedure to work, your drive must be formatted.

Step 1 Place the Cisco Micro Webserver 200 Installation Tools and Utilities CD-ROM into the CD-ROM drive of your Windows 95 or Windows NT system.

Step 2 Open a recursive File Transfer Protocol (FTP) client (such as, wsftp or Reflection FTP) to your Micro Webserver 200.

Step 3 Open /local on your Micro Webserver 200.

Step 4 Open Z:\diskmstr (where Z\: is your CD-ROM drive).

Step 5 FTP the cisco, lib, var, etc, and all other necessary directories to the /local drive on your Micro Webserver 200.

Firmware Upgrade

Note If you upgrade Flash, do not reboot during the upgrade or else you will corrupt the Flash

To upgrade the firmware on the MWEB 200 Flash, you may use the Configuration Utility or perform the following steps:

Step 1 FTP or RCP the new firmware release to the hard drive.

Step 2 Copy the release to /local/cisco/mw200/software/firmware/

Once the new firmware release is on the hard drive, input the following commands on the console:

Step 3 Log on as "admin" to the system:

Username:admin Password:

Step 4 Enter:

mweb200#copy disk flash /local/cisco/mw200/software/firmware/newimage.bin

(where newimage.bin is the name of the new firmware release)

While the new image is being copied to flash, the console displays messages:

copying /local/cisco/mw200/software/firmware/newimage.bin to flash EwEwEwEwEwEwEwEwEwEwEw mweb200#

Step 5 To activate the new firmware, reboot the system:

mweb200#reload Proceed with reload?[confirm]

Step 6 Enter "yes" at the confirm prompt to reload your Micro Webserver 200 with the new firmware.

Proceed with reload?[confirm]yes

Important Notes

The following notes provide helpful information on general product usage.

Web Browsers

You must have Java enabled on your World Wide Web browser for the Administrative Wizard to launch properly. Neither the Administrative Wizard nor the Configuration Utility function on Apple Macintosh systems. The Administrative Wizard and the Configuration Utility may not work on Sun systems.

CD-ROM Support

When a SCSI CD-ROM drive is attached to the Micro Webserver, CD-ROM discs can be exported to the World Wide Web. The Micro Webserver 200 is capable of reading CD-ROM discs in ISO9660 format, with or without Rock Ridge extensions. Rarely, a disc for Macintosh or UNIX systems uses another format. These discs cannot be read by the Micro Webserver 200.

Note CD-ROM media is limited to 10,000 files and 1,000 folders.

New SCSI Devices

The Micro Webserver 200 cannot format new SCSI hard drives. However, it can read the hard drive directly from a Windows 95 or Windows NT system.

Data Backup

Cisco recommends that you always keep a backup of the software content on the Micro Webserver 200's hard drive to prevent data loss. Copy files using your client FTP program.

Erasing Your Hard Drive

You can erase your hard drive and recreate the file system on the Micro Webserver 200 in two ways:

The first option erases boot 0. Enter:

mweb200#quick-erase /local mweb200#makefs /local

The second option erases every hard disk sector. Enter:

mweb200#long-erase /local mweb200#makefs /local

Hard Disk Drive Care

Proper care and handling will protect your hard disk drive from damage. If you drop your Micro Webserver 200, the hard disk drive could become severely damaged. In this case, contact Cisco Technical Support at tac@cisco.com.

Password Change

When changing the password, you must change both the admin and the root passwords.

Step 1 Enter configuration mode by typing the following command at the config prompt:

mweb200#configure

Step 2 Modify the password as follows (where newpassword is the desired password):

mweb200(config)#user mod username root password newpassword mweb200(config)#user mod username admin password newpassword

Step 3 Exit config mode:

mweb200(config)#end

Step 4 Save and reload the configuration:

mweb200#write mweb200#reload

Password Recovery

The root and admin password recovery procedure is based on changing the boot flags such that your Micro Webserver 200 boots when prompting for the administrator login.

Note When recovering a lost password, you must change both the admin and root passwords.

Step 1 Attach the supplied (color-coded blue) console cable between the Micro Webserver 200 and your PC serial port.

Note

Using Cisco Micro Webserver 200

Step 2 Reboot your system.

Step 3 During the bootup you have one second and must stop automatic reboot by pressing any key on the keyboard. The following information will display:

Cisco MicroWeb II Boot Copyright (c) 1986-1997 by Cisco Systems, Inc. Compiled: 14:05:14 Nov 17 1997 by morlee PPC403GA Processor with 4094 Kbytes Memory Press any key to stop autoboot ... > 1 [mweb200]:

Step 4 Now, you can control various boot options:

mweb200]: ? ? - print this list @ - boot (load and go) p - print boot params c - change boot params l - load boot file g adrs - go to adrs d adrs[,n]- display memory m adrs - modify memory f adrs, nbytes, value - fill memory t adrs, adrs, nbytes - copy memory e - print fatal exception n netif - print network interface device address $dev(0,procnum)host:/file h=# e=# b=# g=# u=usr [pw=passwd] f=# tn=targetname s=script o=other Boot flags: 0x02 - load local system symbols 0x04 - don't autoboot 0x08 - quick autoboot (no countdown) 0x20 - disable login security 0x40 - use bootp to get boot parameters 0x80 - use tftp to get boot image 0x100 - use proxy arp 0x1000- Edit cisco cookie 0x2000- Emergency Serial Download 0x4000- Bypass the NVRAM Configuration available boot devices: ma flash

Step 5 Note the current boot flags by entering the letter "p" at the mweb200 prompt.

[mweb200]: p boot device : flash processor number : 0 host name : cisco inet on ethernet (e) : 0.0.0.0 flags (f) : 0x8 target name (tn) : mweb200 [mweb200]:

The desired affect of bypassing the login is achieved by changing the flags parameter in the list to a value of 0x8000 from a value of 0x8.

Step 6 Enter the letter "c" at the mweb200 prompt. This allows you to change the boot flags.

[mweb200]: c

Step 7 Move down the fields by pressing the Enter key on the parameter list until you reach the flags field.

'.'=clear field;'-'=go to previous field;^D = quit;Enter=next field boot device : flash processor number : 0 host name : cisco inet on ethernet (e) : 0.0.0.0 flags (f) : 0x8

Step 8 At the flags (f): 0x8 prompt, enter the value 0x8000.

flags (f): 0x8 0x8000

The result appears as follows:

flags (f): 0x8 0x8000

Step 9 Press the Enter key until you reach the end of the list.

Step 10 Boot your Micro Webserver 200 by entering the character "@" and pressing "Enter" at the mweb200 prompt:

[mweb200]:@ Enter

Step 11 Enter configuration mode by typing the following command at the config prompt:

mweb200#configure

Step 12 Modify the password to the new passwords for root and admin as follows

(where newpassword is the desired password):

mweb200(config)#user mod username root password newpassword mweb200(config)#user mod username admin password newpassword

Step 13 Exit config mode:

mweb200(config)#end

Step 14 Save and reload the configuration:

mweb200#write mweb200#reload

Step 15 Now you have seven seconds and must stop the automatic reboot by pressing any key on the keyboard.

The following display appears:

Cisco MicroWeb II Boot
Copyright (c) 1986-1997 by Cisco Systems, Inc.
Compiled: 14:05:14 Nov 17 1997 by morlee
PPC403GA Processor with 4094 Kbytes Memory
Press any key to stop autoboot ...
> 7

[mweb200]:

Step 16 Enter the letter "c" at the mweb200 prompt. This allows you to change the boot flags.

[mweb200]: c

Step 17 Navigate the fields by pressing the Enter key on the parameter list until you reach the flags field.

'.'=clear field;'-'=go to previous field;^D = quit;Enter=next field boot device : flash processor number : 0 host name : cisco inet on ethernet (e) : 0.0.0.0 flags (f) : 0x8000

Step 18 At the flags (f): 0x8000 prompt, enter the value 0x8.

flags (f) : 0x8000 0x8

The result will appear as follows:

flags (f): 0x8000 0x8

Step 19 Press the Enter key until the end of the list is reached.

Step 20 Boot your Micro Webserver 200 by entering the character "@" and pressing "Enter" at the mweb200 prompt:

[mweb200]:@ Enter

Step 21 Now the passwords for root and admin are changed to the values you entered in Step 12.

Online Documentation

Online documentation is available for your Micro Webserver 200 at:

http://my-web/serverhome/docs/index.html

(where my-web is your Micro Webserver 200 host name or IP address).

The Release Notes for the Cisco Micro Webserver 200 online documentation internal hyperlinks do not link to the sections within the release notes. The hyperlinks will be fixed in the next maintenance release. To view the sections, just scroll up and down the page to the correct sections.

Updated documentation will be available on Cisco Connection Online (CCO).

Version 1.0 Caveats

This section contains caveats that apply to version 1.0. For an updated list of Micro Webserver 200 caveats, go to:

http://www.cisco.com/microweb

System Crash Caveat

Note This problem only arises when you are using the console port.

The Micro Webserver 200 crashes when you enter a null IP address on the boot ROM configuration line (or bootline). For example, the Micro Webserver 200 is preconfigured from Cisco with the following boot ROM configuration:

[mweb200]: p boot device : flash processor number : 0 host name : cisco inet on ethernet (e) : 0.0.0.0 flags (f) : 0x8 startup script (s) : mweb200 [mweb200]:

If inet on ethernet field is cleared by changing the above configuration with a "c", your Micro Webserver 200 will not boot.

Cisco log number: CSCdj34893.

Automatic Boot Caveat

Note This problem only arises when you are using the console port.

You have only one second to prevent an automatic boot of your Micro Webserver 200. Therefore, not enough time is allowed to interrupt this autoboot mode.

Cisco log number: CSCdj68013.

FTP Service Caveats

Under heavy stress ASCII FTP transfers to and from the Micro Webserver 200 are slow due to system buffer limitations. This problem effects both ASCII FTP GET and ASCII FTP PUT. For example, under heavy stress, a 5 MB file PUT transfer takes about 3 minutes. Under normal loads, the usual transfer takes about 40 seconds. Binary FTP is much faster.

Cisco log number: CSCdj70536.
UNIX FTP clients, ncftpget and ncdftpput, do not function with your Micro Webserver 200.

Cisco log number: CSCdj55822.
The FTP daemon does not support "CD UP," an FTP command Microsoft FrontPage uses to change directories to the parent directory. This support will be implemented in the next maintenance release.

Cisco log number: CSCdj72268.

CGI Processing Caveats

The TCL (Tool Command Language) may take several minutes to process CGI scripts depending on your Micro Webserver 200's load because the Micro Webserver 200 mechanism that detects a full stack is slow. The mechanism will be faster in the next maintenance release.

Cisco log number: CSCdj70931.
Syntax error-checking is lacking for CGI scripts. Therefore, CGI scripts do not recover from errors properly. For example, attempting to send an e-mail message results in an attempt to execute a file not present (/usr/lib/sendmail).

Cisco log number: CSCdj72707.

Year 2000 Caveat

Year 2000 compliance is scheduled for the next maintenance release and fails in release 1.0.

Cisco log number: CSCdj68673.

External SCSI CD-ROM Device Caveats

Note The following caveats only apply to external SCSI CD-ROM drives attached to the Micro Webserver 200 SCSI chain.

The firmware recognizes only parts of some CD-ROM media. This problem is rare with documentation-type CD-ROM media. This problem occurs more often with PC installation-type media, where filenames start with characters such as "_" (underscore) or "$" (dollar sign). The Micro Webserver 200 may not parse these characters correctly; therefore, you may see a partial list of the CD-ROM files.

Cisco log number: CSCdj71264.
CD-R generated media may hang older CD-ROM drive models. This problem occurs when CD-R generated media is incompatible with a SCSI CD-ROM device that you attach to the Micro Webserver 200. The Micro Webserver 200 software trys to execute a "stat" on the media and may not succeed because the CD-R generated media is not compatible with your older SCSI CD-ROM.

Note

Cisco log number: CSCdj71266.

If you receive a CD-ROM file system "Assertion Failed" error message such as the one below, your CD-ROM task and the console task on the Micro Webserver 200 will hang:

my-web#Assertion failed: LBNum > 15, file cdromFsLib.c, line 773

This is a very rare problem. Rebooting your Micro Webserver 200 may fix the problem.

Cisco log number: CSCdj72344.

Caveats for Other Services

If both the syslog server and the syslog client are logging to the same file on the hard disk, they may overwrite each other's file. Ensure that your server and client are logging to different files on the hard disk.

Cisco log number: CSCdj69244.
If your syslog client is logging messages to the hard disk, the completion of a cron task may write partial cron job messages to the syslog file on the hard disk.

Cisco log number: CSCdj69541.

Console Caveats

If you are in configuration (config) mode from a console or a telnet session, the cut-and-paste operation will only paste one line at a time; the Micro Webserver 200's buffer only sends the first paste command to the system.

Cisco log number: CSCd41673.
If your Micro Webserver 200's console port is connected to a PC running Windows NT, a reset signal from Windows NT may cause the Micro Webserver 200 to reboot. This happens when Windows NT loads (the blue screen) and a reset signal is sent to the PC serial port. This may not happen on all Windows NT systems and may also happen on Windows 95. This bug will be fixed in the next maintenance release.

Cisco log number: CSCdj72665.

Administrative Wizard and Configuration Utility

The Tab key does not function on the Administrative Wizard's e-mail page.

Cisco log number: CSCdj63805.
After you complete the Administrative Wizard by pressing the Finish button, you must wait several minutes for the Micro Webserver 200 to create the default home pages.

Cisco log number: CSCdj67447.

Cisco Connection Online

Cisco Connection Online (CCO) is Cisco Systems' primary, real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional information and services.

Available 24 hours a day, 7 days a week, CCO provides a wealth of standard and value-added services to Cisco's customers and business partners. CCO services include product information, product documentation, software updates, release notes, technical tips, the Bug Navigator, configuration notes, brochures, descriptions of service offerings, and download access to public and authorized files.

CCO serves a wide variety of users through two interfaces that are updated and enhanced simultaneously: a character-based version and a multimedia version that resides on the World Wide Web (WWW). The character-based CCO supports Zmodem, Kermit, Xmodem, FTP, and Internet e-mail, and it is excellent for quick access to information over lower bandwidths. The WWW version of CCO provides richly formatted documents with photographs, figures, graphics, and video, as well as hyperlinks to related information.

You can access CCO in the following ways:

WWW: http://www.cisco.com
WWW: http://www-europe.cisco.com
WWW: http://www-china.cisco.com
Telnet: cco.cisco.com
Modem: From North America, 408 526-8070; from Europe, 33 1 64 46 40 82. Use the following terminal settings: VT100 emulation; databits: 8; parity: none; stop bits: 1; and connection rates up to 28.8 kbps.

For a copy of CCO's Frequently Asked Questions (FAQ), contact cco-help@cisco.com. For additional information, contact cco-team@cisco.com.

Note If you are a network administrator and need personal technical assistance with a Cisco product that is under warranty or covered by a maintenance contract, contact Cisco's Technical Assistance Center (TAC) at 800 553-2447, 408 526-7209, or tac@cisco.com. To obtain general information about Cisco Systems, Cisco products, or upgrades, contact 800 553-6387, 408 526-7208, or cs-rep@cisco.com.

Table of Contents

Release Notes for the Cisco Micro Webserver 200