|
|
This chapter describes the clear commands used in the Catalyst 5000 series switch CLI. For a summary of the available switch CLI commands, refer to the "Switch Command Quick Reference" chapter. For more information about using the switch CLI, refer to the "Switch Command-Line Interface" chapter.
Use the clear alias command to clear the shorthand versions of commands.
clear alias {name | all}| name | Alternate identifier of the command. |
| all | Keyword that identifies every alternate identifier previously created. |
This command has no default setting.
Switch command.
Privileged.
This example shows how to erase the arpdel alias:
Console> (enable) clear alias arpdel Command alias deleted. Console> (enable)
This example shows how to erase the all aliases:
Console> (enable) clear alias all Command alias table cleared. (1) Console> (enable)
The (1) indicates the number of command aliases cleared.
Use the clear arp command to delete a specific entry or all entries from the ARP table.
clear arp {ip_addr | all}| ip_addr | Specific IP address in the ARP table to be cleared. An IP alias or host name that can be resolved through the DNS can be specified instead of an IP address. |
| all | Keyword that specifies every IP address in the ARP table. |
This command has no default setting.
Switch command.
Privileged.
This example shows how to remove IP address 198.133.219.209 from the ARP table:
Console> (enable) clear arp 198.133.219.209 ARP entry deleted. Console> (enable)
This example shows how to remove all entries from the ARP table:
Console> (enable) clear arp all ARP table cleared. (1) Console> (enable)
The (1) indicates the number of entries cleared.
Use the clear banner motd command to clear the message-of-the-day banner.
clear banner motdThis command has no arguments or keywords.
This command has no default setting.
Switch command.
Privileged.
This example shows how to clear the message-of-the-day banner:
Console> (enable) clear banner motd MOTD banner cleared Console> (enable)
Use the clear boot command to clear the contents of the BOOT and BOOTLDR environment variables, and the configuration register setting.
clear boot [mod_num]| mod_num | (Optional) Module number of the supervisor engine containing the Flash device. |
Switch command.
Privileged.
This example shows how to use the clear boot command:
Console> (enable) clear boot BOOT variable = Console> (enable)
Use the clear cam command to delete a specific entry or all entries from the CAM table.
clear cam {mac_addr | dynamic | static | permanent} [vlan_num]| mac_addr | One or more MAC addresses. |
| dynamic | Keyword that clears the dynamic CAM entries from the CAM table. |
| static | Keyword that clears the static CAM entries from the CAM table. |
| permanent | Keyword that clears the permanent CAM entries from the CAM table. |
| vlan_num | (Optional) Number of the VLAN. |
This command has no default setting.
Switch command.
Privileged.
This example shows how to remove MAC address 00-40-0b-a0-03-fa from the CAM table:
Console> (enable) clear cam 00-40-0b-a0-03-fa CAM table entry cleared. Console> (enable)
This example shows how to clear dynamic entries from the CAM table:
Console> (enable) clear cam dynamic Dynamic CAM entries cleared. Console> (enable)
Use the clear cgmp statistics command to clear CGMP statistical information.
clear cgmp statisticsThis command has no arguments or keywords.
This command has no default setting.
Switch command.
Privileged.
This example shows how to clear CGMP statistical information:
Console> (enable) clear cgmp statistics CGMP statistics cleared. Console> (enable)
Use the clear config command to clear the system or module configuration information stored in NVRAM.
clear config {mod_num | rmon | all}| mod_num | Number of the module. |
| rmon | Keyword that clears all RMON configurations, including the historyControlTable, the alarmTable, the eventTable, and the ringStation ControlTable. |
| all | Keyword that specifies all modules and system configuration information, including the IP address. |
This command has no default setting.
Switch command.
Privileged.
When using an RSM, clear config clears the portion of the RSM configuration kept by the Catalyst 5000 series switch supervisor engine. The portion of the configuration kept by the RSM must be cleared at the router level (router> prompt).
Before using the clear config all command, save a backup of the configuration.
This example shows how to delete the configuration information in NVRAM on module 2:
Console> (enable) clear config 2 This command will clear module 2 configuration. Do you want to continue (y/n) [n]? y .............................. Module 2 configuration cleared. Console> (enable)
This example shows how to delete the configuration information stored in NVRAM on module 1 (the supervisor module):
Console> (enable) clear config 1 This 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 the configuration information for the entire Catalyst 5000 series switch:
Console> (enable) clear config all This command will clear all configuration in NVRAM. Do you want to continue (y/n) [n]? y ........................................... Connection closed by foreign host host%
Use the clear counters command to clear MAC and port counters.
clear countersThis command has no keywords or arguments.
This command has no default setting.
Switch command.
Privileged.
This command also clears ATM module counters.
This example shows how to reset MAC and port counters to zero:
Console> (enable) clear counters MAC and Port counters cleared. Console> (enable)
Use the clear drip statistics command to clear DRiP statistical information.
clear drip statisticsThis command has no keywords or arguments.
This command has no default setting.
Switch command.
Privileged.
This example shows how to clear DRiP statistical information:
Console> (enable) clear drip statistics DRIP statistics cleared. Console> (enable)
Use the clear igmp statistics command to clear IGMP router port statistical information.
clear igmp statisticsThis command has no arguments or keywords.
This command has no default setting.
Switch command.
Privileged.
This example shows how to clear IGMP statistical information:
Console> (enable) clear igmp statistics IGMP statistics cleared. Console> (enable)
show igmp statistics
Use the clear ip alias command to clear IP aliases set using the set ip alias command.
clear ip alias {name | all}| name | IP address alias to delete. |
| all | Keyword that specifies that all previously set IP addresses aliases be deleted. |
This command has no default setting.
Switch command.
Privileged.
This example shows how to delete a previously defined IP alias named babar:
Console> (enable) clear ip alias babar IP alias deleted. Console> (enable)
Use the clear ip dns domain command to clear the default DNS domain name.
clear ip dns domainThis command has no arguments or keywords.
This command has no default setting.
Switch command.
Privileged.
This example shows how to clear the default DNS domain name:
Console> (enable) clear ip dns domain Default DNS domain name cleared. Console> (enable)
Use the clear ip dns server command to remove a DNS server from the DNS server listing.
clear ip dns server {ip_addr | all}| ip_addr | IP address of the DNS server you want to remove. An IP alias or a host name that can be resolved through DNS can also be used. |
| all | Keyword that specifies all the IP addresses in the DNS server listing to be removed. |
This command has no default setting.
Switch command.
Privileged.
This example shows how to remove the DNS server at IP address 198.92.30.32 from the DNS server listing:
Console> (enable) clear ip dns server 198.92.30.32 198.92.30.32 cleared from DNS table. Console> (enable)
Use the clear ip permit command to remove a specified IP address and mask, or all IP addresses and masks from the permit list.
clear ip permit {ip_addr | all} [mask]| ip_addr | IP address to be cleared. An IP alias or a host name that can be resolved through DNS can also be used. |
| all | Keyword that specifies all entries in the IP permit list to be removed. |
| mask | (Optional) Subnet mask of the specified IP address. |
This command has no default setting.
Switch command.
Privileged.
The clear ip permit all command clears the permit list, but does not change the state of the IP permit feature. A warning is displayed if all IP addresses are cleared 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 clear a specific entry.
These examples show the usage of the clear ip permit command:
Console> (enable) clear ip permit 172.100.101.102 172.100.101.102 cleared from IP permit list. Console> (enable) Console> (enable) clear ip permit 172.160.128.0 255.255.192.0 172.160.128.0 with mask 255.255.192.0 cleared from IP permit list. Console> (enable) Console> (enable) clear ip permit all IP permit list cleared. WARNING!! IP permit list is still enabled. Console> (enable)
set ip permit
show ip permit
show port counters
Use the clear ip route command to delete IP routing table entries.
clear ip route destination gateway| destination | IP address of the host or network. An IP alias or a host name that can be resolved through DNS can also be used. |
| gateway | IP address or alias of the gateway router. |
The default is destination. If the destination is not the active default gateway, the actual destination is the default.
Switch command.
Privileged.
This example shows how to delete the route table entries using the clear ip route command:
Console> (enable) clear ip route 134.12.3.0 elvis Route deleted. Console> (enable)
Use the clear log command to delete system error log entries.
clear log [mod_num]| mod_num | (Optional) Module number for which you want to erase the system error log. |
This command has no default setting.
Switch command.
Privileged.
If you do not specify a module number, the system error log for the entire system is erased.
This example shows how to clear the system error log:
Console> (enable) clear log System error log cleared. Console> (enable)
Use the clear logging buffer command to clear the system logging buffer.
clear logging bufferThis command has no arguments or keywords.
This command has no default setting.
Switch command.
Privileged.
This example shows how to clear the system logging buffer:
Console (enable) clear logging buffer System logging buffer cleared. Console> (enable)
Use the clear logging server command to delete a syslog server from the system log server table.
clear logging server ip_addr| ip_addr | IP address of the syslog server to be deleted. |
This command has no default setting.
Switch command.
Privileged.
This example shows how to delete a syslog server from the configuration:
Console (enable) clear logging server 171.69.192.207 System log server 171.69.192.207 removed from system log server table. Console> (enable)
set logging server
show logging
Use the clear mls command set to clear the MLS feature in the Catalyst 5000 series switch.
clear mls include {{ip_addr} | all}Switch command.
Privileged.
If you enter any of the clear mls commands on a Catalyst 5000 series switch without MLS, the following warning message is displayed:
MLS not supported on feature card.
When you remove an RSM from the Catalyst 5000 series switch, it is immediately removed from the inclusion list and all the NFLS entries for the RSM are removed.
Up to 16 routers can be explicitly included.
To use a router as an NFLS, you must meet the following conditions:
Use the following syntax to specify an IP subnet address:
If you do not use the all argument in the clear mls entry command, you must specify at least one of the other three keywords (source, destination, or flow) and its arguments.
A 0 value for source_port and destination_port clears all entries. Unspecified options are treated as wildcards and all entries are cleared.
This example shows how to disable MLS for the Stargate router (IP address 172.20.15.1):
Console> (enable) clear mls include Stargate Multilayer switching is disabled for router 172.20.15.1 (Stargate) Console>(enable)
This example shows how to clear additional flow information (protocol family and protocol port pair):
Console> (enable) clear mls nde flow Netflow data export filter cleared. Console>(enable)
This example shows how to clear MLS statistics, including: total packets switched and total packets exported (for NDE):
Console> (enable) clear mls statistics
Netflow data export statistics cleared.
Console>(enable)
This example shows how to clear the MLS entries with destination IP address 172.20.26.22:
Console>(enable) clear mls entry destination 172.20.26.22
Multilayer switching entry cleared.
Console>(enable)
This example shows how to clear specific MLS entries for destination IP address 172.20.26.22:
Console>(enable) clear mls destination 172.20.26.22 source 172.20.22.113 flow tcp 520 320
Multilayer switching entry cleared
Console>(enable)
set mls
show mls
show mls statistics
Use the clear multicast router command to clear manually configured multicast router ports from the multicast router port list.
clear multicast router {mod_num/port_num | all}| mod _num | Number of the module. |
| port_num | Number of the port on the module. |
| all | Keyword that specifies all multicast router ports to be cleared. |
The default configuration has no multicast router ports configured.
Switch command.
Privileged.
This example shows how to clear multicast router port 1 on module 3:
Console> (enable) clear multicast router 3/1
Port 3/1 cleared from multicast router port list.
Console> (enable)
set multicast router
show multicast group count
Use the clear ntp server command to remove one or more servers from the NTP server table.
clear ntp server {ip_addr | all}| ip_addr | IP address of the server to remove from the server table. |
| all | Keyword that specifies all server addresses in the server table to be removed. |
The default configuration has no NTP servers configured.
Switch command.
Privileged.
These examples show how to use the clear ntp server command to remove NTP servers from the server table:
Console> (enable) clear ntp server 172.20.22.191 NTP server 172.20.22.191 removed. Console> (enable) Console> (enable) clear ntp server all All NTP servers cleared. Console> (enable)
Use the clear port broadcast command to disable broadcast/multicast suppression on one or more ports.
clear port broadcast mod_num/port_num| mod_num | Number of the module. |
| port_num | Number of the port on the module. |
The default configuration has broadcast/multicast suppression cleared (that is, unlimited broadcast/multicast traffic allowed).
Switch command.
Privileged.
This example shows how to disable broadcast/multicast suppression:
Console> (enable) clear port broadcast 2/1 Broadcast traffic unlimited on ports 2/1. Console> (enable)
Use the clear port filter command to clear MAC address or protocol filters, filters configured on a specific port, or to clear all configured filters.
clear port filter [mod_num/port_num] [mac_addr | protocol_type | all]| mod_num | (Optional) Number of the module. |
| port_num | (Optional) Number of the port on the module. |
| mac_addr | (Optional) MAC address on which the filter that you want to clear is based. This address can be entered in canonical format (00-11-33-44-55) or in noncanonical (00:11:22:33:44:55) format. |
| protocol_type | (Optional) Protocol type on which the filter that you want to clear is based. |
| all | (Optional) Keyword used to specify for all filters to be cleared. |
The command has no default setting.
Switch command.
Privileged.
The following example shows how to clear a MAC address filter (00:40:0b:01:bc:65) configured on port 2 of module 3:
Console> (enable) clear port filter 3/2 00:40:0b:01:bc:65 Port 3/2 filter Mac Address 00:40:0b:01:bc:65 cleared. Console> (enable)
set port filter
show port filter
Use the clear snmp trap command to clear an entry from the SNMP trap receiver table.
clear snmp trap {rcvr_addr | all}| rcvr_addr | IP address or IP alias of the trap receiver (the SNMP management station) to clear. |
| all | Keyword that specifies every entry in the SNMP trap receiver table. |
The default configuration has no entries in the SNMP trap receiver table.
Switch command.
Privileged.
This example shows how to clear an entry from the SNMP trap receiver table:
Console> (enable) clear snmp trap 192.122.173.82 SNMP trap receiver deleted. Console> (enable)
set snmp trap
show port counters
test snmp trap
Use the clear spantree portvlancost command to restore the default path cost to a VLAN on a port.
clear spantree portvlancost mod_num/port_num [vlan_list]| mod_num | Number of the module. |
| port_num | Number of the port. |
| vlan_list | (Optional) List of VLANs to clear. If not specified, all VLANs are cleared. |
This command has no default setting.
Switch command.
Privileged.
These examples show how to restore the default path cost to a VLAN on a port:
Console> (enable) clear spantree portvlancost 2/10 1-10 Port 2/10 VLANs 11-21 have path cost 6 Port 2/10 VLANs 1-10,22-1000 have path cost 10. Console> (enable) Console>(enable) clear spantree portvlancost 2/10 Port 2/10 VLANs 1-1000 have path cost 10. Console> (enable)
set spantree portvlancost
show spantree statistics
Use the clear spantree portvlanpri command to reset the spanning-tree port VLAN priority.
clear spantree portvlanpri mod_num/port_num [vlans]| mod_num | Number of the module. |
| port_num | Number of the port on the module. |
| vlans | (Optional) One or more VLANs. |
This command has no default setting.
Switch command.
Privileged.
This example shows how to reset the spanning-tree port VLAN priority:
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 30 Console> (enable)
set spantree portvlancost
show spantree
Use the clear spantree root command to restore the switch priority and Spanning-Tree Protocol parameters to the factory default values.
clear spantree root [vlan_list]| vlan_list | (Optional) List of the VLAN numbers to clear. |
The default configuration has the switch priority set to 32768.
Switch command.
Privileged.
These examples show how to clear the spantree root:
Console>(enable) clear spantree root 1-20 VLANs 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. Console>(enable) clear spantree root 22,24 VLANs 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)
set spantree root
show spantree
Use the clear spantree statistics command to clear the spanning-tree statistics.
clear spantree statistics [vlan_list]| vlan_list | (Optional) List of the VLAN numbers to clear. |
This command has no defaults.
Switch command.
Privileged.
This example shows how to clear the spanning-tree statistics for VLAN 1:
Console>(enable) clear spantree statistics 1 Cleared all VLAN counters for VLAN 1 Statistics cleared for vlans 1 Console> (enable)
Use the clear spantree uplinkfast command to turn off the uplinkfast feature and return the switch priority and portcosts to the factory default values.
clear spantree uplinkfastThis command has no arguments or keywords.
This command has no defaults.
Switch command.
Privileged.
This command could cause load balancing to be lost in some cases.
This example shows how to turn off the uplinkfast feature and return the switch priority to the factory default values:
Console>(enable) clear spantree uplinkfast This command will cause all portcosts, portvlancosts, and the bridge priority on all vlans to be set to default. Do you want to continue (y/n) [n]? y VLANs 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)
set spantree uplinkfast
show spantree uplinkfast
Use the clear tacacs key command to remove the key setting used for TACACS+ authentication and encryption.
clear tacacs keyThis command has no arguments or keywords.
The default key value is null.
Switch command.
Privileged.
This example shows how to clear the key setting used for authentication and encryption:
Console> (enable) clear tacacs key TACACS server key cleared. Console> (enable)
Use the clear tacacs server command to remove a host from the list of TACACS+ servers.
clear tacacs server ip_addr| ip_addr | IP address of the server to be removed from the list of TACACS+ servers. |
There is no default setting for this command.
Switch command.
Privileged.
This example shows how to remove a server from the list of TACACS+ servers:
Console> (enable) clear tacacs server 170.1.2.20 170.1.2.20 cleared from TACACS table Console> (enable)
Use the clear timezone command to return the time zone to its default, UTC.
clear timezoneThis command has no arguments or keywords.
The default time zone is UTC.
Switch command.
Privileged.
The clear timezone command only functions when NTP is running. If you set the time manually and NTP is disengaged, the clear timezone command has no effect.
This example shows how to clear the time zone:
Console> (enable) clear timezone Timezone name and offset cleared. Console> (enable)
Use the clear top command to stop the TopN process.
clear top {all | report_num}| all | Keyword that stops all nonpending TopN results. |
| report_num | TopN report number to kill. |
This command has no default setting.
Switch command.
Privileged.
The clear top all command will not kill any pending TopN reports. Only the reports with a done status are killed.
You can terminate TopN processes (without the background option; show top background command) by pressing Ctrl-C in the same Telnet/console session, or by entering the clear top [report_num] command from a separate Telnet/console session. The prompt is not printed before the TopN report is completely displayed. Other commands will be blocked until the report has been displayed.
This example shows how to stop the TopN 1 process from a console session:
Console> (enable) clear top 1 12/24/1997,12:05:38:MGMT-5: TopN report 1 killed by Console//. Console> (enable)
This example shows how to stop all nonpending TopN reports:
Console> (enable) clear top all 12/24/1997, 12:07:06:MGMT-5: TopN report 1 killed by Console//. 12/24/1997, 12:07:06:MGMT-5: TopN report 2 killed by Console//. Console> (enable)
This example shows how to stop the TopN 4 process from a Telnet session:
Console> (enable) clear top 4 12/24/1997,12:06:00:MGMT-5: TopN report 4 killed by telnet/172.22.34.2/. Console> (enable)
| mod_num | Number of the module. |
| port_num | Number of the port on the module. |
| vlans | (Optional) One or more VLANs to remove from the allowed VLAN list for the trunk port. |
If you do not specify any VLANs, the mode is set to auto for ISL trunk ports and off for other trunk ports (except ATM LANE trunks, which are always on). For more information about auto and off modes, see the set trunk command.
Switch command.
Privileged.
If you specify VLANs, those VLANs are removed from the list of VLANs allowed on the trunk. Traffic for the removed VLANs are not forwarded over a trunk port. Default VLANs cannot be cleared on the trunk. To add VLANs that you have removed, use the set trunk mod_num/port_num vlan_range command.
This example shows how to clear the VLANs 200 through 500 from the trunk port on port 2 of module 1:
Console> (enable) clear trunk 1/2 200-500 Removing 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 clear the trunk on port 2 of module 1:
Console> (enable) clear trunk 1/2 Port(s) 1/2 trunk mode set to auto. Port(s) 1/2 trunk type set to isl. Console> (enable)
Use the clear vlan command to delete an existing VLAN from a management domain.
clear vlan vlan_num| vlan_num | Number of the VLAN (range is 2 to 1000). |
This command has no default setting.
Switch command.
Privileged.
 Caution
