Catalyst 3550 Multilayer Switch Command Reference, 12.1(4)EA1
Commands - part 3

Table Of Contents

trust

udld (global configuration)

udld (interface configuration)

udld reset

vlan

vlan access-map

vlan database

vlan filter

vmps reconfirm (privileged EXEC)

vmps reconfirm (global configuration)

vmps retry

vmps server

vtp

vtp domain

vtp file

vtp password

vtp pruning

vtp v2-mode

wrr-queue bandwidth

wrr-queue cos-map

wrr-queue dscp-map

wrr-queue queue-limit

wrr-queue random-detect max-threshold

wrr-queue threshold


2

trust

Use the trust policy-map class configuration command to define a trust state for traffic classified by the class or the class-map command. Use the no form of this command to return to the default setting.

trust [cos | dscp | ip-precedence]

no trust [cos | dscp | ip-precedence]

Syntax Description

cos

(Optional) Classify ingress packets by using the packet class of service (CoS) values. For untagged packets, the port default CoS value is used.

dscp

(Optional) Classify ingress packets by using the packet Differentiated Services Code Point (DSCP) values (most significant 6 bits of 8-bit service-type field). For non-IP packets, the packet CoS value is used if the packet is tagged. If the packet is untagged, the default port CoS value is used to map CoS to DSCP.

ip-precedence

(Optional) Classify ingress packets by using the packet IP-precedence values (most significant 3 bits of 8-bit service-type field). For non-IP packets, the packet CoS value is used if the packet is tagged. If the packet is untagged, the port default CoS value is used to map CoS to DSCP.


Defaults

The port is not trusted. If no keyword is specified when the command is entered, the default is dscp.

Command Modes

Policy-map class configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

Use this command to distinguish the quality of service (QoS) trust behavior for certain traffic from others. For example, incoming traffic with certain DSCP values can be trusted. You can configure a class map to match and trust the DSCP values in the incoming traffic.

Trust values set with this command supersede trust values set on specific interfaces with the mls qos trust interface configuration command.

The trust command is mutually exclusive with set command within the same policy map.

You cannot attach policy maps that contain set or trust policy-map class configuration commands or that have access control list (ACL) classification to an egress interface by using the service-policy interface configuration command.

If you specify trust cos, QoS derives the internal DSCP value by using the received or default port CoS value and the CoS-to-DSCP map.

If you specify trust dscp, QoS derives the internal DSCP value by using the DSCP value from the ingress packet. For non-IP packets that are tagged, QoS derives the internal DSCP value by using the received CoS value; for non-IP packets that are untagged, QoS derives the internal DSCP value by using the default port CoS value. In either case, the internal DSCP value is derived from the CoS-to-DSCP map.

If you specify trust ip-precedence, QoS derives the internal DSCP value by using the IP precedence value from the ingress packet and the IP-precedence-to-DSCP map. For non-IP packets that are tagged, QoS derives the internal DSCP value by using the received CoS value; for non-IP packets that are untagged, QoS derives the internal DSCP value by using the default port CoS value. In either case, the internal DSCP value is derived from the CoS-to-DSCP map.

To return to policy-map configuration mode, use the exit command. To return to privileged EXEC mode, use the end command.

Examples

The following example shows how to define a port trust state to trust incoming DSCP values for traffic classified with class1:

Switch(config)# policy-map policy1
Switch(config-pmap)# class class1
Switch(config-pmap-c)# trust dscp
Switch(config-pmap-c)# police 1000000 20000 exceed-action policed-dscp-transmit
Switch(config-pmap-c)# exit

You can verify the previous commands by entering the show policy-map user EXEC command.

Related Commands

Command
Description

class

Defines a classification using the class-map name, access-group, DSCP, or IP precedence.

police

Defines a policer for classified traffic.

policy-map

Creates or modifies a policy map that can be attached to multiple interfaces to specify a service policy.

show policy-map

Displays QoS policy maps.


udld (global configuration)

Use the udld global configuration command to enable aggressive or normal mode in the UniDirectional Link Detection (UDLD) and to set the configurable message timer time. Use the no form of the command to disable aggressive or normal mode UDLD on all fiber-optic ports.

udld {aggressive | enable | message time message-timer-interval}

no udld {aggressive | enable | message}

Syntax Description

aggressive

Enable UDLD in aggressive mode on all fiber-optic interfaces.

enable

Enable UDLD in normal mode on all fiber-optic interfaces.

message time message-timer-interval

Configure the period of time between UDLD probe messages on ports that are in the advertisement phase and are determined to be bidirectional. The range is 7 to 90 seconds.


