Working With System Software Images and Configuration Files

This chapter describes how to work with system software image files and switch configuration files, and how to use the Supervisor Engine III Flash file system.

Note For complete syntax and usage information for the commands used in this chapter, refer to the Catalyst 5000 Series Command Reference publication.

This chapter consists of these sections:

Downloading System Software Images to the Switch

These sections describe how to download system software images to the Catalyst 5000 series switch supervisor engine and to the Token Ring, Fiber Distributed Data Interface/Copper Distributed Data Interface (FDDI/CDDI), ATM, and Gigabit EtherChannel switching modules:

Understanding How Software Image Downloads Work

You can download system software images to the Catalyst 5000 using one of two methods:

Trivial File Transfer Protocol (TFTP)---You can use TFTP to perform a network download of files from a TFTP server
Kermit---You can use Kermit, a popular file-transfer and terminal-emulation software program, to perform a serial transfer of files over the supervisor engine console port

Some Catalyst 5000 series modules, such as FDDI and ATM modules, have their own onboard Flash. When you download a software image file, the switch checks the header of the image file to determine the type of software image.

Depending on the type of software image you are downloading, one of the following occurs:

Supervisor engine software image---The image file is downloaded to the supervisor engine Flash memory. On the Supervisor Engine I or II, you can store only a single image file at a time. On the Supervisor Engine III, you can store multiple image files on the various Flash memory system devices (such as boot Flash and Flash memory PC cards).

Caution Some Catalyst 5000 supervisor engine software releases update the Supervisor Engine III erasable programmable logic devices (EPLDs). The EPLDs can be updated only a finite number of times. You should avoid loading a new software release and then backing out unnecessarily. Catalyst 5000 series supervisor engine software release notes indicate which software releases have code that updates the EPLDs.

Token Ring, FDDI, ATM, or Gigabit EtherChannel images---If you specified a module number, the image file is downloaded to the specified module only (provided the image file is designed for the specified module type). If you do not specify a module number, the image file is downloaded to every module of the appropriate type. The file is relayed packet by packet to the appropriate modules using the Inter-Process Communications (IPC) protocol internal to the system, with communication taking place across the switching bus. Downloading a software image to multiple modules significantly speeds up the process of updating the software on multiple modules of the same type.

	Caution Some Catalyst 5000 supervisor engine software releases update the Supervisor Engine III erasable programmable logic devices (EPLDs). The EPLDs can be updated only a finite number of times. You should avoid loading a new software release and then backing out unnecessarily. Catalyst 5000 series supervisor engine software release notes indicate which software releases have code that updates the EPLDs.

Downloading Software Images Using TFTP

The following sections describe how to download software images to the Catalyst 5000 series switch using TFTP:

Note For more information on working with system software image files on the Supervisor Engine III Flash file system, refer to the "Using the Flash File System" section.

Preparing to Download an Image Using TFTP

Before you begin downloading a software image using TFTP, make sure of the following:

Ensure the workstation acting as the TFTP server is configured properly. On a Sun workstation, make sure the /etc/inetd.conf file contains the following line:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot

: Make sure the /etc/services file contains this line:

tftp 69/udp

Note

fastboot

reboot

Ensure the Catalyst 5000 series switch has a route to the TFTP server. The switch and the TFTP server must be in the same subnetwork if you do not have a router to route traffic between subnets. Check connectivity to the TFTP server using the ping command.
Ensure the software image to be downloaded is in the correct directory on the TFTP server.
Ensure that the permissions on the file are set correctly. Permissions on the file should be world-read.
A power interruption (or other problem) during the download procedure can corrupt the Flash code. If the Flash code is corrupted, you can connect to the switch through the console port. At the boot> prompt, you can download the Flash code again through an enabled port in VLAN 1. By default, port 1/1 is enabled. You can use port 1/1 or enable another port.

Downloading Supervisor Images Using TFTP (Supervisor Engine I and II)

Note Catalyst 5505, Catalyst 5509, and Catalyst 5500 only---If you have a redundant supervisor engine, you cannot download a system image directly from a TFTP server to the Flash memory on the standby supervisor engine. When you download the image to the active supervisor, the standby supervisor updates automatically with the new image. In addition, you cannot copy an image from the standby supervisor engine to the active supervisor engine.

Use the following procedure to download a supervisor engine software image to a Catalyst 5000 series switch with a Supervisor Engine I or II installed:

Step 1 Copy the software image file to the appropriate TFTP directory on the workstation (usually /tftpboot on a UNIX workstation).

Step 2 Log into the Catalyst 5000 series switch through the console port or via a Telnet session. If you log in via Telnet, your Telnet session disconnects when you reset the switch to run the new software.

Step 3 Download the software image from the TFTP server using the download host file command.

Specify the IP address or host name of the workstation acting as the TFTP server and the name of the file to download.

The Catalyst 5000 series switch downloads the image file, erases the Flash memory on the supervisor engine, and reprograms the Flash memory with the downloaded Flash code.

Note

Step 4 Reset the Catalyst 5000 series switch using the reset system command. If you are connected to the switch via Telnet, your Telnet session disconnects.

Step 5 When the switch reboots, enter the show version command to check the version of the code on the switch.

Note For an example that shows a complete TFTP download procedure of a supervisor engine software image to a Catalyst 5000 series switch with a Supervisor Engine I or II module, see the "Example Supervisor Image TFTP Download (Supervisor I and II)" section.

Downloading Supervisor Images Using TFTP (Supervisor Engine III)

Use this procedure to download a software image to a Catalyst 5000 series switch with a Supervisor Engine III installed:

Step 1 Copy the software image file to the appropriate TFTP directory on the workstation (usually /tftpboot on a UNIX workstation).

Step 3 Download the software image from the TFTP server using the copy tftp flash command.

When prompted, enter the IP address or host name of the TFTP server, the name of the file to download, the Flash device to which to copy the file, and the destination filename.

The Catalyst 5000 series switch downloads the image file to the Flash device.

Note

Step 4 Prepend the image filename to the BOOT environment variable using the set boot system flash device:filename prepend command, so the new image boots when you reset the switch.

Step 5 Reset the Catalyst 5000 series switch using the reset system command. If you are connected to the switch via Telnet, your Telnet session disconnects.

During startup, the Flash memory on the supervisor engine is reprogramed with the new Flash code.

Step 6 When the switch reboots, enter the show version command to check the version of the code on the switch.

Note For an example that shows a complete TFTP download procedure of a supervisor engine software image to a Catalyst 5000 series switch with a Supervisor Engine III module, see the "Example Supervisor Image TFTP Download (Supervisor III)" section.

Downloading Switching Module Images Using TFTP (Supervisor Engine I and II)

Use this procedure to download a software image to a Catalyst 5000 series switch with a Supervisor Engine I or II installed:

Step 1 Copy the software image file to the appropriate TFTP directory on the workstation (usually /tftpboot on a UNIX workstation).

Step 2 Log into the Catalyst 5000 series switch through the console port or via a Telnet session. If you log in via Telnet, your Telnet session might disconnect when you reset modules to run the new software.

