Catalyst 6500 Series Command Reference, 7.6
set port auxiliaryvlan to set rcp username

Table Of Contents

set port auxiliaryvlan

set port broadcast

set port channel

set port cops

set port debounce

set port disable

set port dot1q-all-tagged

set port dot1qtunnel

set port dot1x

set port duplex

set port enable

set port errdisable-timeout

set port flowcontrol

set port gmrp

set port gvrp

set port host

set port inlinepower

set port jumbo

set port l2protocol-tunnel

set port lacp-channel

set port macro

set port membership

set port name

set port negotiation

set port protocol

set port qos

set port qos autoqos

set port qos cos

set port qos policy-source

set port qos trust

set port qos trust-device

set port qos trust-ext

set port rsvp dsbm-election

set port security

set port speed

set port sync-restart-delay

set port trap

set port unicast-flood

set port voice interface dhcp

set power redundancy

set prompt

set protocolfilter

set pvlan

set pvlan mapping

set qos

set qos acl default-action

set qos acl ip

set qos acl ipx

set qos acl mac

set qos acl map

set qos autoqos

set qos bridged-microflow-policing

set qos cos-dscp-map

set qos drop-threshold

set qos dscp-cos-map

set qos ipprec-dscp-map

set qos mac-cos

set qos map

set qos policed-dscp-map

set qos policer

set qos policy-source

set qos rsvp

set qos rxq-ratio

set qos statistics export

set qos statistics export aggregate

set qos statistics export destination

set qos statistics export interval

set qos statistics export port

set qos txq-ratio

set qos wred

set qos wrr

set radius attribute

set radius deadtime

set radius key

set radius retransmit

set radius server

set radius timeout

set rcp username


2

set port auxiliaryvlan

To configure the auxiliary VLAN ports, use the set port auxiliaryvlan command.

set port auxiliaryvlan mod[/port] {vlan | untagged | dot1p | none}

Syntax Description

mod[/port]

Number of the module and (optional) port or multiple ports.

vlan

Number of the VLAN; valid values are from 1 to 4096.

untagged

Specifies the connected device send and receive untagged packets without 802.1p priority.

dot1p

Specifies the connected device send and receive packets with 802.1p priority.

none

Specifies that the switch does not send any auxiliary VLAN information in the CDP packets from that port.


Defaults

The default setting is none.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

If you do not specify a port, all ports are selected.The vlan option specifies that the connected device send packets tagged with a specific VLAN.

If you enter the none option, voice information will not be sent or received.

Dynamic VLAN support for voice VLAN identifier (VVID) includes these restrictions to the following multiple VLAN access port (MVAP) configuration on the switch port:

You can configure any VVID on a dynamic port including dot1p and untagged, except when the VVID is equal to dot1p or untagged. If this is the case, you must configure VMPS with the MAC address of the IP phone. When you configure the VVID as dot1p or untagged on a dynamic port, this warning message is displayed:

VMPS should be configured with the IP phone mac's.

For dynamic ports, the auxiliary VLAN ID cannot be the same as the native VLAN ID assigned by VMPS for the dynamic port.

You cannot configure trunk ports as dynamic ports, but an MVAP can be configured as a dynamic port.

Examples

This example shows how to set the auxiliary VLAN port to untagged:

Console> (enable) set port auxiliaryvlan 5/7 untagged
Port 5/7 allows the connected device send and receive untagged packets and 
without 802.1p priority.  
Console> (enable)

This example shows how to set the auxiliary VLAN port to dot1p:

Console> (enable) set port auxiliaryvlan 5/9 dot1p
Port 5/9 allows the connected device send and receive packets with 802.1p priority.
Console> (enable)

This example shows how to set the auxiliary VLAN port to none:

Console> (enable) set port auxiliaryvlan 5/12 none 
Port 5/12 will not allow sending CDP packets with AuxiliaryVLAN information.
Console> (enable)

This example shows how to set the auxiliary VLAN port to a specific module, port, and VLAN:

Console> (enable) set port auxiliaryvlan 2/1-3 222 
Auxiliaryvlan 222 configuration successful.
AuxiliaryVlan AuxVlanStatus Mod/Ports
------------- ------------- -------------------------
222           active        1/2,2/1-3
Console> (enable)

