cc/td/doc/product/lan/cat5000/rel_4_4
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Working With System Software Images and Configuration Files

Working With System Software Images and Configuration Files

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

Note For complete syntax and usage information for the commands used in this chapter, refer to the Command Reference for your switch.

This chapter consists of these sections:

Using the Flash File System

These sections describe how to use the Flash file system:

Understanding How the Flash File System Works

The Flash file system provides a number of useful commands to help you manage system image and configuration files.

The Flash file system on the Supervisor Engine III, the RSM, and the Catalyst  2926G series switches consists of three Flash devices on which you can store system files:

On the Supervisor Engine III FSX and FLX, and on the Catalyst 4000 and 2948G series switches, there is only one flash device, bootflash:.

Note Throughout this publication, the term Flash PC card is used in place of the term PCMCIA card.

Working with the Flash File System

These sections describe how to work with the 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]

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

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}

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> (enableThis example shows how to copy a file from a TFTP server to the running configuration:
Console> (enable) copy tftp configThis example shows how to copy a file from a TFTP server to the running configuration:

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 enter the squeeze command on a Flash device, you cannot restore files that you deleted on that device before you entered 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]

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]

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

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 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 PC 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]]

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)

Downloading System Software Images to the Switch

These sections describe how to download system software images to the switch supervisor engine and to intelligent modules:

Understanding How Software Image Downloads Work

You can download system software images to switch using one of two methods:

Some modules, such as Catalyst  5000 series 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:

Downloading Software Images Using TFTP

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

Note For more information on working with system software image files on the 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:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot
Make sure that the /etc/services file contains this line:
tftp 69/udp

Downloading Supervisor Images Using TFTP

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 sychronizes 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 the switch from a TFTP server:

Step 1 Copy the software image file to the appropriate TFTP directory on the workstation.

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

Step 3 Use the command appropriate for your switch and supervisor engine to download the software image from the TFTP server:

The switch downloads the image file from the TFTP server:

Step 4 Catalyst  5000 series Supervisor Engine III, III  FSX, and III  FLX, and Catalyst  4000, 2948G, and 2926G series switches---Modify the BOOT environment variable using the set boot system flash device:filename prepend command, so that the new image boots when you reset the switch. Specify the Flash device (device:) and the filename of the downloaded image (filename).

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

During startup, on the Catalyst  5000 series Supervisor Engine III, III  FSX, and III  FLX, and on the Catalyst 4000, 2948G, and 2926G series switches, the Flash memory on the supervisor engine is reprogrammed 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 examples that show complete TFTP download procedures for the various supervisor engine and switch types, see the "Example TFTP Download Procedures" section.

Downloading Switching Module Images Using TFTP

Use this procedure to download a software image to an intelligent module on a Catalyst 5000 series switch:

Step 1 Copy the software image file to the appropriate TFTP directory on the workstation.

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

Step 3 Use the command appropriate for your switch and supervisor engine to download the software image from the TFTP server:

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

Step 4 Reset the appropriate modules using the reset mod_num command. If you are connected through 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 complete procedures for TFTP downloads to intelligent modules, see the "Example Single Intelligent Module Image TFTP Download (Catalyst 5000 Series Supervisor I and II)" section, the "Example Multiple Module Image TFTP Download (Supervisor I and II)" section, the "Example Single Module Image TFTP Download (Supervisor III, III FSX, or III FLX)" section and the "Example Multiple Module Image TFTP Download (Supervisor III, III FSX, or III FLX)" section.

Example TFTP Download Procedures

These sections show example TFTP download procedures:

Example Supervisor Image TFTP Download (Catalyst 5000 Series Supervisor Engine  I and II or Catalyst 2926 Series Switch)
Note For a step-by-step procedure for downloading a supervisor engine software image from a TFTP server, see the "Downloading Supervisor Images Using TFTP" 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 or to a Catalyst  2926 series switch:

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 (Catalyst  5000 Series Supervisor III, III FSX, III FLX, or Catalyst  4000, 2948G, or 2926G Series Switches)
Note For a step-by-step procedure for downloading a supervisor engine software image from a TFTP server, see the "Downloading Supervisor Images Using TFTP" 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, III  FSX, or III  FLX module or to a Catalyst  4000, 2948G, or 2926G series switch:

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 Intelligent Module Image TFTP Download (Catalyst 5000 Series Supervisor I and II)
Note For a step-by-step procedure for downloading software images to intelligent modules on a Catalyst  5000 series switch with a Supervisor Engine I or II, refer to the "Downloading Switching Module Images Using TFTP" 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, III FSX, or III FLX)
Note For a step-by-step procedure for downloading software images to intelligent modules on a Catalyst  5000 series switch with a Supervisor Engine III, III FSX, or III FLX, refer to the "Downloading Switching Module Images Using TFTP" 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)
Note For a step-by-step procedure for downloading software images to intelligent modules on a Catalyst  5000 series switch with a Supervisor Engine I or II, refer to the "Downloading Switching Module Images Using TFTP" section.

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, III FSX, or III FLX)
Note For a step-by-step procedure for downloading software images to intelligent modules on a Catalyst  5000 series switch with a Supervisor Engine III, III FSX, or III FLX, refer to the "Downloading Switching Module Images Using TFTP" section.

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, III FSX, or III FLX 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 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:

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 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 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 switch.

