Table of Contents

2

clear vtp statistics

Use the clear vtp statistics command to delete the VTP statistics.

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to clear the VTP statistics:

Console> (enable) clear vtp statistics
vtp statistics cleared.
Console> (enable)

Related Commands

set vtp
show vtp statistics

configure

Use the configure command to download a configuration file from a host and execute each command in that file.

Syntax Description

host	IP address or IP alias of the host.
file	Name of the configuration file.
rcp	(Optional) Keyword that specifies rcp as file transfer method.

Defaults

The default file transfer method is TFTP.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Refer to the Software Configuration Guide for your switch for information on how to construct a configuration file to download using the configure command.

Examples

The following is an example configuration file. Each line contains a command, except for the lines that begin with ! or #. On some servers (NT), the TFTP directory might not be /tftpboot.

begin
show time
set ip alias conc7 198.133.219.207
set ip alias montreux 198.133.119.42
set ip alias cres 192.122.174.42
set prompt system5>
set password
# empty string old password
 
pingpong
pingpong
end
#
 

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

Console> (enable) configure 192.122.174.42 system5.cfg
Configure using system5.cfg from 192.122.174.42 (y/n) [n]? y
/
Done.  Finished Network Download.  (446 bytes)
>> show time
Wed Nov 11 1998, 17:42:50
>> set ip alias conc7 198.133.219.207
IP alias added.
>> set ip alias montreux 198.133.219.40
IP alias added.
>> set ip alias cres 192.122.174.42
IP alias added.
>> set prompt system5>
>> set password
Enter old password: 
Enter new password: pingpong
Retype new password: pingpong
Password changed.
 

This example shows how to configure a Catalyst 5000 family switch with a Supervisor Engine II, II G, or III G using a configuration file downloaded from a rcp server:

Console> (enable) configure 172.20.52.3 dns-config.cfg rcp
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)

Related Commands

show config
copy

confreg

Use the confreg command to set the configuration register value or to modify the configuration register using the configuration register utility.

Syntax Description

hexvalue

(Optional) Hexadecimal value of the configuration register.

Defaults

This command has no defaults.

Command Types

ROM monitor command.

Command Modes

Normal.

Usage Guidelines

If you specify hexvalue, the confreg command changes the configuration register value to the hexadecimal value specified.

If you do not specify hexvalue, confreg shows the current configuration register values and prompts you to keep or change the current values.

The new configuration register value is written into NVRAM and does not take effect until you reset or power cycle the switch.

Examples

This example shows how to use the confreg command:

rommon 1 > confreg
 
Configuration Summary
enabled are:
console baud:9600
boot:the ROM Monitor
 
do you wish to change the configuration? y/n  [n]: y
enable  "diagnostic mode"? y/n  [n]:<Return> 
enable  "use net in IP bcast address"? y/n  [n]:<Return> 
enable  "load rom after netboot fails"? y/n  [n]:<Return>  
enable  "use all zero broadcast"? y/n  [n]:<Return> 
enable  "break/abort has effect"? y/n  [n]:<Return> 
enable  "ignore system config info"? y/n  [n]:<Return> 
change console baud rate? y/n  [n]:<Return> 
change the boot characteristics? y/n  [n]: y
enter to boot:
 0 = ROM Monitor
 1 = the boot helper image
 2-15 = boot system
    [0]: 2
 
 
    Configuration Summary
enabled are:
console baud:9600
boot:image specified by the boot system commands
      or default to:cisco2-Presto
 
do you wish to change the configuration? y/n  [n]:<Return> 
 
 
You must reset or power cycle for new config to take effect
rommon 2 > 

Related Commands

sync

copy

Use the copy command to perform these tasks:

• Download a system image or configuration file from a TFTP or rcp server to a Flash device

• Upload a system image or configuration file from a Flash device to a TFTP or rcp server

• Configure the switch using a configuration file on a Flash device or on a TFTP or rcp server

• Copy the current configuration to a Flash device or to a TFTP or rcp server

Console> (enable) copy config slot0:cat.cfg
Upload configuration to slot0:cat.cfg 
649324 bytes available on device slot0, proceed (y/n) [n]? y
.........
.
/
Configuration has been copied successfully. (10200 bytes)
Console> (enable)
 

Console> (enable) copy config tftp:lab2.cfg all
IP address or name of remote host [172.20.22.7]? y
Upload configuration to imgFile:lab2.cfg (y/n) [n]? y
.........
.
/
Configuration has been copied successfully. (10299 bytes).
Console> (enable)
 