Related Commands

show port auxiliaryvlan

set port broadcast

To set broadcast, multicast, or unicast suppression for one or more ports, use the set port broadcast command. The threshold limits the backplane traffic received from the module.

set port broadcast mod/port threshold% [violation {drop-packets | errdisable}]
[
multicast {enable | disable}] [unicast {enable | disable}]

Syntax Description

mod/port

Number of the module and the port on the module.

threshold%

Percentage of total available bandwidth that can be used by traffic; valid values are decimal numbers from 0.00% to 100% or whole numbers from 0% to 100%.

violation

(Optional) Specifies an action when suppression occurs.

drop-packets

(Optional) Drops packets when suppression occurs.

errdisable

(Optional) Errdisables the port when suppression occurs.

multicast

(Optional) Specifies multicast suppression.

enable | disable

(Optional) Enables or disables the suppression type.

unicast

(Optional) Specifies unicast suppression.


Defaults

The default is 100% (no broadcast limit).

The default action is drop-packets if a broadcast violation occurs.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

You can enter the threshold value in two ways:

A decimal number followed by a percent sign (for example 0.33%)

A whole number followed by a percent sign (for example 33%)

The percent sign (%) is required when entering the threshold value.

The multicast and unicast keywords are supported on Gigabit Ethernet modules only.

If you enter the command without using the multicast or unicast keyword, only broadcast traffic is suppressed. If you enter the multicast or unicast keyword, both broadcast and the selected traffic type are suppressed.

Examples

This example shows how to limit broadcast traffic to 20 percent:

Console> (enable) set port broadcast 4/3 20%
Port 4/3 broadcast traffic limited to 20.00%.
Console> (enable) 

This example shows how to limit broadcast traffic to 90 percent and to errdisable when suppression occurs:

Console> (enable) set port broadcast 4/6 90% violation errdisable
Port 4/6 broadcast traffic limited to 90.00%.
On broadcast suppression port 4/6 is configured to move to errdisabled state.
Console> (enable)

This example shows how to allow a specific amount of multicast traffic to a range of ports:

Console> (enable) set port broadcast 4/1-24 80% multicast enable
Port 4/1-24 multicast traffic limited to 80%.
Console> (enable) 

This example shows how to limit broadcast and multicast traffic to 91 percent, to disable unicast traffic, and to errdisable when suppression occurs:

Console> (enable) set port broadcast 4/2 91% violation errdisable multicast enable unicast 
disable 
Port 4/2 broadcast and multicast traffic limited to 91.00%.
On broadcast suppression port 4/2 is configured to move to errdisabled state.
Console> (enable)

This example shows how to limit broadcast, multicast, and unicast traffic to 91 percent:

Console> (enable) set port broadcast 4/2 91% multicast enable unicast enable
Port 4/2 broadcast, multicast and unicast traffic limited to 91.00%.
Console> (enable)

Related Commands

clear port broadcast
show port broadcast

set port channel

To configure EtherChannel on Ethernet module ports, use the set port channel command.

set port channel mod/port [admin_group]

set port channel mod/port mode {on | off | desirable | auto} [silent | non-silent]

set port channel all mode off

set port channel all distribution {ip | mac} [source | destination | both]

set port channel all distribution {session} [source | destination | both]

Syntax Description

mod/port

Number of the module and the port on the module.

admin_group

(Optional) Number of the administrative group; valid values are from 1 to 1024.

mode

Specifies the EtherChannel mode.

on

Enables and forces specified ports to channel without PAgP.

off

Prevents ports from channeling.

desirable

Sets a PAgP mode that places a port into an active negotiating state, in which the port initiates negotiations with other ports by sending PAgP packets.

auto

Sets a PAgP mode that places a port into a passive negotiating state, in which the port responds to PAgP packets it receives, but does not initiate PAgP packet negotiation.

silent

(Optional) Uses with auto or desirable when no traffic is expected from the other device to prevent the link from being reported to STP as down.

non-silent

(Optional) Uses with auto or desirable when traffic is expected from the other device.

all mode off

Turns off channeling on all ports globally.

all distribution

Applies frame distribution to all ports in the Catalyst 6500 series switch.

