Catalyst 5000 Family Command Reference (6.3 and 6.4)
set tokenring portaging through show accounting

Table Of Contents

set tokenring priority

set tokenring reduction

set traffic monitor

set trunk

set udld

set udld aggressive-mode

set udld interval

set vlan

set vlan mapping

set vmps downloadmethod

set vmps downloadserver

set vmps server

set vmps state

set vtp

set vtp pruneeligible

show accounting

show alias


2

set tokenring priority

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/port {threshold thresh_num | minxmit min_num}

Syntax Description

mod/port

Number of the module and the port on the module.

threshold thresh_num

Keyword and variable to specify the priority queue threshold; valid values are from 0 to 7.

minxmit min_num

Keyword and variable to specify the minimum frame priority to be used; valid values are from 0 to 6.


Defaults

The default thresh_num is 3 and the default min_num is 4.

Command Types

Switch command.

Command Modes

Privileged.

Examples

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)

Related Commands

show tokenring

set tokenring reduction

Use the set tokenring reduction command to reduce broadcast storms in an externally looped network.

set tokenring reduction {enable | disable}

Syntax Description

enable | disable

Keyword to turn broadcast reduction on (enable) or off (disable).


Defaults

The default configuration is enabled.

Command Types

Switch command.

Command Modes

Privileged.

Examples

The following example shows how to enable All-Routes Explorer reduction:

Console> (enable) set tokenring reduction enable
Tokenring reduction enabled
Console> (enable)

The following example shows how to disable All-Routes Explorer reduction:

Console> (enable) set tokenring reduction disable
Tokenring reduction disabled
Console> (enable)

Related Commands

show tokenring

set traffic monitor

Use the set traffic monitor command to configure the threshold at which a high traffic log will be generated.

set traffic monitor threshold

Syntax Description

threshold

0 to 100 percent.


Defaults

The default threshold is 100 percent. No high traffic log is created.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If backplane traffic exceeds the threshold configured by the set traffic monitor command, a high traffic log is created. If the threshold is set to 100 percent, no high-traffic system warning is generated.

Examples

This example shows how to set the high traffic threshold to 80 percent:

Console> (enable) set traffic monitor 80
Traffic monitoring threshold set to 80%.
Console> (enable) 

Related Commands

show traffic

set trunk

Use the set trunk command to configure trunk ports and to add VLANs to the allowed VLAN list for existing trunks.

set trunk mod/port [on | off | desirable | auto | nonegotiate] [vlan_range] [isl | dot1q dot10 | lane | negotiate]

Syntax Description

mod/port

Number of the module and the port on the module.

on

(Optional) Keyword to force the port to become a trunk port and persuade the neighboring port to become a trunk port. The port becomes a trunk port even if the neighbor port does not agree to become a trunk. This is the only possible mode for ATM ports.

off

(Optional) Keyword to force a port to become a nontrunk port and persuade the neighboring port to become a nontrunk port. The port becomes a nontrunk port even if the neighbor port does not agree to become a nontrunk port. This is the default mode for FDDI trunks. This option is not allowed for ATM ports.

desirable

(Optional) Keyword to specify a port negotiate actively with the neighbor port to become a trunk link. This mode is not allowed on FDDI and ATM ports.

auto

(Optional) Keyword to cause the port to become a trunk port if the neighboring port tries to negotiate a trunk link. This mode is not allowed on FDDI and ATM ports. This is the default mode for Fast Ethernet and Gigabit Ethernet ports.

nonegotiate

(Optional) Keyword to force the port to become a trunk port but prevent it from sending DTP frames to its neighbor. This mode is only allowed on ISL and IEEE 802.1Q trunks.

vlan_range

(Optional) VLANs to add to the list of allowed VLANs on the trunk. The VLAN range is from 1 to 1005.

isl

(Optional) Keyword to specify an ISL trunk on an Ethernet port.

dot1q

