-
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
2repeat
Use the repeat ROM monitor command to repeat a command.
repeat [num | string]
Syntax Description
num
(Optional) Number of the command (from the command history buffer list).
string
(Optional) String that uniquely matches a command in the command history buffer list.
Defaults
If no argument is specified, the last command is repeated.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
The optional num and string arguments specify which command in the command history buffer to repeat.
If you specify a string to match, the most recent command in the buffer to begin with the specified string is executed again.
If the string contains white space, you must use quotation marks.
This command is aliased to "r" by the ROM monitor for convenience.
Examples
These examples show how to use the repeat command. You use the history command to display the list of previously entered commands:
rommon 22 > history8 dir9 dir bootflash:10 dis11 dis 0xa000100012 dis 0xbe00000013 history14 meminfo15 meminfo -l16 meminfo17 meminfo -l18 meminfo19 meminfo20 meminfo -l21 meminfo -l22 historyrommon 23 > repeat dirdir bootflash:File size Checksum File name1973032 bytes (0x1e1b28) 0xdadf5e24 lluerommon 24 > repeatdir bootflash:File size Checksum File name1973032 bytes (0x1e1b28) 0xdadf5e24 lluerommon 25 > repeat 15meminfo -lMain memory size: 16 MB.Packet memory size: 0 MBMain memory size: 0x1000000Available main memory starts at 0xa000e000, size 0xff2000NVRAM size: 0x20000Parity Map for the DRAM BanksSocket 0 in Bank 0 Has No ParitySocket 1 in Bank 0 Has No ParitySocket 0 in Bank 1 Has No ParitySocket 1 in Bank 1 Has No Parity==========================================================================reset—ROM monitor
Use the reset ROM monitor command to perform a soft reset of the switch.
reset {mod | system}
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 reset command:
rommon 26 > resetSystem Bootstrap, Version 3.1(1.69)Copyright (c) 1994-1997 by cisco Systems, Inc.Supervisor III processor with 16384 Kbytes of main memoryrommon 1 >===========================================================================reset—switch
Use the reset command to restart the system or an individual module and to schedule a system reset.
reset [mod | system | mindown]
reset [mindown] at {hh:mm} [mm/dd] [reason]
reset [mindown] in [hh:] {mm} [reason]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
In software release 5.2 and later, you can use the reset mindown command to reset the switch as part of a minimal downtime software upgrade in a system with redundant supervisor engine modules. For complete information on performing a minimal downtime software upgrade, refer to the Catalyst 5000 Family Software Configuration Guide.
CautionIf you make configuration changes after entering the reset mindown command but before the active supervisor engine resets, the changes are not saved. Input from the CLI is still accepted by the switch while the standby supervisor engine is reset, but any changes you make to the configuration between the time when you enter the reset mindown command and the time when the supervisor engine comes online running the new software image are not saved or synchronized with the standby supervisor engine.
If you do not specify a module number (either a switching module or the active supervisor engine), the command resets the entire system.
If you reset an intelligent module (such as the Catalyst 5000 family RSM or RSFC, or an ATM module), both the module hardware and software are completely reset.
You can use the reset mod command to switch to the standby supervisor engine, where mod is the module number of the active supervisor engine.
Examples
This example shows how to reset the supervisor engine module on a Catalyst 5500 switch with redundant supervisor engines:
Console> (enable) reset 1This command will force a switch-over to the standby supervisor moduleand disconnect your telnet session.Do you want to continue (y/n) [n]? yConnection closed by foreign host.host%Console> (enable)This example shows how to reset module 4:
Console> (enable) reset 4This command will reset module 4 and may disconnect your telnet session.Do you want to continue (y/n) [n]? yResetting module 4...Console> (enable)This example shows how to schedule a system reset for a specific future time:
Console> (enable) reset at 20:00Reset scheduled at 20:00:00, Wed Aug 18 2000.Proceed with scheduled reset? (y/n) [n]? yReset scheduled for 20:00:00, Wed Aug 18 2000 (in 0 day 5 hours 40 minutes).Console> (enable)This example shows how to schedule a reset for a specific future time and include a reason for the reset:
Console> (enable) reset at 23:00 8/18 Software upgrade to 5.3(1).Reset scheduled at 23:00:00, Wed Aug 18 2000.Reset reason: Software upgrade to 5.3(1).Proceed with scheduled reset? (y/n) [n]? yReset scheduled for 23:00:00, Wed Aug 18 2000 (in 0 day 8 hours 39 minutes).Console> (enable)This example shows how to schedule a reset with minimum down time:
Console> (enable) reset mindown at 23:00 8/18 Software upgrade to 5.3(1).Reset scheduled at 23:00:00, Wed Aug 18 2000.Reset reason: Software upgrade to 5.3(1).Proceed with scheduled reset? (y/n) [n]? yReset mindown scheduled for 23:00:00, Wed Aug 18 2000 (in 0 day 8 hours 39 minutes).Console> (enable)This example shows how to schedule a reset after a specified time:
Console> (enable) reset in 5:20 Configuration updateReset scheduled in 5 hours 20 minutes.Reset reason: Configuration updateProceed with scheduled reset? (y/n) [n]? yReset scheduled for 19:56:01, Wed Aug 18 2000 (in 5 hours 20 minutes).Reset reason: Configuration updateConsole> (enable)session
Use the session command to access the CLI of an intelligent module such as a Catalyst 5000 family RSM, RSFC, or ATM module.
session mod
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Usage Guidelines
After you enter this command, the system responds with the Enter Password: prompt, if a password is configured on the module.
To end the session with the intelligent module, enter the quit command.
Examples
This example shows how to open a session with an ATM module (module 4):
Console> session 4Trying ATM-4...Connected to ATM-4.Escape character is `^]'.ATM>set
Use the set command to display all of the ROM monitor command variable names with their values.
set
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 set command to display all of the monitor variable names with their values:
rommon 2 > setPS1=rommon ! >BOOT=?=0Related Commands
set accounting commands
Use the set accounting commands command to enable accounting of the command events on the switch.
set accounting commands enable {config | enable | all} [stop-only] tacacs+
set accounting commands disable
Syntax Description
Defaults
Accounting is disabled by default.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You must configure the TACACS+ servers before enabling accounting.
Examples
This example shows how to enable accounting for configuration commands when sending records only upon termination of the event, using a TACACS+ server:
Console> (enable) set accounting commands enable config stop-only tacacs+Accounting set to enable for commands-config events in stop-only mode.Console> (enable)This example shows how to disable command accounting:
Console> (enable) set accounting commands disableAccounting set to disable for commands-config events.Console> (enable)Related Commands
set accounting connect
set accounting exec
set accounting suppress
set accounting system
set accounting update
set tacacs server
show accountingset accounting connect
Use the set accounting connect command to enable accounting of outbound connection events on the switch.
set accounting connect enable [start-stop | stop-only] {tacacs+ | radius}
set accounting connect disable
Syntax Description
Defaults
Accounting is disabled by default.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.
Examples
This example shows how to enable accounting on Telnet and rlogin sessions when generating records at stop only, using a TACACS+ server:
Console> (enable) set accounting connect enable stop-only tacacs+Accounting set to enable for connect events in stop-only mode.Console> (enable)This example shows how to disable accounting:
Console> (enable) set accounting connect disableAccounting set to disable for connect events.Console> (enable)Related Commands
set accounting commands
set accounting exec
set accounting suppress
set accounting system
set accounting update
set tacacs server
show accountingset accounting exec
Use the set accounting exec command to enable accounting of normal mode sessions on the switch.
set accounting exec enable [start-stop | stop-only] {tacacs+ | radius}
set accounting exec disable
Syntax Description
Defaults
Accounting is disabled by default.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.
Examples
This example shows how to enable accounting of normal login mode events when generating records at start and stop, using a RADIUS server:
Console> (enable) set accounting exec enable start-stop radiusAccounting set to enable for exec events in start-stop mode.Console> (enable)This example shows how to disable accounting of normal login mode events:
Console> (enable) set accounting exec disableAccounting set to disable for exec events in start-stop mode.Console> (enable)Related Commands
set accounting commands
set accounting connect
set accounting suppress
set accounting system
set accounting update
set tacacs server
show accountingset accounting suppress
Use the set accounting suppress command to enable or disable suppression of accounting information for a user who has logged in without a username.
set accounting suppress null-username {enable | disable}
Syntax Description
null-username
Keyword to specify unknown users.
enable
Keyword to enable suppression for unknown users.
disable
Keyword to disable suppression unknown users.
Defaults
Accounting is disabled by default.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You must configure the TACACS+ servers and shared keys before enabling accounting.
Examples
This example shows how to suppress accounting information for users without a username:
Console> (enable) set accounting suppress null-username enableAccounting will be suppressed for user with no username.Console> (enable)This example shows how to include accounting-event information of users without usernames:
Console> (enable) set accounting suppress null-username disableAccounting will be not be suppressed for user with no username.Console> (enable)Related Commands
set accounting commands
set accounting connect
set accounting exec
set accounting suppress
set accounting system
set accounting update
set tacacs server
show accountingset accounting system
Use the set accounting system command to enable accounting of system events on the switch.
set accounting system enable [start-stop | stop-only] {tacacs+ | radius}
set accounting system disable
Syntax Description
Defaults
Accounting is disabled by default.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You must configure the RADIUS or TACACS+ servers and shared keys before enabling accounting.
Examples
This example shows how to enable accounting for system events when sending records only upon termination of the event, using a RADIUS server:
Console> (enable) set accounting system enable stop-only radiusAccounting set to enable for system events in start-stop mode.Console> (enable)This example shows how to disable accounting for system events:
Console> (enable) set accounting system disableAccounting set to disable for system events.Console> (enable)Related Commands
set accounting commands
set accounting connect
set accounting exec
set accounting suppress
set accounting update
set tacacs server
show accounting