ip

Specifies the frame distribution method using IP address values.

mac

Specifies the frame distribution method using MAC address values.

source

(Optional) Specifies the frame distribution method using source address values.

destination

(Optional) Specifies the frame distribution method using destination address values.

both

(Optional) Specifies the frame distribution method using source and destination address values.

session

Allows frame distribution of Layer 4 traffic.

both

(Optional) Specifies the frame distribution method using source and destination Layer 4 port number.


Defaults

The default is EtherChannel is set to auto and silent on all module ports. The defaults for frame distribution are ip and both.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

This command is not supported by non-EtherChannel-capable modules.

The set port channel all distribution session command is supported on systems configured with the Supervisor Engine 2 with Layer 3 Switching Engine II (PFC2) only.

Make sure that all ports in the channel are configured with the same port speed, duplex mode, and so forth. For more information on EtherChannel, refer to the Catalyst 6500 Series Switch Software Configuration Guide.

With the on mode, a usable EtherChannel exists only when a port group in on mode is connected to another port group in on mode.

If you are running QoS, make sure that bundled ports are all of the same trust types and have similar queueing and drop capabilities.

Disable the port security feature on the channeled ports (see the set port security command). If you enable port security for a channeled port, the port shuts down when it receives packets with source addresses that do not match the secure address of the port.

You can configure up to eight ports on the same switch in each administrative group.

When you assign ports to an existing administrative group, the original ports associated with the administrative group will move to a new automatically picked administrative group. You cannot add ports to the same administrative group.

If you do not enter an admin_group value, a new administrative group is created with the admin_group value selected automatically. The next available administrative group is automatically selected.

If you do not enter the channel mode, the channel mode of the ports addressed are not modified.

The silent | non-silent parameters only apply if desirable or auto modes are entered.

If you do not specify silent or non-silent, the current setting is not affected.


Note With software releases 6.2(1) and earlier, the 6- and 9-slot Catalyst 6500 series switches support a maximum of 128 EtherChannels.

With software releases 6.2(2) and later, due to the port ID handling by the spanning tree feature, the maximum supported number of EtherChannels is 126 for a 6- or 9-slot chassis and 63 for a 13-slot chassis. Note that the 13-slot chassis was first supported in software release 6.2(2).


Examples

This example shows how to set the channel mode to desirable:

Console> (enable) set port channel 2/2-8 mode desirable
Ports 2/2-8 channel mode set to desirable.
Console> (enable)

This example shows how to set the channel mode to auto:

Console> (enable) set port channel 2/7-8,3/1 mode auto
Ports 2/7-8,3/1 channel mode set to auto.
Console> (enable)

This example shows how to group ports 4/1 through 4 in an administrative group:

Console> (enable) set port channel 4/1-4 96
Port(s) 4/1-4 are assigned to admin group 96.
Console> (enable)

This example shows the display when the port list is exceeded:

Console> (enable) set port channel 2/1-9 1
No more than 8 ports can be assigned to an admin group.
Console> (enable) 

This example shows how to disable EtherChannel on module 4, ports 4 through 6:

Console> (enable) set port channel 4/4-6 mode off
Port(s) 4/4-6 channel mode set to off.
Console> (enable) 

This example shows the display output when you assign ports to an existing administrative group. This example moves ports in admin group 96 to another admin group and assigns ports 4/4 through 6 to admin group 96:

Console> (enable) set port channel 4/4-6 96
Port(s) 4/1-3 are moved to admin group 97.
Port(s) 4/4-6 are assigned to admin group 96.
Console> (enable) 

This example shows how to set the channel mode to off for ports 4/4 through 6 and assign ports 4/4 through 6 to an automatically selected administrative group:

Console> (enable) set port channel 4/4-6 off
Port(s) 4/4-6 channel mode set to off.
Port(s) 4/4-6 are assigned to admin group 23.
Console> (enable) 

This example shows how to configure the EtherChannel load-balancing feature:

Console> (enable) set port channel all distribution ip destination
Channel distribution is set to ip destination.
Console> (enable) 

Related Commands

show channel
show channel group
show port channel

set port cops

To create port roles, use the set port cops command.