Step 3 Download the software image from the TFTP server using the download host file [mod_num] command.

Specify the IP address or host name of the workstation acting as the TFTP server, and the name of the file to download. If you are downloading the image to a single module, specify the module number. The image is downloaded to that module.

If you do not specify a module number, the switch examines the header of the image file to determine to which modules the software is downloaded. The image is then downloaded to all the modules of that type.

The Catalyst 5000 series switch downloads the image file, erases the Flash memory on the appropriate modules, and reprograms the Flash memory with the downloaded Flash code.

Note

Step 4 Reset the appropriate modules using the reset mod_num command. If you are connected via Telnet, your Telnet session disconnects if you reset the module through which your connection was made.

Step 5 When the upgraded modules come online, enter the show version [mod_num] command to check the version of the code on the switch.

Note For examples that show a complete TFTP download procedure of a switching module software image to a Catalyst 5000 series switch with a Supervisor Engine I or II module, see the "Example Single Module Image TFTP Download (Supervisor I and II)" section and the "Example Multiple Module Image TFTP Download (Supervisor I and II)" section.

Downloading Switching Module Images Using TFTP (Supervisor Engine III)

Use this procedure to download a software image to a Catalyst 5000 series switch with a Supervisor Engine III installed:

Step 1 Copy the software image file to the appropriate TFTP directory on the workstation (usually /tftpboot on a UNIX workstation).

Step 3 Download the software image from the TFTP server.

If there is only one module of the type appropriate for the image, or if there are multiple modules of the same type and you want to update the image on all of them, use the copy tftp flash command to download the image.
If there are multiple modules of the type appropriate for the image but you only want to update a single module, use the copy tftp m/bootflash: command, where m is the number of the module to which to download the software image.

When prompted, enter the IP address or host name of the workstation acting as the TFTP server and the name of the file to download.

The Catalyst 5000 series switch downloads the image file, erases the Flash memory on the appropriate modules, and reprograms the Flash memory with the downloaded Flash code.

Note

Step 4 Reset the module using the reset mod_num command. If you are connected via Telnet, your Telnet session disconnects if you reset the module through which your connection was made.

Step 5 When the upgraded modules come online, enter the show version [mod_num] command to check the version of the code on the switch.

Note For examples that show a complete TFTP download procedure of a switching module software image to a Catalyst 5000 series switch with a Supervisor Engine I or II module, see the "Example Single Module Image TFTP Download (Supervisor III)" section and the "Example Multiple Module Image TFTP Download (Supervisor III)" section.

Example TFTP Download Procedures

These sections show example TFTP download procedures on the Catalyst 5000 series switch:

Example Supervisor Image TFTP Download (Supervisor I and II)

Note For a step-by-step procedure for downloading a supervisor engine software image to a Supervisor Engine I or II, refer to the "Downloading Supervisor Images Using TFTP (Supervisor Engine I and II)" section.

This example shows a complete TFTP download procedure of a supervisor engine software image to a Catalyst 5000 series switch with a Supervisor Engine I or II module:

Console> (enable) show version 1

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
1   2    WS-X5509   007486003 Hw : 2.3
                              Fw : 3.1(2)
                              Fw1: 3.1(1)
                              Sw : 4.1(2)
Console> (enable) download 172.20.52.3 cat5000-sup.4-2-1.bin

Download image cat5000-sup.4-2-1.bin from 172.20.52.3 to module 1 FLASH (y/n)
 [n]? y
/
Finished network single module download. (2748504 bytes)
FLASH on Catalyst:
 
Type            Address             Location
Intel 28F016    20000000            NMP (P3) 8MB SIM
 
Erasing flash sector...done.
Programming flash sector...done.
Erasing flash sector...done.
Programming flash sector...done.
Erasing flash sector...done.
Programming flash sector...done.
The system needs to be reset to run the new image.
Console> (enable) reset system

This command will reset the system.
Do you want to continue (y/n) [n]? y

Console> (enable) 07/21/1998,10:52:36:SYS-5:System reset from Console//
 
 
 
 
 
ATE0
ATS0=1
 
 
 
ROM Power Up Diagnostics of Feb 19 1998
 
Init NVRAM Log
LED Test  ................... done
ROM Checksum  ............... passed
Dual Port RAM r/w Test  ..... passed
ID PROM  .................... passed
System DRAM Size(mb)  ....... 16
DRAM Data Bus Test  ......... passed
DRAM Address Test  .......... passed
DRAM Byte/Word Access Test .. passed
EARL Test  .................. passed
 
 
BOOTROM Version 3.1(2), Dated Feb 19 1998 11:05:50
BOOT date: 07/21/98 BOOT time: 10:52:51
Uncompressing NMP image.  This will take a minute...
Downloading epld sram device please wait ...
Programming successful for Altera 10K10 SRAM EPLD
Updating epld flash version from 0000 to 0400
 
Running System Diagnostics from this Supervisor (Module 1)
This may take up to 2 minutes....please wait
 
 
Cisco Systems Console
 
 
 
 
Enter password:
07/21/1998,10:53:39:SYS-5:Module 1 is online
07/21/1998,10:53:58:PAGP-5:Port 1/1 joined bridge port 1/1.
07/21/1998,10:54:15:SYS-5:Module 7 is online
07/21/1998,10:54:22:SYS-5:Module 2 is online
07/21/1998,10:54:39:SYS-5:Module 9 is online
07/21/1998,10:54:43:SYS-5:Module 5 is online
07/21/1998,10:54:56:SYS-5:Module 3 is online
07/21/1998,10:54:57:SYS-5:Module 6 is online
07/21/1998,10:54:58:DTP-5:Port 3/1-2 has become dot10 trunk
07/21/1998,10:55:36:SYS-5:Module 2 is online
Console> show version 1

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
1   2    WS-X5509   007486003 Hw : 2.3
                              Fw : 3.1(2)
                              Fw1: 3.1(1)
                              Sw : 4.2(1)
Console>

Example Supervisor Image TFTP Download (Supervisor III)

Note For a step-by-step procedure for downloading a supervisor engine software image to a Supervisor Engine III, refer to the "Downloading Supervisor Images Using TFTP (Supervisor Engine III)" section.

This example shows a complete TFTP download procedure of a supervisor engine software image to a Catalyst 5000 series switch with a Supervisor Engine III module:

Console> (enable) show version 1

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
1   2    WS-X5530   007451586 Hw : 1.3
                              Fw : 3.1.2
                              Fw1: 3.1(2)
                              Sw : 4.1(2)
Console> (enable) copy tftp flash

IP address or name of remote host []? 172.20.52.3

Name of file to copy from []? cat5000-sup3.4-2-1.bin

Flash device [bootflash]?
Name of file to copy to [cat5000-sup3.4-2-1.bin]?
 
4369664 bytes available on device bootflash, proceed (y/n) [n]? y

CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
CCCCCCCCCCCCCCCCCCC
File has been copied successfully.
Console> (enable) set boot system flash bootflash:cat5000-sup3.4-2-1.bin prepend

