-
Catalyst 5000 Family Command Reference (6.3 and 6.4)
-
Index
-
Preface
-
Command-Line Interfaces
-
Switch and ROM Monitor Commands
-
clear banner motd through clear kerberos realm
-
clear kerberos server through clear vtp pruneeligible
-
clear vtp statistics through enable
-
format through history-switch
-
meminfo through reconfirm vmps
-
reload through session
-
set through set cops
-
set prompt through set spantree portvlanpri
-
set spantree priority through set tokenring locallearning
-
set default portstatus through set logging console
-
set logging history through set ntp client
-
set ntp key through set port trap
-
set tokenring portaging through show accounting
-
show alias through show channel
-
show channel group through show gmrp timer
-
show gvrp configuration through show ip route
-
show kerberos through show multicast group count
-
show multicast protocols status through show rif
-
show rmsautostate through show timezone
-
show tokenring through squeeze
-
switch through write terminal
-
Acronyms
-
Table Of Contents
2show vmps vlanports
Use the show vmps vlanports command to display ports belonging to a restricted VLAN.
show vmps vlanports vlan_name
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to display the VLAN ports in the Engineering VLAN:
Console> show vmps vlanports EngineeringVLAN Name Device ID Port ID--------------- --------------- ----------Engineering 172.20.220.110 2/4Console>Table 2-93 describes the fields in the show vmps vlanports command output.
Related Commands
show vtp domain
Use the show vtp domain command to display VTP domain information.
show vtp domain
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to display VTP domain information:
Console> show vtp domainDomain Name Domain Index VTP Version Local Mode Password-------------------------------- ------------ ----------- ----------- ----------1 2 server -Vlan-count Max-vlan-storage Config Revision Notifications---------- ---------------- --------------- -------------15 1023 5 disabledLast Updater V2 Mode Pruning PruneEligible on Vlans--------------- ------- -------- -------------------------172.20.44.30 enabled disabled 2-1000Console>Table 2-94 describes the fields in the show vtp domain command output.
Related Commands
show vtp statistics
Use the show vtp statistics command to display VTP statistics.
show vtp statistics
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to display VTP statistics:
Console> show vtp statisticsVTP statistics:summary advts received 0subset advts received 0request advts received 0summary advts transmitted 1subset advts transmitted 1request advts transmitted 0No of config revision errors 0No of config digest errors 0VTP pruning statistics:Trunk Join Transmitted Join Received Summary advts received fromnon-pruning-capable device-------- --------------- ------------- ---------------------------5/1-2Console>Table 2-95 describes the fields in the show vtp statistics command output.
Related Commands
slip
Use the slip command to attach or detach SLIP for the console port.
slip {attach | detach}
Syntax Description
Defaults
By default, SLIP is not active (detached).
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You can enter the slip command from a console port session or a Telnet session.
Examples
This example shows how to enable SLIP for a console port during a console port session:
Console> (enable) slip attachConsole port now running SLIP.<console port running SLIP>This example shows how to disable SLIP for a console port during a Telnet session:
Console> (enable) slip detachSLIP detached on Console port.<console port back to RS-232 Console>Console> (enable)Related Commands
squeeze
Use the squeeze command to delete Flash files permanently.
squeeze [m/]device:
Syntax Description
m/
(Optional) Module number of the supervisor engine containing the Flash device.
device:
Device where the Flash device resides.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A colon (:) is required after the specified device.
This command applies only to the Supervisor Engine III. If you attempt to run this command on a Supervisor Engine I or II, you will receive an error message.
Examples
These examples show how to use the squeeze command to delete the slot0 Flash files and then use the show flash command to confirm the deletion:
Console> squeeze slot0:All deleted files will be removed, proceed (y/n) [n]?ySqueeze operation may take a while, proceed (y/n) [n]?y..........................................................Console> (enable) show flash-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name1 .. ffffffff 1f65a4dd 45050 8 20429 Apr 01 1999 15:38:42 5500.cfg2 .. ffffffff 13c368fe 4e9aa0 29 4868557 Mar 02 2000 12:06:18 cat5000-sup3.6-1-0-30-FTL.bin2712928 bytes available (4889248 bytes used)Console>Related Commands
switch
Use the switch command to switch the clock from the supervisor engine clock to the internal clock or from the active supervisor engine to the redundant supervisor engine.
switch {clock | supervisor}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The switch command is supported only on Catalyst 5500 and Catalyst 5505 switches.
Examples
This example shows how to switch the clock:
Console> (enable) switch clockThis command will reset system and force a clock switch-over.Do you want to continue (y/n) [n]?Console> (enable)This example shows how to switch to the redundant supervisor engine:
Console> (enable) switch supervisorThis command will force a switch-over to the standby Supervisor module.Do you want to continue (y/n) [n]?Console> (enable)sync
Use the sync command to write the working in-core copy of environment variables and the aliases to NVRAM so they are read on the next reset.
sync
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to use the sync command:
rommon 10 > syncrommon 11 >telnet
Use the telnet command to start a Telnet connection to a remote host.
telnet host [port_num]
Syntax Description
host
Name or IP address of the remote host to which you want to connect.
port_num
(Optional) Specific port connection on the remote host.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to open and close a Telnet session with the host elvis:
Console> (enable) telnet elvisTrying 192.122.174.11...Connected to elvis.Escape character is '^]'.UNIX(r) System V Release 4.0 (elvis)login: fredPassword:Last login: Thu Jun 11 09:25:01 from forster.cisc.rumSun Microsystems Inc. SunOS 5.4 Generic July 1994You have new mail.% logoutConsole> (enable)Related Commands
test packetbuffer
Use the test packetbuffer command to run packet buffer testing immediately.
test packetbuffer {mod/port...} [complement | [fixed {pattern}]]
test packetbuffer cancel
Syntax Description
Defaults
A default pattern value of 0x55aa55aa55aa is used for the complement.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You can run immediate packet buffer testing on disabled ports (in other words, ports that do not have user traffic running through them). You can not run immediate packet buffer testing on enabled ports (in other words, ports that have user traffic running through them).
Immediate packet buffer testing on a disabled port takes up to one minute.
Note
To run scheduled packet buffer testing on disabled and enabled ports, use the set test packetbuffer command.
Examples
This example shows how to test packet buffers on module 5 ports 1 through 24:
Console> (enable) test packetbuffer 5/1-24Packet buffer test started. Estimated test time: 5 minutes.Console> (enable) 2000 Jan 29 14:52:28 %SYS-3-PKTBUFBAD:Port 5/4 failed packet buffer test2000 Jan 29 14:54:30 %SYS-5-PKTTESTDONE:Packet buffer test done. Use `show test' to see test resultsThis example shows how to cancel a packet buffer test:
Console> (enable) test packetbuffer cancelNo on-demand packetbuffer tests running.Use `set test pacektbuffer disable' to stop scheduled or continuous tests.Console> (enable)Related Commands
set test diaglevel
set test packetbuffer
show testtest snmp trap
Use the test snmp trap command to send an SNMP trap message to the trap receivers.
test snmp trap trap_num [specific_num]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to run trap 0:
Console> (enable) test snmp trap 0SNMP trap message sent. (4)Console> (enable)Related Commands
traceroute
Use the traceroute command to display a hop-by-hop path through an IP network from the switch to a specific destination host.
traceroute [-n] [-w wait_time] [-i initial_ttl] [-m max_ttl] [-p dest_port] [-q nqueries] [-t tos] host
[data_size]Syntax Description
Defaults
Entering the traceroute host command without options sends three 40-byte ICMP datagrams with an initial TTL of 1, a maximum TTL of 30, a timeout period of 5 seconds, and a TOS specification of 0 to destination UDP port number 33434. For each host in the processed path, the initial TTL for each host and the destination UDP port number for each packet sent are incremented by one.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
To interrupt traceroute after the command has been issued, press Ctrl-C.
The traceroute command uses the TTL field in the IP header to cause routers and servers to generate specific return messages. Traceroute starts by sending a UDP datagram to the destination host with the TTL field set to 1. If a router finds a TTL value of 1 or 0, it drops the datagram and sends back an ICMP "time exceeded" message to the sender. The traceroute facility determines the address of the first hop by examining the source address field of the ICMP time-exceeded message.
To identify the next hop, traceroute again sends a UDP packet but this time with a TTL value of 2. The first router decrements the TTL field by 1 and sends the datagram to the next router. The second router sees a TTL value of 1, discards the datagram, and returns the time-exceeded message to the source. This process continues until the TTL is incremented to a value large enough for the datagram to reach the destination host (or until the maximum TTL is reached).
To determine when a datagram has reached its destination, traceroute sets the UDP destination port in the datagram to a very large value that the destination host is unlikely to be using. When a host receives a datagram with an unrecognized port number, it sends an ICMP "port unreachable" error to the source. This message indicates to the traceroute facility that it has reached the destination.
Catalyst 5000 family switches can participate as the source or destination of the traceroute command. However, because they are Layer 2 devices, these switches do not examine the TTL field in the IP header and do not decrement the TTL field or send ICMP time-exceeded messages. A Catalyst 5000 family switch does not appear as a hop in the traceroute command output.
Examples
This example shows how to use the traceroute command to determine the path from the source to the destination host server10:
Console> (enable) traceroute server10traceroute to server10.company.com (172.16.22.7), 30 hops max, 40 byte packets1 engineering-1.company.com (172.31.192.206) 2 ms 1 ms 1 ms2 engineering-2.company.com (172.31.196.204) 2 ms 3 ms 2 ms3 gateway_a.company.com (172.16.1.201) 6 ms 3 ms 3 ms4 server10.company.com (172.16.22.7) 3 ms * 2 msConsole> (enable)Table 2-96 describes the fields in the traceroute command output.
If traceroute receives an ICMP error message other than a time-exceeded or port-unreachable message, it prints one of the error codes shown in Table 2-97 instead of the round-trip time or an asterisk (*).
Related Commands
unalias
Use the unalias command to remove the alias name and associated value from the alias list.
unalias name
Syntax Description
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to use the unalias command to remove the s alias and then check to ensure it was removed:
rommon 5 > aliasr=repeath=history?=helpb=bootls=diri=resetk=stacks=setrommon 6 > unalias srommon 7 > aliasr=repeath=history?=helpb=bootls=diri=resetk=stackrmmon 8 > smonitor: command "s" not found===========================================================================Related Commands
undelete
Use the undelete command to recover a deleted file on a Flash memory device. The deleted file can be recovered using its index (because there could be multiple deleted files with the same name).
undelete index [[m/]device:]
Syntax Description
index
Index number of the deleted file.
m/
(Optional) Module number of the supervisor engine containing the Flash device.
device:
(Optional) Device where the Flash device resides.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A colon (:) is required after the specified device.
Use the dir command to learn the index number of the file to be undeleted.
A file cannot be undeleted if a valid file with the same name exists. You must delete the existing file before you can undelete the target file.
A file can be deleted and undeleted up to 15 times.
To delete all deleted files permanently on a device, use the squeeze command.
Examples
This example shows how to recover the deleted file with index 1 and use the show flash command to confirm:
Console> (enable) undelete 1 bootflash:Console> (enable) show flash-#- ED --type-- --crc--- -seek-- nlen -length- -----date/time------ name1 .. ffffffff a638976e 3627ec 23 3286891 Jan 01 1999 07:04:37 cat5000-supn2 .. ffffffff a6a84c93 365f74 17 14086 Jan 29 1999 02:33:56 switch_confg3 .. ffffffff 141a9127 70b7cc 29 3823575 Mar 09 1999 19:15:55 cat5000-supn1428272 bytes available (6173904 bytes used)Console> (enable)Related Commands
unset=varname
Use the unset=varname command to remove a variable name from the variable list.
unset=varname
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no defaults.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to use the set command to display the variable list, use the unset command to remove a variable name from the variable list, and then use the set command to display the variable list to verify:
rommon 2 > setPS1=rommon ! >BOOT=?=0rommon 3 > unset=0rommon 4 > setPS1=rommon ! >BOOT=Related Commands
upload
Use the upload command to upload a software image to a network host.
upload host file [mod] [rcp | tftp]
Syntax Description
Defaults
If you do not specify the type of upload method, TFTP is used.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
This command is not supported by the three-port Gigabit Ethernet switching module (WS-X5403).
To upload a software image for the RSM, use the session command.
Examples
This example shows how to upload the supervisor engine image to the c5009_11.bin file on the mercury host:
Console> (enable) upload mercury c5009_11.bin 3Upload Module 1 image to c5009_11.bin on mercury (y/n) [n]? y/Done. Finished Network Upload. (153908 bytes)Console> (enable)This example shows how to upload the c5000_spv11.bin file from the mercury host to the supervisor engine module:
Console> (enable) upload mercury c5000_spv11.bin rcpUpload 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 LocationIntel 28F008 20000000 NMP (P3) 4MB SIMErasing 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)Related Commands
varname=
Use the varname= command to set the variable VARNAME to varvalue. The syntax varname= sets the variable to a NULL string.
varname=value
Syntax Description
Defaults
This command has no defaults.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
Do not put a space before or after the equal (=) sign. If there are spaces, you must place the value in quotes. Spell out variable names in all caps to make them conspicuous.
Examples
This example shows how to assign a variable name to a value:
rommon 1 > s=setrommon 2 > sPS1=rommon ! >BOOT=?=0Related Commands
verify
Use the verify command to confirm the checksum of a file on a Flash device.
verify [[m/]device:] filename
Syntax Description
m/
(Optional) Module number of the supervisor engine containing the Flash device.
device:
(Optional) Device where the Flash device resides.
filename
Name of the configuration file.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A colon (:) is required after the specified device.
Examples
This example shows how to use the verify command:
Console> verify cat5k_r47_1.cbi..........................................................File cat5k_r47_1.cbi verified OK.wait
Use the wait command to cause the CLI to pause for a specified number of seconds before executing the next command. This command might be included in a configuration file.
wait seconds
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to pause the CLI for 5 seconds:
Console> wait 5Console>write
Use the write command to upload or display nondefault configurations to a host or terminal.
write {host file | network | terminal} [rcp] [all]
write memory
Syntax Description
Defaults
By default, the write command will upload or output only nondefault configurations. Use the keyword all to upload or output both default and nondefault configurations.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
Caution
The write host file command is a shorthand version of the write network command.
You cannot use the write network command to upload software to the ATM module. With the write network command, the file must already exist on the host (use the UNIX touch filename command to create the file).
The write memory command is only applicable when the switch is set to save its configuration to a text file.
Examples
This sample session assumes that module 1 is a 2-port supervisor engine, module 2 is a 12-port 10/100BASE-T switched Ethernet module, modules 3 and 5 are empty, and module 4 is an FDDI module. Details of the ATM configuration must be accessed through the special module mode.
This example shows how to upload the system5.cfg file to the mercury host using the write network command:
Console> (enable) write networkIP address or name of host? mercuryName of configuration file to write? system5.cfgUpload configuration to system5.cfg on mercury (y/n) [y]? y/Done. Finished Network Upload. (9003 bytes)Console> (enable)This example shows how to upload the system5.cfg file to the mercury host using the write network rcp command:
Console> (enable) write network rcpIP address or name of host? mercuryName of configuration file to write? system5.cfgUpload configuration to system5.cfg on mercury (y/n) [y]? y/Done. Finished Network Upload. (9003 bytes)Console> (enable)This example shows how to upload the system5.cfg file to the mercury host using the write host file command as a shorthand method:
Console> (enable) write mercury system5.cfgUpload configuration to system5.cfg on mercury (y/n) [y]? y/Done. Finished Network Upload. (9003 bytes)Console> (enable)This example shows how to use the write terminal all command to display the entire (default and non-default) configuration file on the terminal:
Console> (enable) write terminal allbeginset password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70set prompt Console>!#systemset system baud 9600set system modem disableset system nameset system locationset system contact!#snmpset snmp community read-only publicset snmp community read-write privateset snmp community read-write-all secretset snmp trap disable!#vlan/trunkset vlan 1 1/1-2,4/1set vlan 2 2/1-5!#trunks!#camset cam agingtime 1 300set cam agingtime 2 300!#ipset interface sc0 0.0.0.0 0.0.0.0 0.0.0.0set interface sl0 0.0.0.0 0.0.0.0set ip redirect enableset ip unreachable disableset ip fragmentation enableset ip alias default 0.0.0.0set arp agingtime 1200!#bridgeset bridge ipx snaptoether 8023rawset bridge ipx 8022toether 8023set bridge ipx 8023rawtofddi snap!#Command alias!#cdpset cdp enable 1/1-2,2/1-5,4/1set cdp interval 1/1 60set cdp interval 1/2 60set cdp interval 2/1 60set cdp interval 2/2 60set cdp interval 2/3 60set cdp interval 2/4 60set cdp interval 2/5 60set cdp interval 4/1 60!#spantree#vlan 1set spantree enable 1set spantree fwddelay 15 1set spantree hello 2 1set spantree maxage 20 1set spantree priority 32768 1set spantree portpri 1/1 32set spantree portcost 1/1 10set spantree portpri 1/2 32set spantree portcost 1/2 10set spantree portpri 4/1 32set spantree portcost 4/1 10#vlan 2set spantree enable 2set spantree fwddelay 15 2set spantree hello 2 2set spantree maxage 20 2set spantree priority 32768 2set spantree portpri 2/1 32set spantree portcost 2/1 100set spantree portpri 2/2 32set spantree portcost 2/2 100set spantree portpri 2/3 32set spantree portcost 2/3 100set spantree portpri 2/4 32set spantree portcost 2/4 100set spantree portpri 2/5 32set spantree portcost 2/5 100!#trunk!#module 1set module name 1set port enable 1/1set port name 1/1set port duplex 1/1 halfset port level 1/1 normalset port enable 1/2set port name 1/2set port duplex 1/2 halfset port level 1/2 normal!#module 2set module name 2set module enable 2!set port enable 2/1set port name 2/1set port duplex 2/1 halfset port level 2/1 normalset port enable 2/2set port name 2/2set port duplex 2/2 halfset port level 2/2 normalset port enable 2/3set port name 2/3set port duplex 2/3 halfset port level 2/3 normalset port enable 2/4set port name 2/4set port duplex 2/4 halfset port level 2/4 normalset port enable 2/5set port name 2/5set port duplex 2/5 halfset port level 2/5 normal!#module 3 empty!#module 4set module name 4set module enable 4!set fddi userdata 4 WorkGroup Stackset fddi tnotify 4 30set fddi treq 4 5000set port enable 4/1set port name 4/1set port level 4/1 normalset fddi tlmin 4/1 40set port enable 4/2set port name 4/2set port level 4/2 normalset fddi tlmin 4/2 40!#module 5 emptyendConsole> (enable)This example shows how to upload the running system configuration to a prespecified location:
Console> (enable) write memoryUpload configuration to bootflash:switch.cfg7165844 bytes available on device bootflash, proceed (y/n) [n]? yRelated Commands
copy
show config
show running-configwrite tech-support
Use the write tech-support command set to generate a report that contains status information about your switch or upload the output of the command to a TFTP server, where you can send it to TAC.
write tech-support host file [module mod] [vlan vlan] [memory] [config]
write tech-support host file [port mod/port] [vlan vlan] [memory] [config]
Syntax Description
Defaults
By default, this command displays the output for technical-support-related show commands. Use keywords to specify the type of information to be displayed. If you do not specify any parameters, the system displays all configuration, memory, module, port, instance data, and VLAN data.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
Caution
Note
Note
If you specify the config keyword, the write tech-support command displays the output of these commands:
•
•
•
•
•
•
•
•
•
•
•
•