Defaults

UDLD is disabled on all fiber-optic interfaces.

The message timer is set at 60 seconds.

Command Modes

Global configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

In normal mode, if UDLD is in the advertisement or in the detection phase and all the neighbor cache entries are aged out, UDLD restarts the link-up sequence to try to resynchronize with any potentially out-of-sync neighbors.

If you enable aggressive mode, when all the neighbors of a port have aged out either in the advertisement or in the detection phase, UDLD restarts the link-up sequence to try to get resynchronized with any potentially out-of-sync neighbor and shuts down the port if after the fast train of messages, the link state is still undetermined. Use aggressive mode on point-to-point links where no failure between two neighbors is allowed. In this situation, UDLD probe packets can be considered as a heart beat whose presence guarantees the health of the link. Conversely, the loss of the heart beat means trouble, and the link must be shut down if it is not possible to re-establish a bidirectional link.

If you change the message time between probe packets, you are making a trade-off between the detection speed and the CPU load. By decreasing the time, you can make the detection-response faster but increase the load on the CPU.

This command affects fiber-optic interfaces only. Use the udld interface configuration command to enable UDLD on other interface types.

Examples

The following example shows how to enable UDLD on all fiber-optic interfaces:

Switch(config)# udld enable

You can verify the previous command by entering the show udld user EXEC command.

Related Commands

Command
Description

show udld

Displays UDLD administrative and operational status for all ports or the specified port.

udld (interface configuration)

Enables UDLD on an individual interface or prevents a fiber-optic interface from being enabled by the udld global configuration command.

udld reset

Resets all interfaces shutdown by UDLD and permits traffic to begin passing through them again.


udld (interface configuration)

Use the udld interface configuration command to enable the UniDirectional Link Detection (UDLD) on an individual interface or prevent a fiber-optic interface from being enabled by the udld global configuration command. Use the no form of this command to return to the udld global configuration command setting or disable UDLD if executed on a non-fiber-optic port.

udld {aggressive | enable | disable}

no udld {aggressive | enable | disable}

Syntax Description

aggressive

Enable UDLD in aggressive mode on the specified interface.

enable

Enable UDLD in normal mode on the specified interface.

disable

Disable UDLD on the specified interface. This keyword applies only to fiber-optic interfaces.


Defaults

On fiber-optic interfaces, UDLD is neither enabled, in aggressive mode, nor disabled. For this reason, fiber-optic interfaces enable UDLD according to the state of the udld enable or udld aggressive global configuration command.

On nonfiber-optic interfaces, UDLD is disabled.

Command Modes

Interface configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

A UDLD-capable port cannot detect a unidirectional link if it is connected to a UDLD-incapable port of another switch.

In normal mode, if UDLD is in the advertisement or in the detection phase and all the neighbor cache entries are aged out, UDLD restarts the link-up sequence to try to resynchronize with any potentially out-of-sync neighbors.

If you enable aggressive mode, once all the neighbors of a port have aged out either in the advertisement or in the detection phase, UDLD restarts the link-up sequence to try to get resynchronized with any potentially out-of-sync neighbor and shuts down the port if after the fast train of messages, the link state is still undetermined. Use aggressive mode on point-to-point links where no failure between two neighbors is allowed. In this situation, UDLD probe packets can be considered as a heart beat whose presence guarantees the health of the link. Conversely, the loss of the heart beat means trouble, and the link must be shut down if it is not possible to re-establish a bidirectional link.

Use the no udld enable command on fiber-optic ports to return control of UDLD to the udld enable global configuration command or to disable UDLD on non-fiber-optic ports.

Use the udld aggressive command on fiber-optic ports to override the setting of the udld enable or udld aggressive global configuration command. Use the no form on fiber-optic ports to remove this setting and return control of UDLD enabling to the udld global configuration command or disable UDLD on non-fiber-optic ports.

The disable keyword is supported on fiber-optic ports only. Use the no form of this command to remove this setting and return control of UDLD to the udld global configuration command.

If, due to a module or GBIC change that is detected by the platform software and the port changes from fiber-optic to non-fiber-optic or visa versa, all configurations are maintained.

Examples

The following example shows how to enable UDLD on an interface:

Switch(config)# interface gigabitethernet0/11
Switch(config-if)# udld enable

The following example shows how to disable UDLD on a fiber-optic interface despite the setting of the udld global configuration command:

Switch(config)# interface gigabitethernet0/11
Switch(config-if)# udld disable

You can verify the previous commands by entering the show running-config or the show udld interface privileged EXEC command.

Related Commands

Command
Description

show running-config

