cc/td/doc/product/webscale/webcache/ce23
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Maintaining the System Software

Maintaining the System Software

This chapter covers the tasks required for maintaining a Content Engine or a Content Engine farm:

Upgrading the System Software

Presently, two types of Cache software files are available on Cisco Connnection Online (CCO) to download, files with the .pax suffix and files with the .bin suffix. The .pax file contains the full-image software with the graphical user interface (GUI) and is the file routinely installed. The .bin file software is for recovery situations that require booting from the network, or restoring Flash memory. See the "Recovering the System Software" section for instructions on loading your system image with the .bin file.

The following procedure describes how to upgrade the Content Engine system software and optionally change the boot parameters.


Step 1   Download the .pax file to your Windows NT or UNIX machine.

Step 2   From the Windows NT or UNIX machine, use FTP to put the new image file (for example, ce500-200.pax) in the Content Engine /local directory.

If you are using a command-line FTP client, perform the following substeps to put the .pax file on the Content Engine. In the example, the Content Engine IP address is 192.168.88.89:

    ftp 192.168.88.89
    cd /local
    bin
    put ce500-200.pax
When the transfer is complete, quit the FTP session.

Step 3   Log on to the Content Engine through the console port.

Step 4   At the Content Engine command prompt, enter install to install the image files. For example, if the filename is ce550-210.pax, enter:

console# install ce550-210.pax Extracting . Extracting ./imgname.txt Extracting ./etc Extracting ./etc/boot ... (etc) Extracting ./lib/gui/snmp Extracting ./lib/gui/snmp/CISCO-CACHEENGINE-MIB.my Extracting ./lib/gui/snmp/CISCO-SMI.my Extracting ./[image_name].bin.dbg.cus1 File extraction done. ce25.pax: installation is complete. Copy new image '[image_name].bin' to flash memory?[no]: y Erasing Programming erasing program image sector. 100% complete... You may type [reload] to reboot your box now

Step 5   From the Content Engine console, enter reload to reboot the Content Engine:

console# reload Proceed with reload? [confirm] y 303949 bytes copying bootagent boot start: 0x7fee000 starting new system - entry 0x8010 0x7dc8800 (tCallback0): NCR810_ Press any key to stop auto-boot...

If you want to stop the auto-boot process to change default boot parameters, perform the following steps (console connection only):

This ensures that the Content Engine boots from Flash memory rather than from a system image resident on another network host.

For example:

    Press any key to stop auto-boot... [CE500 Series]: c '.' = clear field; '-' = go to previous field; ^D = quit boot device (flash,net) [ net]: flash filename [ ]: ^D . . [CE500 Series]: @

Step 6   When the boot process is complete, verify the software version with the show version command:

console# show version Cisco Content Engine Copyright (c) 1986-2000 by Cisco Systems, Inc. Software Release: CE ver 2.30 (Build: #1 08/07/00) Compiled: 13:47:15 Aug 6 2000 by morlee Image text-base 0x108000, data_base 0x392244 System restarted by Reload The system has been up for 0 weeks, 0 day, 0 hours, 1 minutes, 10 seconds. System booted from "flash"

Recovering the System Software

The Content Engine can be booted from a system image resident on another network host (booted from the network) if the native onboard image is corrupted. A corrupted system image can result from a power failure that occurs while the installation procedure is updating the Flash memory. When the Content Engine is booted from the network, a new Flash memory image can be installed.

Recovery software is available from Cisco Connection Online (CCO). Make sure to download the correct .bin file for your Content Engine model.

To reboot the Content Engine with recovery software, perform the following steps:


Step 1   Make sure you have a console connection established. Reboot your Content Engine manually by toggling the power on/off switch.