Console> (enable) copy config flash
Flash device [bootflash]? slot1:
Name of file to copy to [configFile]? cat.cfg
Upload configuration to slot1:cat.cfg 
749124 bytes available on device slot1, proceed (y/n) [n]? y
.........
.
/
Configuration has been copied successfully. (200345 bytes).
Console> (enable)
 

Console> (enable) copy rcp 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) 
 

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

Console> (enable) copy rcp config
IP address or name of remote host []? 172.20.52.3
Name of file to copy from []? dns-config.cfg
 
Configure using rcp: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) copy flash config
Flash device [bootflash]? 
Name of configuration file? test.cfg
Configure using bootflash:test.cfg (y/n) [n]? y
/
Finished download. (10900 bytes)
>> set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
Password changed.
>> set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70
Password changed.
>> set prompt Console>
>> set length 24 default
Screen length set to 24.
>> set logout 20
.....
Console> (enable)
 

Console> (enable) copy tftp bootflash:
Address or name of remote host [172.20.22.7]?
Enter source file name [cat4000-sup.4-5-1.bin]?
Enter destination file name [cat4000-sup.4-5-1.bin]?
6942528 bytes available in flash, proceed (y/n) [n]?y
Console> (enable)
 

Console> (enable) copy tftp cfg1
IP address or name of remote host [172.20.32.10]?
Name of file to copy from [/tftpboot/my.cfg]?
Download config file from /tftpboot/my.cfg to cfg1 (y/n) [n]?
.........
File has been copied to cfg1.
Console> (enable)

write
configure

delete

Use the delete command to delete a file on a Flash device.

Syntax Description

file-id	The file to delete, where file-id is of the format [[m/]device:][filename]. m/ = The module where the Flash device is located (such as the standby supervisor engine, an FDDI module, or an ATM module). Module 1 is assumed if no module is specified. device: = Device where the file is located. Valid Flash devices are bootflash:, slot0:, and slot1:. The colon (:) is required after the device name. filename = Name of the system image or configuration file.
cfg1	Keyword that specifies the first startup configuration file on the Supervisor Engine II G and III G.
cfg2	Keyword that specifies the second startup configuration file on the Supervisor Engine II G and III G.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported on Catalyst 5000 family Supervisor Engine II.

These switches support only the bootflash: Flash device:

• Catalyst 5000 family Supervisor Engine III F

• Catalyst 4000 family switches

• Catalyst 2926G series switches

• Catalyst 2948G switch

• Catalyst 2980G switch

The cfg1 and cfg2 startup configuration files are present only on the Catalyst 5000 family Supervisor Engine II G and III G.

Use the undelete command to recover a deleted file.

A file cannot be undeleted if a valid file with the same name exists. Instead, you must delete the existing one first and then undelete the desired file. A file can be deleted or undeleted up to 15 times. To permanently remove all deleted files on a device, use the squeeze command.

Examples

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

Console> (enable) delete bootflash:switch_config.cfg
Console> (enable) 
 
 

This example shows how to delete the first startup configuration file (cfg1) on a Supervisor Engine II G or III G:

Console> (enable) delete cfg1
Delete cfg1 from flash (y/n) [n]? y
cfg1 has been deleted from flash
Console> (enable)

Related Commands

dirswitch
undelete
show flash
squeeze

dev

Use the dev command to list the device IDs available on a switch.

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no defaults.

Command Types

ROM monitor command.

Command Modes

Normal.

Usage Guidelines

This command is supported by the Catalyst 5000 family switches and the Catalyst 2926G series switches.

Examples

This example shows how to use the dev command:

rommon 4 > dev
Devices in device table:
        id  name
bootflash: boot flash                 
    slot0: PCMCIA slot 0              
    slot1: PCMCIA slot 1              
    eprom: eprom                      
rommon 5 > 

dir---ROM monitor

Use the dir command to list the files on a Flash device.

Syntax Description

device

Name of the Flash device.

Defaults

This command has no defaults.

Command Types

ROM monitor command.

Command Modes

Normal.

Examples

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

rommon 6 > dir bootflash:
         File size           Checksum   File name
     14086 bytes (0x3706)     0xa6a84c93    switch_config.cfg (deleted)
      5415 bytes (0x1527)     0x53bbccda    5509_config.cfg
    446464 bytes (0x6d000)    0x8503219d    cat5000-sup3.5-1-1.bin (deleted)
   4231861 bytes (0x4092b5)   0x1d6092f4    cat5000-sup3.5-2-1.bin
rommon 7 > 

dir---switch

Use the dir command to display a list of files on a Flash device.

Syntax Description

