cc/td/doc/product/lan/cat5000/rel_5_2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

set arp
set authentication enable
set authentication login
set banner motd
set boot auto-config
set boot config-register
set boot system flash
set bridge apart
set bridge fddicheck
set bridge ipx 8022toether
set bridge ipx 8023rawtofddi
set bridge ipx snaptoether
set cam
set cdp
set cdp holdtime
set cdp interval
set cgmp
set cgmp leave
set channel cost
set channel vlancost
set enablepass
set fddi alarm

set arp

Use the set arp command to add IP address-to-MAC address mapping entries to the ARP table and to set the ARP aging time for the table.

set arp ip_addr hw_addr
set arp agingtime agingtime

Syntax Description

ip_addr

IP address or IP alias to map to the specified MAC address.

hw_addr

MAC address to map to the specified IP address or IP alias.

agingtime

Keyword to set the period of time after which an ARP entry is removed from the ARP table.

agingtime

Number of seconds (from 0 to 1,000,000) that entries will remain in the ARP table before being deleted. Setting this value to 0 disables aging.

Default

No ARP table entries exist; ARP aging is set to 1200 seconds.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

hw_addr is 6-hexbyte MAC address in canonical (00-11-22-33-44-55) or non-canonical (00:11:22:33:44:55) format.

Examples

This example shows how to map IP address 192.168.255.255 to MAC address 00-00-0c-40-0f-bc:

Console> (enable) set arp 192.168.255.255 00-00-0c-40-0f-bc
ARP entry added.
Console> (enable)
 

This example shows how to set the aging time for the ARP table to 1800 seconds:

Console> (enable) set arp agingtime 1800
ARP aging time set to 1800 seconds.
Console> (enable)
Related Commands

clear arp
show arp

set authentication enable

Use the set authentication enable command to configure the switch to use TACACS+, Kerberos, RADIUS, or local authentication to authenticate privileged (enable) mode access on the switch.

set authentication enable {local | radius | tacacs | kerberos} enable [console | telnet | both]     [primary]
set authentication enable {local | radius | tacacs | kerberos} disable [console | telnet | both]

Syntax Description

local

Keyword to specify local authentication for privileged mode access.

radius

Keyword to specify RADIUS authentication for privileged mode access.

tacacs

Keyword to specify TACACS+ authentication for privileged mode access.

kerberos

Keyword to specify Kerberos authentication for privileged mode access.

enable

Keyword to enable the specified authentication method for privileged mode access.

console

Keyword to specify the authentication method applies to console sessions.

telnet

Keyword to specify the authentication method applies to Telnet sessions.

both

Keyword to specify the authentication method applies to both Telnet and console sessions.

primary

(Optional) Keyword to specify the specified authentication method be tried first.

disable

Keyword to disable the specified authentication method for privileged mode access.

Default

The default setting of this command is local authentication is enabled and all other authentication methods are disabled.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can specify TACACS+ or RADIUS as the primary authentication method for login and enable access by entering the primary keyword. If you enter the primary keyword, the specified authentication method will be tried first. If you do not specify a primary authentication, authentication will be tried in the order in which you enabled them.

You can specify that the authentication method applies to console sessions, Telnet sessions, or both, by entering the console, telnet, or both keyword. If you do not specify console, telnet, or both, the authentication method applies to both console and Telnet sessions.

Examples

This example shows how to use the TACACS+ server to determine if a user has privileged access permission:

Console> (enable) set authentication enable tacacs enable
Tacacs Enable authentication set to enable.
Console> (enable)
 

This example shows how to use the local password to determine if the user has privileged access permission:

Console> (enable) set authentication enable local enable
Local Enable authentication set to enable.
Console> (enable)
 

This example shows how to use the RADIUS server to determine if the user has privileged access permission:

Console> (enable) set authentication enable radius enable both 
RADIUS Enable authentication set to enable for console and telnet sessions.
Console> (enable) 
 

This example shows how to use the TACACS+ server as the primary method to determine if the user has privileged access permission:

Console> (enable) set authentication enable tacacs enable primary
Tacacs Enable authentication set to enable as primary authentication for console and telnet sessions.
Console> (enable) 
 