Displays the running configuration on the switch.

show udld

Displays UDLD administrative and operational status for all ports or the specified port.

udld (global configuration)

Enables aggressive or normal mode in UDLD or sets the configurable message timer time.

udld reset

Resets all interfaces shutdown by UDLD and permits traffic to begin passing through them again.


udld reset

Use the udld reset privileged EXEC command to reset all interfaces shutdown by the UniDirectional Link Detection (UDLD) and permit traffic to begin passing through them again (though other features, such as spanning tree, Port Aggregation Protocol (PAgP), and Dynamic Trunking Protocol (DTP) still have their normal effects, if enabled).

udld reset

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

If the interface configuration is still enabled for UDLD, these ports begin to run UDLD again and might shutdown for the same reason if the problem has not been corrected.

Examples

The following example shows how to reset all interfaces shutdown by UDLD:

Switch# udld reset
1 ports shutdown by UDLD were reset.

You can verify the previous command by entering the show udld user EXEC command.

Related Commands

Command
Description

show running-config

Displays the running configuration on the switch.

show udld

Displays UDLD administrative and operational status for all ports or the specified port.


vlan

Use the vlan VLAN configuration command to configure virtual LAN (VLAN) characteristics for a specific VLAN. Use the no form of this command without additional parameters to delete a VLAN. Use the no form with parameters to change its configured characteristics.

vlan vlan-id [name vlan-name] [media {ethernet | fddi | fdi-net | tokenring | tr-net}]
[state {suspend | active}] [said said-value] [mtu mtu-size] [ring ring-number]
[bridge bridge-number | type {srb | srt}] [parent parent-vlan-id]
[stp type {ieee | ibm | auto}] [are are-number] [ste ste-number]
[backupcrf {enable | disable}] [tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]

no vlan vlan-id [name vlan-name] [media {ethernet | fddi | fdi-net | tokenring | tr-net}]
[state {suspend | active}] [said said-value] [mtu mtu-size] [ring ring-number]
[bridge bridge-number | type {srb | srt}] [parent parent-vlan-id]
[stp type {ieee | ibm | auto}] [are are-number] [ste ste-number]
[backupcrf {enable | disable}] [tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]


Note The switch supports only Ethernet ports. You configure only FDDI and Token Ring media-specific characteristics for VLAN Trunk Protocol (VTP) global advertisements to other switches. These VLANs are locally suspended.


Table 2-21 lists the valid syntax for each media type.

Table 2-21 Valid Syntax for Different Media Types 

Media Type
Valid Syntax

Ethernet

vlan vlan-id [name vlan-name] media ethernet [state {suspend | active}]
[said said-value] [mtu mtu-size] [tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]

FDDI

vlan vlan-id [name vlan-name] media fddi [state {suspend | active}]
[said said-value] [mtu mtu-size] [ring ring-number] [parent parent-vlan-id] [tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]

FDDI-NET

vlan vlan-id [name vlan-name] media fd-net [state {suspend | active}]
[said said-value] [mtu mtu-size] [bridge bridge-number]
[stp type {ieee | ibm | auto}] [tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]

If VTP V2 mode is disabled, do not set the stp type to auto.

Token Ring

VTP V2 mode is disabled.

vlan vlan-id [name vlan-name] media tokenring [state {suspend | active}]
[said said-value] [mtu mtu-size] [ring ring-number] [parent parent-vlan-id]
[tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]

Token Ring concentrator relay function (TrCRF)

VTP V2 mode is enabled.

vlan vlan-id [name vlan-name] media tokenring [state {suspend | active}]
[said said-value] [mtu mtu-size] [ring ring-number] [parent parent-vlan-id]
[bridge type {srb | srt}] [are are-number] [ste ste-number]
[backupcrf {enable | disable}] [tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]

Token Ring-NET

VTP V2 mode is disabled.

vlan vlan-id [name vlan-name] media tr-net [state {suspend | active}]
[said said-value] [mtu mtu-size] [bridge bridge-number]
[stp type {ieee | ibm}] [tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]

Token Ring bridge relay function (TrBRF)

VTP V2 mode is enabled.

vlan vlan-id [name vlan-name] media tr-net [state {suspend | active}]
[said said-value] [mtu mtu-size] [bridge bridge-number]
[stp type {ieee | ibm | auto}] [tb-vlan1 tb-vlan1-id] [tb-vlan2 tb-vlan2-id]


VLAN Configuration Rules

Table 2-22 describes the rules for configuring VLANs.

Table 2-22 VLAN Configuration Rules 

Configuration
Rule