(Optional) Keyword to specify an IEEE 802.1Q trunk on an Ethernet port. IEEE 802.1Q trunks are supported in Catalyst 5000 family software release 4.1(1) and later with 802.1Q-capable hardware. Automatic negotiation of 802.1Q trunks is supported in software release 4.2(1) and later. In software release 4.1, you must use the nonegotiate mode with 802.1Q trunks.

dot10

(Optional) Keyword to specify an IEEE 802.10 trunk on a FDDI or CDDI port.

lane

(Optional) Keyword to specify an ATM LANE trunk on an ATM port.

negotiate

(Optional) Keyword to specify that the port become an ISL (preferred) or 802.1Q trunk, depending on the configuration and capabilities of the neighboring port.


Defaults

All ports except ATM LANE ports are nontrunk ports by default. ATM LANE and RSM ports are always configured as trunk ports.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Trunking capabilities are hardware dependent. Refer to the Catalyst 5000 Family Module Installation Guide to determine the trunking capabilities of your hardware, or enter the show port capabilities command.

The Catalyst 5000 family switches use the DTP (formerly known as DISL) to negotiate trunk links automatically on Fast Ethernet and Gigabit Ethernet ports. Whether a port will negotiate to become a trunk port depends on both the mode and the trunk type specified for that port. Refer to the Software Configuration Guide for your switch for detailed information on how trunk ports are negotiated.

DTP is a point-to-point protocol. However, some internetworking devices might improperly forward DTP frames. You can avoid this problem by ensuring that trunking is turned off on ports connected to non-Catalyst 5000 family devices if you do not intend to trunk across those links. When enabling trunking on a link to a Cisco router, enter the nonegotiate keyword to cause the port to become a trunk but not generate DTP frames. The nonegotiate keyword is available in Catalyst 5000 family software release 2.4(3) and later.

For trunking to be negotiated on Fast Ethernet and Gigabit Ethernet ports, the ports must be in the same VTP domain. However, you can use the on or nonegotiate mode to force a port to become a trunk, even if it is in a different domain.

To remove VLANs from the allowed list for a trunk, enter the clear trunk mod/port vlan_range command. When you first configure a port as a trunk, the set trunk command always adds all VLANs to the allowed VLAN list for the trunk, even if you specify a VLAN range (the specified VLAN range is ignored).

To remove VLANs from the allowed list, enter the clear trunk mod/port vlan_range command. To later add VLANs that were removed, enter the set trunk mod/port vlan_range command.

If you do not enter a trunk-type keyword, the value is unchanged from the previous configuration.

You cannot change the allowed VLAN range on the RSM port.

The RSM port can be configured only as an IEEE 802.1Q-type trunk.

To return a trunk to its default trunk type and mode, enter the clear trunk mod/port command.

If you enter the set trunk command on a Token Ring port, you receive a message indicating that the port is "not a trunk-capable port."

When a port is in trunking mode, the jumbo frame feature is automatically enabled on that port. When the port is not in trunking mode, the jumbo frame setting on that port returns to the original setting you have set. If you try to the disable jumbo frame feature on a trunk port, the port continues to pass jumbo frames until trunking is turned off.

Examples

This example shows how to set port 2 on module 1 as a trunk port:

Console> (enable) set trunk 1/2 on
Port(s) 1/2 trunk mode set to on.
Console> (enable)

This example shows how to set port 2 on module 1 as a non-trunk port:

Console> (enable) set trunk 1/2 off
Port(s)  1/2 trunk mode set to off.
Console> (enable) 

This example shows how to set port 2 on module 1 as a preferred trunk port:

Console> (enable) set trunk 1/2 desirable 
Port(s)  1/2 trunk mode set to desirable.
Console> (enable) 2000 Jan 11 09:16:29 %DTP-5-TRUNKPORTON:Port 1/2 has become ik

This example shows how to add VLANs 5 through 50 to the allowed VLAN list for a trunk port (VLANs were previously removed from the allowed list with the clear trunk command):