BOOT variable = bootflash:cat5000-sup3.4-2-1.bin,1;bootflash:cat5000-sup3.4-1
-2.bin,1;
Console> (enable) reset system

This command will reset the system.
Do you want to continue (y/n) [n]? y

Console> (enable) 07/21/1998,13:51:39:SYS-5:System reset from Console//
 
 
System Bootstrap, Version 3.1(2)
Copyright (c) 1994-1997 by cisco Systems, Inc.
Presto processor with 32768 Kbytes of main memory
 
Autoboot executing command: "boot bootflash:cat5000-sup3.4-2-1.bin"
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
CCCCCCCCCCCCCCCCCCC
Uncompressing file:  ###########################################################
################################################################################
################################################################################
################################################################################
################################################################################
################################################################################
################################################################################
################################################################################
################################################################################
################################################################################
#############
 
 
System Power On Diagnostics
NVRAM Size .. .................512KB
ID Prom Test ..................Passed
DPRAM Size ....................16KB
DPRAM Data 0x55 Test ..........Passed
DPRAM Data 0xaa Test ..........Passed
DPRAM Address Test ............Passed
Clearing DPRAM ................Done
System DRAM Memory Size .......32MB
DRAM Data 0x55 Test ...........Passed
DRAM Data 0xaa Test ...........Passed
DRAM Address Test  ............Passed
Clearing DRAM .................Done
EARL++ ........................Present
EARL RAM Test .................Passed
EARL Serial Prom Test .........Passed
Level2 Cache ..................Present
Level2 Cache test..............Passed
 
Boot image: bootflash:cat5000-sup3.4-2-1.bin
Downloading epld sram device please wait ...
Programming successful for Altera 10K10 SRAM EPLD
Downloading epld sram device please wait ...
Programming successful for Altera 10K30 SRAM EPLD
Downloading epld sram device please wait ...
 
 
Cisco Systems Console
 
 
 
 
Enter password:
07/21/1998,13:52:51:SYS-5:Module 1 is online
07/21/1998,13:53:11:SYS-5:Module 4 is online
07/21/1998,13:53:11:SYS-5:Module 5 is online
07/21/1998,13:53:14:PAGP-5:Port 1/1 joined bridge port 1/1.
07/21/1998,13:53:14:PAGP-5:Port 1/2 joined bridge port 1/2.
07/21/1998,13:53:40:SYS-5:Module 2 is online
07/21/1998,13:53:45:SYS-5:Module 3 is online
 
Console> show version 1

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
1   2    WS-X5530   007451586 Hw : 1.3
                              Fw : 3.1.2
                              Fw1: 3.1(2)
                              Sw : 4.2(1)
Console>

Example Single Module Image TFTP Download (Supervisor I and II)

Note For a step-by-step procedure for downloading a software image to a switching module on a switch with a Supervisor Engine I or II, refer to the "Downloading Switching Module Images Using TFTP (Supervisor Engine I and II)" section.

This example shows a complete TFTP download procedure of an FDDI software image to a single FDDI module in a Catalyst 5000 series switch with a Supervisor Engine I or II module:

Console> (enable) show version 3

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
3   2    WS-X5101   003489788 Hw : 1.0
                              Fw : 1.1
                              Fw1: 1.3
                              Sw : 2.1(7)
Console> (enable) download 172.20.52.3 cat5000-fddi.3-1-1.bin 3

This command will reset module 3.
Download image cat5000-fddi.3-1-1.bin from 172.20.52.3 to Module 3 FLASH (y/n) [
n]? y

|
Finished network single module download. (1060456 bytes)
...............................................................................
...............................................................................
...............................................................................
...............................................................................
...............................................................................
..................................
SCP download checksum ok
SCP download done.
Please wait until module 3 comes online before resetting.
(Approximately 5 minutes)
Console> (enable) Console> (enable) 07/21/1998,11:23:36:SYS-5:Module 3 FLASH pro
gramming complete
07/21/1998,11:24:59:SYS-5:Module 3 is online
07/21/1998,11:25:00:DTP-5:Port 3/1-2 has become dot10 trunk
 
Console> (enable) show version 3

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
3   2    WS-X5101   003489788 Hw : 1.0
                              Fw : 1.1
                              Fw1: 1.3
                              Sw : 3.1(1)
Console> (enable)

Example Single Module Image TFTP Download (Supervisor III)

Note For a step-by-step procedure for downloading a software image to a switching module on a switch with a Supervisor Engine III, refer to the "Downloading Switching Module Images Using TFTP (Supervisor Engine III)" section.

This example shows a complete TFTP download procedure of an ATM software image to a single ATM module in a Catalyst 5000 series switch with a Supervisor Engine III module:

Console> (enable) show version 4

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
4   1    WS-X5155   003414855 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(6)
Console> (enable) copy tftp 4/flash

IP address or name of remote host []? 172.20.52.3

Name of file to copy from []? cat5000-atm.3-2-7.bin

Download image tftp:cat5000-atm.3-2-7.bin to Module 4 FLASH (y/n) [n]? y

This command will reset Download Module(s) you selected.
 
Do you wish to continue download flash (y/n) [n]? y

-
Download done for module 4, please wait for it to come online
 
File has been copied successfully.
Console> (enable) 07/21/1998,13:13:54:SYS-5:Module 4 is online
 
Console> (enable) show version 4

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
4   1    WS-X5155   003414855 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(7)
Console> (enable)

Example Multiple Module Image TFTP Download (Supervisor I and II)

This example shows a complete TFTP download procedure of an ATM software image to multiple ATM modules in a Catalyst 5000 series switch with a Supervisor Engine I or II module:

Console> (enable) show version 8

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
8   1    WS-X5155   003414855 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(4)
Console> (enable) show version 9

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
9   1    WS-X5155   003414463 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(6)
Console> (enable) download 172.20.52.3 cat5000-atm.3-2-7.bin

Download image cat5000-atm.3-2-7.bin from 172.20.52.3 to Module 8 FLASH (y/n) [n
]? y

Download image cat5000-atm.3-2-7.bin from 172.20.52.3 to Module 9 FLASH (y/n) [n
]? y

This command will reset download module(s) you selected.
 
Do you wish to continue download to flash (y/n) [n]? y

-
Download done for module 8, please wait for it to come online
 
Download done for module 9, please wait for it to come online
 
Finished network multiple modules download. (2378316 bytes)
Please wait until module(s) come online before resetting.
Console> (enable) 07/21/1998,13:19:54:SYS-5:Module 8 is online
07/21/1998,13:19:54:SYS-5:Module 9 is online
 
Console> (enable) show version 8

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
8   1    WS-X5155   003414855 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(7)
Console> (enable) show version 9

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
9   1    WS-X5155   003414463 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(7)
Console> (enable)

Example Multiple Module Image TFTP Download (Supervisor III)

This example shows a complete TFTP download procedure of an ATM software image to multiple ATM modules in a Catalyst 5000 series switch with a Supervisor Engine III module:

