|
|
Use the set spantree uplinkfast command to enable fast switchover to alternate ports when the root port fails. This command applies to a switch, not to a WAN.
set spantree uplinkfast enable [rate station_update_rate] [all-protocols {off | on}]
enable | Keyword to enable a fast switchover. |
rate | (Optional) Keyword to specify the number of multicast packets transmitted per 100 ms when an alternate port is chosen after the root port goes down. |
station_update_rate | (Optional) Number of multicast packets transmitted per 100 ms when an alternate port is chosen after the root port goes down. |
all-protocols | (Optional) Keyword to specify whether the switch generates dummy multicast packets for all protocol groups (IP, IPX, and Group) in a network with switches using protocol filtering. |
off | (Optional) Keyword to prevent the switch from generating multicasts for all protocol groups. |
on | (Optional) Keyword to cause the switch to generate multicasts for all protocol groups. |
disable | Keyword to disable fast switchover. |
The default station_update_rate is 15 packets per 100 ms.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
The set spantree uplinkfast enable command has the following results:
If you run set spantree uplinkfast enable on a switch that has this feature already enabled, only the station update rate is updated. The rest of the parameters are not modified.
If you run set spantree uplinkfast disable on a switch, the UplinkFast feature is disabled but the switch priority and port cost values are not reset to the factory defaults. To reset the values to the factory defaults, enter the clear spantree uplinkfast command.
The default station_update_rate value is 15 packets per 100 ms, which is equivalent to a 1 percent load on a 10-Mbps Ethernet port. If you specify this value as 0, the switch does not generate station-update-rate packets.
Use the all-protocols on keywords on switches that have UplinkFast enabled but do not have protocol filtering enabled, and that are connected to upstream switches in the network that have protocol filtering enabled. The all-protocols on keywords cause the switch to generate multicasts for each protocol-filtering group.
On switches with both UplinkFast and protocol filtering enabled, or if no other switches have protocol filtering enabled, you do not need to use the all-protocols on keywords.
This example shows how to enable the spantree UplinkFast feature and specify the number of multicast packets transmitted to 40 packets per 100 ms:
Console>(enable) set spantree uplinkfast enable rate 40 VLANs 1-1000 bridge priority set to 49152. The port cost and portvlancost of all ports increased to above 3000. Station update rate set to 40 packets/100ms. uplinkfast turned on for bridge. Console> (enable)
This example shows how to disable the spantree UplinkFast feature:
console> (enable) set spantree uplinkfast disable Uplinkfast disabled for switch. Use clear spantree uplinkfast to return stp parameters to default. console>(enable) clear spantree uplink 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)
This example shows how to enable the all-protocols feature:
Console> (enable) set spantree uplinkfast enable all-protocols on uplinkfast update packets enabled for all protocols. uplinkfast already enabled for bridge.
This example shows how to disable the all-protocols feature:
Console> (enable) set spantree uplinkfast enable all-protocols off uplinkfast all-protocols field set to off. uplinkfast already enabled for bridge. Console> (enable)
show spantree
clear spantree uplinkfast
Use the set standbyports command to enable or disable the standby ports feature. The standby ports feature allows the ports on the standby supervisor engine module to pass traffic. If this feature is disabled, the ports are in standby mode.
set standbyports enable | disable
enable | Keyword to enable the standby ports feature. |
disable | Keyword to disable the standby ports feature. |
The default is disabled. However, if upgrading from supervisor engine software release 4.1 or 4.2, the standby ports feature remains enabled.
Catalyst 5000 family switches
Switch command.
Privileged.
This example shows how to enable the standby ports feature:
Console> (enable) set standbyports enable Standby ports feature enabled. Please wait while the standby ports are coming up. Console> (enable)
This example shows how to disable the standby ports feature:
Console> (enable) set standbyports disable Standby ports feature disabled. Console> (enable)
Use the set summertime command to specify whether the system should set the clock ahead one hour during daylight saving time.
set summertime {enable | disable} [zone]
enable | Keyword to cause the system to set the clock ahead one hour during daylight saving time. |
disable | Keyword to prevent the system from setting the clock ahead one hour during daylight saving time. |
zone | (Optional) Time zone used by the set summertime command. |
By default, the set summertime command is disabled.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
This command advances the clock one hour at 2:00 a.m. on the first Sunday in April and moves back the clock one hour at 2:00 a.m. on the last Sunday in October.
This example shows how to cause the system to set the clock ahead one hour during daylight saving time:
Console> (enable) set summertime enable PDT Summertime is enabled and set to "PDT". Console> (enable)
This example shows how to prevent the system from setting the clock ahead one hour during daylight saving time:
Console> (enable) set summertime disable Summertime disabled. Console> (enable)
Use the set system baud command to set the console port baud rate.
set system baud rate
rate | Baud rate. Valid rates are 600, 1200, 2400, 4800, 9600, 19200, and 38400. |
The default value is 9600 baud.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
This example shows how to set the system baud rate to 19200:
Console> (enable) set system baud 19200 System console port baud rate set to 19200. Console> (enable)
Use the set system contact command to identify a contact person for the system.
set system contact [contact_string]
contact_string | (Optional) Text string that contains the name of the person to contact for system administration. If no contact string is specified, the system contact string is cleared. |
The default configuration has no system contact configured.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
This example shows how to set the system contact string:
Console> (enable) set system contact Xena ext.24 System contact set. Console> (enable)
Use the set system location command to identify the location of the system.
set system location [location_string]
location_string | (Optional) Text string that indicates where the system is located. If no location string is specified, the system location is cleared. |
This command has no default setting.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
This example shows how to set the system location string:
Console> (enable) set system location Closet 230 4/F System location set. Console> (enable)
Use the set system modem command to enable or disable modem control lines on the console port.
set system modem {enable | disable}
enable | Keyword to activate modem control lines on the console port. |
disable | Keyword to deactivate modem control lines on the console port. |
The default configuration has modem control lines disabled.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
This example shows how to enable modem control lines on the console port:
Console> (enable) set system modem enable Modem control lines enabled on console port. Console> (enable)
This example shows how to disable modem control lines on the console port:
Console> (enable) set system modem disable Modem control lines disabled on console port. Console> (enable)
Use the set system name command to configure a name for the system.
set system name [name_string]
name_string | (Optional) Text string that identifies the system. |
The default configuration has no system name configured.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
In Catalyst 5000 family and 2926G series software release 4.1(1) and later, and Catalyst 4000 family and 2948G software release 4.4 and later, if you use the set system name command to assign a name to the switch, the switch name is used as the prompt string. However, if you specify a different prompt string using the set prompt command, that string is used for the prompt. If no name is specified, the system name is cleared.
In Catalyst 5000 family and 2926G series software release 4.1(1) and later, if you do not specify a system name, the system name is cleared, and a DNS lookup is initiated for a system name. If a name is found, that is the name used; if no name is found, no name is designated.
The system name can be 255 characters long, and the prompt can be 20 characters long. The system name is truncated appropriately when used as a prompt; a greater-than symbol (>) is appended to the truncated system name. If the system name was found from a DNS lookup, it is truncated to remove the domain name. If the prompt is obtained using the system name, it is updated whenever the system name changes. You can overwrite this prompt any time by setting the prompt manually. Any change in the prompt is reflected in all current open sessions.
This example shows how to set the system name to Information Systems:
Console> (enable) set system name Information Systems System name set. Console> (enable)
Use the set tacacs attempts command to configure the maximum number of login attempts allowed to the TACACS+ server.
set tacacs attempts count
count | Number of login attempts allowed (1 to 10). |
The default value for this command is 3.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
This example shows how to configure the TACACS+ server to allow a maximum of six login attempts:
Console> (enable) set tacacs attempts 6 Tacacs number of attempts set to 6. Console> (enable)
Use the set tacacs directedrequest command to enable or disable the TACACS+ directed-request option. When enabled, you can direct a request to any of the configured TACACS+ servers and only the username is sent to the specified server.
set tacacs directedrequest {enable | disable}
enable | Keyword to send the portion of the address before the @ sign (the username) to the host specified after the @ sign. |
disable | Keyword to send the entire address string to the default TACACS+ server. |
This default configuration has the TACACS+ directed-request option disabled.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
When tacacs directedrequest is enabled, you must specify a configured TACACS+ server after the @ sign. If the specified host name does not match the IP address of a configured TACACS+ server, the request is rejected. When tacacs directedrequest is disabled, the Catalyst 5000 family, 4000 family, and 2926G series, 2948G switch queries the list of servers beginning with the first server in the list and then sends the entire string, accepting the first response from the server. This command is useful for sites that have developed their own TACACS+ server software to parse the entire address string and make decisions based on the contents of the string.
This example shows how to enable the tacacs directedrequest option:
Console> (enable) set tacacs directedrequest enable Tacacs direct request has been enabled. Console> (enable)
Use the set tacacs key command to set the key for TACACS+ authentication and encryption.
set tacacs key key
key | Printable ASCII characters used for authentication and encryption. Key length is limited to 100 characters. |
The default value of key is null.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
The key must be the same as the key used on the TACACS+ server. All leading spaces are ignored. Spaces within the key and at the end of the key are included. Double quotation marks are not required, even if there are spaces between words in the key, unless the quotation marks themselves are part of the key. The key can consist of any printable ASCII characters except the tab character.
This example shows how to set the authentication and encryption key:
Console> (enable) set tacacs key Who Goes There The tacacs key has been set to Who Goes There. Console> (enable)
Use the set tacacs server command to define a TACACS+ server.
set tacacs server ip_addr [primary]
ip_addr | IP address of the server on which the TACACS+ server resides. |
primary | (Optional) Keyword to designate the specified server as the primary TACACS+ server. |
There is no default setting for this command.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
You can configure a maximum of three servers. The primary server, if configured, is contacted first. If no primary server is configured, the first server configured becomes the primary server.
This example shows how to configure the server on which the TACACS+ server resides and to designate it as the primary server:
Console> (enable) set tacacs server 170.1.2.20 primary 170.1.2.20 added to TACACS server table as primary server. Console> (enable)
clear tacacs server
show tacacs
Use the set tacacs timeout command to set the response timeout interval for the TACACS+ server daemon. The TACACS+ server must respond to a TACACS+ authentication request before this interval expires or the next configured server is queried.
set tacacs timeout seconds
seconds | Timeout response interval in seconds (1 to 255). |
The default value for this command is 5 seconds.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
This example shows how to set the response timeout interval for the TACACS+ server to 8 seconds:
Console> (enable) set tacacs timeout 8 Tacacs timeout set to 8 seconds. Console> (enable)
Use the set time command to change the time of day on the system clock.
set time [day_of_week] [mm/dd/yy] [hh:mm:ss]
day_of_week | (Optional) Day of the week. |
mm/dd/yy | (Optional) Month, day, and year. |
hh:mm:ss | (Optional) Current time in 24-hour format. |
This command has no default setting.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
This example shows how to set the system clock to Sunday, March 21, 1999, 7:50 a.m:
Console> (enable) set time sun 3/21/99 7:50 Sun Mar 21 1999, 07:50:00 Console> (enable)
Use the set timezone command to set the time zone for the system.
set timezone [zone_name] [hours [minutes]]
zone_name | (Optional) Name of the time zone to be displayed. |
hours | (Optional) Number of hours offset from UTC; valid values are -12 to 12. |
minutes | (Optional) Number of minutes offset from UTC. If the specified hours value is a negative number, then the minutes value is assumed to be negative as well; valid values are 0 to 59. |
By default, the time zone is set to UTC.
Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch
Switch command.
Privileged.
The set timezone command is effective only when NTP is running. If you set the time explicitly and NTP is disengaged, the set timezone command has no effect. If you have enabled NTP and have not entered the set timezone command, the Catalyst 5000 family, 4000 family, 2926G series, and 2948G switch displays UTC by default.
This example shows how to set the time zone to Pacific Standard Time with an offset of minus 8 hours from UTC:
Console> (enable) set timezone PST -8 Timezone set to "PST", offset from UTC is -8 hours. Console> (enable)
Use the set tokenring acbits command to specify whether AC bits are set unconditionally or conditionally when a port forwards certain LLC frames.
set tokenring acbits mod_num/port_num {enable | disable | sronly | never | always}
mod_num | Number of the module. |
port_num | Number of the port on the module. |
enable | Keyword used to unconditionally set the AC bits on source-routed frames with a RIF length greater than 2 and on all explorer frames in addition to setting the AC bits on all frames forwarded to another port. This parameter is only valid when local address learning is enabled on a port. Therefore, specifying enable automatically enables local address learning on the port. |
disable | Keyword used to specify that the AC bits to be set based exclusively on whether the frame is forwarded to another port. This parameter is only valid when local address learning is enabled on a port. Therefore, specifying disable automatically enables local address learning on the port. |
sronly | Keyword used to specify that the AC bits to be set only on source-routed frames with a RIF length greater than 2 and on all explorer frames. |
never | Keyword used to specify that the AC bits to never be set on LLC frames. This parameter is only valid when local address learning is disabled on the port. Therefore, specifying never automatically disables local address learning on the port. |
always | Keyword used to specify that the AC bits to always be set on LLC frames. This parameter is only valid when local address learning is disabled on a port. Therefore, specifying always automatically disables local address learning on the port. |
The default configuration when local address learning is enabled on a Token Ring port, the default is disable. When local address learning is disabled on a Token Ring port, the default is always.
Catalyst 5000 family switches
Switch command.
Privileged.
You can use the set tokenring acbits command to specify whether the AC bits should be set unconditionally on repeated source-routed LLC frames, which include source-routed frames with a RIF length greater than two and all Spanning-Tree Explorer and All-Routes Explorer frames.
If you set this parameter to disable, the setting of these bits is based on whether the frame was actually forwarded.
This example shows port 4 on module 4 is enabled to set unconditionally the AC bits when forwarding certain LLC frames:
Console> (enable) set tokenring acbits 4/4 enable Port 4/4 acbits enabled. Console> (enable)
This example shows port 4 on module 4 is disabled to set conditionally the AC bits when forwarding certain LLC frames:
Console> (enable) set tokenring acbits 4/4 disable Port 4/4 acbits disabled. Console> (enable)
This example shows how to set the AC bits to always be set on LLC frames on port 2 on module 3:
Console> (enable) set tokenring acbits 3/2 always Warning: Disable Local learning: 3/2 Port 3/2 acbits always Console> (enable)
Use the set tokenring configloss command to specify thresholds that, when exceeded during the user-specified interval, cause the port to be administratively disabled.
set tokenring configloss mod_num/port_num [threshold thresh_num] [interval int_num]
mod_num | Number of the module. |
port_num | Number of the port on the module. |
threshold | (Optional) Keyword to set the threshold for configuration losses. |
thresh_num | Valid values are 1 to 100; the default is 8. |
interval | (Optional) Keyword to set the interval at which the configuration loss is measured. |
int_num | Valid values are 1 to 99 minutes; the default is 10. |
The default threshold configuration is 8; the default interval is 10.
Catalyst 5000 family switches
Switch command.
Privileged.
Configuration loss occurs when a port completes a connection, allows data traffic to flow, and subsequently closes. The configuration loss threshold is used to control the number of configuration losses that can occur within a specified time. When the threshold is exceeded, the port is disabled and you must enable it by using the set port enable command or an SNMP manager.
The following example shows how to set a configuration loss threshold of 25 and an interval of 5 minutes for port 1 on module 4:
Console> (enable) set tokenring configloss 4/1 threshold 25 interval 5 Port 4/1 configloss threshold set to 25, interval set to 5. Console> (enable)
Use the set tokenring distrib-crf command to enable or disable distribution of TrCRF VLANs.
set tokenring distrib-crf {enable | disable}
enable | Keyword to enable distribution of TrCRF VLANs. |
disable | Keyword to disable distribution of TrCRF VLANs. |
This command has no default settings.
Catalyst 5000 family switches
Switch command.
Privileged.
This example shows how to enable distribution of TrCRF VLANs:
Console> (enable) set tokenring distrib-crf enable
This example shows how to disable distribution of TrCRF VLANs:
Console> (enable) set tokenring distrib-crf disable
Use the set tokenring etr command to enable or disable a Token Ring port's use of the early token release procedure when transmitting frames.
set tokenring etr mod_num/port_num {enable | disable}
mod_num | Number of the module. |
port_num | Number of the port on the module. |
enable | disable | Keyword to specify that early token release should be used (enable) or not used (disable) when transmitting frames. |
For 16-Mbps and autospeed-detection ports, the default configuration is to enable early token release.
Catalyst 5000 family switches
Switch command.
Privileged.
You cannot enable early token release for 4-Mbps ports. Enabling or disabling early token release on a port causes the port to close and reopen.
This example shows how to enable early token release on port 2 on module 3:
Console> (enable) set tokenring etr 3/2 enable Port 3/2 Early Token Release enabled. Console> (enable)
This example shows how to disable early token release on port 2 on module 3:
Console> (enable) set tokenring etr 3/2 disable Port 3/2 Early Token Release disabled. Console> (enable)
Use the set tokenring explorer-throttle command to control the number of incoming explorer frames per second allowed on a Token Ring module port.
set tokenring explorer-throttle mod_num/port_num maximum_explorers
mod_num | Module number. |
port_num | Port number. |
maximum_explorers | Maximum number of incoming explorer frames per second allowed on the specified Token Ring port. |
The default is 0, no explorer frame throttling.
Catalyst 5000 family
Switch command.
Privileged.
This command requires Token Ring module software release 3.2(3) or later.
To disable explorer frame throttling, set the maximum_explorers value to 0.
If the configured threshold is reached, any subsequent explorer frames received on the port are dropped until the next one-second window.
Use the set tokenring locallearning command to enable or disable local MAC address learning on a Token Ring port.
set tokenring locallearning mod_num/port_num enable | disable
mod_num | Number of the module. |
port_num | Number of the port on the module. |
enable | disable | Keyword to specify whether local MAC address learning is enabled or disabled. |
The default is for local address learning to be enabled.
Catalyst 5000 family switches
Switch command.
Privileged.
When local address learning is enabled on a Token Ring port, the value of the address recognized AC bits in LLC frames is set by the ports based on whether the frame was actually forwarded. However, when local address learning is disabled, the AC bits cannot be set by the ports based on whether the frame was forwarded because all frames are forwarded to the Catalyst 5000 family switching backplane. Therefore, when local address learning is disabled on a Token Ring port, the AC bits must be set based on the type of frame that has been received. You can configure how the AC bits are set using the set tokenring acbits command.
When local address learning is disabled on a port, the port aging limits configured using the set tokenring portaging command are not used.
This example shows how to disable local address learning:
Console> (enable) set tokenring locallearning 3/2 disable Warning: Resetting acbit value to ALWAYS: 3/2 Local learning disabled for port 3/2 Console> (enable)
Use the set tokenring portaging command to specify the address aging limits for a Token Ring port.
set tokenring portaging mod_num/port_num agingtime
mod_num | Number of the module. |
port_num | Number of the port on the module. |
agingtime | Number of seconds a MAC address remains in the port's address table; valid values are 0 and 5 through 65535 seconds. |
The default is 0 seconds.
Catalyst 5000 family switches
Switch command.
Privileged.
An agingtime of 0 indicates the Token Ring module port address table entries are aged out using the CAM aging time for the corresponding VLAN that has been configured using the
set cam agingtime command.
This example shows how to define the address aging limits for Token Ring port on port 2 on module 3:
Console> (enable) set tokenring portaging 3/2 10 Agingtime set to 10 sec for port 3/2 Console> (enable)
Use the set tokenring portmode command to specify the connection type and access protocol used by a port.
set tokenring portmode mod_num/port_num {auto | fdxcport | hdxcport | fdxstation |
mod_num | Number of the module. |
port_num | Number of the port on the module. |
auto | Keyword to set the port to detect the connection mode. |
fdxcport | Keyword to set the port to operate as a concentrator port in full-duplex mode. |
hdxcport | Keyword to set the port to operate as a concentrator port in half-duplex mode. |
fdxstation | Keyword to set the port to operate as a station in full-duplex mode. |
hdxstation | Keyword to set the port to operate as a station in half-duplex mode. |
riro | Parameter applicable to fiber-optic modules only. |
The default configuration has the port detect the mode of connection.
Catalyst 5000 family switches
Switch command.
Privileged.
This example shows how to set the port mode to autosensing on port 1 on module 4:
Console> (enable) set tokenring portmode 4/1 auto Port 4/1 mode set to auto. Console> (enable)
This example shows how to set port2 on module 4 to operate as a concentrator port in full-duplex mode:
Console> (enable) set tokenring portmode 4/2 fdxcport Port 4/2 mode set to fdxcport. Console> (enable)
Use the set tokenring priority command to specify the highest Token Ring frame priority that will go to the low-priority transmit queue and the minimum Token Ring frame priority that is used when requesting a token.
set tokenring priority mod_num/port_num {threshold thresh_num | minxmit min_num}
mod_num | Number of the module. |
port_num | Number of the port on the module. |
threshold | Keyword to specify the priority queue threshold. |
thresh_num | Valid values are 0 to 7; the default is 3. |
minxmit | Keyword to specify the minimum frame priority to be used. |
min_num | Valid values are 0 to 6; the default is 4. |
The default configuration for threshold is 3. The default configuration for minxmit is 4.
Catalyst 5000 family switches
Switch command.
Privileged.
This example shows how to set the priority threshold levels on port 2 on module 4:
Console> (enable) set tokenring priority 4/2 threshold 6
Port 2 priority threshold set to 6.
Console> (enable)
This example shows how to set the minimum priority levels on port 2 on module 4:
Console> (enable) set tokenring priority 4/2 minxmit 5 Port 2 priority minxmit set to 5. Console> (enable)
Posted: Mon Oct 4 14:02:56 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.