The following example shows how to enable Kerberos as the login authentication method for Telnet:

kerberos> (enable) set authentication login kerberos enable telnet 
kerberos login authentication set to enable for telnet session.
kerberos> (enable) 
 

The following example shows how to enable Kerberos as the login authentication method for the console:

kerberos> (enable) set authentication login  kerberos enable console 
kerberos login authentication set to enable for console session.
kerberos> (enable) 
 
Related Commands

set authentication login
show authentication

set authentication login

Use the set authentication login command to configure the switch to use TACACS+, Kerberos, RADIUS, or local authentication to authenticate normal (login) mode access on the switch.

set authentication login {local | radius | tacacs | kerberos} enable [console | telnet | both]     [primary]
set authentication login {local | radius | tacacs | kerberos} enable [console | telnet | both]

Syntax Description

local

Keyword to specify local authentication for normal mode access.

radius

Keyword to specify RADIUS authentication for normal mode access.

tacacs

Keyword to specify TACACS+ authentication for normal mode access.

kerberos

Keyword to specify Kerberos authentication for normal mode access.

enable

Keyword to enable the specified authentication method for normal mode access.

console

Keyword to specify the authentication method applies to console sessions.

telnet

Keyword to specify the authentication method applies to Telnet sessions.

both

Keyword to specify the authentication method applies to both Telnet and console sessions.

primary

(Optional) Keyword to specify the specified authentication method be tried first.

disable

Keyword to disable the specified authentication method for normal mode access.

Default

The default setting of this command is local authentication is enabled and all other authentication methods are disabled.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can specify TACACS+ or RADIUS as the primary authentication method for normal (login) mode access. If you enter the primary keyword, the specified authentication method will be tried first. If you do not specify a primary authentication, authentication will be tried in the order in which you enabled them.

You can specify that the authentication method applies to console sessions, Telnet sessions, or both, by entering the console, telnet, or both keyword. If you do not specify console, telnet, or both, the authentication method applies to both console and Telnet sessions.

Examples

This example shows how to disable the TACACS+ server from determining if a Telnet user has normal (login) access permission:

Console> (enable) set authentication login tacacs disable telnet
TACACS Login authentication set to disable for the telnet sessions.
Console> (enable) 
 

This example shows how to disable the RADIUS server from determining if a console user has normal (login) access permission:

Console> (enable) set authentication login radius disable console
RADIUS Login authentication set to disable for the console sessions.
Console> (enable) 
 

This example shows how to disable the local password from determining if the user has normal (login) access permission:

Console> (enable) set authentication login local disable telnet
Local Login authentication set to disable for the telnet sessions.
Console> (enable) 
 
Related Commands

set authentication enable
show authentication

set banner motd

Use the set banner motd command to create a login banner to display when users access the switch.

set banner motd c [text] c

Syntax Description

c

Delimiting character used to begin and end the message.

text

(Optional) Message of the day.

Default

No MOTD banner is defined.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can use either the clear banner motd command or the set banner motd cc command to clear the message-of-the-day banner.

Examples