Console> (enable) set trunk 1/1 5-50
Adding vlans 5-50 to allowed list.
Port(s) 1/1 allowed vlans modified to 1,5-50,101-1005.
Console> (enable)

This example shows how to set port 5 on module 4 as an 802.1Q trunk port in desirable mode:

Console> (enable) set trunk 4/5 desirable dot1q
Port(s) 4/5 trunk mode set to desirable.
Port(s) 4/5 trunk type set to dot1q.
Console> (enable)

This example shows how to set port 1 on module 1 as an ISL trunk port:

Console> (enable) set trunk 1/1 isl      
Port(s)  1/1 trunk type set to isl.
Console> (enable) 

Related Commands

clear trunk
set vtp
show trunk
show vtp statistics

set udld

Use the set udld command to enable or disable the UDLD feature on specified ports or globally on all ports.

set udld enable | disable mod/ports

Syntax Description

enable

Keyword to enable the UDLD feature.

disable

Keyword to disable the UDLD feature.

mod/ports

Number of the module and the ports on the module.


Defaults

The default is UDLD is globally disabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Whenever a unidirectional connection is detected, UDLD displays a syslog message to notify you and the network management application (via SNMP) that the port on which the misconfiguration has been detected has been disabled.

If you enter the global set udld enable or disable command, UDLD is globally configured. If UDLD is globally disabled, UDLD is automatically disabled on all interfaces, but the per-port enable (or disable) configuration is not changed. If UDLD is globally enabled, whether UDLD is running on an interface or not depends on its per-port configuration.

UDLD is supported on both Ethernet fiber and copper interfaces. UDLD can only be enabled on Ethernet fiber or copper interfaces.

Examples

This example shows how to enable the UDLD feature for port 1 on module 2:

Console> (enable) set udld enable 2/1
UDLD enabled on port 2/1.
Warning:UniDirectional Link Detection should be enabled on all the ends of the connection 
in order to work properly.
Console> (enable)

This example shows how to disable the UDLD feature for port 1 on module 2:

Console> (enable) set udld disable 2/1
UDLD disabled on port 2/1.
Warning:UniDirectional Link Detection should be enabled on all the ends of the connection 
in order to work properly.
Console> (enable)

This example shows how to enable the UDLD feature for all ports on all modules:

Console> (enable) set udld enable
UDLD enabled globally
Console> (enable) 

This example shows how to disable the UDLD message display for all ports on all modules:

Console> (enable) set udld disable
UDLD disabled globally
Console> (enable) 

Related Commands

show udld

set udld aggressive-mode

Use the set udld aggressive-mode command to enable UDLD aggressive mode on specified ports or globally on all ports.

set udld aggressive-mode enable | disable mod/port

Syntax Description

enable

Keyword to enable UDLD aggressive mode.

disable

Keyword to disable UDLD aggressive mode.

mod/port

Number of the module and the ports on the module.


Defaults

The default is aggressive mode is disabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

After all the neighbors of a port have aged out either in the advertisement or in the detection phase, aggressive mode allows UDLD to restart the linkup sequence to resynchronize with any potentially out-of-sync neighbors, and shut down the port if the link is still undetermined after the fast train of messages.

You also can enable aggressive mode to shut down an active port that does not support autonegotiation or FEFI and becomes connected to its neighbor by a single fiber strand or copper wire after being part of a bidirectional link. This prevents possible spanning tree loops if the port belongs to a channel.

Examples

This example shows how to enable aggressive mode:

Console> (enable) set udld aggressive-mode enable 2/1
Aggressive UDLD enabled on port 2/1.
Warning: UniDirectional Link Detection should be enabled on all the ends of the connection 
in order to work properly.
Console> (enable)

This example shows how to disable aggressive mode:

Console> (enable) set udld aggressive-mode disable 2/1
Aggressive UDLD disabled on port 2/1.
Warning: UniDirectional Link Detection should be enabled on all the ends of the connection 
in order to work properly.
Console> (enable) 

Related Commands

show udld

set udld interval