set port cops mod/port roles role1 [role2]...

Syntax Description

mod/port

Number of the module and the port on the module.

roles role#

Specifies the roles.


Defaults

The default is all ports have a default role of null string, for example, the string of length 0.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

A port may have multiple roles. You can configure a maximum of 64 total roles per switch. You can specify multiple roles in a single command.

Examples

This example shows how to create roles on a port:

Console> (enable) set port cops 3/1 roles backbone_port main_port
New role `backbone_port' created.
New role `main_port' created.
Roles added for port 3/1-4.
Console> (enable)

This example shows the display if you attempt to create a roll and exceed the maximum allowable number of roles:

Console> (enable) set port cops 3/1 roles access_port
Unable to add new role. Maximum number of roles is 64.
Console> (enable)

Related Commands

clear port cops
show port cops

set port debounce

To enable or disable the debounce timer or configure the timer setting on a per-port basis, use the set port debounce command.

set port debounce mod/port {enable | disable}

set port debounce mod/port delay time

Syntax Description

mod/port

Number of the module and the port on the module.

enable | disable

Enables or disables the debounce timer.

delay

Sets the debounce timer for gigabit fiber ports.

time

Amount of time the firmware waits before notifying the supervisor engine of a link change; valid values are 200 milliseconds or from 300 to 5000 milliseconds. This is supported on gigabit fiber ports only. See the "Usage Guidelines" section for more information.


Defaults

By default, the debounce timer is disabled on all ports.

When the debounce timer is disabled, the default debounce timer values are as follows:

10/100 ports—300 milliseconds

100BASE-FX ports—300 milliseconds

10/100/1000BASE-T and gigabit TX ports—300 milliseconds

10-gigabit ports—10 milliseconds

When the debounce timer is enabled, the default debounce timer values are as follows:

10/100 ports—3100 milliseconds

100BASE-FX ports—3100 milliseconds

10/100/1000BASE-T and gigabit TX ports—3100 milliseconds

10-gigabit ports—100 milliseconds

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The debounce timer is the time the firmware waits before notifying the supervisor engine of a link change at the physical layer.

Setting the debounce timer value to 200 milliseconds or from 300 to 5000 milliseconds is possible only for gigabit fiber ports. You do not need to enable the debounce timer on a gigabit fiber port before adjusting the timer. Any timer value that is greater than the default value in disabled state is considered a value that enables the timer.

For 10/100 ports and 100BASE-FX ports in the disabled state, the firmware may take up to 600 milliseconds to notify the supervisor engine of a link change because the firmware polling time is every 300 milliseconds.

For 10/100 ports and 100BASE-FX ports in the enabled state, the firmware may take up to 3400 milliseconds to notify the supervisor engine of a link change because the firmware polling time is every 300 milliseconds.

Examples

This example shows how to enable the debounce timer for a specific port on a specific module:

Console> (enable) set port debounce 1/1 enable
Debounce is enabled on port 1/1.
Warning:Enabling port debounce causes Link Up/Down detections to be delayed.
It results in loss of data traffic during debouncing period, which might
affect the convergence/reconvergence of various Layer 2 and Layer 3
protocols.
Use with caution.
Console> (enable)

Related Commands

show port debounce

set port disable

To disable a port or a range of ports, use the set port disable command.

set port disable mod/port

Syntax Description

mod/port

Number of the module and the port on the module.


Defaults

The default system configuration has all ports enabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

It takes approximately 30 seconds for this command to take effect.

Examples

This example shows how to disable a port using the set port disable command:

Console> (enable) set port disable 5/10
Port 5/10 disabled.
Console> (enable) 

Related Commands

set port enable
show port

set port dot1q-all-tagged

To enable the 802.1Q tagging feature on specific ports, use the set port dot1q-all-tagged command.

set port dot1q-all-tagged {mod/port} {enable | disable}

Syntax Description

mod/port

Number of the module and the port on the module.

enable

Enables the dot1q-all-tagged feature.

disable

Disables the dot1q-all-tagged feature.


Defaults

The 802.1Q tagging feature is enabled on a per-port basis. See the "Usage Guidelines" section for more information.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

