|
|
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.
Other commands are described elsewhere in this publication:
Switch CLI:
ATM module CLI:
Use the clear alias command to clear the shorthand versions of commands.
clear alias {name | all}| name | Identifies the 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) 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 and how to remove all entries from the ARP table:
Console> (enable) clear arp 198.133.219.209 ARP entry deleted. 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 | Module number of the supervisor engine containing the Flash device. |
Switch command.
Normal.
This example shows how to use the clear boot command:
Console> clear boot BOOT variable = Console>
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.
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 to be cleared. |
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).
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 does not clear counters for the ATM module.
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 ip alias command to clear IP aliases set using the set ip alias command.
clear ip alias {name | all}| name | Identifies a specific alias for an IP address to delete. |
| all | Specifies that all previously set aliases of IP addresses 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) Specifies the 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.
This example shows 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) 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) 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 | all}| 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. |
| all | Keyword that specifies every entry in the IP routing table to be deleted. |
This command has no default setting.
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) clear ip route all All routes deleted. Console> (enable)
Use the clear log command to delete system error log entries.
clear log [mod_num]| mod_num | (Optional) Specifies the number of the module 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:
Consoleclear 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:
Consoleclear 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 multicast router command to clear 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.
This example shows 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) 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 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.
This example shows 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) clear spantree portvlancost 2/10 Port 2/10 VLANs 1-1000 have path cost 10.
set spantree portvlancost
show spantree portvlancost
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
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 bridge priority set to 32768.
Switch command.
Privileged.
This example shows how to clear the spantree root:
console>(enable) clear spantree 1-20 root 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.
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
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 uplinkfastNone.
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.
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 trunk command to reset trunk ports to bridge ports or to clear partial information in the trunk table.
clear trunk 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. |
If VLANs are specified, they are removed from the list of allowed VLANs on the trunk. If you do not specify a VLAN range, the mode is set to auto for DISL trunk ports and off for other trunk ports. Refer to the set trunk command for more information about auto and off modes.
Switch command.
Privileged.
If VLANs are specified, only the specified VLANs are cleared from the trunk port table. Default VLANs cannot be cleared on the trunk.
This example shows how to clear the trunk for module 1, port 2:
Console> (enable) clear trunk 1/2 2-4 Vlan(s) 2-4 cleared from port 1/2. Console> (enable) clear trunk 1/2 Port 1/2 mode set to auto. 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.
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 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
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) clear vmps server 182.0.0.1 VMPS domain server 182.0.0.1 not in VMPS table.
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 turn off a VLAN's pruning eligibility.
clear vtp pruneeligible vlan_num| vlan_num | Number of the VLANs for which to turn off pruning eligibility. |
The pruning function is disabled by default.
Switch command.
Privileged.
This example shows how to turn off pruning eligibility for a number of VLANs:
Console> (enable) clear vtp pruneeligible 2,3,6-8,100-200 Vlans 1-3,6-8,100-200 will not be pruned on this device. Console> (enable)
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)
|
|