VTP V2 mode is enabled, and you are configuring a TrCRF VLAN media type.

Specify a parent VLAN ID of a TrBRF that already exists in the database.

Specify a ring number. Do not leave this field blank.

Specify unique ring numbers when TrCRF VLANs have the same parent VLAN ID. Only one backup concentrator relay function (CRF) can be enabled.

VTP V2 mode is enabled, and you are configuring VLANs other than TrCRF media type.

Do not specify a backup CRF.

VTP V2 mode is enabled, and you are configuring a TrBRF VLAN media type.

Specify a bridge number. Do not leave this field blank.

VTP V2 mode is disabled.

No VLAN can have an STP type set to auto.

This rule applies to Ethernet, FDDI, FDDI-NET, Token Ring, and Token Ring-NET VLANs.

Add a VLAN that requires translational bridging (values are not set to zero).

The translational bridging VLAN IDs that are used must already exist in the database.

The translational bridging VLAN IDs that a configuration points to must also contain a pointer to the original VLAN in one of the translational bridging parameters (for example, Ethernet points to FDDI, and FDDI points to Ethernet).

The translational bridging VLAN IDs that a configuration points to must be different media types than the original VLAN (for example, Ethernet can point to Token Ring).

If both translational bridging VLAN IDs are configured, these VLANs must be different media types (for example, Ethernet can point to FDDI and Token Ring).


Syntax Description

vlan-id

ID of the configured VLAN. Valid IDs are from 1 to 1005 and must be unique within the administrative domain. Do not enter leading zeroes.

name vlan-name

(Optional) Keyword to be followed by the VLAN name, an ASCII string from 1 to 32 characters that must be unique within the administrative domain.

media {ethernet | fddi | fd-net | tokenring | tr-net}

(Optional) Keyword to be followed by the VLAN media type:

ethernet is Ethernet media type.

fddi is FDDI media type.

fd-net is FDDI network entity title (NET) media type.

tokenring is Token Ring media type if the VTP V2 mode is disabled or TrCRF if the VTP V21 mode is enabled.

tr-net is Token Ring network entity title (NET) media type if the VTP V2 mode is disabled or TrBRF media type if the VTP V2 mode is enabled.

state {suspend | active}

(Optional) Keyword to be followed by the VLAN state.

If active, the VLAN is operational.

If suspend, the VLAN is suspended. Suspended VLANs do not pass packets.

said said-value

(Optional) Keyword to be followed by the security association identifier (SAID) as documented in IEEE 802.10. The value is an integer from 1 to 4294967294 that must be unique within the administrative domain.

mtu mtu-size

(Optional) Keyword to be followed by the maximum transmission unit (MTU) (packet size in bytes). Valid values are from 1500 to 18190.

ring ring-number

(Optional) Keyword to be followed by the logical ring for an FDDI, Token Ring, or TrCRF VLAN. Valid values are from 1 to 4095.

bridge bridge-number|
type {srb | srt}

(Optional) Keyword to be followed by the logical distributed source-routing bridge, the bridge that interconnects all logical rings having this VLAN as a parent VLAN in FDDI-NET, Token Ring-NET, and TrBRF VLANs.

Valid bridge numbers are from 0 to 15.

Type applies only to TrCRF VLANs and is one of these keywords:

srb (source-route bridging)

srt (source-route transparent) bridging VLAN

parent parent-vlan-id

(Optional) Keyword to be followed by the parent VLAN of an existing FDDI, Token Ring, or TrCRF VLAN. This parameter identifies the TrBRF to which a TrCRF belongs and is required when defining a TrCRF. Valid values are from 0 to 1005.

stp type {ieee | ibm | auto}

(Optional) Keyword to be followed by the spanning-tree type for FDDI-NET, Token Ring-NET, or TrBRF VLAN.

ieee for IEEE Ethernet STP running source-route transparent (SRT) bridging.

ibm for IBM STP running source-route bridging (SRB).

auto for STP running a combination of source-route transparent bridging (IEEE) and source-route bridging (IBM).

are are-number

(Optional) Keyword to be followed by the maximum number of all-routes explorer (ARE) hops for this VLAN. This keyword applies only to TrCRF VLANs. Valid values are from 0 to 13. If no value is entered, zero is assumed to be the maximum.

ste ste-number

(Optional) Keyword to be followed by the maximum number of spanning-tree explorer (STE) hops. This keyword applies only to TrCRF VLANs. Valid values are from 0 to 13.

backupcrf {enable | disable}

Keyword to be followed by the backup CRF mode. This keyword applies only to TrCRF VLANs.

enable backup CRF mode for this VLAN.