Although 802.1Q tagging is enabled by default on a per-port basis, tagging only takes effect when you enable the feature globally by entering the set dot1q-all-tagged enable command. When the global command is enabled, if you do not want tagging on a specific port, you must disable the feature on that port.

Examples

This example shows how to enable the dot1q tagging feature on specific ports:

Console> (enable) set port dot1q-all-tagged 1/1-2 enable
Packets on native vlan will be tagged on port(s) 1/1-2.
Console> (enable)

This example shows how to enable the dot1q tagging feature on all ports:

Console> (enable) set port dot1q-all-tagged all enable
Packets on native vlan will be tagged on all applicable ports.
Console> (enable)

This example shows how to disable the dot1q tagging feature on specific ports:

Console> (enable) set port dot1q-all-tagged 1/1-2 disable
Packets on native vlan will not be tagged for port(s) 1/1-2.
Console> (enable)

This example shows how to disable the dot1q tagging feature on all ports:

Console> (enable) set port dot1q-all-tagged all disable
Packets on native vlan will not be tagged on all applicable ports.
Console> (enable)

Related Commands

set dot1q-all-tagged
show dot1q-all-tagged
show port dot1q-all-tagged

set port dot1qtunnel

To configure the dot1q tunnel mode for the port, use the set port dot1qtunnel command.

set port dot1qtunnel mod/port {access | disable}

Syntax Description

mod/port

Number of the module and the port on the module.

access

Turns off the port's trunking mode.

disable

Disables dot1q tunneling.


Defaults

The default is dot1qtunnel is disabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

You cannot enable the dot1q tunneling feature on a port until dot1q-tagged-only mode is enabled.

You cannot disable dot1q-tagged-only mode on the switch until dot1q tunneling is disabled on all the ports on the switch.

You cannot set the dot1q tunnel mode to access if port security is enabled.

You cannot set the dot1q tunnel mode to access on a port with an auxiliary VLAN configured.

An interconnected network can have redundant paths to the same edge switch of ISP, but it cannot have redundant paths to two different edge switches of ISP.


Note PBF does not work with 802.1Q tunnel traffic. PBF is supported on Layer 3 IP unicast traffic, but it is not applicable to Layer 2 traffic. At the intermediate (PBF) switch, all 802.1Q tunnel traffic appears as Layer 2 traffic.


If you enable dot1q-tagged globally, the dot1q-tagged per-port setting controls whether or not the frames are tagged. If you disable dot-1q-tagged globally, the default group is never tagged and the per-port setting has no effect.

Examples

This example shows how to set dot1q tunneling on the port to access:

Console> (enable) set port dot1qtunnel 4/1 access
Dot1q tunnel feature set to access mode on port 4/1.
Port 4/2 trunk mode set to off.
Console> (enable) 

This example shows the output if you try to turn on trunking on a port that has dot1q tunneling mode set:

Console> (enable) set trunk 4/1 on
Failed to set port 4/1 to trunk mode on.
The dot1q tunnel mode for the port is currently set to access.
Console> (enable) 

Related Commands

show port dot1qtunnel

set port dot1x

To configure dot1x on a port, use the set port dot1x command.

set port dot1x mod/port multiple-host {enable | disable}

set port dot1x mod/port {port-control port_control_value}

set port dot1x mod/port {initialize | re-authenticate}

set port dot1x mod/port re-authentication {enable | disable}

set port dot1x mod/port multiple-authentication {enable | disable}

set port dot1x mod/port guest-vlan {vlan | none}

Syntax Description

mod/port

Number of the module and port on the module.

multiple-host

Specifies multiple-user access; see the "Usage Guidelines" section for more information.

enable

Enables multiple-user access.

disable

Disables multiple-user access.

port-control port_control_value

Specifies the port control type; valid values are force-authorized, force-unauthorized, and auto.

initialize

Initializes dot1x on the port.

re-authenticate

Manually initiates a reauthentication of the entity connected to the port.

re-authentication

Automatically initiates reauthentication of the entity connected to the port within the reauthentication time period; see the "Usage Guidelines" section for more information.

enable

Enables automatic reauthentication.

disable

Disables automatic reauthentication.

multiple-authentication

Specifies multiple authentications so that more than one host can gain access to the port; see the "Usage Guidelines" section for more information.