Use the set udld interval command to set the UDLD message interval timer.

set udld interval interval

Syntax Description

interval

Message interval in seconds; valid values are from 7 to 90 seconds.


Defaults

The default is 60 seconds.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to set the message interval timer:

Console> (enable) set udld interval 90
UDLD message interval set to 90 seconds
Console> (enable)

Related Commands

show udld

set vlan

Use the set vlan command to group ports into a VLAN.

set vlan {vlas}{mod/port}

set vlan {vlan_num} [name name] [ type {ethernet | fddi | fddinet | trcrf | trbrf}] [state {active | suspend}] [said said}] [mtu mtu][ring hex_ring_number ]
[decring decimal_ring_number ] [bridge bridge_num ] [parent vlan_num] [mode {srt |
srb}] [stp {ieee | ibm | auto}] [translation vlan_num] [backupcrf {off | on}]
[
aremaxhop hopcount] [stemaxhop hopcount] [rspan]

Syntax Description

vlan_num

Number identifying the VLAN.

mod

Number of the module. This parameter is not valid when defining or configuring TrBRFs.

port

Numbers of the port on the module belonging to the VLAN; this parameter does not apply to TrBRFs.

name name

(Optional) Keyword to define a text string used as the name of the VLAN (1 to 32 characters).

type {ethernet | fddi | fddinet | trcrf | trbrf}

(Optional) Keywords to identify the VLAN type.

state {active | suspend}

(Optional) Keyword to specify whether the state of the VLAN is active or suspended. VLANs in suspended state do not pass packets.

said said

(Optional) Keyword to specify the security association identifier. Valid values are from 1 to 4294967294; this parameter does not apply to TrCRFs or TrBRFs.

mtu mtu

(Optional) Keyword to specify the maximum transmission unit (packet size, in bytes) that the VLAN can use. Possible values are 576 to 18190.

ring hex_ring_number

(Optional) Keyword to specify the logical ring number for Token Ring VLANs. Possible values are hexadecimal numbers 0x1 to 0xFFF; this parameter is valid and required only when defining a TrCRF.

decring decimal_ring_number

(Optional) Keyword to specify the logical ring number for Token Ring VLANs. Possible values are decimal numbers 1 to 4095; this parameter is valid and required only when defining a TrCRF.

bridge bridge_num

(Optional) Keyword to specify the identification number of the bridge. Possible values are hexadecimal numbers 0x1 to 0xF. For Token Ring VLANs, the default is 0F. This parameter is not valid for TrCRFs.

parent vlan_num

(Optional) Keyword to set a parent VLAN. The range for vlan_num is 2 to 1005. This parameter identifies the TrBRF to which a TrCRF belongs and is required when defining a TrCRF.

mode {srt | srb}

(Optional) TrCRF bridging mode.

stp {ieee | ibm | auto}

(Optional) Keyword to specify the Spanning Tree Protocol version for a TrBRF to use, source routing transparent (ieee), source route bridging (ibm), automatic source selection (auto).

translation vlan_num

(Optional) Keyword to specify a translational VLAN used to translate FDDI to Ethernet; valid values are from 1 to 1005. This parameter is not valid for defining or configuring Token Ring VLANs.

backupcrf {off | on}

(Optional) Keyword to specify whether the TrCRF is a backup path for traffic.

aremaxhop hop_count

(Optional) Keyword to specify the maximum number of hops for All-Routes Explorer frames. Possible values are 1 to 14. This parameter is only valid when defining or configuring TrCRFs.

stemaxhop hop_count

(Optional) Keyword to specify the maximum number of hops for Spanning-Tree Explorer frames. Possible values are 1 to 14. This parameter is only valid when defining or configuring TrCRFs.


Defaults

The default configuration has all switched Ethernet ports and Ethernet repeater ports in VLAN 1. The default SAID is 100001 for VLAN 1, 100002 for VLAN 2, 100003 for VLAN 3, and so on. The default type is Ethernet. The default MTU is 1500 bytes. The default state is active.