This example shows how to set the message of the day using the pound sign (#) as the delimiting character:

Console> (enable) set banner motd #
** System upgrade at 6:00am Tuesday.
** Please log out before leaving on Monday. #
MOTD banner set.
Console> (enable>
 

This example shows how to clear the message of the day:

Console> (enable) set banner motd ##
MOTD banner cleared.
Console> (enable>
Related Command

clear banner motd

set boot auto-config

Use the set boot auto-config command to specify one or more configuration files to use to configure the switch at startup and to set the recurrence option. A list of configuration files is stored in the CONFIG_FILE environment variable.

set boot auto-config device:filename [;<device:filename>...] [mod_num]
set boot auto-config
{cfg1 | cfg2 | cfg1;cfg2}
set boot auto-config {recurring | non-recurring}

Syntax Description

device:

Device where the startup configuration file resides.

filename

Names of the startup configuration file.

mod_num

(Optional) Module number of the supervisor engine containing the Flash device.

cfg1

Keyword that specifies the first startup configuration file on the Supervisor Engine II G and III G. Use a semicolon-separated list to specify multiple cfg files.

cfg2

Keyword that specifies the second startup configuration file on the Supervisor Engine II G and III G. Use a semicolon-separated list to specify multiple cfg files.

recurring

Keyword to retain config_file variable settings. Available only on the Supervisor Engine II G and III G.

non-recurring

Keyword to clear config_file variable settings before the startup configuration file runs. Available only on the Supervisor Engine II G and III G.

Default

The default setting of this command is non-recurring and the CONFIG_FILE is not defined.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The set boot auto-config command always overwrites the existing CONFIG_FILE environment variable settings (you cannot prepend or append a file to the variable contents).

In the Catalyst 5000 family Supervisor Engine III or III F, and Catalyst 4000 family, 2926G series, and 2948G switches, multiple configuration files may be specified, but they must be separated by a semicolon (;).

In the Catalyst 5000 family Supervisor Engine II G and III G, two configuration files may be specified. Separate the files using a semicolon (;).

You can set recurring, non-recurring, cfg1, and cfg2 keywords in Supervisor Engines II G and III G only.

To set the recurrence on other supervisor engines and switches, use the set boot config-register auto-config command.

Examples

This example shows how to specify the configuration file environment variable:

Console> (enable) set boot auto-config slot0:cfg1
CONFIG_FILE variable = slot0:cfg1
WARNING: nvram configuration may be lost during next bootup,
         and re-configured using the file(s) specified.
Console> (enable)
 

This example shows how to specify the configuration file environment variable on Supervisor Engines II G and III G:

Console> (enable) set boot auto-config cfg1
CONFIG_FILE variable = cfg1
WARNING: nvram configuration may be lost during next bootup,
         and re-configured using the file(s) specified.
Console> (enable)
 

This example shows how to specify multiple configuration files on Supervisor Engines II G
and III G:

Console> (enable) set boot auto-config cfg1;cfg2
CONFIG_FILE variable = cfg1;cfg2
WARNING: nvram configuration may be lost during next bootup,
         and re-configured using the file(s) specified.
Console> (enable)
 

This example shows how to set the auto-configuration to recurring on Supervisor Engines II G
and III G:

Console> (enable) set boot auto-config recurring
auto-config: recurring
Console> (enable)
Related Commands
set boot system flash

set boot config-register

Use the set boot config-register command to set the boot configuration register value.

set boot config-register 0xvalue [mod_num]
set boot config-register boot {rommon | bootflash | system} [mod_num]
set boot config-register baud {1200 | 2400 | 4800 | 9600} [mod_num]
set boot config-register ignore-config {enable | disable} [mod_num]
set boot config-register auto-config {recurring | non-recurring} [mod_num]

Syntax Description

0xvalue

(Optional) Keyword to set the 16-bit configuration register value. This value is a hexadecimal value and the valid range is 0x0 to 0xFFFF.

mod_num

(Optional) Module number of the supervisor engine on which to set the configuration register value.

boot

Keyword to specify the boot method to use the next time the switch is reset or power cycled.

rommon

Keyword that causes the switch to remain in ROM monitor mode the next time the switch is reset or power cycled.

bootflash

Keyword that causes the switch to boot using the first valid system image in bootflash the next time the switch is reset or power cycled.

system

Keyword that causes the switch to boot using the system images specified in the BOOT environment variable the next time the switch is reset or power cycled.

baud

Keyword to set the console baud rate.

1200 | 2400 | 4800 | 9600

Keywords to specify the ROM monitor console port baud rate.

ignore-config

Keyword that specifies whether the switch should ignore the configuration in NVRAM the next time the switch is restarted.

enable

Keyword that causes the switch to ignore the configuration in NVRAM the next time the switch is restarted.

disable

Keyword that prevents the switch from ignoring the configuration in NVRAM the next time the switch is restarted.

recurring

Keyword that causes the switch to retain the contents of the CONFIG_FILE environment variable after the switch is reset or power cycled and configured using the files specified by the CONFIG_FILE environment variable.

non-recurring

Keyword that causes the switch to clear the contents of the CONFIG_FILE environment variable after the switch is reset or power cycled and before the switch is configured using the files specified by the CONFIG_FILE environment variable.

Default

The default configuration register value is 0x10F, which specifies the following settings:

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

We recommend that you use only the rommon and system options to the set boot config-register boot command.

Each time you enter one of the set boot config-register commands, the system displays all current configuration register information (the equivalent of entering the show boot command).

The baud rate specified in the configuration register is used by the ROM monitor only and is different from the baud rate specified by the set system baud command.

The auto-config_file variable is slot0:switch.cfg for non-recurring and bootflash:switch.cfg for the Catalyst 4000 family switches.

Caution Enabling the ignore-config parameter is the same as entering the clear config all command; that is, it clears the entire configuration stored in NVRAM the next time the switch is restarted.
Examples

This example shows how to specify the default 16-bit configuration register value:

Console> (enable) set boot config-register 0x10f
Configuration register is 0x10f
ignore-config: disabled
auto-config: non-recurring
console baud: 9600
boot: image specified by the boot system commands
Console> (enable)
 

This example shows how to specify rommon as the boot image to use on the next restart:

Console> (enable) set boot config-register boot rommon
Configuration register is 0x100
ignore-config: disabled
auto-config: non-recurring
console baud: 9600
boot: the ROM monitor
Console> (enable) 
 

This example shows how to change the ROM monitor console port baud rate to 4800:

Console> (enable) set boot config-register baud 4800
Configuration register is 0x900
ignore-config: disabled
auto-config: non-recurring
console baud: 4800
boot: the ROM monitor
Console> (enable)
 

This example shows how to cause the switch to ignore the configuration in NVRAM the next time the switch is reset or power cycled:

Console> (enable) set boot config-register ignore-config enable
Configuration register is 0x940
ignore-config: enabled
auto-config: non-recurring
console baud: 4800
boot: the ROM monitor
Console> (enable) 
 

This example shows how to set the auto-configuration to recurring:

Console> (enable) set boot config-register auto-config recurring
Configuration register is 0x960
ignore-config: enabled
auto-config: recurring
console baud: 4800
boot: the ROM monitor
Console> (enable)
 
Related Commands

clear boot
show boot

set boot system flash

Use the set boot system flash command to set the BOOT environment variable, which specifies a list of software images that the switch attempts to load at startup.

set boot system flash device:filename [prepend] [mod_num]

Syntax Description

device:

Flash device where the software image is stored (the colon [:] is required).

filename

(Optional) Name of the software image file on the Flash device.

prepend

(Optional) Keyword to place the software image file first in the list of images to attempt to boot.

mod_num

(Optional) Module number of the supervisor engine on which to modify the BOOT environment variable.

Default

This command has no default setting.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

This command is not supported on the Catalyst 5000 Supervisor Engine II.

The mod_num option is not supported on the Catalyst 2926G series switch.

You can enter several boot system commands to provide a fail-safe method for booting the switch. The system stores and executes the boot system commands in the order in which you enter them.

When you copy a new software image to a Flash device and want to switch to boot that image the next time the switch is reset, clear the BOOT environment variable using the clear boot system all command or use the prepend keyword to place the new software image file first in the list of images to attempt to boot.

If the file does not exist (for example, if you entered the wrong filename), then the filename is appended to the bootstring, and a message displays, "Warning: File not found but still added in the bootstring."

If the file does exist, but is not a supervisor engine software image, the file is not added to the bootstring, and a message displays, "Warning: file found but it is not a valid boot image."

Examples

This example shows how to append a software image file to the BOOT environment variable:

Console> (enable) set boot sys flash bootflash:cat5000-sup3.5-1-1.bin
BOOT variable = 
bootflash:cat5000-sup3.5-2-1.bin,1;bootflash:cat5000-sup3.5-1-1.bin,1;
Console> (enable) 
 

This example shows how to prepend a software image file to the BOOT environment variable:

Console> (enable) set boot system flash slot0:cat5000-sup3.5-2-1.bin prepend
BOOT variable = 
slot0:cat5000-sup3.5-2-1.bin,1;bootflash:cat5000-sup3.4-5-2.bin,1;
Console> (enable) 
Related Commands

clear boot
show boot

set bridge apart

Use the set bridge apart command to enable or disable APaRT on FDDI.

set bridge apart {enable | disable}

Syntax Description

enable

Keyword to activate APaRT on FDDI.

disable

Keyword to deactivate APaRT on FDDI.

Default

The default configuration has APaRT enabled.

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to disable APaRT:

Console> (enable) set bridge apart disable
APaRT disabled
Console> (enable) 
Related Command

set bridge fddicheck

set bridge fddicheck

Use the set bridge fddicheck command to enable or disable the relearning of MAC addresses (as FDDI MAC addresses) that were already learned from an Ethernet interface (as Ethernet MAC addresses).

set bridge fddicheck {enable | disable}

Syntax Description

enable

Keyword to permit FDDI to relearn MAC addresses learned from an Ethernet interface.

disable

Keyword to prevent FDDI from relearning MAC addresses learned from an Ethernet interface.

Default

The default configuration has fddicheck disabled.

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

When fddicheck is enabled, a MAC address seen on the FDDI ring is not learned (stored in FDDI CAM) as an FDDI MAC address if the MAC address was previously learned from an Ethernet interface (as an Ethernet MAC address).

With fddicheck enabled, MAC addresses previously learned from an Ethernet interface will not be relearned on the FDDI interface until the CAM is cleared.

This command requires information from the FDDI CAM. If you disable APaRT, fiddicheck is also automatically disabled. To enable fddicheck, first enable APaRT.

Example

This example shows how to enable fddicheck on the switch:

Console> (enable) set bridge fddicheck enable
FDDICHECK enabled
Console> (enable) 
Related Command

show bridge

set bridge ipx 8022toether

Use the set bridge ipx 8022toether command to set the default method for translating IPX packets from FDDI 802.2 to Ethernet. The default translation method specified is used only until the real protocol types are learned.

set bridge ipx 8022toether {8023 | snap | eii | 8023raw}

Syntax Description

8023

Keyword to specify Ethernet 802.3 as the default translation method.

snap

Keyword to specify Ethernet SNAP as the default translation method.

eii

Keyword to specify Ethernet II as the default translation method.

8023raw

Keyword to specify Ethernet 802.3 RAW as the default translation method.

Default

The default translation method for FDDI 802.2 to Ethernet networks is 8023 (Ethernet 802.3).

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the default protocol to SNAP for translating IPX packets between FDDI 802.2 and Ethernet networks:

Console> (enable) set bridge ipx 8022toether snap
8022 to ETHER translation set.
Console> (enable)
Related Command

show bridge

set bridge ipx 8023rawtofddi

Use the set bridge ipx 8023rawtofddi command to set the default method for translating IPX packets from Ethernet 802.3 to FDDI. The default translation method specified is used only until the real protocol types are learned.

set bridge ipx 8023rawtofddi {8022 | snap | fddiraw}

Syntax Description

8022

Keyword to specify FDDI 802.2 as the default translation method.

snap

Keyword to specify FDDI SNAP as the default translation method.

fddiraw

Keyword to specify FDDI RAW as the default translation method.

Default

The default translation method for Ethernet 802.3 to FDDI networks is SNAP (FDDI SNAP).

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the default translation method to FDDI SNAP for translating IPX packets between Ethernet 802.3 and FDDI networks:

Console> (enable) set bridge ipx 8023rawtofddi snap
8023RAW to FDDI translation set.
Console> (enable)
Related Command

show bridge

set bridge ipx snaptoether

Use the set bridge ipx snaptoether command to set the default method for translating IPX FDDI SNAP frames to Ethernet frames. The default translation specified is used for all broadcast IPX SNAP frames and for any unlearned Ethernet MAC addresses.

set bridge ipx snaptoether {8023 | snap | eii | 8023raw}

Syntax Description

8023

Keyword to specify Ethernet 802.3 as the default frame type.

snap

Keyword to specify Ethernet SNAP as the default frame type.

eii

Keyword to specify Ethernet II as the default frame type.

8023raw

Keyword to specify Ethernet 802.3 RAW as the default frame type.

Default

The default translation method for translating IPX FDDI SNAP frames to Ethernet frames is 8023raw (Ethernet 802.3 RAW).

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the default method for translating IPX FDDI SNAP frames to Ethernet frames to SNAP:

Console> (enable) set bridge ipx snaptoether snap
Bridge snaptoether default IPX translation set.
Console> (enable)
Related Command

show bridge

set cam

Use the set cam command to add entries into the CAM table and to set the aging time for the CAM table.

set cam {dynamic | static | permanent} {unicast_mac} {mod/port} [vlan]
set cam {dynamic | static | permanent} {route_descr} {mod/port} [vlan]
set cam {static | permanent} {multicast_mac} {mod/ports...} [vlan]
set cam agingtime vlan agingtime

Syntax Description

dynamic

Keyword to specify that entries are subject to aging.

static

Keyword to specify that entries are not subject to aging. Static (nonpermanent) entries will remain in the table until the system is reset.

permanent

Keyword to specify that permanent entries are stored in NVRAM until they are removed by the clear cam or clear config command.

unicast_mac

MAC address of the destination host used for a unicast.

mod/port

Number of the module and the port.

vlan

(Optional) Number of the VLAN.

multicast_mac

MAC address of the destination host used for a multicast.

route_descr

Route descriptor of the "next hop" relative to this switch. This variable is entered as two hexadecimal bytes in the following format: 004F. Do not use a "-" to separate the bytes.

mod/ports...

Number of the module and the ports.

vlan

(Optional) Number of the VLAN. This number is optional unless you are setting CAM entries to dynamic, static, or permanent for a trunk port, or if you are using the agingtime keyword.

agingtime

Keyword to set the period of time after which an entry is removed from the table.

agingtime

Number of seconds (0 to 1,000,000 for the Catalyst 5000 family and 2926G series switches; 0 and 15 to 1,000,000 for the Catalyst 4000 family and 2948G switches) that dynamic entries remain in the table before being deleted. Setting aging time to 0 disables aging.

Default

The default aging time for all configured VLANs is 300 seconds.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The set cam {dynamic | static | permanent} {route_descr} {mod/port} [vlan] command is not supported by the Catalyst 4000 family and 2948G switches.

If the given MAC address is a multicast address (the least significant bit of the most significant byte is set to 1) or broadcast address (ff-ff-ff-ff-ff-ff) and multiple ports are specified, the ports must all be in the same VLAN. If the given address is a unicast address and multiple ports are specified, the ports must be in different VLANs.

The set cam command does not support the RSM.

If you enter a route descriptor with no VLAN parameter specified, the default is the VLAN already associated with the port. If you enter a route descriptor, you may only use a single port number (of the associated port).

The minimum configurable non-zero age time for the Catalyst 4000 family and 2948G switches is 15 seconds. You cannot configure an aging time between 1 and 15 seconds.

Examples

This example shows how to set the CAM table aging time for VLAN 1 to 300 seconds:

Console> (enable) set cam agingtime 1 300
Vlan 1 CAM aging time set to 300 seconds.
Console> (enable) 
 

This example shows how to add a static unicast entry to the table for module 2, port 9:

Console> (enable) set cam static 00-00-0c-a0-03-fa 2/9
Static unicast entry added to CAM table.
Console> (enable)
 

This example shows how to add a permanent multicast entry to the table for a group of ports:

Console> (enable) set cam permanent 01-40-0b-a0-03-fa 1/1,2/1,2/3,2/8-12
Permanent multicast entry added to CAM table.
Console> (enable)
Related Commands

clear cam
show cam

set cdp

Use the set cdp command to enable or disable CDP globally or on specified ports, and to configure the CDP hold time.

set cdp {enable | disable} [mod/ports...]

Syntax Description

enable

Keyword to enable the CDP feature.

disable

Keyword to disable the CDP feature.

mod/ports...

Number of the module and ports.

Default

The default system configuration has CDP enabled; the message interval is set to 60 seconds for every port.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

If you enter the global set cdp enable or disable command, CDP is globally configured. If CDP is globally disabled, CDP is automatically disabled on all ports, but the per-port enable (or disable) configuration is not changed. If CDP is globally enabled, whether CDP is running on a port or not depends on its per-port configuration.

If you configure CDP on a per-port basis, the mod/ports... can be entered as a single module and port or a range of ports; for example, 2/1-12,3/5-12.

Examples

This example shows how to enable the CDP on port 1 on module 2:

Console> (enable) set cdp enable 2/1
CDP enabled on port 2/1.
Console> (enable)
 

This example shows how to disable the CDP message display for port 1 on module 2:

Console> (enable) set cdp disable 2/1
CDP disabled on port 2/1.
Console> (enable)
Related Command

show cdp

set cdp holdtime

Use the set cdp holdtime command to configure the CDP hold time.

set cdp holdtime holdtime

Syntax Description

holdtime

Keyword to specify the global CDP hold time value.

holdtime

Number of seconds for the global CDP hold time value; valid values are 10 to 255 seconds.

Default

The default CDP hold time value has the message interval globally set to 180 seconds.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

The holdtime argument is not supported on Catalyst 5000 family and 2926G series switches with supervisor engine software release 4.2(2) and earlier and 3.2(4) and earlier, and Catalyst 4000 family and 2948G switches.

Examples

This example shows how to specify the global CDP hold time value:

Console> (enable) set cdp holdtime 200
CDP holdtime set to 200 seconds.
Console> (enable)
Related Command

show cdp

set cdp interval

Use the set cdp interval command to globally set the message interval for CDP.

set cdp interval interval

Syntax Description

interval

Number of seconds (5 to 900) the system waits between CDP message transmissions.

Default

The default is set to 60 seconds.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to set the CDP message interval to 100 seconds:

Console> (enable) set cdp interval 100
CDP message interval set to 100 seconds for all ports.
Console> (enable)
Related Commands

set cdp
show cdp

set cgmp

Use the set cgmp command to enable or disable CGMP on the switch.

set cgmp {enable | disable}

Syntax Description

enable

Keyword to enable CGMP on the switch.

disable

Keyword to disable CGMP on the switch.

Default

By default, CGMP is disabled.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

CGMP requires that you connect the switch to a router running CGMP.

Examples

This example shows how to enable CGMP on a device:

Console> (enable) set cgmp enable
CMGP support for IP multicast enabled.
Console> (enable)
 

This example shows how to disable CGMP on a device:

Console> (enable) set cgmp disable
CMGP support for IP multicast disabled.
Console> (enable)
 

This example shows what happens if you try to enable CGMP if IGMP snooping is already enabled:

Console> (enable) set cgmp enable
Disable IGMP Snooping feature to enable CGMP.
Console> (enable) 
Related Commands

clear multicast router
set multicast router
show multicast group
show multicast group count

set cgmp leave

Use the set cgmp leave command to enable or disable CGMP leave processing.

set cgmp leave {enable | disable}

Syntax Description

enable

Keyword to enable CGMP leave processing.

disable

Keyword to disable CGMP leave processing.

Default

By default, CGMP leave processing is disabled.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Examples

This example shows how to enable CGMP leave processing:

Console> (enable) set cgmp leave enable
CMGP support for leave processing enabled.
Console> (enable)
 

This example shows how to disable CGMP leave processing:

Console> (enable) set cgmp leave disable
CMGP support for leave processing disabled.
Console> (enable)
Related Commands

clear multicast router
set multicast router
show multicast group
show multicast group count
show cgmp leave

set channel cost

Use the set channel cost command to set the spanning-tree port cost for an EtherChannel port bundle.

set channel cost {channel_id | all} [cost]

Syntax Description

channel_id

EtherChannel ID of the channel to modify.

all

Keyword to specify all EtherChannel port bundles on the switch.

cost

(Optional) Spanning-tree port cost to apply to the EtherChannel.

Default

The default is the spanning-tree port cost is calculated automatically based on the current port costs of the ports in the EtherChannel.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

To determine the channel_id of an EtherChannel port bundle, use the show channel command.

If you do not specify the cost, the spanning-tree port cost is updated based on the current port costs of the channeling ports. If you change the channel port cost, the port costs of member ports in the channel are modified to reflect the new cost. A message appears listing the ports whose port costs were changed.

Examples

This example shows how to set the channel 768 path cost to 23:

Console> (enable) set channel cost 768 23
Port(s) 1/1-2,7/3,7/5 port path cost are updated to 60.
Channel 768 cost is set to 23.
Warning:channel cost may not be applicable if channel is broken.
Console> (enable) 

This example shows how to set all channel path costs to 15:

Console> (enable) set channel cost all 15
Port(s) 4/1-4 port path cost are updated to 39.
Channel 768 cost is set to 15.
Warning:channel cost may not be applicable if channel is broken.
Console> (enable)
Related Command

set channel vlancost
set port channel
show channel
show channel group
show port channel

set channel vlancost

Use the set channel vlancost command to set the spanning-tree port-VLAN cost for an EtherChannel port bundle.

set channel vlancost channel_id [cost]

Syntax Description

channel_id

EtherChannel ID of the channel to modify.

cost

(Optional) Spanning-tree port-VLAN cost to apply to the EtherChannel.

Default

The default is the spanning-tree port-VLAN cost is calculated automatically based on the current port-VLAN costs of the ports in the EtherChannel.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guidelines

You can configure the port-VLAN cost of only one EtherChannel at a time.

To determine the channel_id of an EtherChannel port bundle, use the show channel command.

If you do not specify the cost, the spanning-tree port-VLAN cost is updated based on the current port-VLAN costs of the channeling ports. If you change the channel port-VLAN cost, the port-VLAN costs of member ports in the channel are modified to reflect the new cost. A message appears listing the ports whose port-VLAN costs were changed.

Example

This example shows how to set the channel 768 port-VLAN cost to 10:

Console> (enable) set channel vlancost 768 10
Port(s) 1/1-2 vlan cost are updated to 24.
Channel 768 vlancost is set to 10.
Console> (enable) 
Related Command

set channel cost
set port channel
show channel
show channel group
show port channel

set enablepass

Use the set enablepass command to change the privileged (enable) mode password on the switch.

set enablepass

Syntax Description

This command has no arguments or keywords.

Default

The default configuration has no enable password configured.

Supported Platforms

Catalyst 5000 family switches
Catalyst 4000 family switches
Catalyst 2926G series switches
Catalyst 2948G switch

Command Type

Switch command.

Command Mode

Privileged.

Usage Guideline

The command prompts you for the old password. If the password you enter is valid, you are prompted to enter a new password and to verify the new password. A zero-length password
is allowed.

Example

This example shows how to establish a new password:

Console> (enable) set enablepass
Enter old password: <old_password>
Enter new password: <new_password>
Retype new password: <new_password>
Password changed.
Console> (enable)
Related Commands

enable
set password

set fddi alarm

Use the set fddi alarm command to specify the LER-alarm value for an FDDI port. The value defines the rate at which the LER threshold is exceeded on a link. The LER-alarm value affects the results of the LER threshold test.

set fddi alarm mod_num/port_num value

Syntax Description

mod_num

Number of the module.

port_num

Number of the port.

value

Value for the LER-alarm parameter. This exponential value represents the number of link errors per second (that is, 10-value link errors per second). Valid values are between 7 and 15.

Default

The default LER-alarm value is 8 milliseconds (10-8 seconds).

Supported Platforms

Catalyst 5000 family switches

Command Type

Switch command.

Command Mode

Privileged.

Example

This example shows how to change the LER-alarm value to 10-11 seconds for port 1 on module 4:

Console> (enable) set fddi alarm 4/1 11
Port 4/1 alarm value set to 11.
Console> (enable)
Related Commands

set fddi cutoff
set fddi tlmin
set fddi tnotify
set fddi treq
set fddi userdata
show fddi


hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon Oct 4 13:50:15 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.