disable backup CRF mode for this VLAN.

tb-vlan1 tb-vlan1-id

and tb-vlan2 tb-vlan2-id

(Optional) Keyword to be followed by the first and second VLAN to which this VLAN is translationally bridged. Translational VLANs translate FDDI or Token Ring to Ethernet, for example. Valid values are from 0 to 1005. Zero is assumed if no value is specified.


Defaults

The vlan-name variable is VLANxxxx, where xxxx represents four numeric digits (including leading zeroes) equal to the VLAN ID number.

The media type is ethernet.

The state is active.

The said value is 100000 plus the VLAN ID.

The mtu size is dependent upon the VLAN type:

For Ethernet, FDDI and FDDI-NET VLANs, the default is 1500 bytes.

For Token Ring and Token-Ring-NET VLANs, the default is 1500 bytes.

For TrCRF and TrBRF VLANs, the default is 4472 bytes.

The ring number for Token Ring VLANs is zero. For FDDI VLANs, there is no default. For TrCRF VLANs, you must specify a ring number.

The bridge number is zero (no source-routing bridge) for FDDI-NET and Token Ring-NET VLANs. For TrBRF VLANs, you must specify a bridge number.

The parent VLAN ID is zero (no parent VLAN) for FDDI and Token Ring VLANs. For TrCRF VLANs, you must specify a parent VLAN ID. For both Token Ring and TrCRF VLANs, the parent VLAN ID must already exist in the database and be associated with a Token Ring-NET or TrBRF VLAN.

The STP type is ibm for FDDI-NET and Token Ring-NET VLANs. For FDDI and Token Ring VLANs, the default is no type specified.

The ARE value is 7.

The STE value is 7.

Backup CRF is disabled.

The tb-vlan1-id and tb-vlan2-id variables are zero (no translational bridging).

Command Modes

VLAN configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

The following are the results of using the no vlan commands:

When the no vlan vlan-id form is used, the VLAN is deleted. Deleting VLANs automatically resets to zero any other parent VLANs and translational bridging parameters that refer to the deleted VLAN.

When the no vlan vlan-id name vlan-name form is used, the VLAN name returns to the default name (VLANxxxx, where xxxx represent four numeric digits [including leading zeroes] equal to the VLAN ID number).

When the no vlan vlan-id media form is used, the media type returns to the default (ethernet). Changing the VLAN media type (including the no form) resets the VLAN MTU to the default MTU for the type (unless the mtu keyword is also present in the command). It also resets the VLAN parent and translational bridging VLAN to the default (unless the parent, tb-vlan1, or tb-vlan2 are also present in the command).

When the no vlan vlan-id state form is used, the VLAN state returns to the default (active).

When the no vlan vlan-id said form is used, the VLAN SAID returns to the default (100,000 plus the VLAN ID).

When the no vlan vlan-id mtu form is used, the VLAN MTU returns to the default for the applicable VLAN media type. You can also modify the MTU using the media keyword.

When the no vlan vlan-id ring form is used, the VLAN logical ring number returns to the default (0).

When the no vlan vlan-id bridge form is used, the VLAN source-routing bridge number returns to the default (0). The vlan vlan-id bridge command is only used for FDDI-NET and Token Ring-NET VLANs and is ignored in other VLAN types.

When the no vlan vlan-id parent form is used, the parent VLAN returns to the default (0). The parent VLAN resets to the default if the parent VLAN is deleted or if the media keyword changes the VLAN type or the VLAN type of the parent VLAN.

When the no vlan vlan-id stp type form is used, the VLAN spanning-tree type returns to the default (ieee).

When the no vlan vlan-id tb-vlan1 or no vlan vlan-id tb-vlan2 form is used, the VLAN translational bridge VLAN (or VLANs, if applicable) returns to the default (0). Translational bridge VLANs must be a different VLAN type than the affected VLAN, and if two are specified, the two must be different VLAN types from each other. A translational bridge VLAN resets to the default if the translational bridge VLAN is deleted, if the media keyword changes the VLAN type, or if the media keyword changes the VLAN type of the corresponding translation bridge VLAN.

Examples

The following example shows how to add an Ethernet VLAN with default media characteristics. The default includes a vlan-name of VLANxxx, where xxxx represents four numeric digits (including leading zeroes) equal to the VLAN ID number. The default media option is ethernet; the state option is active. The default said-value variable is 100000 plus the VLAN ID; the mtu-size variable is 1500; the stp-type option is ieee. The VLAN is added if it did not already exist; otherwise, this command does nothing.

Switch(vlan)# vlan 2