The default TrBRF is 1005, the default TrCRF is 1003, and the default MTU for TrBRFs and TrCRFs is 4472. The default state is active. The default aremaxhop value is 7; the default stemaxhop value is 7.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

VLAN 1 parameters are factory configured and cannot be changed.

You cannot use the set vlan command until the Catalyst 5000 family switch is either in VTP transparent mode (set vtp mode) or until a VTP domain name has been set (set vtp).

Valid MTU values for Token Ring VLAN are 1500 or 4472. While you can enter any value for the MTU value, the value you enter defaults to the next lowest valid value.

You cannot set multiple VLANs for ISL ports using this command. The VLAN name can be from 1 to 32 characters in length. If adding a new VLAN, the VLAN number must be within the range 2 to 1001. When modifying a VLAN, the valid range for the VLAN number is 2 to 1005.

On a new Token Ring VLAN, if you do not specify the parent parameter for a TrCRF, the default TrBRF (1005) is used.

Examples

This example shows how to set VLAN 850 to include ports 4 through 7 on module 3, because ports 4 through 7 were originally assigned to TrCRF 1003, the message reflects the modification of VLAN 1003:

Console> (enable) set vlan 850 3/4-7
VLAN 850 modified.
VLAN 1003 modified.
VLAN  Mod/Ports
---- -----------------------
850   3/4-7
Console> (enable) 

Related Commands

clear vlan
show vlan

set vlan mapping

Use the set vlan mapping command to map 802.1Q VLANs to ISL VLANs.

set vlan mapping dot1q 1q_vlan_num isl isl_vlan_num

Syntax Description

dot1q

Keyword to specify the 802.1Q VLAN.

1q_vlan_num

Number identifying the 802.1Q VLAN; valid values are from 1001 to 4095.

isl

Keyword to specify the ISL VLAN.

isl_vlan_num

Number identifying the ISL VLAN; valid values are from 1 to 1000.


Defaults

The default is no 802.1Q-to-ISL mappings are defined.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

IEEE 802.1Q VLAN trunks support VLANs 1 through 4095. ISL VLAN trunks support VLANs 1 through 1000. The switch automatically maps 802.1Q VLANs 1000 and lower to ISL VLANs with the same number.

The native VLAN of the 802.1Q trunk cannot be used in the mapping.

Use this feature to map 802.1Q VLANs above 1000 to ISL VLANs. Note that if you map a 802.1Q VLAN over 1000 to an ISL VLAN, the corresponding 802.1Q VLAN will be blocked. For example, if you map 802.1Q VLAN 2000 to ISL VLAN 200, then 802.1Q VLAN 200 will be blocked.

You can map up to seven VLANs. Only one 802.1Q VLAN can be mapped to an ISL VLAN. For example, if 802.1Q VLAN 800 has been automatically mapped to ISL VLAN 800, do not manually map any other 802.1Q VLANs to ISL VLAN 800.

You cannot overwrite existing 802.1Q VLAN mapping. If the 802.1Q VLAN number is in the mapping table, the command is aborted. You must first clear that mapping.

If vlan_num does not exist, then either of the following occurs:

If the switch is in server or transparent mode, the VLAN is created with all default values.

If the switch is in client mode, then the command proceeds without creating the VLAN. A warning will be given indicating that the VLAN does not exist.

If the table is full, the command is aborted with an error message indicating the table is full.

Examples

This example shows how to map VLAN 1022 to ISL VLAN 850:

Console> (enable) set vlan mapping dot1q 1022 isl 850
Vlan 850 configuration successful
Vlan mapping successful
Console> (enable)

This example shows the display if you enter a VLAN that does not exist:

Console> (enable) set vlan mapping dot1q 1017 isl 999
Vlan mapping successful
Warning: vlan 999 non-existent
Vlan 999 configuration successful
Console> (enable)

This example shows the display if you enter an existing mapping:

Console> (enable) set vlan mapping dot1q 1033 isl 722
722 exists in the mapping table. Please clear the mapping first.
Console> (enable)