enable

Enables multiple authentication.

disable

Disables multiple authentication.

guest-vlan

Specifies an active VLAN as an 802.1x guest VLAN.

vlan

Number of the VLAN; valid values are from 1 to 1005 and 1025 to 4094.

none

Clears the guest VLAN on the port.


Defaults

The default settings are as follows:

The default port_control_value is force-authorized.

The multiple host feature is disabled.

The reauthentication feature is disabled.

The multiple authentication feature is disabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

The dot1x port will not be allowed to become a trunk port, MVAP, channel port, dynamic port, or a secure port.

When setting the port control type, the following applies:

force-authorized forces the controlled port to transition to the authorized state unconditionally and is equivalent to disabling 802.1x restriction in the port.

force-unauthorized forces the controlled port to transit to the unauthorized state unconditionally and prevents the authorized services of the authenticator to the supplicant.

auto enables 802.1x control on the port.

If you disable the multiple host feature, once a dot1x port is authorized through a successful authentication of a supplicant, only that particular host (MAC address) is allowed on that port. When the system detects another host (different MAC address) on the authorized port, it shuts down the port and displays a syslog message. This is the default system behavior.

If you enable the multiple host feature, once a dot1x port is authorized through a successful authentication of a supplicant, any host (any MAC address) is allowed to send or receive traffic on that port.

If you enable reauthentication, you can set the reauthentication time period in seconds by entering the set dot1x re-authperiod seconds command. The default for the reauthentication time period is 3600 seconds.

You can enable either multiple host mode or multiple authentication mode.

Examples

This example shows how to set the port control type automatically:

Console> (enable) set port dot1x 4/1 port-control auto
Port 4/1 dot1x port-control is set to auto.
Console> (enable)

This example shows how to initialize dot1x on a port:

Console> (enable) set port dot1x 4/1 initialize
dot1x port 4/1 initializing...
dot1x initialized on port 4/1.
Console> (enable)

This example shows how to manually reauthenticate a port:

Console> (enable) set port dot1x 4/1 re-authenticate
dot1x port 4/1 re-authenticating...
dot1x re-authentication successful...
dot1x port 4/1 authorized.
Console> (enable) 

This example shows how to enable multiple-user access on a specific port:

Console> (enable) set port dot1x 4/1 multiple-host enable
Multiple hosts allowed on port 4/1.
Console> (enable) 

This example shows how to enable automatic reauthentication on a port:

Console> (enable) set port dot1x 4/1 re-authentication enable
Port 4/1 re-authentication enabled.
Console> (enable) 

Related Commands

set dot1x
show dot1x
show port dot1x

set port duplex

To configure the duplex type of an Ethernet port or a range of ports, use the set port duplex command.

set port duplex mod/port {full | half}

Syntax Description

mod/port

Number of the module and the port on the module.

full

Specifies full-duplex transmission.

half

Specifies half-duplex transmission.


Defaults

The default configuration for 10-Mbps and 100-Mbps modules has all Ethernet ports set to half duplex.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

You can configure Ethernet and Fast Ethernet interfaces to either full duplex or half duplex.

The set port duplex command is not supported on Gigabit Ethernet ports. Gigabit Ethernet ports support full-duplex mode only.

If the transmission speed on a 16-port RJ-45 Gigabit Ethernet port is set to 1000, duplex mode is set to full. If the transmission speed is changed to 10 or 100, the duplex mode stays at full. You must configure the correct duplex mode when transmission speed is changed to 10 or 100 from 1000.

Examples

This example shows how to set port 1 on module 2 to full duplex:

Console> (enable) set port duplex 2/1 full
Port 2/1 set to full-duplex.
Console> (enable)

Related Commands

show port

set port enable

To enable a port or a range of ports, use the set port enable command.

set port enable mod/port

Syntax Description

mod/port

Number of the module and the port on the module.


Defaults

The default is all ports are enabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

It takes approximately 30 seconds for this command to take effect.

Examples

This example shows how to enable port 3 on module 2:

Console> (enable) set port enable 2/3
Port 2/3 enabled.
Console> (enable) 

Related Commands

set port disable
show port

set port errdisable-timeout