The following example shows how to modify an existing VLAN by changing its name and MTU size:

Switch(vlan)# no vlan name engineering mtu 1200

You can verify the previous commands by entering the show vlan privileged EXEC command.

Related Commands

Command
Description

show vlan

Displays the parameters for all configured VLANs or one VLAN (if the VLAN ID or name is specified) in the administrative domain.


vlan access-map

Use the vlan access-map global configuration command to create or modify a virtual LAN (VLAN) map entry for VLAN packet filtering. This entry changes the mode to the VLAN access map configuration. Use the no form to delete a VLAN map entry. Use the vlan filter interface configuration command to apply a VLAN map to one or more VLANs.

vlan access-map name [number]

no vlan access-map name [number]

Syntax Description

name

Name of the VLAN map.

number

(Optional) The sequence number of the map entry that you want to create or modify (0 to 65535). If you are creating a VLAN map and the sequence number is not specified, it is automatically assigned in increments of 10, starting from 10.
This number is the sequence to insert to, or delete from a VLAN access-map entry.


Defaults

By default, there are no VLAN map entries and no VLAN maps applied to a VLAN.

Command Modes

Global configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

In global configuration mode, use this command to create or modify a VLAN map. This entry changes the mode to VLAN access map configuration, where you can use the match command to specify the access lists for IP or non-IP traffic to match and use the action command to set whether a match causes the packet to be forwarded or dropped.

When you do not specify an entry number (sequence number), it is added to the end of the map.

There can be only one VLAN map per VLAN and it is applied as packets are received by a VLAN.

You can use the no vlan access-map name [number] command with a sequence number to delete a single entry.

In global configuration mode, use the vlan filter command to apply the map to one or more VLANs.


Note For more information about VLAN map entries, see the Catalyst 3550 Multilayer Switch Software Configuration Guide for this release.


Examples

The following example shows how to create a VLAN map named vac1 and apply matching conditions and actions to it. If no other entries already exist in the map, this will be entry 10.

Switch(config)# vlan access-map vac1
Switch(config-access-map)# match ip address acl1
Switch(config-access-map)# action drop

The following example shows how to delete VLAN map vac1:

Switch(config)# no vlan access-map vac1

Related Commands

Command
Description

action (access-map configuration)

Sets the action for the VLAN access map entry.

match (access-map configuration)

Sets the VLAN map to match packets against one or more access lists.

show vlan access-map

Displays information about a particular VLAN access map or all VLAN access maps.

vlan filter

Applies the VLAN access map to one or more VLANs.


vlan database

Use the vlan database privileged EXEC command to enter virtual LAN (VLAN) configuration mode. From this mode, you can add, delete, and modify VLAN configurations and globally propagate these changes by using the VLAN Trunk Protocol (VTP).

vlan database

Syntax Description

This command has no arguments or keywords.

Defaults

No default is defined.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

To return to the privileged EXEC mode from the VLAN configuration mode, enter the exit command.


Note This command mode is different from other modes because it is session-oriented. When you add, delete, or modify VLAN parameters, the changes are not applied until you exit the session by entering the apply or exit commands. When the changes are applied, the VTP configuration version is incremented. You can also not apply the changes to the VTP database by entering abort.


Once you are in VLAN configuration mode, you can access the VLAN database editing buffer manipulation commands, including:

abort—Keyword used to exit mode without applying the changes.

apply—Keyword used to apply current changes and bump revision number.

exit—Keyword used to apply changes, bump revision number, and exit mode.

no—Keyword used to negate a command or set its defaults; valid values are vlan and vtp.

reset—Keyword used to abandon current changes and reread current database.

show—Keyword used to display database information.

vlan—Keyword used to access subcommands to add, delete, or modify values associated with a single VLAN.

vtp—Keyword used to access subcommands to perform VTP administrative functions.

Examples

The following example shows how to enter the VLAN configuration mode from the privileged EXEC mode:

Switch# vlan database
Switch(vlan)#

Related Commands

Command
Description

abort

Abandons the proposed new VLAN configuration, exits VLAN configuration mode, and returns to privileged EXEC mode.

apply

Implements the proposed new VLAN configuration, increments the database configuration revision number, propagates it throughout the administrative domain, and remains in VLAN configuration mode.

reset

Abandons the proposed VLAN configuration and remains in VLAN configuration mode. Resets the proposed database to the implemented VLAN database on the switch.

shutdown vlan

Shuts down (suspends) local traffic on the specified VLAN.


vlan filter

Use the vlan filter global configuration command to apply a virtual LAN (VLAN) map to one or more VLANs. Use the no form of this command to remove the map.