This example shows the display if the mapping table is full:

Console> (enable) set vlan mapping dot1q 1099 isl 917
Vlan Mapping Table Full.
Console> (enable) 

Related Commands

clear vlan mapping
show vlan

set vmps downloadmethod

Use the set vmps downloadmethod command to specify whether to use TFTP or rcp to download the VMPS database.

set vmps downloadmethod {rcp | tftp} [username]

Syntax Description

rcp

Keyword to specify rcp as the method for downloading the VMPS database.

tftp

Keyword to specify TFTP as the method for downloading the VMPS database.

username

(Optional) Username for downloading with rcp.


Defaults

If no method is specified, TFTP will be used.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The username option is not allowed if TFTP is specified as the download method.

Examples

This example shows how to specify the method for downloading the VMPS database:

Console> (enable) set vmps downloadmethod rcp jdoe
vmps downloadmethod : RCP
rcp vmps username   : jdoe
Console> (enable) 

Related Commands

download vmps
set rcp username
show vmps

set vmps downloadserver

Use the set vmps downloadserver command to specify the IP address of the TFTP or rcp server from which the VMPS database is downloaded.

set vmps downloadserver ip_addr [filename]

Syntax Description

ip_addr

IP address of the TFTP or rcp server from which the VMPS database is downloaded.

filename

(Optional) VMPS configuration filename on the TFTP or rcp server.


Defaults

If a filename is not specified, the set vmps downloadserver command uses the default filename vmps-config-database.1.

Command Types

Switch command.

Command Modes

Privileged.

Examples

This example shows how to specify the server from which the VMPS database is downloaded and the configuration filename:

Console> (enable) set vmps downloadserver 192.168.69.100 vmps_config.1
IP address of the server set to 192.168.69.100
VMPS configuration filename set to vmps_config.1
Console> (enable)

Related Commands

download vmps
set vmps state
show vmps

set vmps server

Use the set vmps server command set to configure the VMPS server.

set vmps server ip_addr [primary]

set vmps server retry count

set vmps server reconfirminterval interval

Syntax Description

ip_addr

IP address of the VMPS server.

primary

(Optional) Keyword to specify the device as the primary VMPS server.

retry count

Keyword and variable to specify the retry interval; valid values are from 1 to 10 minutes.

reconfirminterval interval

Keyword and variable to specify the reconfirmation interval; valid values are from 0 to 120 minutes.


Defaults

If no IP address is specified, VMPS uses the local VMPS configuration.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

You can specify the IP addresses of up to three VMPS servers. You can define any VMPS server as the primary VMPS server.

If the primary VMPS server is down, all subsequent queries go to a secondary VMPS server. VMPS checks on the primary server's availability once every five minutes. When the primary VMPS server comes back online, subsequent VMPS queries are directed back to the primary VMPS server.

To use a co-resident VMPS (when VMPS is enabled in a device), configure one of the three VMPS addresses as the IP address of interface sc0.

When you specify the reconfirminterval interval, enter 0 to disable reconfirmation.

Examples

This example shows how to define a primary VMPS server:

Console> (enable) set vmps server 192.168.10.140 primary
192.168.10.140 added to VMPS table as primary domain server.
Console> (enable)

This example shows how to define a VMPS server:

Console> (enable) set vmps server 192.168.69.171
192.168.69.171 added to VMPS table as backup domain server.
Console> (enable)

Related Commands

show vmps

set vmps state

Use the set vmps state command to enable or disable VMPS.

set vmps state {enable | disable}

Syntax Description

enable

Keyword to enable VMPS.

disable

Keyword to disable VMPS.


Defaults

By default, VMPS is disabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Before using the set vmps state command, you must use the set vmps tftpserver command to specify the IP address of the server from which the VMPS database is downloaded.

Examples

This example shows how to enable VMPS:

Console> (enable) set vmps state enable
Vlan membership Policy Server enabled.
Console> (enable)