To prevent an errdisabled port from being enabled, use the set port errdisable-timeout command.

set port errdisable-timeout mod/port {enable | disable}

Syntax Description

mod/port

Number of the module and the port on the module.

enable

Enables errdisable timeout.

disable

Disables errdisable timeout.


Defaults

By default, the errdisable timeout for each port is enabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

When the global timer times out, the port will be reenabled. Use the set port errdisable-timeout command if you want the port to remain in the errdisabled state.

Examples

This example shows how to prevent port 3/3 from being enabled when it goes into errdisabled state:

Console> (enable) set port errdisable-timeout 3/3 disable
Successfully disabled errdisable-timeout for port 3/3.
Console> (enable) 

Related Commands

set errdisable-timeout
show errdisable-timeout
show port errdisable-timeout

set port flowcontrol

To configure a port to send or receive pause frames, use the set port flowcontrol command. Pause frames are special packets that signal a source to stop sending frames for a specific period of time because the buffers are full.

set port flowcontrol mod/port {receive | send} {off | on | desired}

Syntax Description

mod/port

Number of the module and the port on the module.

receive

Specifies a port processes pause frames.

send

Specifies a port sends pause frames.

off

Prevents a local port from receiving and processing pause frames from remote ports or from sending pause frames to remote ports.

on

Enables a local port to receive and process pause frames from remote ports or send pause frames to remote ports.

desired

Obtains predictable results regardless of whether a remote port is set to on, off, or desired.


Defaults

Flow-control defaults vary depending upon port speed:

Gigabit Ethernet ports default to off for receive (Rx) and desired for transmit (Tx)

Fast Ethernet ports default to off for receive and on for transmit

On the 24-port 100BASE-FX and 48-port 10/100 BASE-TX RJ-45 modules, the default is off for receive and off for send.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

When you configure the 24-port 100BASE-FX and 48-port 10/100 BASE-TX RJ-45 modules, you can set the receive flow control to on or off and the send flow control to off.

All Catalyst Gigabit Ethernet ports can receive and process pause frames from remote devices.

To obtain predictable results, use these guidelines:

Use send on only when remote ports are set to receive on or receive desired.

Use send off only when remote ports are set to receive off or receive desired.

Use receive on only when remote ports are set to send on or send desired.

Use send off only when remote ports are set to receive off or receive desired.

Table 2-15 describes guidelines for different configurations of the send and receive keywords.

Table 2-15 send and receive Keyword Configurations

Configuration
Description

send on

Enables a local port to send pause frames to remote ports.

send off

Prevents a local port from sending pause frames to remote ports.

send desired

Obtains predictable results whether a remote port is set to receive on, receive off, or receive desired.

receive on

Enables a local port to process pause frames that a remote port sends.

receive off

Prevents a local port from sending pause frames to remote ports.

receive desired

Obtains predictable results whether a remote port is set to send on, send off, or send desired.


Examples

This example shows how to configure port 1 of module 5 to receive and process pause frames:

Console> (enable) set port flowcontrol receive 5/1 on
Port 5/1 flow control receive administration status set to on
(port will require far end to send flowcontrol)
Console> (enable)

This example shows how to configure port 1 of module 5 to receive and process pause frames if the remote port is configured to send pause frames:

Console> (enable) set port flowcontrol receive 5/1 desired
Port 5/1 flow control receive administration status set to desired
(port will allow far end to send flowcontrol if far end supports it)
Console> (enable)

This example shows how to configure port 1 of module 5 to receive but NOT process pause frames on port 1 of module 5:

Console> (enable) set port flowcontrol receive 5/1 off
Port 5/1 flow control receive administration status set to off
(port will not allow far end to send flowcontrol)
Console> (enable)

This example shows how to configure port 1 of module 5 to send pause frames:

Console> (enable) set port flowcontrol send 5/1 on
Port 5/1 flow control send administration status set to on
(port will send flowcontrol to far end)
Console> (enable)

This example shows how to configure port 1 of module 5 to send pause frames and yield predictable results even if the remote port is set to receive off:

Console> (enable) set port flowcontrol send 5/1 desired
Port 5/1 flow control send administration status set to desired
(port will send flowcontrol to far end if far end supports it)
Console> (enable)

