-
Catalyst 4000 Family Command Reference, 7.3
-
Switch and ROM Monitor Commands
-
Index
-
Preface
-
Command-Line Interface
-
alias through copy
-
delete through session
-
set through set dot1x
-
set enablepass through set logging history
-
set logging level through set pvlan
-
set pvlan mapping through set spantree portinstancepri
-
set spantree portpri through set vtp pruning
-
show accounting through show counters
-
show crypto key through show multicast group
-
show multicast group count through show pvlan mapping
-
show qos info through show test
-
show time through write terminal
-
Acronyms
-
Table Of Contents
Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
clear kerberos clients mandatory
clear kerberos credentials forward
clear spantree portinstancecost
clear spantree portinstancepri
Catalyst 4000 Family, Catalyst 2948G, and Catalyst 2980G Switch and ROM Monitor Commands
This chapter contains an alphabetical listing of all switch and ROM monitor commands available on the Catalyst 4000 family, Catalyst 2948G, and Catalyst 2980G switches.
alias
Use the alias command to set and display aliases.
alias [name=value]
Syntax Description
name=
(Optional) Variable that specifies the alias name.
value
(Optional) Variable that specifies the value of the alias.
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
If value contains blank spaces or other special (shell) characters, you must enclose the entry in quotation marks. If value has a space as its last character, the next command line word is checked for an alias (normally, only the first word on a command line is checked).
Without an argument, this command prints a list of all alias names and their values.
An equal sign (=) is required between the name and value of the alias.
Examples
This example shows how to display a list of available alias commands and how to create an alias for the set command:
rommon 1 > aliasr=repeath=history?=helpb=booti=resetrommon 2 > alias s=setrommon 3 > aliasr=repeath=history?=helpb=booti=resets=setrommon 4 > sPS1=rommon ! >BOOT=bootflash:RTSYNC_llue_11,1;slot0:f1,1;=========================================================================Related Commands
boot
Use the boot command to boot up an external process.
boot [-x] [-v] [device][imagename]
Syntax Description
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
With no arguments, boot will boot the first image in Flash memory. Specify an image by typing its name. Specify the device by typing the device ID.
You must specify a device name.
Examples
This example shows how to use the boot command:
rommon 1 > boot -x bootflash:cat5000-sup3.6-1-0-59.binCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCUncompressing file: ########################################################################################## ########################################################################################## ################################################################################rommon 2 >cd
Use the cd command to set the default Flash device for the system.
cd [[m/]device:]]
Syntax Description
Defaults
By default, the Flash device is bootflash.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A colon (:) is required after the specified device.
For those commands for which device is an option, the device set by cd is used if a Flash device is not specified.
This command is supported on the Supervisor Engine III only.
Examples
This example shows how to set the system default Flash device to bootflash:
Console> (enable) cd bootflash:Console> (enable)Related Commands
clear alias
Use the clear alias command to delete the abbreviated versions of commands.
clear alias {name | all}
Syntax Description
name
Variable that specifies the alternate identifier of the command.
all
Keyword that identifies every alternate identifier that has been created.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the arpdel alias:
Console> (enable) clear alias arpdelCommand alias deleted.Console> (enable)This example shows how to delete all aliases:
Console> (enable) clear alias allCommand alias table cleared. (1)Console> (enable)(1) indicates the number of entries deleted.
Related Commands
clear arp
Use the clear arp command to delete a specific entry or all entries from the ARP table.
clear arp [all | dynamic | permanent | static]
clear arp ip_addr
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a specific IP address from the ARP table:
Console> (enable) clear arp 198.133.219.209ARP entry deleted.Console> (enable)This example shows how to delete all entries from the ARP table:
Console> (enable) clear arp allARP table cleared. (1)Console> (enable)(1) indicates the number of entries deleted.
This example shows how to delete all ARP entries of a specific type:
Console> (enable) clear arp dynamicUnknown hostDynamic ARP entries cleared. (3)Console> (enable)Related Commands
clear banner motd
Use the clear banner motd command to delete the message-of-the-day banner.
clear banner motd
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You can use either the clear banner motd command to delete the message-of-the-day banner or use the set banner motd text command to replace the message-of-the-day banner.
Examples
This example shows how to delete the message-of-the-day banner:
Console> (enable) clear banner motdMOTD banner clearedConsole> (enable)Related Commands
clear boot—ROM monitor
Use the clear boot command to clear the contents of the BOOT environment variable and the autoboot state machine.
clear boot
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 clear the contents of the BOOT environment variable:
rommon 1 > clear bootrommon 2 >Related Commands
clear boot—switch
Use the clear boot command to clear the contents of the BOOT environment variable and the configuration register setting.
clear boot system all [mod]
clear boot system flash device:[filename] [mod]
clear boot auto-config [mod]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you want to rearrange the booting order, you can use the prepend keyword with the set boot system flash command or you can clear the entire BOOT environment variable using the clear boot system command and then redefine the list.
This command is supported on the Supervisor Engine III only.
Examples
This example shows how to clear the contents of the Flash device:
Console> (enable) clear boot system allBOOT variable =Console> (enable)This example shows how to delete the auto-config file:
Console> (enable) clear boot auto-configCONFIG_FILE variable =Console> (enable)Related Commands
clear cam
Use the clear cam command to delete a specific entry or all entries from the CAM table, and to clear the CAM notification log or counters.
clear cam {mac_addr | dynamic | static | permanent} [vlan]
clear cam notification {all | counters | history}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
When you use the clear cam command, the EARL CAM table entries are cleared, or the CAM notification counters or history are cleared.
Examples
This example shows how to delete MAC address 00-40-0b-a0-03-fa from the CAM table:
Console> (enable) clear cam 00-40-0b-a0-03-faCAM table entry cleared.Console> (enable)This example shows how to clear dynamic entries from the CAM table:
Console> (enable) clear cam dynamicDynamic CAM entries cleared.Console> (enable)This example shows how to clear all CAM notification counters:
Console> (enable) clear cam notification allMAC address notification counters and history log cleared.Console> (enable)This example shows how to clear CAM notification counters:
Console> (enable) clear cam notification countersMAC address notification counters cleared.Console> (enable)This example shows how to clear the CAM notification history log:
Console> (enable) clear cam notification historyMAC address notification history log cleared.Console> (enable)Related Commands
set cam agingtime
set cam notification
set snmp trap
show camclear cgmp statistics
Use the clear cgmp statistics command to delete CGMP statistical information.
clear cgmp statistics
Syntax DescriptionDescription
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete CGMP statistical information:
Console> (enable) clear cgmp statisticsCGMP statistics cleared.Console> (enable)Related Commands
set cgmp
show cgmp leave
show cgmp statisticsclear config pvlan
Use the clear config pvlan command to delete all private VLAN configurations in the system, including port mappings.
clear config pvlan
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete all private VLAN configurations in the system:
Console> (enable) clear config pvlanThis command will clear all private VLAN configurations.Do you want to continue (y/n) [n]? yVLAN 15 deleted VLAN 16 deleted VLAN 17 deleted VLAN 18 deletedPrivate VLAN configuration cleared. Console> (enable)Related Commands
clear vlan
clear pvlan mapping
configure
set pvlan
set pvlan mapping
set vlan
show config
show pvlan
show pvlan mapping
show vlanclear config—ROM monitor
Use the clear config command to delete information about the system or module configuration stored in NVRAM.
clear config all
Syntax Description
all
Keyword that deletes all information about modules and system configuration, including the IP address.
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Usage Guidelines
When you delete the configuration using the clear config all command, the default switch configuration is restored. The information that is deleted includes manually configured IP addresses and IP addresses learned through DHCP or RARP.
When you delete the configuration, the IP address and subnet mask on the me1 and sc0 interfaces are set to 0.0.0.0. The me1 interface is brought down, and the sc0 interface is brought up.
Note
Before using the clear config all command, save a backup of the configuration.
Examples
This example shows how to delete all the configuration information:
rommon 1 > set boot config-register ignore-config enablerommon 2 > boot -x bootflash:cat4000.6-1-1.binCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC CCCCCCCCCCCCCCCCCCC#############################Starting Off-line Diagnostics[ output of Off-line Diagnostics ]Exiting Off-line DiagnosticsIP address for Catalyst not configuredDHCP/BOOTP will commence after the ports are onlinePorts are coming online ...Cisco Systems, Inc. ConsoleEnter password:2000 Jun 24 06:29:21 %SYS-4-NVLOG:initBootNvram:ignore-config enabled:clear config allConsole>Related Commands
clear config—switch
Use the clear config command to delete the system or module configuration information stored in NVRAM.
clear config {mod | rmon | all | snmp | acl nvram}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
When you delete the configuration using the clear config all command, the default switch configuration is restored. The information that is deleted includes manually configured IP addresses and IP addresses learned through DHCP or RARP.
When you delete the configuration, the IP address and subnet mask on the sc0 interface are set to 0.0.0.0.
Note
Examples
This example shows how to delete the configuration information in NVRAM on module 2:
Console> (enable) clear config 2This command will clear module 2 configuration.Do you want to continue (y/n) [n]? y..............................Module 2 configuration cleared.Console> (enable)This example shows how to delete the configuration information stored in NVRAM on module 1 (supervisor engine):
Console> (enable) clear config 1This command will clear module 1 configuration.Do you want to continue (y/n) [n]? y......Module 1 configuration cleared.host%This example shows how to delete all the configuration information:
Console> (enable) clear config allThis 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]? yReleasing IP address...Done............................................................................System configuration cleared.Console> (enable)This example shows how to delete all the SNMP configuration information:
Console> (enable) clear config snmpThis command will clear SNMP configuration in NVRAM.Do you want to continue (y/n) [n]? y...........................................Connection closed by foreign hosthost%This example shows how to delete all ACL configuration information from NVRAM:
Console> (enable) clear config acl nvramACL configuration has been deleted from NVRAM.Warning:Use the copy commands to save the ACL configuration to a fileand the 'set boot config-register auto-config' commands to configure theauto-config feature.Console> (enable)Related Commands
clear counters
Use the clear counters command to clear MAC and port counters.
clear counters
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
This command also clears ATM module counters.
Examples
This example shows how to reset MAC and port counters to zero:
Console> (enable) clear countersMAC and Port counters cleared.Console> (enable)Related Commands
clear crypto key rsa
Use the clear crypto key rsa command to delete all RSA public-key pairs.
clear crypto key rsa
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete RSA key pairs:
Console> (enable) clear crypto key rsaDo you really want to clear RSA keys (y/n) [n]? yRSA keys has been cleared.Console> (enable)Related Commands
set crypto key rsa
show crypto keyclear dot1x config
Use the clear dot1x config command to disable dot1x on all ports and return the values to the factory default settings.
clear dot1x config
Syntax Description
This command has no keywords or arguments.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to disable dot1x and return the values to the factory default settings:
Console> (enable) clear dot1x configThis command will disable Dot1x and take values back to factory default.Do you want to continue (y/n) [n]? yDot1x config cleared.Console> (enable)Related Commands
set dot1x
set port dot1x
show dot1x
show port dot1xclear gmrp statistics
Use the clear gmrp statistics command to delete all the GMRP statistics information from a specified VLAN or all VLANs.
clear gmrp statistics {vlan | all}
Syntax Description
vlan
Variable that specifies the number of the VLAN.
all
Keyword that deletes all GMRP statistics information from all VLANs.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete GMRP statistical information from all VLANs:
Console> (enable) clear gmrp statistics allGMRP statistics cleared.Console> (enable)This example shows how to delete GMRP statistical information from VLAN 1:
Console> (enable) clear gmrp statistics 1GMRP statistics cleared from VLAN 1.Console> (enable)Related Commands
clear gvrp statistics
Use the clear gvrp statistics command to delete all the GVRP statistics information.
clear gvrp statistics {mod/port | all}
Syntax Description
mod/port
Variable that specifies the number of the module and port.
all
Keyword that deletes the GVRP statistics information for all ports.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete GVRP statistical information:
Console> (enable) clear gvrp statistics allGVRP statistics cleared for all ports.Console> (enable)This example shows how to delete GVRP statistical information for module 2, port 1:
Console> (enable) clear gvrp statistics 2/1GVRP statistics cleared on port 2/1.Console> (enable)Related Commands
clear igmp filter
Use the clear igmp filter all command to delete all IGMP multicast filter profiles.
clear igmp filter all
Use the clear igmp filter profile command to delete an IP address from an IGMP multicast filter profile or to delete the filter profile.
clear igmp filter profile profile_id {ip_addr [- ip_addr]| all}
Use the clear igmp filter map command to delete the association between IGMP multicast filter profiles and associated ports.
clear igmp filter map {port_list | all}
Syntax Description
Defaults
By default, the IGMP multicast filter feature deletes all IGMP multicast filters.
A profile ID value must be established in the clear igmp filter profile.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The administrator of the switch can view the configuration of this feature using the CLI and SNMP interfaces.
When you delete an IGMP filter the filter is deleted and all the associations between the filter and associated ports are deleted.
When you clear an association between IGMP filters the association is deleted, not the filter.
Examples
This example shows how to delete all IGMP multicast filters.
Console> (enable) clear igmp filter allSuccessfully remove all the profile(s)Console> (enable)This example shows how to delete an IP address (226.1.1.1) from an IGMP multicast filter profile (1) or to delete the filter profile:
Console> (enable) clear igmp filter profile 1 226.1.1.1Console> (enable)This example shows how to delete the association of IGMP multicast filter profiles with a port or list of ports.
Console> (enable) clear igmp filter map allConsole> (enable)Related Commands
set igmp filter
show igmp filterclear ip alias
Use the clear ip alias command to delete IP aliases that are set using the set ip alias command.
clear ip alias {name | all}
Syntax Description
name
Variable that specifies the IP address alias to delete.
all
Keyword that deletes all previously set IP address aliases.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a previously defined IP alias named babar:
Console> (enable) clear ip alias babarIP alias deleted.Console> (enable)Related Commands
clear ip dns domain
Use the clear ip dns domain command to delete the default DNS domain name.
clear ip dns domain
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the default DNS domain name:
Console> (enable) clear ip dns domainDefault DNS domain name cleared.Console> (enable)Related Commands
clear ip dns server
Use the clear ip dns server command to delete a DNS server from the DNS server listing.
clear ip dns server {ip_addr | all}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the DNS server at IP address 192.168.255.255 from the DNS server listing:
Console> (enable) clear ip dns server 192.168.255.255192.168.255.255 cleared from DNS table.Console> (enable)Related Commands
clear ip permit
Use the clear ip permit command to delete a specified IP address and mask or all IP addresses and masks from the permit list.
clear ip permit {ip_addr} [mask] [telnet | ssh | snmp | all]
Use the clear ip permit all command to delete all entries in the IP permit list.
clear ip permit all
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The clear ip permit all command deletes the permit list but does not change the state of the IP permit feature. A warning is displayed if all IP addresses are deleted from the permit list, and the feature is enabled. If a mask other than the default (255.255.255.255) has been configured, you must provide both the address and mask to delete a specific entry.
If the telnet, ssh, snmp, or all keywords are not specified, the IP address is deleted from both the SNMP and Telnet permit lists.
Examples
These examples show how to delete specified IP addresses:
Console> (enable) clear ip permit 172.100.101.102172.100.101.102 cleared from IP permit list.Console> (enable)Console> (enable) clear ip permit 172.160.161.0 255.255.192.0 snmp172.160.128.0 with mask 255.255.192.0 cleared from snmp permit list.Console> (enable)Console> (enable) clear ip permit 172.100.101.102 telnet172.100.101.102 cleared from telnet permit list.Console> (enable)Console> (enable) clear ip permit 172.100.101.102 ssh172.100.101.102 cleared from secure shell permit list.Console> (enable)Console> (enable) clear ip permit allIP permit list cleared.WARNINGIP permit list is still enabled.Console> (enable)Related Commands
set ip permit
show ip permit
show port countersclear ip route—ROM monitor
Use the clear ip route command to delete IP routes that are set using the set ip command.
clear ip route all
Syntax Description
Defaults
This command has no default settings.
Command Types
ROM monitor command.
Command Modes
Normal.
Examples
This example shows how to delete previously defined IP routes:
rommon 1 > clear ip route allrommon 2 >Related Commands
set ip route—ROM monitor
show ip route—ROM monitorclear ip route—switch
Use the clear ip route command to delete IP routing table entries.
clear ip route all
clear ip route destination gateway
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the route table entries using the clear ip route command:
Console> (enable) clear ip route 172.16.2.2 elvisRoute deleted.Console> (enable)Related Commands
set ip route—switch
show ip route—switchclear kerberos clients mandatory
Use the clear kerberos clients mandatory command to disable mandatory Kerberos authentication for services on the network.
clear kerberos clients mandatory
Syntax Description
This command has no arguments or keywords.
Defaults
By default, Kerberos clients are not set to mandatory.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to authenticate to a host on the network. However, if forwarding is not enabled and a user tries to list credentials after authenticating to a host, the output will show no Kerberos credentials present.
You can optionally configure the switch to forward users' TGTs with them as they authenticate from the switch to Kerberized remote hosts on the network when using Kerberized Telnet.
As an added layer of security, you can optionally configure the switch so that after users authenticate to it, they can authenticate to other services on the network only with Kerberos clients. If you do not make Kerberos authentication mandatory and Kerberos authentication fails, the application attempts to authenticate users using the default method of authentication for that network service. For example, Telnet prompts for a password.
Examples
This example shows how to delete mandatory Kerberos authentication:
Console> (enable) clear kerberos clients mandatoryKerberos clients mandatory clearedConsole> (enable)Related Commands
set kerberos clients mandatory
set kerberos credentials forwardclear kerberos credentials forward
Use the clear kerberos credentials forward command to disable credentials forwarding.
clear kerberos credentials forward
Syntax Description
This command has no arguments or keywords.
Defaults
By default, forwarding is disabled.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to authenticate to a host on the network. However, if forwarding is not enabled and a user tries to list credentials after authenticating to a host, the output will show no Kerberos credentials present.
You can optionally configure the switch to forward users' TGTs with them as they authenticate from the switch to Kerberized remote hosts on the network when using Kerberized Telnet.
Examples
This example shows how to disable Kerberos credentials forwarding:
Console> (enable) clear kerberos credentials forwardKerberos credentials forwarding disabledConsole> (enable)Related Commands
set kerberos clients mandatory
set kerberos credentials forwardclear kerberos creds
Use the clear kerberos creds command to delete all the Kerberos credentials.
clear kerberos creds
Syntax Description
This command has no arguments or keywords.
Defaults
By default, forwarding is disabled.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
A user authenticated to a Kerberized switch has a ticket granting ticket (TGT) and can use it to authenticate to a host on the network. This command deletes all Kerberos credentials.
Examples
This example shows how to delete all Kerberos credentials:
Console> (enable) clear kerberos credsConsole> (enable)Related Commands
set kerberos credentials forward
clear kerberos realm
Use the clear kerberos realm command to delete an entry that is mapping the name of a Kerberos realm to a DNS domain name or a host name.
clear kerberos realm {dns-domain | host} kerberos-realm
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The name of the Kerberos realm can sometimes be mapped to a DNS domain name or a host name. This mapping can be done with the set kerberos realm command.
Examples
This example shows how to delete an entry mapping a Kerberos realm to a domain name:
Console> (enable) clear kerberos realm CISCO CISCO.COMKerberos DnsDomain-Realm entry CISCO - CISCO.COM deletedConsole> (enable)Related Commands
set kerberos local-realm
set kerberos realmclear kerberos server
Use the clear kerberos server command to delete a specified key distribution center (KDC) entry.
clear kerberos server kerberos-realm {hostname | ip-address} [port_num]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
You can specify to the switch which KDC to use in a Kerberos realm. This command deletes a server entry from the table.
Examples
This example shows how to delete a KDC server entered on the switch:
Console> (enable) clear kerberos server CISCO.COM 187.0.2.1 750Kerberos Realm-Server-Port entry CISCO.COM-187.0.2.1-750 deletedConsole> (enable)Related Commands
clear kerberos srvtab entry
Use the clear kerberos srvtab entry command to delete the SRVTAB file that is entered directly into the switch from the command line.
clear kerberos srvtab entry kerberos-principal principal-type
Syntax Description
kerberos-principal
Variable that specifies the service on the switch.
principal-type
Variable that specifies the version of the Kerberos SRVTAB.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a SRVTAB file entered directly into the switch:
kerberos> (enable) clear kerberos srvtab entry host/niners.cisco.com@CISCO.COM 0kerberos> (enable)Related Commands
set kerberos srvtab entry
set kerberos srvtab remoteclear key config-key
Use the clear key config-key command to delete the configuration key.
clear key config-key
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a DES key:
Console> (enable) clear key config-keyRelated Commands
clear lacp-channel statistics
Use the clear lacp-channel statistics command to delete LACP statistical information.
clear lacp-channel statistics
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Normal.
Examples
This example shows how to delete LACP statistical information:
Console> (enable) clear lacp-channel statisticsLACP channel counters are cleared.Console> (enable)Related Commands
set channelprotocol
set lacp-channel system-priority
set port lacp-channel
set spantree channelcost
set spantree channelvlancost
show lacp-channel
show port lacp-channelclear log
Use the clear log command set to clear module, system error log, or dump log entries.
clear log [mod]
clear log dump
Syntax Description
mod
(Optional) Variable that specifies the module number.
dump
Keyword that clears dump log entries.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you do not specify a module number, the system error log for the entire system is cleard.
Examples
This example shows how to clear the system error log:
Console> (enable) clear logSystem error log cleared.Console> (enable)This example shows how to clear the dump log:
Console> (enable) clear log dumpConsole> (enable)Related Commands
clear log command
Use the clear log command command to delete the command log entry table.
clear log command [mod]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The command log entry table is a history log of the commands input to the switch from the console or from Telnet.
Examples
This example shows how to delete the command log table for module 3:
Console> (enable) clear log command 3Module 3 log cleared.Console> (enable)Related Commands
clear logging buffer
Use the clear logging buffer command to clear the system logging buffer.
clear logging buffer
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to clear the system logging buffer:
Console> (enable) clear logging bufferSystem logging buffer cleared.Console> (enable)Related Commands
clear logging level
Use the clear logging level command to reset the default logging level of all facilities to their default factory settings.
clear logging level [facility | all]
Syntax Description
facility
(Optional) Variable that specifies the name of facility to reset. For facility types, see set logging level.
all
(Optional) Keyword that resets all facilities.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to reset all facilities back to their factory default settings:
Console> (enable) clear logging level allDefault logging level for all facilities cleared.This example shows how to reset a system back to its factory default settings:
Console> (enable) clear logging level systemDefault logging level for facility <sys> cleared.clear logging server
Use the clear logging server command to delete a syslog server from the system log server table.
clear logging server ip_addr
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a syslog server from the configuration:
Console> (enable) clear logging server 192.168.255.255 System log server 192.168.255.255 removed from system log server table.Console> (enable)Related Commands
set logging server
show loggingclear multicast router
Use the clear multicast router command to delete manually configured multicast router ports from the multicast router port list.
clear multicast router {mod_num/port_num | all}
Syntax Description
mod_num
Variable that specifies the number of the module.
port_num
Variable that specifies the number of the port on the module.
all
Keyword that deletes all multicast router ports.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete port 1 on module 3 from the list of multicast router ports:
Console> (enable) clear multicast router 3/1 Port 3/1 cleared from multicast router port list.Console> (enable)Related Commands
set multicast router
show multicast routerclear ntp key
Use the clear ntp key command to delete all authentication keys or a specific authentication key.
clear ntp key {public_keynum | all}
Syntax Description
public_keynum
Variable that specifies the number of the key pair; valid values are from 1 to 4,292,945,295.
all
Keyword that deletes all authentication keys.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete an NTP authentication key:
Console> (enable) clear ntp key 435NTP key 435 cleared.Console> (enable)Related Commands
clear ntp server
Use the clear ntp server command to delete one or more servers from the NTP server table.
clear ntp server {ip_addr | all}
Syntax Description
ip_addr
Variable that specifies the IP address of the server to delete from the server table.
all
Keyword that deletes all server addresses in the server table.
Defaults
By default, no NTP servers are configured.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a specific NTP server from the server table:
Console> (enable) clear ntp server 172.20.22.191NTP server 172.20.22.191 removed.Console> (enable)This example shows how to delete all NTP servers from the server table:
Console> (enable) clear ntp server allAll NTP servers cleared.Console> (enable)Related Commands
clear ntp timezone
Use the clear ntp timezone command to return the time zone to its default, Coordinated Universal Time (UTC).
clear ntp timezone
Syntax Description
This command has no arguments or keywords.
Defaults
By default, the time zone is set to UTC.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The clear ntp timezone command functions only when NTP is running. If you set the time manually and NTP is disengaged, this command has no effect.
Examples
This example shows how to delete the time zone:
Console> (enable) clear ntp timezoneTimezone name and offset cleared.Console> (enable)Related Commands
clear port host
Use the clear port host command to return access ports back to the system default configuration.
clear port host
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete port host 1 on module 2:
Console> (enable) clear port host 2/1Port(s) 2/1 trunk mode set to auto.Spantree port 2/1 fast start disabled.Port(s) 2/1 channel mode set to auto.Console> (enable)This example shows how to delete port hosts 1 to 4 on module 2:
Console> (enable) clear port host 2/1-4Port(s) 2/1 trunk mode set to auto.Port(s) 2/2 trunk mode set to auto.Port(s) 2/3 trunk mode set to auto.Port(s) 2/4 trunk mode set to auto.Spantree ports 2/1-4 fast start disabled.Port(s) 2/1 channel mode set to auto.Port(s) 2/2 channel mode set to auto.Port(s) 2/3 channel mode set to auto.Port(s) 2/4 channel mode set to auto.console> (enable)Related Commands
clear port security
Use the clear port security command to delete all MAC addresses or a specific MAC address from the list of secure MAC addresses on a port.
clear port security mod_num/port_num {mac_addr | all}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a specific MAC address from a port's list of secure addresses:
Console> (enable) clear port security 4/1 00-11-22-33-44-5500-11-22-33-44-55 cleared from secure address list list for port 4/1.Console> (enable)Related Commands
set port security
show port securityclear pvlan mapping
Use the clear pvlan mapping command to delete a private VLAN mapping.
clear pvlan mapping {primary_vlan}{isolated_vlan | community_vlan}{mod/port}
clear pvlan mapping {mod/port}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you do not specify the mapping to delete, all the mappings of the specified promiscuous ports are deleted.
Examples
This example shows how to delete the mapping of VLAN 902 to 901, previously set on module 3, ports 2 to 5:
Console> (enable) clear pvlan mapping 901 902 3/2-5Successfully cleared mapping between 901 and 902 on 3/2-5 Console> (enable)Related Commands
clear config pvlan
clear vlan
set pvlan
set pvlan mapping
set vlan
show pvlan
show pvlan mapping
show vlanclear qos config
Use the clear qos config command to return the values set by the set qos command to the default values and delete the Class of Service-to-MAC address mappings.
clear qos config
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to return the values set by the set qos command to the default values and delete the Class of Service (CoS) assigned to MAC addresses:
Console> (enable) clear qos configThis command will disable QoS and take values back to factory default.Do you want to continue (y/n) [n]? yQoS config cleared.Console> (enable)Related Commands
clear qos defaultcos
Use the clear qos defaultcos command to restore the default Class of Service (CoS) value for the entire switch.
clear qos defaultcos
Syntax Description
This command has no arguments or keywords.
Defaults
By default, CoS for the entire switch is set to CoS equals 0.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to restore the default CoS value for the entire switch:
Console> (enable) clear qos defaultcosqos defaultcos setting cleared.Console> (enable)Related Commands
clear qos map
Use the clear qos map command to return the CoS-to-transmit queue and drop threshold values to their default values.
clear qos map port_type
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to return the CoS-to-transmit queue and drop threshold mappings to the default values on 1q4t ports:
Console> (enable) clear qos map 1q4tQos map setting cleared.Console> (enable)Related Commands
clear radius key
Use the clear radius key command to delete all or one of the RADIUS shared keys from the RADIUS shared key table.
clear radius key
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the RADIUS key:
Console> (enable) clear radius keyRadius server key cleared.Console> (enable)Related Commands
clear radius server
Use the clear radius server command to delete all or one of the RADIUS servers from the RADIUS server table.
clear radius server all
clear radius server ip_addr
Syntax Description
all
Keyword that deletes all RADIUS servers from the RADIUS server table.
ip_addr
Variable that specifies the IP address of the RADIUS server you want to delete.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a specific RADIUS server from the RADIUS server table:
Console> (enable) clear radius server 192.168.255.255192.168.255.255 cleared from radius server table.Console> (enable)Related Commands
clear rcp
Use the clear rcp command to delete rcp information for file transfers.
clear rcp
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete rcp information:
Console> (enable) clear rcpConsole> (enable)Related Commands
clear snmp access
Use the clear snmp access command to delete the access rights of an SNMP group with a specific security model and security level.
clear snmp access [-hex] {groupname security-model {v1 | v2c | v3} {noauthentication | authentication | privacy}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you use special characters for groupname (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
Examples
This example shows how to delete SNMP access for a group:
Console> (enable) clear snmp access cisco-group security-model v3 authenticationCleared snmp access cisco-group version v3 level authentication.Console> (enable)Related Commands
clear config—switch
set snmp access
show snmp
clear snmp community
Use the clear snmp community command to delete the mappings between different community strings and security modes.
clear snmp community index [-hex] {index_name}
Syntax Description
index
Keyword that deletes an index.
-hex
(Optional) Keyword that displays the index_name in hexadecimal format.
index_name
Variable that specifies the name of the SNMP index.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you use special characters for index_name (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
If you do not enter an index_name, a NULL context string is used.
Examples
This example shows how to delete SNMP access for a group:
Console> (enable) clear snmp community index ind1Cleared snmp community ind1.Console> (enable)Related Commands
set snmp community
show snmp communityclear snmp group
Use the clear snmp group command to delete the SNMP user from an SNMP group.
clear snmp group [-hex] groupname user {[-hex] username}
security-model {v1 | v2c | v3}Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you use special characters for groupname or username (nonprintable delimiters for these parameters), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
Examples
This example shows how to delete the SNMP group from the vacmAccessTable:
Console> (enable) clear snmp group cisco-group user joe security-model v3Cleared snmp group cisco-group user joe version v3.Console> (enable)Related Commands
clear snmp notify
Use the clear snmp notify command to delete the SNMP notifyname in the SNMP Notify Table.
clear snmp notify [-hex] {notifyname}
Syntax Description
-hex
(Optional) Keyword that displays the notifyname in hexadecimal format.
notifyname
Variable that specifies a unique identifier to index the snmpNotifyTable.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you use special characters for notifyname (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
Examples
This example shows how to delete an SNMP notifyname from the SNMP NotifyTable:
Console> (enable) clear snmp notify joeCleared SNMP notify table joe.Console> (enable)Related Commands
clear snmp targetaddr
Use the clear snmp targetaddr command to delete the SNMP target address entry in the TargetAddressTable.
clear snmp targetaddr [-hex] {addrname}
Syntax Description
-hex
(Optional) Keyword that displays the addrname in hexadecimal format.
addrname
Variable that specifies an arbitrary but unique name of the target agent; the maximum length is 32 bytes.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you use special characters for addrname (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
Examples
This example shows how to delete an SNMP target address entry in the SNMP TargetAddressTable:
Console> (enable) clear snmp targetaddr joeCleared SNMP targetaddr joe.Console> (enable)Related Commands
clear snmp targetparams
Use the clear snmp targetparams command to delete the SNMP target parameters used in the snmpTargetParamsTable.
clear snmp targetparams [-hex] {paramsname}
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you use special characters for paramsname (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
Examples
This example shows how to delete the SNMP target parameters in the snmpTargetParamsTable:
Console> (enable) clear snmp targetparams joeCleared SNMP targetparams table joe.Console> (enable)Related Commands
set snmp targetparams
show snmpclear snmp trap
Use the clear snmp trap command to delete an entry from the SNMP trap receiver table.
clear snmp trap {rcvr_addr | all}
clear snmp trap rcvr_addr [port rcvr_port] [owner rcvr_owner] [index rcvr_index]
Syntax Description
Defaults
By default, there are no entries in the SNMP trap receiver table.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete an entry from the SNMP trap receiver table:
Console> (enable) clear snmp trap 192.168.255.255SNMP trap receiver deleted.Console> (enable)Related Commands
set snmp trap
show port counters
test snmp trapclear snmp user
Use the clear snmp user command to delete an SNMP user.
clear snmp user [-hex] {username} [remote {engineid}]
Syntax Description
Defaults
If a remote engine ID is not provided, the default local SNMP engine ID is used.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you use special characters for username (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
Examples
This example shows how to delete a user from an SNMP group:
Console> (enable) clear snmp user joeCleared SNMP user joe.Console> (enable)This example shows how to delete a user on a remote SNMP engine:
Console> (enable) clear snmp user joe remote 00:00:00:09:00:d0:00:4c:18:00Cleared SNMP user.Console> (enable)Related Commands
clear snmp view
Use the clear snmp view command to delete the MIB viewname from the vacmViewTreeFamilyTable.
clear snmp view [-hex] {viewname} {subtree}
Syntax Description
-hex
(Optional) Keyword that displays the viewname in hexadecimal format.
viewname
Variable that specifies the name of a MIB view.
subtree
Variable that specifies the name of the subtree.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you use special characters for viewname (nonprintable delimiters for this parameter), you must use a hexadecimal keyword, which is one or two hexadecimal digits separated by a colon (:); for example, 00:ab:34.
A MIB subtree used in conjunction with a mask defines a view subtree that can be in OID format or a text name mapped to a valid OID.
Examples
This example shows how to delete the SNMP MIB viewname:
Console> (enable) clear snmp view myview 1.1.3Cleared snmp view myview with subtree 1.1.3Console> (enable)Related Commands
clear spantree mst
Use the clear spantree mst command to delete the mapping of VLANs to an MST instance.
clear spantree mst instance [vlan vlans]
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you enter only one instance number, you also can enter a VLAN number. If you enter a range of instance numbers, you can not enter a VLAN number.
If you do not specify a VLAN, all VLANs are unmapped from the specified instance and added to MST instance 0 (IST).
Examples
This example shows you how to delete the VLAN 2 from MST instance 2:
Console> (enable) clear spantree mst 2 vlan 2Console> (enable)Related Commands
set spantree mst redetect-protocol
show spantree mstclear spantree portcost
Use the clear spantree portcost command to delete the port cost of a port on the switch.
clear spantree portcost mod/port [mst]
Syntax Description
mod/port
Variables for the number of the module and the port on the module.
mst
(Optional) Keyword that restores the default path cost to an MST instance on a port.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to restore the default path cost on a port:
Console> (enable) clear spantree portcost 3/1Port 3/1 is using the cost 0.Console> (enable)This example shows how to restore the default path cost to all MST instances on a port:
Console> (enable) clear spantree portcost 8/1 mstPort 8/1 MST is using the cost 20000 in MST mode.Console> (enable)Related Commands
set spantree portcost
show spantree statisticsclear spantree portinstancecost
Use the clear spantree portinstancecost command to restore the default path cost to an instance on a port.
clear spantree portinstancecost mod/port [mst] instances
Syntax Description
Defaults
The default path cost is based on port speed; see Table 2-1 for default settings.
Table 2-1 Default Port Cost—Short Mode
4 Mb
250
10 Mb
100
16 Mb
62
100 Mb
19
155 Mb
14
1 Gb
4
10 Gb
2
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
This command is valid in MISTP mode only.
Examples
This example shows how to restore the default path cost to an instance on a port:
Console> (enable) clear spantree portinstancecost 5/1 2Port 5/1 mistp-instance 1-16 have path cost 200000.Console> (enable)This example shows how to restore the default path cost to all MST instances on a port:
Console> (enable) clear spantree portinstancecost 8/1 mst 0-15Port 8/1 MST Instance 0-15 have path cost 20000.Console> (enable)Related Commands
set spantree portinstancecost
show spantree statisticsclear spantree portinstancepri
Use the clear spantree portinstancepri command to reset the spanning tree port instance priority.
clear spantree portinstancepri mod/port [instances]
Syntax Description
mod/port
Variable that specifies the number of the module and the port on the module.
instances
(Optional) Variable that specifies the number of the instance; valid values are from 0 to 15.
Defaults
By default, the port priority is set to 0, with no instances specified.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
This command is valid in MISTP mode only.
Examples
This example shows how to reset the spanning tree port instance priority:
Console> (enable) clear spantree portinstancepri 5/1 2Port 5/1 instances 1-16 using portpri 32.Console> (enable)This example shows how to reset the spanning tree port priority for all MST instances:
Console> (enable) clear spantree portinstancepri 8/1 mst 0-15Port 8/1 MST Instances 0-15 using portpri 32Console> (enable)Related Commands
set spantree portinstancepri
show spantreeclear spantree portvlancost
Use the clear spantree portvlancost command to restore the default spanning tree port VLAN cost on a port.
clear spantree portvlancost mod_num port_num preferred_vlans
Syntax Description
Defaults
The default cost is based on the port speed; see Table 2-2 for default settings.
Table 2-2 Default Port Cost
100 Kb
200,000,000
1 Mb
20,000,000
10 Mb
2,000,000
100 Mb
200,000
1 Gb
20,000
10 Gb
2,000
100 Gb
200
1 Tb
20
10 Tb
2
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to restore the default spanning tree port VLAN cost for VLANs 1 through 10 on port 2/10:
Console> (enable) clear spantree portvlancost 2/10 1-10Port 2/10 VLANs 11-21 have path cost 6Port 2/10 VLANs 1-10,22-1000 have path cost 10.Console> (enable)Related Commands
set spantree portfast
show spantree statisticsclear spantree portpri
Use the clear spantree portpri command to delete the port priority of a port on the switch.
clear spantree portpri mod/port [mst]
Syntax Description
mod/port
Variables for the number of the module and the port on the module.
mst
(Optional) Keyword that resets the spanning tree MST port priority.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the spanning tree port priority:
Console> (enable) clear spantree portpri 3/1Port 3/1 is using the cost 32.Console> (enable)This example shows how to delete the spanning tree MST port priority:
Console> (enable) clear spantree portpri 8/1 mstPort 8/1 is using the priority 32 in MST mode.Console> (enable)Related Commands
set spantree portpri
show spantreeclear spantree portvlanpri
Use the clear spantree portvlanpri command to restore the default spanning tree port VLAN priority on a port.
clear spantree portvlanpri mod_num port_num vlans
clear spantree portvlanpri trcrf | trbrf
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to restore the default spanning tree port VLAN priority for VLANs 23 to 40 on module 1 port 2:
Console> (enable) clear spantree portvlanpri 1/2 23-40 Port 1/2 vlans 3,6-20,23-1000 using portpri 32 Port 1/2 vlans 1-2,4-5,21-22 using portpri 30Console> (enable)Related Commands
clear spantree portinstancecost
show spantree mistp-instance
show spantreeclear spantree root
Use the clear spantree root command to restore the spanning tree bridge priority, hello time, maxage, and forward delay on the switch to their default values.
clear spantree root vlans
clear spantree root mistp-instance instances
clear spantree root mst instances
Syntax Description
Defaults
The default bridge configurations are:
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the spanning tree root on a range of VLANs:
Console> (enable) clear spantree root 1-20VLANs 1-20 bridge priority set to 32678.VLANs 1-20 bridge hello time set to 2 seconds.VLANs 1-20 bridge max aging time set to 20 seconds.VLANs 1-20 bridge forward delay set to 15 seconds.This example shows how to delete the spanning tree root on two specific VLANs:
Console> (enable) clear spantree root 22,24VLANs 22,24 bridge priority set to 32678.VLANs 22,24 bridge hello time set to 2 seconds.VLANs 22,24 bridge max aging time set to 20 seconds.VLANs 22,24 bridge forward delay set to 15 seconds.Console> (enable)This example shows how to delete the spanning tree root on an instance:
Console> (enable) clear spantree root mistp-instance 1Instance 1 bridge priority set to 32768.Instance 1 bridge max aging time set to 20.Instance 1 bridge hello time set to 2.Instance 1 bridge forward delay set to 15.Console> (enable)This example shows how to delete the spanning tree root on an MST instance:
Console> (enable) clear spantree root mst 0MST Instance s 0 bridge priority set to 32768.Instances 0 bridge max aging time set to 20.Instances 0 bridge hello time set to 2.Instances 0 bridge forward delay set to 15.Console> (enable)Related Commands
set spantree root
show spantreeclear spantree statistics
Use the clear spantree statistics command to delete the spanning tree statistics on a specified port
or VLAN.clear spantree statistics mod/port
clear spantree statistics vlans
clear spantree statistics mistp-instance instances
clear spantree statistics mst instance
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the spanning tree statistics for VLAN 1:
Console> (enable) clear spantree statistics 1Cleared all VLAN counters for VLAN 1Statistics cleared for vlans 1Console> (enable)This example shows how to delete the spanning tree statistics for a port:
Console> (enable) clear spantree statistics 3/1Statistics cleared for module 3/1Console> (enable)This example shows how to delete the spanning tree statistics for an instance:
Console> (enable) clear spantree statistics mistp-instance 2Statistics cleared for instances 2Console> (enable)This example shows how to delete the spanning tree statistics for an MST instance:
Console> (enable) clear spantree statistics mst 0Statistics cleared for MST instance: 0Console> (enable)Related Commands
clear spantree uplinkfast
Use the clear spantree uplinkfast command to disable UplinkFast and return the spanning tree bridge priority, port priorities, and port costs to their default values.
clear spantree uplinkfast
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
This command changes spanning tree port priorities and port costs, which might affect VLAN load-balancing configurations.
Examples
This example shows how to turn off the UplinkFast feature and return the spanning tree bridge priority, port priorities, and port costs to their default values:
Console>(enable) clear spantree uplinkfastThis command will cause all portcosts, portvlancosts, and thebridge priority on all vlans to be set to default.Do you want to continue (y/n) [n]? yVLANs 1-1005 bridge priority set to 32768.The port cost of all bridge ports set to default value.The portvlancost of all bridge ports set to default value.uplinkfast disabled for bridge.Console> (enable)Related Commands
set spantree uplinkfast
show spantree uplinkfastclear tacacs key
Use the clear tacacs key command to delete the TACACS+ authentication and encryption server key.
clear tacacs key
Syntax Description
This command has no arguments or keywords.
Defaults
By default, the key value is NULL.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the TACACS+ server key used for authentication and encryption:
Console> (enable) clear tacacs keyTACACS server key cleared.Console> (enable)Related Commands
clear tacacs server
Use the clear tacacs server command to delete a host from the list of TACACS+ servers.
clear tacacs server {ip_addr | all}
Syntax Description
ip_addr
Variable that specifies the IP address of the server to be deleted from the list of TACACS+ servers.
all
Keyword that deletes all hosts from the list of TACACS+ servers.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a server from the list of TACACS+ servers:
Console> (enable) clear tacacs server 192.168.255.255192.168.255.255 cleared from TACACS tableConsole> (enable)Related Commands
clear timezone
Use the clear timezone command to return the time zone to its default, Coordinated Universal Time (UTC).
clear timezone
Syntax Description
This command has no arguments or keywords.
Defaults
By default, the time zone is UTC.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The clear timezone command functions only when NTP is enabled. If you set the time manually and NTP is disabled, the clear timezone command has no effect.
Examples
This example shows how to delete the time zone:
Console> (enable) clear timezoneTimezone name and offset cleared.Console> (enable)Related Commands
clear top
Use the clear top command to terminate any TopN report processes that are running.
clear top {all | report_num}
Syntax Description
all
Keyword that terminates all nonpending TopN results.
report_num
Variable that specifies the TopN report number to terminate; valid values are from 1 to 5.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The clear top all command will not kill any pending TopN reports. Only reports with a done status are killed.
You can terminate TopN processes without the background option by pressing Ctrl-C in the same Telnet or console session, or by entering the clear top [report_num] command from a separate Telnet or console session. Use the show top background command to find out if the background option is used.
The prompt is not displayed before the TopN report is completely displayed. Other commands will be blocked until the report has been displayed.
Examples
This example shows how to stop the TopN process 1 from a console session or a Telnet session:
Console> (enable) clear top 1Console> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by Console//Console> (enable)Console> (enable) clear top 1Console> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by telnet/172.20.52.124//Console> (enable)This example shows how to stop all nonpending TopN report processes:
Console> (enable) clear top allConsole> (enable) %MGMT-5-TOPN_TERMINATE:Report 1 terminated by Console//%MGMT-5-TOPN_TERMINATE:Report 2 terminated by Console//%MGMT-5-TOPN_TERMINATE:Report 3terminated by Console//Console> (enable)Related Commands
clear trunk
Use the clear trunk command to restore a trunk port to its default trunk type and mode or to delete specific VLANs from the allowed VLAN list for a trunk port.
clear trunk mod ports [vlans]
Syntax Description
Defaults
If you do not specify any VLANs, this command sets the mode to auto for ISL and IEEE 802.1Q trunk ports. For more information about auto and off modes, see the set trunk command.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you specify VLANs, those VLANs are deleted from the list of VLANs allowed on the trunk. Traffic for the deleted VLANs is not forwarded over the trunk port.
Default VLANs cannot be deleted from the allowed VLAN list on the trunk.
To add VLANs that you have deleted, use the set trunk mod_num/port_num vlan_range command.
Examples
This example shows how to delete VLANs 200 to 500 from the trunk port on port 2 of module 1:
Console> (enable) clear trunk 1/2 200-500Removing Vlan(s) 200-500 from allowed list.Port 1/2 allowed vlans modified to 1-199,501-1000.Console> (enable)This example shows how to delete the trunk on port 2 of module 1:
Console> (enable) clear trunk 1/2Port(s) 1/2 trunk mode set to auto.Port(s) 1/2 trunk type set to isl.Console> (enable)Related Commands
clear vlan
Use the clear vlan command to delete an existing VLAN from a management domain.
clear vlan vlan
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
Follow these guidelines for deleting VLANs:
•
•
•
Caution
Caution
When you delete a private VLAN (primary, isolated, or community), the ports are set to inactive and are not assigned to any VLAN. The private VLAN mappings for the selected VLAN are also deleted. ACL to VLAN mappings are also deleted.
Examples
This example shows how to delete an existing VLAN (VLAN 4) from a management domain:
Console> (enable) clear vlan 4 This command will deactivate all ports on vlan 4 in the entire management domain Do you want to continue(y/n) [n]? y VLAN 4 deletedConsole> (enable)Related Commands
clear vlan mapping
Use the clear vlan mapping command to delete existing 802.1Q VLAN to ISL VLAN mapped pairs.
clear vlan mapping dot1q {1q_vlan_num | all}
Syntax Description
dot1q
Keyword that specifies the 802.1Q VLAN.
1q_vlan_num
Variable that specifies the 802.1Q VLAN from which to delete the mapping.
all
Keyword that deletes the mapping table of all entries.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete an existing mapped 802.1Q VLAN (VLAN 1044) from the
mapping table:Console> (enable) clear vlan mapping dot1q 1044Vlan Mapping 1044 Deleted.Console> (enable)This example shows how to delete all mapped 802.1Q VLANs from the mapping table:
Console> (enable) clear vlan mapping dot1q allAll Vlan Mapping Deleted.Console> (enable)Related Commands
clear vmps rcp
Use the clear vmps rcp command to delete a VMPS RCP username from the VMPS server table.
clear vmps rcp username
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
If you do not enter a username, all RCP usernames are deleted.
Examples
This example shows how to delete the VMPS RCP username jdoe from the VMPS server table:
Console> (enable) clear vmps rcp jdoeConsole> (enable)Related Commands
clear vmps server
Use the clear vmps server command to delete a VMPS server from the VMPS server table.
clear vmps server ip_addr
Syntax Description
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete a VMPS server from the VMPS table:
Console> (enable) clear vmps server 192.168.255.255VMPS domain server 192.168.255.255 cleared from VMPS table.Console> (enable)This example shows the results of trying to delete a nonexistent VMPS server from the VMPS table:
Console> (enable) clear vmps server 192.168.255.255VMPS domain server 192.168.255.255 not in VMPS table.Console> (enable)Related Commands
clear vmps statistics
Use the clear vmps statistics command to delete existing VMPS client statistics.
clear vmps statistics
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete existing VMPS statistics:
Console> (enable) clear vmps statisticsVMPS and dynamic vlan statistics cleared.Console> (enable)Related Commands
clear vtp pruning
Use the clear vtp pruning command to specify the VLANs in the VTP domain that are ineligible for pruning.
clear vtp pruning vlan_num
Syntax Description
vlan_num
Variable that specifies the number of VLANs to be made ineligible for pruning; valid values are from 1 to 1005.
Defaults
By default, VLANs 2 to 1000 are eligible for pruning.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
VTP pruning prevents traffic in each pruning-eligible VLAN from being transmitted on a VLAN trunk if no stations belonging to that VLAN are located across that trunk. Use the set vtp command to enable VTP pruning.
Use the set vtp pruning command to make the VLANs eligible for pruning again.
Examples
This example shows how to make VLANs 200 to 500 ineligible for pruning:
Console> (enable) clear vtp pruning 200-500Vlans 1,200-500,1001-1005 will not be pruned on this device.VTP domain Company modified.Console> (enable)Related Commands
clear vtp statistics
Use the clear vtp statistics command to delete the VTP statistics.
clear vtp statistics
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default settings.
Command Types
Switch command.
Command Modes
Privileged.
Examples
This example shows how to delete the VTP statistics:
Console> (enable) clear vtp statisticsvtp statistics cleared.Console> (enable)Related Commands
configure
Use the configure command to download a configuration file from a host and run each command in that file.
configure host file [rcp]
Syntax Description
Defaults
By default, the file transfer method is TFTP.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
Refer to the Software Configuration Guide-Catalyst 4000 Family, 2948G, and 2980G Switches for information on how to construct a configuration file to download using the configure command.
Examples
The following is a sample 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.
beginshow timeset ip alias conc7 198.133.219.207set ip alias montreux 198.133.119.42set ip alias cres 192.122.174.42set prompt system5>set password# empty string old passwordpingpongpingpongend#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.cfgConfigure using system5.cfg from 192.122.174.42 (y/n) [n]? y/Done. Finished Network Download. (446 bytes)>> show timeWed Nov 11 1998, 17:42:50>> set ip alias conc7 198.133.219.207IP alias added.>> set ip alias montreux 198.133.219.40IP alias added.>> set ip alias cres 192.122.174.42IP alias added.>> set prompt system5>>> set passwordEnter old password:Enter new password: pingpongRetype new password: pingpongPassword changed.Related Commands
confreg
Use the confreg command to set the configuration register value or to modify the configuration register using the configuration register utility.
confreg [hexvalue]
Syntax Description
Defaults
This command has no default settings.
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, the confreg command 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 > confregConfiguration Summaryenabled are:console baud:9600boot:the ROM Monitordo you wish to change the configuration? y/n [n]: yenable "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]: yenter to boot:0 = ROM Monitor1 = the boot helper image2-15 = boot system[0]: 2Configuration Summaryenabled are:console baud:9600boot:image specified by the boot system commandsor default to:cisco2-Prestodo you wish to change the configuration? y/n [n]:<Return>You must reset or power cycle for new config to take effectrommon 2 >Related Commands
copy
Use the copy command set to upload or download a Flash image or a switch configuration to or from a Flash device, rcp server, or TFTP server.
copy file-id {config | flash | rcp | tftp}
copy config {file-id | flash | rcp| tftp} [all]
copy tftp {file-id | flash | config}
copy rcp {file-id | flash | config}
copy flash {file-id | tftp | rcp | config}
Syntax Description
Defaults
If a source or destination Flash device is not specified, the default Flash device (specified by the cd command) is used. Use the pwd command to display the current default Flash device. If the destination filename is omitted, the system uses the source filename.
When you define a system name using the set system name command, the system stores image and configuration files in the sysname.cfg file; otherwise, it uses the default myswitch.cfg file.
If you do not specify a module for the file-id variable, module 1 is assumed.
Command Types
Switch command.
Command Modes
Privileged.
Usage Guidelines
The Catalyst 4000 family switches support only the bootflash: Flash device.
If you use the flash keyword as the copy source or destination, you are prompted for the Flash device name. If you are copying a software image to multiple intelligent switching modules of the same type, use the flash keyword as the copy destination. The switch automatically determines which modules to copy the image to based on the header in the source image file. If you want to copy a software image to a single intelligent switching module in a switch with multiple modules of the same type, you must specify the destination file-id as m/bootflash: (do not specify a filename).
Examples
This example shows how to upload the non-default switch configuration to a file named cat.cfg on the slot0: Flash device:
Console> (enable) copy config slot0:cat.cfgUpload configuration to slot0:cat.cfg649324 bytes available on device slot0, proceed (y/n) [n]? y........./Configuration has been copied successfully. (10200 bytes)Console> (enable)This example shows how to upload both the default and non-default switch configuration to a file named lab2.cfg on a TFTP server:
Console> (enable) copy config tftp:lab2.cfg allIP address or name of remote host [172.20.22.7]? yUpload configuration to imgFile:lab2.cfg (y/n) [n]? y........./Configuration has been copied successfully. (10299 bytes).Console> (enable)This example shows how to upload the non-default switch configuration to the cat.cfg file on the slot1: Flash device:
Console> (enable) copy config flashFlash device [bootflash]? slot1:Name of file to copy to [configFile]? cat.cfgUpload configuration to slot1:cat.cfg749124 bytes available on device slot1, proceed (y/n) [n]? y........./Configuration has been copied successfully. (200345 bytes).Console> (enable)This example shows how to upload an image from a remote host into Flash using rcp:
Console> (enable) copy rcp flashIP address or name of remote host []? 172.20.52.3Name of file to copy from []? cat5000-sup3.4-2-1.binFlash device [bootflash]?Name of file to copy to [cat5000-sup3.4-2-1.bin]?4369664 bytes available on device bootflash, proceed (y/n) [n]? yCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCFile has been copied successfully.Console> (enable)This example shows how to upload the running configuration on a Catalyst 4000 family, Catalyst 2948G, or Catalyst 2980G switch to an rcp server for storage:
Console> (enable) copy config rcpIP address or name of remote host []? 172.20.52.3Name of file to copy to []? cat5000_config.cfgUpload configuration to rcp:cat5000_config.cfg, (y/n) [n]? y...../Configuration has been copied successfully.Console> (enable)This example shows how to configure a switch using a configuration file downloaded from an rcp server:
Console> (enable) copy rcp configIP address or name of remote host []? 172.20.52.3Name of file to copy from []? dns-config.cfgConfigure using rcp:dns-config.cfg (y/n) [n]? y/Finished network download. (134 bytes)>>>> set ip dns server 172.16.10.70 primary172.16.10.70 added to DNS server table as primary server.>> set ip dns server 172.16.10.140172.16.10.140 added to DNS server table as backup server.>> set ip dns enableDNS is enabled>> set ip dns domain corp.comDefault DNS domain name set to corp.comConsole> (enable)This example shows how to configure the switch using a configuration file on a Flash device:
Console> (enable) copy flash configFlash device [bootflash]?Name of configuration file? test.cfgConfigure using bootflash:test.cfg (y/n) [n]? y/Finished download. (10900 bytes)>> set password $1$FMFQ$HfZR5DUszVHIRhrz4h6V70Password changed.>> set enablepass $1$FMFQ$HfZR5DUszVHIRhrz4h6V70Password changed.>> set prompt Console>>> set length 24 defaultScreen length set to 24.>> set logout 20.....Console> (enable)This example shows how to copy a file from a TFTP server to a Flash device:
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]?yConsole> (enable)Related Commands