This example shows how to disable VMPS:

Console> (enable) set vmps state disable
All the VMPS configuration information will be lost and the resources released on disable.
Do you want to continue (y/n[n]):y
VLAN Membership Policy Server disabled.
Console> (enable)

Related Commands

download vmps
show vmps

set vtp

Use the set vtp command to set the options for VTP.

set vtp [domain domain_name] [mode {client | server | transparent}] [passwd passwd]
[
pruning {enable | disable}] [v2 {enable | disable}]

Syntax Description

domain domain_name

(Optional) Keywords to define the name that identifies the VLAN management domain.

mode

(Optional) Keyword to specify the VTP mode.

client

(Optional) Keyword to specify VTP client mode.

server

(Optional) Keyword to specify VTP server mode.

transparent

(Optional) Keyword to specify VTP transparent mode.

passwd passwd

(Optional) Keyword to define the VLAN trunk protocol password. The VTP password can be 8 to 64 characters in length.

pruning enable | disable

(Optional) Keywords to specify to enable or disable VTP pruning for the entire management domain.

v2

(Optional) Keyword to set version 2 mode.

enable

(Optional) Keyword to enable v2.

disable

(Optional) Keyword to disable v2.


Defaults

The defaults are as follows: server mode, no password, pruning disabled, and v2 disabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

All switches in a VTP domain must run the same version of VTP. VTP version 1 and VTP
version 2 do not operate on switches in the same VTP domain. VTP version 2 is supported in software release 3.1(1) and later and is disabled by default.

If all switches in a domain are VTP version 2-capable, you only need to enable VTP version 2 on one switch (using the set vtp v2 enable command); the version number is then propagated to the other version 2-capable switches in the VTP domain.

The domain_name can be 1 to 32 characters in length.

If the VTP password has already been defined, entering passwd 0 (zero) clears the VTP password.

VTP supports three different modes: server, client, and transparent. If you make a change to the VTP or VLAN configuration on a switch in server mode, that change is propagated to all of the switches in the same VTP domain.

If the receiving switch is in server mode and its revision number is higher than the sending switch, the configuration is not changed. If the revision number is lower the configuration is duplicated.

If the receiving switch is in client mode, the client switch changes its configuration to duplicate the configuration of the server. If you have switches in client mode, make sure to make all VTP or VLAN configuration changes on a switch in server mode.

If the receiving switch is in transparent mode, the configuration is not changed. Switches in transparent mode do not participate in VTP. If you make VTP or VLAN configuration changes on a switch in transparent mode, the changes are not propagated to the other switches in the network.

If you assign a VTP password, no VTP or VLAN configuration changes can be made without first entering the password.

The pruning keyword is used to enable or disable VTP pruning for the VTP domain. 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 pruneeligible and clear vtp pruning commands to specify which VLANs should or should not be pruned when pruning is enabled for the domain.

To disable VTP, enter the set vtp mode transparent command. This disables VTP from the domain but does not remove the domain from the switch. Use the clear config all command to remove the domain from the switch.


Caution Be careful when you use the clear config all command. This command clears the entire switch configuration, not just the VTP domain.

Examples

This example shows how to use the set vtp command:

Console> (enable) set vtp domain Engineering mode client
VTP domain Engineering modified
Console> (enable)

Related Commands

clear vlan
clear vtp pruning
set vlan
set vtp pruneeligible
show vtp domain
show vlan

set vtp pruneeligible

Use the set vtp pruneeligible command to specify which VLANs in the VTP domain are eligible for pruning.

set vtp pruneeligible vlans

Syntax Description

vlans

Range of VLAN numbers; valid values are from 2 to 1000.


Defaults

By default, VLANs 2 through 1000 are eligible for pruning.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

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. You do not need to use the set vtp pruneeligible command unless you have previously used the clear vtp pruning command to make some VLANs pruning ineligible.

If VLANs have been made pruning ineligible, use the set vtp pruneeligible command to make them pruning eligible again.

Examples