Console> (enable) show version 4

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
4   1    WS-X5155   003414855 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(6)
Console> (enable) show version 5

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
5   1    WS-X5155   003414463 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(6)
Console> (enable) copy tftp flash

IP address or name of remote host []? 172.20.52.3

Name of file to copy from []? cat5000-atm.3-2-7.bin

Download image tftp:cat5000-atm.3-2-7.bin to Module 4 FLASH (y/n) [n]? y

Download image tftp:cat5000-atm.3-2-7.bin to Module 5 FLASH (y/n) [n]? y

This command will reset Download Module(s) you selected.
 
Do you wish to continue download flash (y/n) [n]? y

-
Download done for module 4, please wait for it to come online
 
Download done for module 5, please wait for it to come online
 
File has been copied successfully.
Console> (enable) 07/21/1998,12:25:10:SYS-5:Module 4 is online
07/21/1998,12:25:10:SYS-5:Module 5 is online
 
Console> (enable) show version 4

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
4   1    WS-X5155   003414855 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(7)
Console> (enable) show version 5

Mod Port Model      Serial #  Versions
--- ---- ---------- --------- ----------------------------------------
5   1    WS-X5155   003414463 Hw : 1.2
                              Fw : 1.3
                              Fw1: 1.3
                              Sw : 3.2(7)
Console> (enable)

Downloading Software Images Over a Serial Connection on the Console Port

These sections describe how to perform a serial download of software images over the Catalyst 5000 series supervisor engine console port using Kermit:

Preparing to Download an Image Using Kermit

Before you begin a serial download of a software image using Kermit, make sure of the following:

On a UNIX workstation, make sure your shell window is local (not an rlogin window to a different workstation).
Ensure that the supervisor engine console port is connected to a serial port on your PC or workstation with a serial cable.
Ensure that the Kermit software is installed on your PC or workstation.
Ensure that the line speed settings are the same on the PC or workstation and on the switch:
- On the switch, you can change the console port speed by entering the set system baud rate command. The default baud rate is 9600 baud.
- On the PC or workstation, you can change the baud rate of the serial port by entering the set speed rate command at the Kermit> prompt.
  
  Caution To prevent communication problems, do not use a speed greater than 19,200 baud.
Ensure that Kermit is using the proper serial port.
- On a PC, specify the serial port using the set port comx command, where x is the PC serial port number (1 through 8) that you connected to the switch.
- On a UNIX workstation, specify the serial port using the set port /dev/ttyx command, where x is the serial port (a or b) that you connected to the switch.

	Caution To prevent communication problems, do not use a speed greater than 19,200 baud.

Downloading Software Images Using Kermit (PC Procedure)

Note This procedure applies to PC serial downloads only. For information on performing a serial download on a UNIX workstation, refer to the "Downloading Software Images Using Kermit (UNIX Procedure)" section.

Use this procedure to perform a serial download of a software image over the Catalyst 5000 series supervisor engine console port:

Step 1 Copy the software image file to the directory where Kermit is loaded.

Step 2 Start Kermit on the PC.

Note Before continuing, ensure that the line speed is correct and that you have selected the proper serial line, as described in the "Preparing to Download an Image Using Kermit" section.

Step 3 At the Kermit> prompt, enter the connect command to connect to the Catalyst 5000 series switch. If your line and speed are set correctly, the switch Console> prompt appears.

Step 4 Enter the enable command to enter privileged mode.

Step 5 Enter the download serial command. The file is downloaded to module 1 by default.

Step 6 When prompted, confirm the download.

Step 7 Enter the escape sequence Ctrl-]-c by holding down the Control key while you press ], and then press c.

Step 8 At the Kermit> prompt, enter the send filename command to send the file to the Catalyst 5000 series switch.

The Catalyst 5000 series switch downloads the image file, erases the Flash memory on the supervisor engine or the appropriate module, and reprograms the Flash memory with the downloaded Flash code.

Note

Step 9 When the Kermit> prompt reappears, enter the connect command to return to the switch Console> prompt. You will see status information as the switch erases and reprograms the Flash memory.

Note

If you enter the connect command more than two minutes after the Kermit> prompt reappears, you might see only a Console> prompt instead of the status information about erasing and programming Flash code.

Step 10 Reset the Catalyst 5000 series switch using the reset system command.

Step 11 When the switch reboots, enter the show version [mod_num] command to check the version of the code on the switch.

Note For an example that shows a complete serial download procedure using Kermit on a PC, see the "Example PC Serial Download Procedure" section.

Downloading Software Images Using Kermit (UNIX Procedure)

Note This procedure applies to UNIX serial downloads only. For information on performing a serial download on a PC, refer to the "Downloading Software Images Using Kermit (PC Procedure)" section.

Use this procedure to perform a serial download of a software image over the Catalyst 5000 series supervisor engine console port:

To copy the software to the workstation, log in as root, and perform these steps:

Step 1 Copy the software image file to your home directory.

Step 2 At the UNIX command prompt, start Kermit by entering the kermit command (make sure the directory where Kermit is installed in included in the $PATH environment variable on the workstation).

Note Before continuing, ensure that the line speed is correct and that you have selected the
proper serial line, as described in the "Preparing to Download an Image Using Kermit" section.

Step 3 At the C-Kermit> prompt, enter the connect command to connect to the Catalyst 5000 series switch. If your line and speed are set correctly, the switch Console> prompt appears.

Step 4 Enter the enable command to enter privileged mode.

Step 5 Enter the download serial command. The file downloads to module 1 by default.

Step 6 When prompted, confirm the download.

Step 7 Enter the escape sequence Ctrl-\-c by holding down the Control key while you press \, and then press c.

Step 8 At the Kermit> prompt, enter the send filename command to send the file to the Catalyst 5000 series switch.

You can monitor the progress of the download by pressing the a key at any time during the Kermit download. A dot appears onscreen for every four packets transferred. If there is a problem transferring the file, one or more of the following letter codes appear:

T---Kermit timed out.
N---Kermit is not acknowledging the Catalyst 5000 series switch download process.
E---Kermit detected an error in the progress of the transaction.

The Catalyst 5000 series switch downloads the image file, erases the Flash memory on the supervisor engine or the appropriate module, and reprograms the Flash memory with the downloaded Flash code.

Note

Step 9 Press Return to return to the C-Kermit> prompt. When the Kermit> prompt reappears, enter the connect command to return to the switch Console> prompt. You will see status information as the switch erases and reprograms the Flash memory.

Note

connect

Step 10 Reset the Catalyst 5000 series switch using the reset system command.

Step 11 When the switch reboots, enter the show version [mod_num] command to check the version of the code on the switch.

Note For an example that shows a complete serial download procedure using Kermit on a
UNIX workstation, see the "Example UNIX Workstation Serial Download Procedure" section.

Example Serial Software Image Download Procedures

These sections show example serial download procedures over the Catalyst 5000 series supervisor engine console port using Kermit:

Example PC Serial Download Procedure

This screen output shows an example of a complete serial download procedure on a PC:

C:\ copy A:\*.*

copying c5009_xx.bin

C:\ kermit