vlan filter mapname vlan-list list

no vlan filter mapname vlan-list list

Syntax Description

mapname

Name of the VLAN map entry.

list

The list of one or more VLANs in the form tt, uu-vv, xx, yy-zz, where spaces around commas and dashes are optional.


Defaults

By default, there are no VLAN filters.

Command Modes

Global configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

To avoid accidentally dropping too many packets and disabling connectivity in the middle of the configuration process, we recommend that you completely define the VLAN access map before applying it to a VLAN.


Note For more information about VLAN map entries, see the Catalyst 3550 Multilayer Switch Software Configuration Guide for this release.


Examples

The following example applies VLAN map entry map1 to VLANs 20 and 30:

Switch(config)# vlan filter map1 vlan-list 20, 30

The following example shows how to delete VLAN map entry mac1 from VLAN 20:

Switch(config)# no vlan filter map1 vlan-list 20

Related Commands

Command
Description

show vlan access-map

Displays information about a particular VLAN access map or all VLAN access maps.

show vlan filter

Displays information about all VLAN filters or about a particular VLAN or VLAN access map.

vlan access map

Creates a VLAN map entry for VLAN packet filtering.


vmps reconfirm (privileged EXEC)

Use the vmps reconfirm privileged EXEC command to immediately send VLAN Query Protocol (VQP) queries to reconfirm all dynamic VLAN assignments with the VLAN Membership Policy Server (VMPS).

vmps reconfirm

Syntax Description

This command has no arguments or keywords.

Defaults

No default is defined.

Command Modes

Privileged EXEC

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Examples

The following example shows how to immediately send VQP queries to the VMPS:

Switch# vmps reconfirm

You can verify the previous command by entering the show vmps privileged EXEC command and examining the VMPS Action row of the Reconfirmation Status section. The show vmps command shows the result of the last time the assignments were reconfirmed either as a result of the reconfirmation timer expiring or because the vmps reconfirm command was issued.

Related Commands

Command
Description

show vmps

Displays VQP and VMPS information.

vmps reconfirm interval

Changes the reconfirmation interval for the VLAN Query Protocol (VQP) client.


vmps reconfirm (global configuration)

Use the vmps reconfirm global configuration command to change the reconfirmation interval for the VLAN Query Protocol (VQP) client.

vmps reconfirm interval

Syntax Description

interval

Reconfirmation interval for VQP client queries to the VLAN Membership Policy Server (VMPS) to reconfirm dynamic VLAN assignments. The interval range is from 1 to 120 minutes.


Defaults

The default reconfirmation interval is 60 minutes.

Command Modes

Global configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Examples

The following example shows how to set the VQP client to reconfirm dynamic VLAN entries every 20 minutes:

Switch(config)# vmps reconfirm 20

You can verify the previous command by entering the show vmps privileged EXEC command and examining information in the Reconfirm Interval row.

Related Commands

Command
Description

show vmps

Displays VQP and VMPS information.

vmps reconfirm (privileged EXEC)

Sends VQP queries to reconfirm all dynamic VLAN assignments with the VMPS.


vmps retry

Use the vmps retry global configuration command to configure the per-server retry count for the VLAN Query Protocol (VQP) client.

vmps retry count

Syntax Description

count

Number of attempts to contact the VLAN Membership Policy Server (VMPS) by the client before querying the next server in the list. The retry range is from 1 to 10.


Defaults

The default retry count is 3.

Command Modes

Global configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Examples

The following example shows how to set the retry count to 7:

Switch(config)# vmps retry 7

You can verify the previous command by entering the show vmps privileged EXEC command and examining information in the Server Retry Count row.

Related Commands

Command
Description

show vmps

Displays VQP and VMPS information.


vmps server

Use the vmps server global configuration command to configure the primary VLAN Membership Policy Server (VMPS) and up to three secondary servers. Use the no form of this command to remove a VMPS server.

vmps server ipaddress [primary]

no vmps server [ipaddress]

Syntax Description

ipaddress

IP address or host name of the primary or secondary VMPS servers. If you specify a host name, the Domain Name System (DNS) server must be configured.

primary

(Optional) Determines whether primary or secondary VMPS servers are being configured.


Defaults

No primary or secondary VMPS servers are defined.

Command Modes

Global configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

The first server entered is automatically selected as the primary server whether or not primary is entered. The first server address can be overridden by using primary in a subsequent command.

If a member switch in a cluster configuration does not have an IP address, the cluster does not use the VMPS server configured for that member switch. Instead, the cluster uses the VMPS server on the command switch, and the command switch proxies the VMPS requests. The VMPS server treats the cluster as a single switch and uses the IP address of the command switch to respond to requests.