file-id	The file on which to perform the copy action, where file-id is of the format [[m/]device:][filename]. m/ = The module where the Flash device is located (such as the standby supervisor engine, an FDDI module, or an ATM module). Module 1 is assumed if no module is specified. device: = Device where the file is located. Valid Flash devices are bootflash:, slot0:, and slot1:. You can also specify tftp: as the device name. The colon (:) is required after the device name. filename = Name of the system image or configuration file.
all	(Optional) Keyword that specifies to display all files on the device, including deleted files.
deleted	(Optional) Keyword that specifies to display only deleted files.
long	(Optional) Keyword that specifies to display files that have not been deleted, in long format.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Normal and privileged.

Usage Guidelines

This command is not supported on the Catalyst 5000 family Supervisor Engine II.

When you omit all keywords (all, deleted, or long), the system displays file information in short format. Short format output is explained in Table 2-1.

Table 2-1: Short Format File Information

Column Heading	Description
#	File index number
length	File length
date/time	Date and time the file was created
name	Filename

When you use one of the keywords, the system displays file information in long format. The long format is shown in Table 2-2.

Table 2-2: Long Format File Information

Column Heading	Description
#	File index number
ED	Letter to indicate whether the file contains an error (E) or is deleted (D)
type	File type (1 = configuration file, 2 = image file); when the file type is unknown, the system displays a zero or FFFFFFFF in this field
crc	File cyclic redundancy check
seek	Offset into the file system of the next file
nlen	Filename length
length	File length
date/time	Date and time the file was created
name	Filename

Console> (enable) dir
-#- -length- -----date/time------ name
  2  3093399 Oct 18 1998 12:33:14 cat5000-sup3.4-5-1.bin
 
1428272 bytes available (6173904 bytes used)
Console> (enable)
 

Console> (enable) dir long
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
  2 .. ffffffff 762950d6  6234d0   25  3093399 Oct 18 1998 12:33:14 cat5000-sup3.4-5-1.bin
 
1428272 bytes available (6173904 bytes used)
Console> (enable)
 

Console> (enable) dir all
-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name
  1 .D ffffffff 5415406e  3300b8   25  3080247 Jun 12 1998 13:22:46 cat5000-sup3.4-5-1.bin
  2 .. ffffffff 762950d6  6234d0   25  3093399 Oct 18 1998 12:33:14 cat5000-sup3.4-5-1.bin
 
1428272 bytes available (6173904 bytes used)
Console> (enable)

show flash

disable

Use the disable command to return to normal mode from privileged mode.

Syntax Description

This command has no arguments or keywords.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to return to normal mode:

Console> (enable) disable
Console> 

Related Commands

enable

disconnect

Use the disconnect command to close an active console port or Telnet session.

Syntax Description

ip_addr	Source IP address or IP alias of the session to disconnect; in dot notation, for example, 101.102.103.104.
console	Keyword that specifies to clear an active session on the console port.

Defaults

This command has no default setting.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If multiple sessions from the same IP address exist, the system checks if the current session originated from the specified IP address. If the session did not originate from the specified IP address, all Telnet sessions from the address are disconnected. If the session does originate from the specified address, all sessions, other than the current session, are disconnected. The system prompts whether to disconnect the current Telnet session. You can answer n and remain connected or answer y and be disconnected.

Examples

This example shows how to close a Telnet session to host 192.168.255.255 (the 1 in parenthesis indicates the number of active sessions disconnected):

Console> (enable) disconnect 192.168.255.255
Telnet session from 192.168.255.255 disconnected. (1)
Console> (enable)
 

This example shows how to close the current console session:

Console> (enable) disconnect console
Console session disconnected.
Console> (enable)

Related Commands

telnet

download

Use the download command to copy a software image from a specified host to the Flash memory of the supervisor engine or a designated module.

Syntax Description

host	Name or IP address of host.
file	Name of file to be downloaded.
mod_num	(Optional) Number of the module to receive downloaded image.
rcp	(Optional) Keyword that specifies to copy an image from a specified host to Flash using rcp.
serial	Keyword that specifies to download through the serial (console) port.

Defaults

If a module number is not specified, the image is downloaded to all modules for which the image
is valid.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is supported by the Catalyst 5000 family switches and the Catalyst 2926G series switches.

The Catalyst 5000 family and 2926G series switches support two ways to download software images to the switch:

• TFTP network download through any network port

• Kermit serial download through the EIA/TIA-232 console port

You can only download supervisor engine software using the Kermit method.

If you are performing a serial download, you can only download a software image to the supervisor engine. You cannot download a software image to a switching module using the serial download method.

If the module number is specified, the system attempts to download the file to the specified module. If the module is a different type from the type indicated by the download header, the download fails. If the module number is not specified, the file is downloaded to all modules of the type specified in the download header.