Kermit, 4C(057) 06 Apr 98, 4.2 BSD
Type ? for help
Kermit> set port com1

Kermit> set speed 9600

Kermit> connect

Connecting to com1,speed 9600.
The escape character is ^] (ASCII 29).
Type the escape character followed by C to get back,
or followed by ? to see other options
Console> enable

Console> (enable) download serial

Download CBI image via console port (y/n) [n]? y
Waiting for DOWNLOAD!
Return to your local Machine by typing its escape sequence
Issue Kermit send command from there[ Send \QFilename\Q]
<CONTROL-] c to return to Local Machine>
Kermit> send c5009_xx.bin

                    File name: c5009_xx.bin
  KBytes transferred: xxxx
Percent transferred: 100%
                        Sending: Complete
    Number of Packets: xxxx
    Number of retries: None
                  Last error: None
              Last warning: None
Kermit> connect

Finished network download.  (1136844 bytes)
Flash erase in progress ... Erase done
Programming Flash:  Flash Programming Complete
Flash erase in progress ... Erase done
Programming Flash:  Flash Programming Complete
Flash erase in progress ... Erase done
Programming Flash:  Flash Programming Complete
Flash erase in progress ... Erase done
Programming Flash:  Flash Programming Complete
Flash erase in progress ... Erase done
Programming Flash:  Flash Programming Complete
Flash erase in progress ... Erase done
Programming Flash:  Flash Programming Complete
Flash erase in progress ... Erase done
Programming Flash:  Flash Programming Complete
The system needs to be reset to run the new image.
Cisco Systems Console

Enter password:

Mon Apr 06, 1998, 14:35:08

Console>

Example UNIX Workstation Serial Download Procedure

This screen output shows an example of a complete serial download procedure on a UNIX workstation:

workstation% cd /tmp

workstation% tar -xvfp /dev/rfd0

c5009_xx.bin, 1156046 bytes, 2258 tape blocks
workstation% ls -la

total 1150
drwxrwsrwt  5 bin           512 Sep 28 04:15 .
drwxr-xr-x 18 root         1536 Sep 27 15:41 ..
-r--r--r--  1 60000     1156046 Jul 18 10:32 c5009_xx.bin
workstation% kermit

C-Kermit, 4E(072) 06 Apr 98, SUNOS 4.x
Type ? for help
C-Kermit> set line /dev/ttya

C-Kermit> set speed 9600

/dev/ttya: 9600 baud
C-Kermit> connect