When using the no form without specifying the ipaddress, all configured servers are deleted. If you delete all servers when dynamic-access ports are present, the switch cannot forward packets from new sources on these ports because it cannot query the VMPS.

Examples

The following example shows how to configure the server with IP address 191.10.49.20 as the primary VMPS server. The servers with IP addresses 191.10.49.21 and 191.10.49.22 are configured as secondary servers:

Switch(config)# vmps server 191.10.49.20 primary
Switch(config)# vmps server 191.10.49.21
Switch(config)# vmps server 191.10.49.22

The following example shows how to delete the server with IP address 191.10.49.21:

Switch(config)# no vmps server 191.10.49.21

You can verify the previous commands by entering the show vmps privileged EXEC command and examining information in the VMPS Domain Server row.

Related Commands

Command
Description

show vmps

Displays VQP and VMPS information.


vtp

Use the vtp VLAN configuration command to configure the VLAN Trunk Protocol (VTP) mode. Use the no form of this command to return to the default setting of server.

vtp {server | client | transparent}

no vtp {server | client | transparent}

Syntax Description

server

Place the switch in VTP server mode. A switch in VTP server mode is enabled for VTP and sends advertisements. You can configure VLANs on it. The switch can recover all the VLAN information in the current VTP database from nonvolatile storage after reboot.

client

Place the switch in VTP client mode. A switch in VTP client mode is enabled for VTP, can send advertisements, but does not have enough nonvolatile storage to store VLAN configurations. You cannot configure VLANs on it. When a VTP client starts up, it does not transmit VTP advertisements until it receives advertisements to initialize its VLAN database.

transparent

Place the switch in VTP transparent mode. A switch in VTP transparent mode is disabled for VTP, does not transmit advertisements or learn from advertisements sent by other devices, and cannot affect VLAN configurations on other devices in the network. The switch receives VTP advertisements and forwards them on all trunk ports except the one on which the advertisement was received.



Note The switch supports up to 1005 VLANs in client, server, or transparent mode.


Defaults

The default mode is server mode.

Command Modes

VLAN configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

The no vtp client and no vtp transparent forms of the command return the switch to VTP server mode.

The vtp server command is the same as no vtp client or no vtp transparent except that it does not return an error if the switch is not in client or transparent mode.

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 server mode, the configuration is not changed.

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 other switches in the network.

If you make a change to the VTP or VLAN configuration on a switch in server mode, that change is propagated to all the switches in the same VTP domain.

The vtp transparent command disabled VTP from the domain but does not remove the domain from the switch.

VTP can be set to either server or client mode only when dynamic VLAN creation is disabled.

Examples

The following example shows how to place the switch in VTP transparent mode:

Switch(vlan)# vtp transparent

You can verify the previous commands by entering the show vtp status privileged EXEC command.

Related Commands

Command
Description

show vtp counters

Displays the VTP statistics for the switch.

show vtp status

Displays general information about the VTP management domain status.


vtp domain

Use the vtp domain VLAN configuration command to configure the VLAN Trunk Protocol (VTP) administrative domain.

vtp domain domain-name

Syntax Description

domain-name

ASCII string from 1 to 32 characters that identifies the VTP administrative domain for the switch. The domain name is case sensitive.


Defaults

No domain name is defined.

Command Modes

VLAN configuration

Command History

Release
Modification

12.1(4)EA1

This command was first introduced.


Usage Guidelines

The switch is in the no-management-domain state until you configure a domain name. While in the no-management-domain state, the switch does not transmit any VTP advertisements even if changes occur to the local VLAN configuration. The switch leaves the no-management-domain state after receiving the first VTP summary packet on any port that is currently trunking or after configuring a domain name using the vtp domain command. If the switch receives its domain from a summary packet, it resets its configuration revision number to zero. After the switch leaves the no-management-domain state, it can never be configured to reenter it until you clear the nonvolatile RAM (NVRAM) and reload the software.

Domain names are case sensitive.

Once you configure a domain name, it cannot be removed. You can only reassign it to a different domain.

Examples

The following example shows how to set the administrative domain for the switch:

Switch(vlan)# vtp domain OurDomainName

You can verify the previous commands by entering the show vtp status privileged EXEC command.

Related Commands

Command
Description

show vtp counters

Displays the VTP statistics for the switch.

show vtp status

Displays general information about the VTP management domain status.

vtp password

Configures the VTP administrative domain password.


vtp file

Use the vtp file global configuration command to modify the VLAN Tr