The 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.

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.

Step 10 Reset the 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 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).

Step 3 At the C-Kermit> prompt, enter the connect command to connect to the 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 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:

The 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.

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.

Step 10 Reset the 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 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 switch to a TFTP server:

Note For more information on working with system software image files on the Flash file system, see 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:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot
Make sure that the /etc/services file contains this line:
tftp 69/udp

Uploading Software Images to a TFTP Server

Use this procedure to upload a software image on a switch to a TFTP server for storage:

Step 1 Log into the switch through the console port or a Telnet session.

Step 2 Upload the software image to the TFTP server using the command appropriate for your switch and supervisor engine:

The software image is uploaded to the TFTP server.

This example shows how to upload the supervisor engine software image on a Catalyst  5000 series Supervisor Engine I or II, or a Catalyst  2926 series switch, 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)

Working with Configuration Files

These sections describe how to work with switch configuration files on the Catalyst  5000, 4000, 2948G, 2926G, and 2926  series switches:

Note For more information on working with configuration files on the Flash file system, see the "Using the Flash File System" section.

Guidelines for Creating and Using Configuration Files

Creating configuration files can aid in the configuration of your 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 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:

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.
Include a blank line after each occurrence of these commands in a configuration file:

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 switch.

Step 2 Open the configuration file in a text editor, such as vi or emacs on UNIX or Notepad 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 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 switch using configuration files you create or download from another switch. In addition, you can store configuration files on Flash devices on hardware that supports the Flash file system, 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:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot
Make sure that the /etc/services file contains this line:
tftp 69/udp

Configuring the Switch Using a File on a TFTP Server

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

Step 1 Copy the configuration file to the appropriate TFTP directory on the workstation.

Step 2 Log into the switch through the console port or a Telnet session.

Step 3 Configure the switch using the configuration file downloaded from the TFTP server using the command appropriate for your switch and supervisor engine:

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

This example shows how to configure a Catalyst 5000 series switch with a Supervisor Engine  I or II, or a Catalyst 2926 series 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)

This example shows how to configure a Catalyst 5000 series switch with a Supervisor Engine III, III  FSX, or III FLX, or a Catalyst  4000, 2948G, or 2926G series 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)

Configuring the Switch Using a File on a Flash Device (Catalyst  5000 Series Supervisor Engine III, III FSX, III FLX or Catalyst  4000, 2948G, or 2926G Series Switches)

Use this procedure to configure a Catalyst 5000 series switch with a Supervisor Engine III, III FSX, or III FLX, or a Catalyst  4000, 2948G, or 2926G series switch using a configuration file stored on a Flash device in the Flash file system:

Step 1 Log into the switch through the console port or a Telnet session.

Step 2 Locate the configuration file using the cd and dir commands (for more information, see 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:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot
Make sure that the /etc/services file contains this line:
tftp 69/udp

Uploading a Configuration File to a TFTP Server

Use this procedure to upload a configuration file from a switch to a TFTP server for storage:

Step 1 Log into the switch through the console port or a Telnet session.

Step 2 Upload the switch configuration to the TFTP server using the command appropriate for your switch and supervisor engine:

The file is uploaded to the TFTP server.

This example shows how to upload the running configuration on a Catalyst 5000 series switch with a Supervisor Engine I or II, or on a Catalyst 2926 series switch, 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)

This example shows how to upload the running configuration on a Catalyst 5000 series switch with a Supervisor Engine III, III  FSX, or III FLX, or on a Catalyst  4000, 2948G, or 2926G series switch, to a TFTP server for storage:

Console> (enable) copy config tftp
IP address or name of remote host []? 172.20.52.3
Name of file to copy to []? cat5000_config.cfg
 
Upload configuration to tftp:cat5000_config.cfg, (y/n) [n]? y
.....
..........
.......
 
..........
...........
..
/
Configuration has been copied successfully.
Console> (enable)
Console> (enable)

Clearing the Configuration

To clear the configuration on the entire switch, perform this task in privileged mode:
Task Command

Clear the switch configuration.

clear config all

This example shows how to clear the configuration for the entire switch:

Console> (enable) clear config all
This command will clear all configuration in NVRAM.
This command will cause ifIndex to be reassigned on the next system startup.
Do you want to continue (y/n) [n]? y
........
.............................
 
System configuration cleared.
Console> (enable)

To clear the configuration on an individual module, perform this task in privileged mode:
Task Command

Clear the configuration for a specific module.

clear config mod_num

Note If you remove a module and replace it with a module of another type (for example, if you remove a Fast Ethernet module and insert a Token Ring module), the module configuration is inconsistent. The output of the show module command indicates this problem. To resolve the inconsistency, clear the configuration on the problem module.

This example shows how to clear the configuration on a specific module:

Console> (enable) clear config 2
This command will clear module 2 configuration.
Do you want to continue (y/n) [n]? y
.............................
Module 2 configuration cleared.
Console> (enable)


hometocprevnextglossaryfeedbacksearchhelp

Copyright 1989-1999©Cisco Systems Inc.