Connecting thru /dev/ttya, speed 9600.
The escape character is CTRL-\ (28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
Console> enable

Console> (enable) download serial c5009_xx.bin

Download CBI image via console port (y/n) [n]? y

Waiting for DOWNLOAD!
Return to your local Machine by typing its escape sequence
Issue Kermit send command from there[ Send \QFilename\Q]
[Back at Local System]
C-Kermit> send c5009_xx.bin

SF
c5009_xx.bin => c5009_xx.bin, Size: 1156046
CTRL-F to cancel file,  CTRL-R to resend current packet
CTRL-B to cancel batch, CTRL-A for status report: 
.......................................................................................
.......................................
*** Display Truncated ***
...............................................................
.................................... [OK]
ZB?
C-Kermit> connect

Connecting thru /dev/ttya, speed 9600.
The escape character is CTRL-\ (28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
Download OK
Initializing Flash
Programming Flash
Base....Code....Length....Time....Done
Cisco Systems Console
Enter password:
Mon Apr 06, 1998, 17:35:08
Console>

Uploading System Software Images to a TFTP Server

These sections describe how to upload system software images from a Catalyst 5000 series switch to a TFTP server:

Note For more information on working with system software image files on the Supervisor Engine III Flash file system, refer to the "Using the Flash File System" section.

Preparing to Upload an Image to a TFTP Server

Before you attempt to upload a software image to a TFTP server, do the following:

Ensure the workstation acting as the TFTP server is configured properly. On a Sun workstation, make sure the /etc/inetd.conf file contains this line:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot

: Make sure the /etc/services file contains this line:

tftp 69/udp

Note

fastboot

reboot

Ensure the Catalyst 5000 series switch has a route to the TFTP server. The switch and the TFTP server must be in the same subnetwork if you do not have a router to route traffic between subnets. Check connectivity to the TFTP server using the ping command.
You might need to create an empty file on the TFTP server before uploading the image. To create an empty file, enter the touch > filename command, where filename is the name of the file you will use when uploading the image to the server.
If you are overwriting an existing file (including an empty file, if you had to create one), ensure that the permissions on the file are set correctly. Permissions on the file should be world-write.

Uploading Software Images to a TFTP Server (Supervisor I and II)

Use this procedure to upload supervisor engine software images on a Catalyst 5000 series switch with a Supervisor Engine I or II to a TFTP server for storage:

Step 1 Log into the Catalyst 5000 series switch through the console port or via a Telnet session.

Step 2 Upload the software image to the TFTP server using the upload host filename [mod_num] command. Specify the number of the module from which to upload the image in the mod_num argument. You do not need to specify the module number if you are uploading the supervisor engine software image.

This example shows how to upload the supervisor engine software image to a TFTP server:

Console> (enable) upload 172.20.52.3 cat5000-sup.4-2-1.bin

Upload Module 1 image to cat5000-sup.4-2-1.bin on 172.20.52.3 (y/n) [n]? y
-
Finished network upload.  (3021332 bytes)
Console> (enable)

Uploading Software Images to a TFTP Server (Supervisor III)

Use this procedure to upload supervisor engine software images on a Catalyst 5000 series switch with a Supervisor Engine III to a TFTP server for storage:

Step 1 Log into the Catalyst 5000 series switch through the console port or via a Telnet session.

Step 2 Upload the software image to the TFTP server using the copy flash tftp command. When prompted, specify the Flash device, source filename, TFTP server address, and destination filename. If desired, you can also use the copy file-id tftp command.

Working with Configuration Files

These sections describe how to work with switch configuration files on the Catalyst 5000 series switches:

Note For more information on working with configuration files on the Supervisor Engine III Flash file system, refer to the "Using the Flash File System" section.

Guidelines for Creating and Using Configuration Files

Creating configuration files can aid in the configuration of the Catalyst 5000 series switch. Configuration files can contain some or all the commands needed to configure one or more switches. For example, you might want to download the same configuration file to several Catalyst 5000 series switches that have the same hardware configuration so that they have identical module and port configurations.

Use the following guidelines when creating a configuration file:

We recommend that you connect via the console port when using configuration files to configure the Catalyst 5000 series switch. If you configure the switch from a Telnet session, IP addresses are not changed, and ports and modules are not disabled.
If no passwords have been set on the switch, you must set them on each switch by entering the set password and set enablepass commands. Enter a blank line after the set password and set enablepass commands. The passwords are saved in the configuration file as clear text.

: If passwords already exist, you cannot enter the set password and set enablepass commands because the password verification will fail. If you enter passwords in the configuration file, the switch mistakenly attempts to execute the passwords as commands as it executes the file.

Certain commands must be followed by a blank line in the configuration file. The blank line is necessary; without the blank line, these commands might disconnect your Telnet session. Before disconnecting a session, the switch prompts you for confirmation. The blank line acts as a carriage return, which indicates a negative response to the prompt and thus retains the Telnet session.

Include a blank line after each occurrence of these commands in a configuration file:

set interface sc0 ip_addr netmask
set interface sc0 disable
set module disable mod_num
set port disable mod_num/port_num

Creating a Configuration File

When creating a configuration file, you must list commands in a logical way so that the system can respond appropriately. One method of creating a configuration file is as follows:

Step 1 Download an existing configuration from a Catalyst 5000 series switch.

Step 2 Open the configuration file in a text editor, such as vi or emacs on UNIX or Textpad on a PC.

Step 3 Extract the portion of the configuration file with the desired commands and save it in a new file. Make sure the file begins with the word begin on a line by itself and ends with the word end on a line by itself.

Step 4 Copy the configuration file to the appropriate TFTP directory on the workstation (usually /tftpboot on a UNIX workstation).

Step 5 Make sure the permissions on the file are set to world-read.

This example shows an example configuration file. This file could be used to set the DNS configuration on multiple Catalyst 5000 series switches.

begin
!
#dns
set ip dns server 172.16.10.70 primary
set ip dns server 172.16.10.140
set ip dns enable
set ip dns domain corp.com
end

Downloading Configuration Files to the Switch

You can configure the Catalyst 5000 series switch using configuration files you create or download from another switch. In addition, you can store configuration files on Flash devices on the Supervisor Engine III and you can configure the switch using a configuration stored on a Flash device.

These sections describe how to configure the switch using configuration files downloaded from a TFTP server or stored on a Flash device:

Preparing to Download a Configuration File Using TFTP

Before you begin downloading a configuration file using TFTP, do the following:

Ensure the workstation acting as the TFTP server is configured properly. On a Sun workstation, make sure the /etc/inetd.conf file contains this line:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot

: Make sure the /etc/services file contains this line:

tftp 69/udp

Note

fastboot

reboot

Ensure the Catalyst 5000 series switch has a route to the TFTP server. The switch and the TFTP server must be in the same subnetwork if you do not have a router to route traffic between subnets. Check connectivity to the TFTP server using the ping command.
Ensure the configuration file to be downloaded is in the correct directory on the TFTP server.
Ensure that the permissions on the file are set correctly. Permissions on the file should be world-read.

Configuring the Switch Using a File on a TFTP Server (Supervisor Engine I and II)

Use this procedure to configure a Catalyst 5000 series switch with a Supervisor Engine I or II using a configuration file downloaded from a TFTP server:

Step 1 Copy the configuration file to the appropriate TFTP directory on the workstation (usually /tftpboot on a UNIX workstation).

Step 2 Log into the Catalyst 5000 series switch through the console port or via a Telnet session.

Step 3 Configure the switch using the configuration file downloaded from the TFTP server using the configure network command.

Specify the IP address or host name of the TFTP server and the name of the file to download.

The configuration file downloads and the commands are executed as the file is parsed line-by-line.

This example shows how to configure the switch using a configuration file downloaded from a TFTP server:

Console> (enable) configure network

IP address or name of remote host? 172.20.52.3

Name of configuration file? dns-config.cfg

Configure using dns-config.cfg from 172.20.52.3 (y/n) [n]? y

/
Finished network download.  (134 bytes)
>>
>> set ip dns server 172.16.10.70 primary
172.16.10.70 added to DNS server table as primary server.
>> set ip dns server 172.16.10.140
172.16.10.140 added to DNS server table as backup server.
>> set ip dns enable
DNS is enabled
>> set ip dns domain corp.com
Default DNS domain name set to corp.com
Console> (enable)

Configuring the Switch Using a File on a TFTP Server (Supervisor Engine III)

Use this procedure to configure a Catalyst 5000 series switch with a Supervisor Engine III using a configuration file downloaded from a TFTP server:

Step 1 Copy the configuration file to the appropriate TFTP directory on the workstation (usually /tftpboot on a UNIX workstation).

Step 2 Log into the Catalyst 5000 series switch through the console port or via a Telnet session.

Step 3 Configure the switch using the configuration file downloaded from the TFTP server using the copy tftp config command.

Specify the IP address or host name of the TFTP server and the name of the file to download.

The configuration file downloads and the commands are executed as the file is parsed line-by-line.

This example shows how to configure the switch using a configuration file downloaded from a TFTP server:

Console> (enable) copy tftp config

IP address or name of remote host []? 172.20.52.3

Name of file to copy from []? dns-config.cfg

 
Configure using tftp:dns-config.cfg (y/n) [n]? y

/
Finished network download.  (134 bytes)
>>
>> set ip dns server 172.16.10.70 primary
172.16.10.70 added to DNS server table as primary server.
>> set ip dns server 172.16.10.140
172.16.10.140 added to DNS server table as backup server.
>> set ip dns enable
DNS is enabled
>> set ip dns domain corp.com
Default DNS domain name set to corp.com
Console> (enable)
Console> (enable)

Configuring the Switch Using a File on a Flash Device (Supervisor Engine III)

Use this procedure to configure a Catalyst 5000 series switch with a Supervisor Engine III using a configuration file stored on a Flash device in the Flash file system:

Step 1 Log into the Catalyst 5000 series switch through the console port or via a Telnet session.

Step 2 Locate the configuration file using the cd and dir commands (for more information, refer to the "Using the Flash File System" section).

Step 3 Configure the switch using the configuration file stored on the Flash device using the copy file-id config command.

The commands are executed as the file is parsed line-by-line.

This example shows how to configure the switch using a configuration file stored on a Flash device:

Console> (enable) copy slot0:dns-config.cfg config

 
Configure using slot0:dns-config.cfg (y/n) [n]? y

 
Finished network download.  (134 bytes)
>>
>> set ip dns server 172.16.10.70 primary
172.16.10.70 added to DNS server table as primary server.
>> set ip dns server 172.16.10.140
172.16.10.140 added to DNS server table as backup server.
>> set ip dns enable
DNS is enabled
>> set ip dns domain corp.com
Default DNS domain name set to corp.com
Console> (enable)
Console> (enable)

Uploading Configuration Files to a TFTP Server

These sections describe how to upload the running configuration or a configuration file stored on a Flash device to a TFTP server:

Preparing to Upload a Configuration File to a TFTP Server

Before you attempt to upload a configuration file to a TFTP server, do the following:

Ensure the workstation acting as the TFTP server is configured properly. On a Sun workstation, make sure the /etc/inetd.conf file contains this line:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot

: Make sure the /etc/services file contains this line:

tftp 69/udp

Note

fastboot

reboot

Ensure the Catalyst 5000 series switch has a route to the TFTP server. The switch and the TFTP server must be in the same subnetwork if you do not have a router to route traffic between subnets. Check connectivity to the TFTP server using the ping command.
You might need to create an empty file on the TFTP server before uploading the configuration file. To create an empty file, enter the touch > filename command, where filename is the name of the file you will use when uploading the configuration to the server.
If you are overwriting an existing file (including an empty file, if you had to create one), ensure that the permissions on the file are set correctly. Permissions on the file should be world-write.

Uploading a Configuration File to a TFTP Server (Supervisor Engine I and II)

Use this procedure to upload a configuration file on a Catalyst 5000 series switch with a Supervisor Engine I or II to a TFTP server for storage:

Step 1 Log into the Catalyst 5000 series switch through the console port or via a Telnet session.

Step 2 Upload the switch configuration to the TFTP server using the write network command. Specify the IP address or hostname of the TFTP server and the destination filename. The file is uploaded to the TFTP server.

This example shows how to upload the running configuration to a TFTP server:

Console> (enable) write network

IP address or name of remote host? 172.20.52.3

Name of configuration file? cat5002_config.cfg

Upload configuration to cat5002_config.cfg on 172.20.52.3 (y/n) [n]? y

.....
..........
..........
..
/
Finished network upload.  (8534 bytes)
Console> (enable)

Uploading the Running Configuration to a TFTP Server (Supervisor Engine III)

Use this procedure to upload the running configuration on a Catalyst 5000 series switch with a Supervisor Engine III to a TFTP server for storage:

Step 1 Log into the Catalyst 5000 series switch through the console port or via a Telnet session.

Step 2 Upload the running configuration to the TFTP server using the copy config tftp command. Specify the IP address or hostname of the TFTP server and the destination filename. The file is uploaded to the TFTP server.

This example shows how to upload the running configuration to a TFTP server:

Console> (enable) copy config tftp

IP address or name of remote host []? 172.20.52.3

Name of file to copy to []? cat5002_config.cfg

 
Upload configuration to tftp:cat5002_config.cfg, (y/n) [n]? y

.....
..........
.......
 
..........
...........
..
/
Configuration has been copied successfully.
Console> (enable)
Console> (enable)

Using the Flash File System

These sections describe how to use the Catalyst 5000 series Flash file system:

Understanding How the Flash File System Works

The Flash file system on the Catalyst 5000 series Supervisor Engine III (as well as on other modules, such as the RSM) provides a number of useful commands to help you manage system image and configuration files.

The Flash file system on the Supervisor Engine III consists of three Flash devices on which you can store system files:

bootflash: onboard Flash memory
slot0: first PC card (PCMCIA) slot
slot1: second PC card slot

Working with the Flash File System

These sections describe how to work with the Catalyst 5000 series Flash file system:

Setting the Default Flash Device

When you set the default Flash device for the system, the default device is assumed when you enter a Flash file system command without specifying the Flash device.

To set the default Flash device, perform this task:

Task Command

Step 1 Set the default Flash device for the system.

cd [[m/][bootflash: | slot0: | slot1:]]

Step 2 Verify the default Flash device for the system.

pwd [mod_num]

Task	Command
Step 1 Set the default Flash device for the system.	cd [[m/][bootflash: \| slot0: \| slot1:]]
Step 2 Verify the default Flash device for the system.	pwd [mod_num]

This example shows how to change the default Flash device to slot0: and verify the default device:

Console> (enable) cd slot0:

Console> (enable) pwd

slot0
Console> (enable)

Listing the Files on a Flash Device

To list the files on a Flash device, perform one of these tasks:

Task Command

Display a list of files on a Flash device.

dir [[m/]device:][filename]

Display a list of only deleted files on a Flash device.

dir [[m/]device:][filename] deleted

Display a list of all files on a Flash device, including deleted files.

dir [[m/]device:][filename] all

Display a detailed list of files on a Flash device.

dir [[m/]device:][filename] long

Task	Command
Display a list of files on a Flash device.	dir [[m/]device:][filename]
Display a list of only deleted files on a Flash device.	dir [[m/]device:][filename] deleted
Display a list of all files on a Flash device, including deleted files.	dir [[m/]device:][filename] all
Display a detailed list of files on a Flash device.	dir [[m/]device:][filename] long

This example shows how to list the files on the default Flash device:

Console> (enable) dir

-#- -length- -----date/time------ name
  4  3134688 Apr 27 1998 08:27:01 cat5000-sup3.4-1-0-66.bin
  5  3231989 Jun 24 1998 12:04:40 cat5000-sup3.4-2-0-28.bin
  6      135 Jul 17 1998 11:30:05 dns_config.cfg
 
1213952 bytes available (6388224 bytes used)
Console> (enable)

This example shows how to list the files on a Flash device other than the default device:

Console> (enable) dir slot0:

-#- -length- -----date/time------ name
  1  3209261 Jun 16 1998 13:18:19 cat5000-sup3.4-2-1.bin
  2      135 Jul 17 1998 11:32:53 dns-config.cfg
  3  3231989 Jul 17 1998 16:54:23 cat5000-sup3.4-1-2.bin
  4     8589 Jul 17 1998 17:02:52 5000_config.cfg
 
9933504 bytes available (6450496 bytes used)
Console> (enable)

This example shows how to list the deleted files on the default Flash device:

Console> (enable) dir deleted

-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
  1 .D ffffffff 81a027ca   41bdc   22     7004 Apr 01 1998 15:27:45 5002.config.
4.1.98.cfg
  2 .D ffffffff ccce97a3   43644   23     6630 Apr 01 1998 15:36:47 5002.default
.config.cfg
  3 .D ffffffff 81a027ca   45220   15     7004 Apr 19 1998 10:05:59 5002_config.
cfg
 
1213952 bytes available (6388224 bytes used)
Console> (enable)

Copying Files

Note The Flash file system copy command replaces the download, upload, configure network, and write network commands used on the Supervisor Engine I and II.

To copy a file, perform one of these tasks in privileged mode:

Task Command

Copy a Flash file to a TFTP server, Flash memory, another Flash device, or to the running configuration.

copy file-id {tftp | flash | file-id | config}

Copy a file from a TFTP server to Flash memory, to a Flash device, or to the running configuration.

copy tftp {flash | file-id | config}

Copy a file from Flash memory to a TFTP server, to a Flash device, or to the running configuration.

copy flash {tftp | file-id | config}

Copy the running configuration to Flash memory, another Flash device, or to a TFTP server.

copy config {flash | file-id | tftp}

Task	Command
Copy a Flash file to a TFTP server, Flash memory, another Flash device, or to the running configuration.	copy file-id {tftp \| flash \| file-id \| config}
Copy a file from a TFTP server to Flash memory, to a Flash device, or to the running configuration.	copy tftp {flash \| file-id \| config}
Copy a file from Flash memory to a TFTP server, to a Flash device, or to the running configuration.	copy flash {tftp \| file-id \| config}
Copy the running configuration to Flash memory, another Flash device, or to a TFTP server.	copy config {flash \| file-id \| tftp}

This example shows how to copy a file from the default Flash device to another Flash device:

Console> (enable) copy cat5000-sup3.4-2-1.bin slot0:

 
13174216 bytes available on device slot0, proceed (y/n) [n]? y
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
CCCCCCCCCCCCCCCCCCcccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc
ccccccccccccCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
File has been copied successfully.
Console> (enable)

This example shows how to copy a file from a TFTP server to the running configuration:

Console> (enable) copy tftp config

IP address or name of remote host []? 172.20.52.3

Name of file to copy from []? dns_config.cfg

 
Configure using tftp:dns_config.cfg (y/n) [n]? y

/
Finished network download.  (135 bytes)
>>
>> set ip dns server 172.16.10.70 primary
172.16.10.70 added to DNS server table as primary server.
>> set ip dns server 172.16.10.140
172.16.10.140 added to DNS server table as backup server.
>> set ip dns enable
DNS is enabled
>> set ip dns domain corp.com
Default DNS domain name set to corp.com
Console> (enable)

This example shows how to download a configuration file from a TFTP server for storage on a Flash device:

Console> (enable) copy tftp flash

IP address or name of remote host []? 172.20.52.3

Name of file to copy from []? dns-config.cfg

Flash device [slot0]?
Name of file to copy to [dns-config.cfg]?
 
9932056 bytes available on device slot0, proceed (y/n) [n]? y

/
File has been copied successfully.
Console> (enable)

This example shows how to copy the running configuration to Flash memory:

Console> (enable) copy config flash

Flash device [bootflash]? slot0:

Name of file to copy to []? 5000_config.cfg

 
Upload configuration to slot0:5000_config.cfg
9942096 bytes available on device slot0, proceed (y/n) [n]? y

.....
..........
.......
 
..........
...........
..
 
Configuration has been copied successfully.
Console> (enable)

This example shows how to upload a configuration file on a Flash device to a TFTP server:

Console> (enable) copy slot0:5000_config.cfg tftp

IP address or name of remote host []? 172.20.52.3

Name of file to copy to [5000_config.cfg]?
/
File has been copied successfully.
Console> (enable)

Deleting Files


	Caution If you issue the squeeze command on a Flash device, you cannot restore files deleted on that device prior to your issuing the squeeze command.

To delete files on a Flash device, perform this task in privileged mode:

Task Command

Step 1 Delete a file on a Flash device.

delete [[m/]device:]filename

Step 2 If desired, permanently remove all deleted files on the Flash device (this operation can take a number of minutes to complete).

squeeze [m/]device:

Step 3 Verify the files are deleted.

dir [[m/]device:][filename]

Task	Command
Step 1 Delete a file on a Flash device.	delete [[m/]device:]filename
Step 2 If desired, permanently remove all deleted files on the Flash device (this operation can take a number of minutes to complete).	squeeze [m/]device:
Step 3 Verify the files are deleted.	dir [[m/]device:][filename]

This example shows how to delete a file from a Flash device:

Console> (enable) delete dns_config.cfg

Console> (enable)

This example shows how to permanently remove all deleted files from a Flash device:

Console> (enable) squeeze slot0:

All deleted files will be removed, proceed (y/n) [n]? y

Squeeze operation may take a while, proceed (y/n) [n]? y

Erasing squeeze log
Console> (enable)

Restoring Deleted Files

You must specify the index number of a deleted file to identify the file to undelete. The index number for each file appears in the first column of the dir command output. A file cannot be undeleted if a valid file with the same name already exists. Instead, you must delete the existing file and then undelete the desired file. A file can be deleted and undeleted up to 15 times.

To restore deleted files on a Flash device, perform this task in privileged mode:

Task Command

Step 1 Identify the index number of the deleted files on the Flash device.

dir [[m/]device:][filename] deleted

Step 2 Undelete a file on a Flash device.

undelete index [[m/]device:]

Step 3 Verify that the file is restored.

dir [[m/]device:][filename]

Task	Command
Step 1 Identify the index number of the deleted files on the Flash device.	dir [[m/]device:][filename] deleted
Step 2 Undelete a file on a Flash device.	undelete index [[m/]device:]
Step 3 Verify that the file is restored.	dir [[m/]device:][filename]

This example shows how to restore a deleted file:

Console> (enable) dir deleted

-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
6 .D ffffffff 42da7f71  657a00   14      135 Jul 17 1998 11:30:05 dns_config.cfg
 
1213952 bytes available (6388224 bytes used)
Console> (enable) undelete 6

Console> (enable) dir

-#- -length- -----date/time------ name
  4  3134688 Apr 27 1998 08:27:01 cat5000-sup3.4-1-0-66.bin
  5  3231989 Jun 24 1998 12:04:40 cat5000-sup3.4-2-0-28.bin
  6      135 Jul 17 1998 11:30:05 dns_config.cfg
 
1213952 bytes available (6388224 bytes used)
Console> (enable)

Verifying a File Checksum

To verify the checksum of a file on a Flash device, perform this task in privileged mode:

Task Command

Verify the checksum of a file on a Flash device.

verify [[m/]device:] filename

Task	Command
Verify the checksum of a file on a Flash device.	verify [[m/]device:] filename

This example shows how to verify the checksum of a file:

Console> (enable) verify cat5000-sup3.4-2-1.bin

CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
CCCCCCCCCCCCCCC
File bootflash:cat5000-sup3.4-2-1.bin verified OK
Console> (enable)

Formatting a Flash Device

Before you use a new Flash device, you must format it. You can reserve up to 16 spare sectors for use when other sectors fail (by default, none are reserved). If you do not reserve spare sectors and later some sectors fail, you will have to reformat the entire Flash memory, erasing all existing data.

Note Flash memory PC cards formatted on the Supervisor Engine III or on a Route-Switch Processor (RSP)-based Cisco 7500 series router are interchangeable provided the router is running software at least at the same level as the supervisor engine. You cannot use Flash cards formatted on a Route Processor (RP)-based Cisco 7000 series router without reformatting.

When you format a Flash device, you can specify the monlib file (the ROM monitor library), which the ROM monitor uses to access files in the Flash file system. The monlib file is also compiled into the system image.

In the format command syntax, use the device2 argument to specify the device that contains the monlib file to use. If you omit the entire device2 argument, the system formats the device using the monlib file that is bundled with the system software. If you omit just the device name (device2) from the [[device2:][monlib-filename]] argument, the system formats the device using the named monlib file from the default Flash device. If you omit the monlib-filename from the [[device2:][monlib-filename]] argument, the system formats the device using the monlib file from device2. If you specify the entire [[device2:][monlib-filename]] argument, the system formats the device using the specified monlib file from the specified device. If the system cannot find a monlib file, it terminates the formatting process.

To format a Flash memory device, perform this task in privileged mode:

Task Command

Format a Flash memory device.

format [spare spare-number] [m/]device1: [[device2:] [monlib-filename]]

Task	Command
Format a Flash memory device.	format [spare spare-number] [m/]device1: [[device2:] [monlib-filename]]

This example shows how to format the Flash device in slot1:

Console> (enable) format slot1:

All sectors will be erased, proceed (y/n) [n]?y

Enter volume id (up to 31 characters):
Formatting sector 1
Format device slot1 completed.
Console> (enable)

Table of Contents

Working With System Software Images and Configuration Files