To download a software image to the Catalyst 5000 family RSM, you must session to the router and use the copy command to download the software.

You can download a software image to the Catalyst 5000 family RSFC by specifying the RSFC module number in the download command. However, when you download a system image to the RSFC from the switch CLI, the image is stored in RAM only. To permanently store the system image on the RSFC, you must session to the RSFC and use the copy command to copy the software.

In software release 5.2 and later, the download command performs the following actions automatically on switches that support the Flash file system:

• If necessary, deletes the oldest image file on the bootflash: Flash device and performs a squeeze on the bootflash: device. The process is repeated until there is space sufficient for copying the new software image.

• Copies the new software image to the bootflash: device.

• Prepends the new image name to the BOOT variable.

Note You can use the download command as part of a minimal downtime software upgrade. For complete information on performing a minimal downtime software upgrade, refer to the Software Configuration Guide for your switch.

The download serial command uses the Kermit protocol through the serial EIA/TIA-232 console port. The download serial command is not allowed from a console session (the console port must be available for the serial download).

Caution After starting the serial download using Kermit, do not attempt to abort the serial download by pressing Ctrl-C. Pressing Ctrl-C interrupts the download process and might leave the switch in a problematic state. If this occurs, reboot the switch.

Examples

This example shows how to download the c5000_spv11.bin file from the mercury host to the supervisor engine module (by default):

Console> (enable) download mercury c5000_spv11.bin
Download image c5000_spv11.bin from mercury to module 1FLASH (y/n) [n]? y
\
Finished network single module download. (2418396 bytes)
FLASH on Catalyst:
 
Type            Address             Location
Intel 28F008    20000000            NMP (P3) 4MB SIM
 
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)
 

This example shows how to download the fddi_1113.cpi file from the mercury host to module 4:

Console> (enable) download mercury fddi_1113.cpi 4
This command will reset Module 4.
Download image fddi_1113.cbi from mercury to Module 4 FLASH (y/n) [n]? y
|
Finished network download.  (1064876 bytes)
...............................................................................n
Console> (enable)
 

This example shows how to use the download command on a Catalyst 5000 family Supervisor Engine III to automatically delete files as necessary and squeeze bootflash:, copy a software image from a TFTP server, and prepend the new image filename to the BOOT variable:

Console> (enable) download 172.20.52.3 cat5000-sup3.5-2-1.bin
Download image cat5000-sup3.5-2-1.bin from 172.20.52.3 to Module 1 FLASH 
(y/n) [n]? y
Squeeze bootflash in progress....
Erasing squeeze log CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
File has been copied successfully.
Console> (enable)
 

This example shows how to download the c5000_spv11.bin file from the mercury host to the supervisor engine module:

Console> (enable) download mercury c5000_spv11.bin rcp
Download image c5000_spv11.bin from mercury to module 1FLASH (y/n) [n]? y
\
Finished network single module download. (2418396 bytes)
FLASH on Catalyst:
 
Type            Address             Location
Intel 28F008    20000000            NMP (P3) 4MB SIM
 
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)
 

This sample session shows how to connect to a remote terminal from a Sun workstation and how to use the download serial command to copy a software image to the supervisor engine module:

[At local Sun workstation]
host% kermit
C-Kermit 5A(172) ALPHA, 30 Jun 95, SUNOS 4.0 (BSD)
Type ? or 'help' for help
C-Kermit> set line /dev/ttyb
C-Kermit> c     
Connecting to /dev/ttyb, speed 9600.
The escape character is ^ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
 
Console> enable
Enter Password: 
Console> (enable) set system baud 19200
^\C
[Back at local Sun workstation]
C-Kermit> set speed 19200
/dev/ttyb, 19200 bps
C-Kermit> c
Connecting to /dev/ttyb, speed 19200.
The escape character is ^ (ASCII 28).
Type the escape character followed by C to get back,
or followed by ? to see other options.
 
Console> (enable) download serial
Download Supervisor image via console port (y/n) [n]? y
 
Concentrator Boot ROM (Ver 1.00)
 
Waiting for DOWNLOAD!!
Return to your local Machine by typing its escape sequence
Issue Kermit send command from there[ Send `Filename`]
 
^\C
[Back at Local System]
C-Kermit> send c5000_xx.bin
                          SF
c5000_xx.bin => C5000_XX.BIN, Size: 1233266
 
X to cancel file, CR to resend current packet
Z to cancel group, A for status report
E to send Error packet, Ctrl-C to quit immediately:...................................
......................................................................................
...... [OK]
ZB
C-Kermit> quit
host%

Related Commands

resetswitch
show flash
upload

Posted: Sun Jun 11 11:20:28 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.