Step 2   Stop the auto-boot process by pressing any key.

    Press any key to stop auto-boot... 6 [CE500 Series]: c '.' = clear field; '-' = go to previous field; ^D = quit boot device (flash,net) [ flash]: net filename [ ]: /Path/filename.bin cache IP address [ ]: 10.1.1.3 IP network mask [ ]: 255.255.255.0 server IP address [ ]: 172.16.63.250 gateway IP address [ ]: 10.1.1.2 protocol (rcp,ftp,tftp) [ ]: ftp username [ ]: name password [ ]: password flags [ 0]:

Step 3   Enter @ to start the boot sequence.

[CE500 Series]: [CE500 Series]: @ boot device (flash,net) [ net]: filename [/CCO Path/filename.bin]: cache IP address [ 10.1.1.3]: IP network mask [ 255.255.255.0]: server IP address [ 172.16.63.250]: gateway IP address [ 10.1.1.2]: protocol (rcp,ftp,tftp) [ ftp]: username [ name]: password [ password]: flags [ 0]: Loading from the network Attaching network interface fei0... done. Attaching network interface lo0... done. Loading... Starting at 0x108000... .................. Console IO Initialized Attaching network interface lo0... done. Restricted Rights Legend Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) of the Commercial Computer Software - Restricted Rights clause at FAR sec. 52.227-19 and subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS sec. 252.227-7013. Cisco Systems, Inc. 170 West Tasman Drive San Jose, California 95134-1706 Cisco Content Engine Copyright (c) 1986-2000 by Cisco Systems, Inc. Software Release: CE ver 2.30 (Build: #01 08/03/2000) Compiled: 18:09:47 Aug 08 2000 by morlee Image text-base 0x108000, data_base 0x42bea4 System restarted by Power Up The system has been up for 0 seconds. System booted from fei SVCINIT - phase complete Initializing SCSI interface... Initializing SCSI controller... Configuring SCSI peripherals... ID LUN VendorID ProductID Rev. Type Blocks BlkSize pScsiPhysDev -- --- -------- ---------------- ---- ---- -------- ------- 0 0 QUANTUM VIKING II 9.1SCA 4110 0 17836668 512 0x00fc9458 DEVINIT - phase complete FSINIT - phase complete Configuring from NVRAM... %% Non-volatile configuration memory has not been set up CONF - phase complete NTP: Waiting (2 minutes) for network initialization START - phase complete

Step 4   Reconfigure the Content Engine with the basic network settings. You can modify the system configuration later using the CLI.

---- System Configuration Dialog ---- You may use Ctrl-D to abort Configuration Dialog at any prompt. Would you like to enter the initial configuration? [yes]: y host name: myContent domain name: myfirm.com admin password: iforget cache IP address: 1.1.1.1 IP network mask: 255.255.230.2 gateway IP address:10.10.10.10 DNS server:yo

If the basic configuration is acceptable, enter yes. The Content Engine indicates whether the configuration is accepted. At this point, the basic configuration is finished.

Use this configuration? [yes]: y Building configuration... . . START - phase complete

Step 5   Log on to the Content Engine with your new admin password. Verify that you are running the correct version by entering show version.

Username: admin Password: test cache# cache# show version Cisco Content Engine Copyright (c) 1986-1998 by Cisco Systems, Inc. Software Release: Compiled: 17:08:40 Mar 24 1999 by morlee Image text-base 0x108000, data_base 0x419d2c

Step 6   To operate the management interface (the Cache software GUI) and boot from Flash memory in the future, see the "Upgrading the System Software" section to download the .pax file from CCO and install the .pax file.

You can now use the management interface or the CLI to enable WCCP or proxy mode and start caching.


Maintaining the Hard Disk Storage

Content Engines are equipped with one or more disks that are properly partitioned at the factory before shipment. The Cisco Storage Array can be shipped with unformatted disks. For information on maintaining the Cisco Storage Array disks, see the "Hard Disk Preparation Procedure for the Cisco Storage Array" section.

The principal disk partitions are for the DOS file system and cache file system (dosf and cfs respectively). The dosfs partition contains the image file, user interface images, and memory for system output from features such as syslog. The cfs contains cached network content.

To verify that a disk is partitioned correctly, execute the show disk-partitions command. To display the volume names, execute the show disks command.


Note   The UVFAT partition refers to the dosfs. The bfs partition refers to the boot file system, which is currently not used.

Console# show disk-partitions /c0t0d0 Disk size : 17836667 sectors Partition 1: CISCO_UVFAT_1, offset 63 sectors, size 3906250 sectors Partition 2: CISCO_BFS_1, offset 3906323 sectors, size 1024 sectors Partition 3: CISCO_CFS_1, offset 3907357 sectors, size 13929300 sectors Partition 4: UNUSED, offset 0 sectors, size 0 sectors Console# show disk-partitions /c0t1d0 Disk size : 17836667 sectors Partition 1: UNUSED, offset 0 sectors, size 0 sectors Partition 2: CISCO_BFS_1, offset 10 sectors, size 1024 sectors Partition 3: CISCO_CFS_1, offset 1044 sectors, size 17835613 sectors Partition 4: UNUSED, offset 0 sectors, size 0 sectors Console# show disks /c0t0d0 (scsi bus 0, unit 0, lun 0) /c0t1d0 (scsi bus 0, unit 1, lun 0)
Note   The name of disk 0 is /c0t0d0; the name of disk 1 is /c0t1d0. The c indicates the SCSI contoller number, t is the target number, and d is the logical unit number (LUN).

At any time, you can use the show cfs volumes and show dosfs volumes commands to verify volume status.

Console#
show cfs volumes /c0t0d0s3: mounted /c0t1d0s3: mounted Console# show dosfs volumes /c0t0d0s1: mounted /c0t1d0s1: mounted /local: mounted
Note   You can substitute the alias /local for the dosfs volume name /c0t0d0.

The dosfs partition may be unmounted if the dosfs unmount command was executed. If the dosfs partition is unmounted, mount the dosfs partition using the dosfs mount command.

If the dosfs mount command does not work properly, execute the show disk-partitions command. Check for the UVFAT partition. The size of the dosfs partition should be approximately 2 gigabytes. A sector is equal to 512 bytes. If there is no disk partition for the dosfs, see the "Repartitioning the Hard Disks" section.

If the dosfs volume does not mount, perform the procedure in the "Checking and Repairing DOS File System Volumes" section. If the dosfs volume still does not mount after you perform this procedure, repartition and reformat the disks as described in the "Repartitioning the Hard Disks" section."


Caution   Anytime a volume is partitioned or formatted (dosfs or cfs), all the data on the disk is lost.

Hard Disk Preparation Procedure for the Cisco Storage Array

The Storage Array hard disks are shipped without formatting or partitions. You must enter the disk manufacture EXEC command for each newly installed hard disk. Use the disk, cfs, and dosfs EXEC commands for subsequent maintenance of the disks.

Perform the following procedure when installing a new hard disk for the Cisco Storage Array:


Step 1   Make sure the disk drives are properly inserted into the Storage Array slots, and that the SCSI cable connectors on the Content Engine and Storage Array are tightened.

Step 2   Power on the Storage Array, and then power on the Content Engine.

Step 3   Make a note of the target numbers of any new disk drive that did not mount. The target number is the value of the "t" parameter in the disk volume name.

Determine the target numbers of the unmounted disks with one of the following methods:

Method 1: Enter the show cfs volumes Command

The show cfs volumes command displays all unmounted disks as unmounted cache file system (cfs) volumes. In the following example, disk targets 2, 3, 4, 5, 6, and 7 are not mounted.

    CacheEngine# show cfs volumes /c0t0d0s3: mounted
    /c0t1d0s3: mounted
    /c0t2d0s3: not mounted
    /c0t3d0s3: not mounted
    /c0t4d0s3: not mounted
    /c0t5d0s3: not mounted /c0t6d0s3: not mounted
    /c0t7d0s3: not mounted
Method 2: Count the Hard Disks in the Storage Array

The leftmost hard disk inserted in a Storage Array bus is always target 2. Counting to the right, the next disk is target 3, the next disk is target 4, and so on. There can be empty slots between targets on the same bus, but this is not recommended.

In a two-host, split-bus configuration, each bus is counted independently. For example, in a split-bus, six-disk, fully populated Storage Array, bus 0 disk drive targets are 2, 3, and 4, and bus 1 disk drive targets are 2, 3, and 4. If the first disk on bus 1 is removed (slot 5 is empty) and the Content Engine is rebooted, bus 0 targets are still 2, 3, and 4, but bus 1 targets are 2 and 3. The empty disk slot is skipped, and the target count begins with the first detected disk on bus 1.

Method 3: Read the Mount Failed Error Messages

The Content Engine generates an error message for each disk drive that fails to mount as the Content Engine boots up. In the following example, disk targets 2, 3, 4, 5, 6, and 7 failed to mount:

Thu Dec 31 16:06:50 1987: CFS volume /c0t2d0s3 mount failed S_cfslib_NOT_CFS_PARTITION
Thu Dec 31 16:06:50 1987: CFS volume /c0t3d0s3 mount failed S_cfslib_NOT_CFS_PARTITION
Thu Dec 31 16:06:50 1987: CFS volume /c0t4d0s3 mount failed S_cfslib_NOT_CFS_PARTITION
Thu Dec 31 16:06:50 1987: CFS volume /c0t5d0s3 mount failed S_cfslib_NOT_CFS_PARTITION
Thu Dec 31 16:06:50 1987: CFS volume /c0t6d0s3 mount failed S_cfslib_NOT_CFS_PARTITION
Thu Dec 31 16:06:50 1987: CFS volume /c0t7d0s3 mount failed S_cfslib_NOT_CFS_PARTITION

Step 4   Enter the disk manufacture command for each new hard disk to be installed.

In the following example, the disks with target numbers 2 and 3 are partitioned, formatted, and mounted with the disk manufacture EXEC command.

ContentEngine# disk manufacture /c0t2d0
total size of disk = 35843670
CISCO_UVFAT_1 vol /c0t2d0s1 part_off 0 part_siz 0
Skipping creation of DOS partition for SCSI device
CISCO_BFS_1 vol /c0t2d0s2 part_off 10 part_siz 1024
CISCO_CFS_1 vol /c0t2d0s3 part_off 1044 part_siz 35842616
CacheEngine# disk manufacture /c0t3d0
total size of disk = 35843670
CISCO_UVFAT_1 vol /c0t3d0s1 part_off 0 part_siz 0
Skipping creation of DOS partition for SCSI device
CISCO_BFS_1 vol /c0t3d0s2 part_off 10 part_siz 1024
CISCO_CFS_1 vol /c0t3d0s3 part_off 1044 part_siz 35842616

Step 5   Enter the show cfs volumes command to verify that the disks are mounted.

ContentEngine# show cfs volumes /c0t0d0s3: mounted /c0t1d0s3: mounted /c0t2d0s3: mounted /c0t3d0s3: mounted

See the disk manufacture command in the Cisco Cache Software Command Reference documentation for further information on the Storage Array.

Repartitioning the Hard Disks


Caution   Whenever a disk is partitioned, all the data on the disk is lost.

To repartition disk 0, which is the location of the dosfs partition, enter the disk partition command.


Note   The name of disk 0 is /c0t0d0; the name of disk 1 is /c0t1d0.

Console# disk partition /c0t0d0 dosfs cfs this will create a dos partition and cfs partition total size of disk = 17836667 CISCO_UVFAT_1 vol /c0t0d0s1 part_off 63 part_siz 3906250 CISCO_BFS_1 vol /c0t0d0s2 part_off 3906323 part_siz 1024 CISCO_CFS_1 vol /c0t0d0s3 part_off 3907357 part_siz 13929300

It is also possible to repartition only the dosfs of disk 0 using the disk partition command, excluding the cfs keyword.

Console# disk partition /c0t0d0 dosfs total size of disk = 17836667 CISCO_UVFAT_1 vol /c0t0d0s1 part_off 63 part_siz 3906250 CISCO_BFS_1 vol /c0t0d0s2 part_off 3906323 part_siz 1024 CISCO_CFS_1 vol /c0t0d0s3 part_off 0 part_siz 0 Skipping creation of CFS partition for SCSI device

To repartition disk 1, enter the disk partition command.

Console# disk partition /c0t1d0 cfs total size of disk = 17836667 CISCO_UVFAT_1 vol /c0t1d0s1 part_off 0 part_siz 0 Skipping creation of DOS partition for SCSI device CISCO_BFS_1 vol /c0t1d0s2 part_off 10 part_siz 1024 CISCO_CFS_1 vol /c0t1d0s3 part_off 1044 part_siz 17835613

Following a repartition, you must format and mount the dosfs and cfs using the following commands:

If the first disk is reformatted, all the cache data is lost as well as all data in the dosfs partition. It will be necessary to reinstall the software image as well as the user interface images. See the "Recovering the System Software" section.

If the second disk is reformatted, all the cache data on that disk (cfs) is lost. The Content Engine will repopulate the disk with regular use.


Note   If the dosfs partition is not mounted correctly, an error message may be generated from the CLI. An example of this error message is shown below.

Console# cli command Could not get stat information about /local <====

Checking and Repairing DOS File System Volumes

The dosfs partition may be corrupted if a power outage occurs while the Content Engine is writing to the disk, or if the disk is removed while writing to the dosfs partitions.

If there is a problem caused by the corrupted dosfs FAT table, perform the following steps:


Step 1   Enter the dosfs check /local command.

Step 2   If an error message occurs, enter the dosfs unmount /local command.

Step 3   Enter the dosfs repair auto /local command.

Step 4   Enter the dosfs mount /local command.

Step 5   If the dosfs mount fails after you enter the dosfs repair command, enter the dosfs format command followed by the dosfs mount command.

If you are working in the current working directory of /local, you may see the following error message:

Could not get stat information about /local.
You can enter the cd / command to avoid this error message.


Note   Entering the dosfs check command effectively prevents system features (such as syslog or transaction logging) from writing to the disk. Disregard error messages generated by these features after entering the dosfs check command, as shown in the following example.

Console# dosfs check /local tSyslog: Cannot write log to Disk File (/local/var/log/syslog.txt), OK

Recovering a Lost Password

If a user password is forgotten, lost, or misconfigured, perform the following steps to reset the password.


Note   There is no way to restore a lost password. You must reset the password to a new one, as described in this procedure.


Step 1   Attach an ASCII terminal to the Content Engine console port.

Step 2   Break to the bootstrap program prompt and press any key before the Content Engine completes the auto-boot sequence.

    Press any key to stop auto-boot... 7 [PRESS ANY KEY NOW before the Content Engine auto reboots] [CE500 Series]:c boot device (flash,net) [ net]: flash filename [ filename]: cache IP address [ 10.1.138.5]: IP network mask [ 255.255.255.0]: server IP address [ 172.16.63.250]: gateway IP address [ 10.1.138.1]: protocol (rcp,ftp,tftp) [ ]: username [ ]: password [ ]: flags [ 0]: 0x8000 [CE500 Series]:@

Step 3   Change the configuration flags field to 0x8000 (as shown above). Then enter @ to continue with the boot sequence.

Step 4   Once you see the CLI prompt, set the password for the user using the user modify username name password new-password command in the global configuration mode.

Step 5   Use the write command to save the configuration change.

By default, the Content Engine has an "admin" user with no password set. When no password is set, you can enter anything as a password.


Sample Configurations

The following sample configurations are outputs of the show running-config command and can be used as a guide for configuring the Content Engine in WCCP Version 1 and Version 2 environments. If a feature is not enabled, it does not appear in the running configuration display, though settings configured for that feature are displayed.

WCCP Version 1 Sample Configuration

The following is a sample WCCP Version 1 configuration:

console# show running-config Building configuration... Current configuration: ! ! logging event-export critical-events alert kernel logging 10.7.8.9 ! user add admin uid 0 password 1 "ceSzbyeb" capability admin-access user add britt uid 5001 password 1 "bbdze9eSbS" capability telnet-access ! ! ! hostname cache1D ! interface ethernet 0 ip address 10.1.1.34 255.255.255.0 ip broadcast-address 10.1.1.255 exit ! ! interface ethernet 1 exit ! ip default-gateway 10.1.1.2 ip name-server 10.2.2.2 ip domain-name cisco.com cron file /local/etc/crontab ntp server 10.6.14.7 ! ! http proxy incoming 8080 icp server remote-client 10.4.6.8 no-fetch url-filter good-sites-allow wccp home-router 10.1.2.1 wccp version 1 ! transaction-logs destination disk transaction-logs interval 750 ! trusted-host 10.4.4.4 ! end cache1D#

WCCP Version 2 Sample Configuration

The following is a sample configuration of a Content Engine in a WCCP Version 2 environment:

console# show running-config Building configuration... Current configuration: ! ! logging event-export critical-events warning user ! user add admin uid 0 password 1 "ceSzbyeb" capability admin-access user add bwhidney uid 5013 password 1 "bSzyydQbSb" capability admin-access user add name uid 5001 ! ! ! hostname console ! interface ethernet 0 ip address 172.16.0.1 255.255.255.128 ip broadcast-address 172.16.0.255 exit ! ! interface ethernet 1 exit ! ! interface ethernet 1 exit ! ip default-gateway 172.16.217.129 ip name-server 10.1.2.2 ip name-server 172.16.2.144 ip domain-name cisco.com ip route 0.0.0.0 0.0.0.0 172.16.227.222 cron file /local/etc/crontab clock timezone pst -8 0 ! bypass static 172.17.11.11 any-server bypass static any-client 172.23.23.23 http cache-cookies http max-ttl days text 4 binary 3 http cache-authenticated http proxy outgoing origin-server http proxy incoming 8082 icp client exclude google.com,cruzio.com url-filter websense server 172.18.11.22 port 3333 timeout 5 no url-filter websense allowmode wccp router-list 1 10.1.1.1 wccp router-list 2 10.1.1.2 wccp router-list 3 10.1.1.3 wccp port-list 1 8082 8080 10 200 3000 40000 wccp port-list 2 65222 65333 wccp port-list 6000 60010 60200 63000 8000 wccp web-cache router-list-num 1 wccp reverse-proxy router-list-num 3 wccp custom-web-cache router-list-num 1 port 473 hash-destination-ip wccp service-number 90 router-list-num 1 port-list-num 1 hash-destination-ip weight 20 password **** wccp home-router 10.1.1.1 wccp version 2 wccp shutdown max-wait 1 ! radius-server exclude enable authentication login tacacs enable primary authentication login local enable authentication configuration tacacs enable authentication configuration local enable ldap server host 10.1.1.5 port 88 ldap server allow-mode transaction-logs archive files 5 transaction-logs archive interval every-day at 12:00 transaction-logs enable transaction-logs export enable transaction-logs sanitize proxy-protocols transparent original-proxy proxy-protocols outgoing-proxy exclude list cisco.com proxy-protocols outgoing-proxy exclude list cruzio.com proxy-protocols outgoing-proxy exclude list 172.19.24.22 rule enable rule block dst-port 33 rule block domain ethel.com rule no-auth domain google.com rule no-cache domain fred.com https proxy outgoing host 1.1.1.1 76 https destination-port allow 111 222 333 https destination-port allow 44 33 https destination-port deny 20 21 23 119 ! exec-timeout 60 !


hometocprevnextglossaryfeedbacksearchhelp
Posted: Tue Jun 5 19:33:34 PDT 2001
All contents are Copyright © 1992--2001 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.