| When you clear a VLAN, depending on the VTP configuration in the network, it might delete the VLAN from the entire VTP domain, which means every switch in the domain could delete that VLAN. If the configured switch is a VTP server and all or some of the other switches in the network are VTP clients, the change propagates to all the clients, for example, those clients will remove the VLAN from their configuration. Servers and transparent switches are unaffected, they keep the VLAN even if it is deleted by another server. |
When you clear a VLAN, all ports assigned to that VLAN become inactive. However, the VLAN assignments of the ports are retained until you move the ports to another VLAN. If the cleared VLAN is reactivated, all ports still configured on that VLAN are also reactivated.
This example shows how to clear an existing VLAN (VLAN 4) from a management domain:
Console> (enable) clear vlan 4 This command will de-activate all ports on vlan 4 in the entire management domain Do you want to continue(y/n) [n]? y VTP: VLAN 4 deletion successful Console> (enable)
Use the clear vmps server command to delete a VMPS server from the VMPS table.
clear vmps server ip_addr| ip_addr | IP address of the VMPS server to be deleted. |
This command has no default setting.
Switch command.
Privileged.
This example shows how to clear a VMPS server from the VMPS table:
Console> (enable) clear vmps server 172.0.0.1 VMPS domain server 172.0.0.1 cleared from VMPS table. Console> (enable)
This example shows the results of trying to clear a nonexistent VMPS server from the VMPS table:
Console> (enable) clear vmps server 182.0.0.1 VMPS domain server 182.0.0.1 not in VMPS table. Console> (enable)
Use the clear vmps statistics command to delete existing VMPS statistics.
clear vmps statisticsThis command has no arguments or keywords.
This command has no default setting.
Switch command.
Privileged.
This example shows how to delete existing VMPS statistics:
Console> (enable) clear vmps statistics VMPS and dynamic vlan statistics cleared. Console> (enable)
Use the clear vtp pruneeligible command to specify which VLANs in the VTP domain are ineligible for pruning.
clear vtp pruneeligible vlan_num| vlan_num | Number of VLANs to make pruning ineligible. |
By default, VLANs 2 through 1000 are eligible for pruning.
Switch command.
Privileged.
VTP pruning causes information about each pruning eligible VLAN to be removed from VTP updates if there are no stations belonging to that VLAN out a particular switch port. Use the set vtp command to enable VTP pruning.
By default, VLANs 2 through 1000 are pruning eligible. Use the clear vtp pruneeligible command to make VLANs pruning ineligible.
If VLANs have been made pruning ineligble, use the set vtp pruneeligible command to make the the VLANs pruning eligible again.
This example shows how to make VLANs 200 through 500 pruning ineligibile:
Console> (enable) clear vtp pruneeligible 200-500 Vlans 1,200-500,1001-1005 will not be pruned on this device. VTP domain Company modified. Console> (enable)
set vtp
set vtp pruneeligible
show vtp domain
Use the clear vtp statistics command to delete the VTP statistics.
clear vtp statisticsThis command has no arguments or keywords.
This command has no default setting.
Switch command.
Privileged.
This example shows how to clear the VTP statistics:
Console> (enable) clear vtp statistics vtp statistics cleared. Console> (enable)
|
|