This example shows how to configure pruning eligibility for VLANs 120 and 150:

Console> (enable) set vtp pruneeligible 120,150
Vlans 120,150 eligible for pruning on this device.
VTP domain nada modified.
Console> (enable)

In this example, VLANs 200-500 were made pruning ineligible using the clear vtp pruning command. This example shows how to make VLANs 220 through 320 pruning eligible again:

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)
Console> (enable) set vtp pruneeligible 220-320
Vlans 2-199,220-320,501-1000 eligible for pruning on this device.
VTP domain Company modified.
Console> (enable)

Related Commands

clear vtp pruning
set vlan
show vtp domain

show accounting

Use the show accounting command to display accounting setup and configuration information on the switch.

show accounting

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 the configuration details of a switch with RADIUS accounting enabled:

Console> show accounting 
Event     Method1 Mode       
-----     ------- ----       
exec:     tacacs+ start-stop 
connect:  radius  stop-only  
system:   tacacs+ stop-only
commands:
config:   tacacs+ stop-only
all:      -       - 

TACACS+ Suppress for no username: disabled
Update Frequency: newinfo

Accounting information:
-----------------------

Active Accounted actions on tty2168059284l, User NULL Priv 15
 Task ID 3, EXEC Accounting record, 0,00:00:22 Elapsed
 task_id=3 start_time=934463479 timezone=UTC service=shell 
Active Accounted actions on tty0l, User kannank Priv 15
 Task ID 2, EXEC Accounting record, 0,00:01:23 Elapsed
 task_id=2 start_time=934463418 timezone=UTC service=shell 
Active Accounted actions on tty2168059284l, User danny Priv 15
 Task ID 4, Connection Accounting record, 0,00:00:07 Elapsed
 task_id=4 start_time=934463495 timezone=UTC service=connection protocol=telnet 
addr=-1407968771 cmd=telnet 172.20.25.253 

Overall Accounting Traffic:
          Starts   Stops  Active
Exec      1        0       2     
Connect   0        0       1     
Command   0        0       0     
System    0        0       0     
Console> 

This example shows the configuration details of a switch with TACACS+ accounting enabled:

Console> show accounting
Tacacs key:
Tacacs login attempts: 3
Tacacs timeout: 5 seconds
Tacacs direct request: disabled

Tacacs-Server                  Status 
--------------                    -------
171.69.1.2                         primary
171.69.1.3

 TACACS+ Suppress for no username: disabled
 Update Frequency: newinfo

 Accounting information:
 -----------------------

 Active Accounted actions on tty2168059284l, User NULL Priv 15
  Task ID 3, EXEC Accounting record, 0,00:00:22 Elapsed
  task_id=3 start_time=934463479 timezone=UTC service=shell 

 Active Accounted actions on tty0l, User kannank Priv 15
  Task ID 2, EXEC Accounting record, 0,00:01:23 Elapsed
  task_id=2 start_time=934463418 timezone=UTC service=shell 
 Active Accounted actions on tty2168059284l, User danny Priv 15
  Task ID 4, Connection Accounting record, 0,00:00:07 Elapsed
  task_id=4 start_time=934463495 timezone=UTC service=connection protocol=telnet 
addr=-1407968771 cmd=telnet 172.20.25.253 

 Overall Accounting Traffic:
           Starts   Stops  Active
 Exec      1        0       2     
 Connect   0        0       1     
 Command   0        0       0     
 System    0        0       0     

Console> 

Related Commands

set accounting commands
set accounting connect
set accounting exec
set accounting suppress
set accounting system
set accounting update

show alias

Use the show alias command to display a list of defined command aliases.

show alias [name]

Syntax Description

name

(Optional) Name of the alias to be displayed. If name is not specified, all defined aliases are displayed.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Normal.

Examples

This example shows how to display all aliases:

Console> show alias
shint           show interface
cc              clear config
shf             show flash
sip             show ip route
Console> 

Related Commands

clear kerberos clients mandatory
session
set alias