Related Commands

show port flowcontrol

set port gmrp

To enable or disable GMRP on the specified ports in all VLANs, use the set port gmrp command.

set port gmrp mod/port {enable | disable}

Syntax Description

mod/port

Number of the module and the port on the module.

enable

Enables GVRP on a specified port.

disable

Disables GVRP on a specified port.


Defaults

The default is GMRP is disabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

You can enter this command even when GMRP is not enabled, but the values come into effect only when you enable GMRP using the set gmrp enable command.

Examples

This example shows how to enable GMRP on module 3, port 1:

Console> (enable) set port gmrp 3/1 enable
GMRP enabled on port(s) 3/1.
GMRP feature is currently disabled on the switch.
Console> (enable)

This example shows how to disable GMRP on module 3, ports 1 through 5:

Console> (enable) set port gmrp 3/1-5 disable
GMRP disabled on port(s) 3/1-5.
Console> (enable)

Related Commands

show gmrp configuration

set port gvrp

To enable or disable GVRP on the specified ports in all VLANs, use the set port gvrp command.

set port gvrp mod/port {enable | disable}

Syntax Description

mod/port

Number of the module and the port on the module.

enable

Enables GVRP on a specified port.

disable

Disables GVRP on a specified port.


Defaults

The default is GVRP is disabled.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

When you enable VTP pruning, it runs on all the GVRP-disabled trunks.

To run GVRP on a trunk, you need to enable GVRP both globally on the switch and individually on the trunk.

You can configure GVRP on a port even when you globally enable GVRP. However, the port will not become a GVRP participant until you globally enable GVRP.

You can enable GVRP on an 802.1Q trunk only.

If you enter the set port gvrp command without specifying the port number, GVRP is affected globally in the switch.

Examples

This example shows how to enable GVRP on module 3, port 2:

Console> (enable) set port gvrp 3/2 enable
GVRP enabled on 3/2.
Console> (enable) 

This example shows how to disable GVRP on module 3, port 2:

Console> (enable) set port gvrp 3/2 disable
GVRP disabled on 3/2.
Console> (enable) 

This example shows what happens if you try to enable GVRP on a port that is not an 802.1Q trunk:

Console> (enable) set port gvrp 4/1 enable
Failed to set port 4/1 to GVRP enable. Port not allow GVRP.
Console> (enable) 

This example shows what happens if you try to enable GVRP on a specific port when GVRP has not first been enabled using the set gvrp command:

Console> (enable) set port gvrp 5/1 enable
GVRP enabled on port(s) 5/1.
GVRP feature is currently disabled on the switch.
Console> (enable)

Related Commands

clear gvrp statistics
set gvrp
show gvrp configuration

set port host

To optimize the port configuration for a host connection, use the set port host command.

set port host mod/port

Syntax Description

mod/port

Number of the module and the port on the module.


Defaults

This command has no default settings.

Command Types

Switch command.

Command Modes

Privileged.

Usage Guidelines

This command is not supported by the NAM.

To optimize the port configuration, the set port host command sets channel mode to off, enables spanning tree PortFast, sets the trunk mode to off, and disables the dot1q tunnel feature. Only an end station can accept this configuration.

Because spanning tree PortFast is enabled, you should enter the set port host command only on ports connected to a single host. Connecting hubs, concentrators, switches, and bridges to a fast-start port can cause temporary spanning tree loops.

Enable the set port host command to decrease the time it takes to start up packet forwarding.

Examples

This example shows how to optimize the port configuration for end station/host connections on ports 2/1 and 3/1:

Console> (enable) set port host 2/1,3/1

Warning: Span tree port fast start should only be enabled on 
ports connected to a single host.  Connecting hubs, concentrators, 
switches, bridges, etc. to a fast start port can cause temporary 
spanning tree loops.  Use with caution.

Spantree ports 2/1,3/1 fast start enabled.
Dot1q tunnel feature disabled on port(s)  4/1.
Port(s) 2/1,3/1 trunk mode set to off.
Port(s) 2/1 channel mode set to off.

Console> (enable) 

Related Commands

clear port host

set port inlinepower

To set the inline power mode of a port or group of ports, use the s