Table Of Contents
set password
Use the set password command to change the login password on the CLI.
set password
Syntax Description
This command has no arguments or keywords.
Default
The default configuration has no password configured.
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 by pressing Return.
Example
This example shows how to set an initial password:
Console> (enable) set passwordEnter old password: <old_password>Enter new password: <new_password>Retype new password: <new_password>Password changed.Console> (enable)set port broadcast
Use the set port broadcast command to set the broadcast/multicast suppression for one or more ports. The broadcast threshold limits the backplane traffic received from the module.
set port broadcast mod_num/port_num threshold[%]
Syntax Description
Default
The default value for the threshold is 100 percent.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
This command is not supported on the Catalyst 4000 and 2948G series switches.
The following Catalyst 5000, 2926G, and 2926 series switching modules support hardware broadcast/multicast suppression: Ethernet switching module (10BaseT 48 port, Telco), part number WS-X5012; and group switching Fast Ethernet module (100BaseTX 24 Port), part number WS-X5223.
Software broadcast/multicast suppression is supported in all Ethernet line modules that support hardware broadcast/multicast suppression, except the Ethernet switching module (10BaseT 48 port, Telco, WS-X5012). For more information on the broadcast/multicast suppression feature, see the Software Configuration Guide for your switch.
Although bandwidth-based broadcast/multicast suppression applies to all ports on a module, you must still specify a port number according to the syntax rules of the set port broadcast mod_num/port_num threshold [%] command. For example, if you specify port 3 on module 4 (4/3), broadcast/multicast suppression is applied to every port on module 4. You can specify any port number between 1 and 24.
Only the Ethernet switching module (10BaseT 48 port, Telco, WS-X5012) supports bandwidth-based broadcast/multicast suppression on a per-port basis.
This command is not supported by the RSM.
On a Token Ring module, uplink ports connect to different switching buses, so the software/firmware knows which SAMBA to set. This is different from other modules with SAMBA, where set applies to all ports, and the SAMBA of switching bus A (to which SAGE inband link is connected) cannot be set for broadcast suppression.
The packets-per-second option is not supported by the 1000BaseX switching module.
Examples
This example shows how to limit broadcast traffic to 500 packets per second on ports 2/1 through 3/24:
Console> (enable) set port broadcast 2/1-3/24 500Ports 2/1-3/24 broadcast traffic limited to 500 packets.Console> (enable)This example shows how to limit broadcast traffic to 20 percent to all ports on module 4 (see "Usage Guidelines" for more information):
Console> (enable) set port broadcast 4/3 20%Port 4/1-24 broadcast traffic limited to 20%.Console> (enable)This example shows how to allow unlimited broadcast traffic to all ports on module 4 (see "Usage Guidelines" for more information):
Console> (enable) set port broadcast 4/3 100%Port 4/1-24 broadcast traffic unlimited.Console> (enable)Related Commands
set port channel
Use the set port channel command to configure EtherChannel on Ethernet module ports.
set port channel mod/ports... [on | off | desirable | auto] [silent | nonsilent]
Syntax Description
Default
The default system configuration has EtherChannel set to auto and silent on all module ports.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
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 "Configuring Ethernet and Fast Ethernet Switching Modules" chapter in the Software Configuration Guide for your switch.
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.
If you do not enter the mod/ports.., all ports are addressed.
If you do not enter the channel mode, the channel mode of the ports addressed are not modified.
The silent | nonsilent parameters only apply if desirable or auto modes are entered.
This command is not supported by the RSM.
This command is not supported by the three-port Gigabit Ethernet switching module (WS-X5403).
On the 1000Base-X switching module (WS-X5410), only ports 1 through 4 and 5 through 8 can be channeled. Port 9 cannot be channeled to other ports.
On the Catalyst 4000 and 2948G series switches, port channel group restrictions apply for each module. The following ports can be channeled:
•
6-port GBIC module (WS-X4306) - 1-2, 3-6
•
10/100 BaseT module (WS-X4232) - 1-2, 3-6, 7-10, ... 31-34
•
10/100 BaseT module (WS-X4148) - 1-4, 5-8, 9-12, ..., 45-48
•
18-port Gigabit module (WS-X4418) - 1-2, 3-6, 7-10, 11-14, 15-18
•
Catalyst 2948G 4 x 12 + 2 (Catalyst 2948G) - 1-4, 5-8, 9-12, ..., 45-48, 49-50
Examples
This example shows how to enable Fast EtherChannel on ports 5-8 of Fast Ethernet module 2:
Console> (enable) set port channel 2/5-8 onPorts 2/5-8 channel mode set to on.Console> (enable)This example shows how to disable Fast EtherChannel on ports 5-8 of Fast Ethernet module 2:
Console> (enable) set port channel 2/5-8 offPorts 2/5-8 disabled and channel mode set to off.Console> (enable)Related Command
set port disable
Use the set port disable command to disable a port or a range of ports.
set port disable mod_num/port_num
Syntax Description
Default
The default system configuration has all ports enabled.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
This command is not supported by the RSM.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Example
This example shows how to disable a port using the set port disable command:
Console> (enable) set port disable 5/10Port 5/10 disabled.Console> (enable)Related Commands
set port duplex
Use the set port duplex command to configure the duplex type of an Ethernet or Fast Ethernet port or range of ports.
set port duplex mod_num/port_num {full | half}
Syntax Description
mod_num
Number of the module.
port_num
Number of the port.
full
Keyword to specify full-duplex transmission.
half
Keyword to specify half-duplex transmission.
Default
The default configuration for 10-Mbps and 100-Mbps modules has all Ethernet ports set to half duplex.
Command Type
Switch command.
Command Mode
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 valid on the 24- and 48-port group switching modules (WS-X5020 and WS-X5223) or the RSM.
The set port duplex command is not valid when issued against a Token Ring port. Use the set tokenring portmode command instead. If you enter a set port duplex command, you are directed to use the proper command.
The Gigabit Ethernet switching modules can only be configured as full duplex.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Examples
This example shows how to set port 1 on module 2 to full duplex:
Console> (enable) set port duplex 2/1 fullPort 2/1 set to full-duplex.Console> (enable)This example shows what the set port duplex command displays if entered against a Token Ring port:
Console> (enable) set port duplex 3/1 fullPort 3/1 is Token Ring, use `set tokenring portmode' command insteadConsole> (enable)Related Command
set port enable
Use the set port enable command to enable a port or a range of ports.
set port enable mod_num/port_num
Syntax Description
Default
The default system configuration has all ports enabled.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
This command is not supported on the RSM.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Example
This example shows how to enable port 3 on module 2:
Console> (enable) set port enable 2/3Port 2/3 enabled.Console> (enable)Related Commands
set port filter
Use the set port filter command to configure a MAC address filter or a protocol filter for ports on the Token Ring module.
set port filter mod_num/port_num {mac_addr | protocol_type} {permit | deny}
Syntax Description
Default
The command has no default setting.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
You can configure up to 16 MAC address filters or 16 protocol (eight SAPs and eight DSAPs) filters per port on the Token Ring module. Refer to through for lists of SAPs and Ethertypes that you can use when defining protocol filters.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
and list the SAPs that you can use to define protocol classes.
Table 2-7
IEEE-Defined SAPs
Table 2-8 IBM-Defined SAPs
Hexadecimal Value DescriptionX'04'
SNA Path Control Individual
X'F0'
NetBIOS
X'F4'
LAN Management Individual
X'F8'
IMPL
X'FC'
Discovery
X'DC'
Dynamic Address Resolution
X'D4'
Resource Management
lists the possible Ethertypes that you can use to define protocol filters.
Example
This example shows how to configure a port filter on port 2 MAC address 00:40:0b:01:bc:65 of module 3:
Console> (enable) set port filter 3/2 00:40:0b:01:bc:65 permitPort 3/2 filter Mac Address 00:40:0b:01:bc:65 set to permit.Console> (enable)Related Commands
clear port filter
show port filterset port flowcontrol
Use the set port flowcontrol command to set the receive flow-control value for a particular Gigabit switching module port.
set port flowcontrol {receive | send} [mod_num/port_num] {off | on | desired}
Syntax Description
Default
Default for receive is off. Default for send is desired. Default on multiplexed ports is on. The exception to these defaults applies to the 18-port Gigabit module. The defaults are shown below:
•
Ports 1-2 = send is off and receive is desired
•
Ports 3-18 = send is on and receive is desired
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
This command is not supported for the RSM.
This command is supported on Gigabit switching modules only.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Examples
These examples show how to use the set port flowcontrol command set:
Console> (enable) set port flowcontrol receive 5/1 onPort 5/1 flow control receive administration status set to on(port will require far end to send flowcontrol)Console> (enable)Console> (enable) set port flowcontrol receive 5/1 desiredPort 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)Console> (enable) set port flowcontrol receive 5/1 offPort 5/1 flow control receive administration status set to off(port will not allow far end to send flowcontrol)Console> (enable)Console> (enable) set port flowcontrol send 5/1 onPort 5/1 flow control send administration status set to on(port will send flowcontrol to far end)Console> (enable)Console> (enable) set port flowcontrol send 5/1 desiredPort 5/1 flow control send administration status set to desired(port will send flowcontrol to far end if far end supports it)Console> (enable)Console> (enable) set port flowcontrol send 5/1 offPort 5/1 flow control send administration status set to off(port will not send flowcontrol to far end)Console> (enable)Related Command
set port level
Use the set port level command to set the priority level of a port or range of ports on the switching bus.
set port level mod_num/port_num {normal | high}
Syntax Description
mod_num
Number of the module.
port_num
Number of the port on the module.
normal
Keyword to set the port priority to normal.
high
Keyword to set the port priority to high.
Default
The default configuration has all ports at normal priority level.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
Packets traveling through a port set at normal priority are served only after packets traveling through a port set at high priority are served.
This command is not supported for the RSM.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Example
This example shows how to set the priority level for port 2 on module 1 to high:
Console> (enable) set port level 1/2 highPort 1/2 port level set to high.Console> (enable)Related Commands
set port disable set port duplex
set port enable set port name
set port speed set port trap
show portset port membership
Use the set port membership command to dynamically or statically assign membership of a port or range of ports to a VLAN.
set port membership mod_num/port_num {dynamic | static}
Syntax Description
mod_num
Module number.
port_num
Port number.
dynamic
Keyword to dynamically assign VLAN membership to a port.
static
Keyword to statically assign VLAN membership to a port.
Default
Default port membership is static.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
When a port is assigned a VLAN dynamically, the show port command output identifies the VLAN as dynamic and, if the dynamic port is shut down by a VMPS, its status is shown as shutdown.
This command is not supported on the RSM.
This command is not supported by the three-port Gigabit Ethernet switching module (WS-X5403).
Token Ring does not currently support dynamic VLAN membership—all Token Ring ports are static. If you issue a set port membership dynamic command against a Token Ring port, the following message is generated:
Feature not supported for Module x.The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Examples
These examples show how to assign VLAN membership to one or more ports using the set port membership command:
Console> (enable) set port membership 3/1-3 dynamicPorts 3/1-3 vlan assignment set to dynamic.Spantree port fast start option enabled for ports 3/1-3.Console> (enable)Console> (enable) set port membership 4/2 dynamicPorts 4/1-12 vlan assignment set to dynamic.Spantree port fast start option enabled for port 4/2.Console> (enable)Related Commands
set port name
Use the set port name command to configure a name for a port.
set port name mod_num/port_num [port_name]
Syntax Description
Default
The default configuration has no port name configured for any port.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
If you do not specify the name string, the port name is cleared.
This command is not supported for the RSM.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Example
This example shows how to set port 1 on module 4 to Snowy:
Console> (enable) set port name 4/1 SnowyPort 4/1 name set.Console> (enable)Related Commands
set port disable
set port duplex
set port enable
set port speed
set port trap
show portset port negotiation
Use the set port negotiation command to enable or disable the link negotiation protocol on the specified port.
set port negotiation mod_num/port_num [enable | disable]
Syntax Description
mod_num
Number of the module.
port_num
Number of the port.
enable
(Optional) Keyword to enable the link negotiation protocol.
disable
(Optional) Keyword to disable the link negotiation protocol.
Default
The default is link negotiation protocol enabled.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
This command only applies to ports on the Gigabit switching module.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Example
This example shows how to disable link negotiation protocol on port 1, module 4:
Console> (enable) set port negotiation 4/1 disableLink negotiation protocol disabled on port 4/1.Console> (enable)Related Command
set port protocol
Use the set port protocol command to enable or disable protocol membership of ports.
set port protocol mod_num/port_num {ip | ipx | group} {on | off | auto}
Syntax Description
Default
By default, ports are configured to on for the IP protocol groups and auto for IPX and Group protocols.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
Protocol filtering is supported only on nontrunking Ethernet, Fast Ethernet, and Gigabit Ethernet ports. Trunking ports are always members of all the protocol groups.
If the port configuration is set to auto, the port initially does not receive any flood packets for that protocol. When the corresponding protocol packets are received on that port, the supervisor engine detects this and adds the port to the protocol group.
Ports configured as auto are removed from the protocol group if no packets are received for that protocol within a certain period of time. This aging time is set to 60 minutes. They are also removed from the protocol group on detection of a link down.
Protocol filtering is supported on MLS-based Catalyst 5000, 2926G, and 2926 series switches and Catalyst 4000 and 2948G series switches.
VINES protocol is not supported by the Catalyst 4000 and 2948G series switches.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Examples
This example shows how to disable IPX protocol membership of port 1 on module 2:
Console> (enable) set port protocol 2/1 ipx offIPX protocol disabled on port 2/1.Console> (enable)This example shows how to enable automatic IP membership of port 1 on module 5:
Console> (enable) set port protocol 5/1 ip autoIP protocol set to auto mode on module 5/1.Console> (enable)Related Command
set port security
Use the set port security command to configure port security on a port or range of ports on an Ethernet module.
set port security mod/ports... {enable | disable} [mac_addr]
Syntax Description
mod
Number of the module.
ports...
Number of the ports.
enable
Keyword to enable port security.
disable
Keyword to disable port security.
mac_addr
(Optional) Secure MAC address of the enabled port.
Default
The default configuration has port security disabled.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
If the MAC address is not given, the command turns on learning mode so that the first MAC address seen on the port becomes the secure MAC address.
If you issue this command against a Token Ring port, the following message is generated:
Feature not supported for Module x.This command is not supported by the three-port Gigabit Ethernet switching module (WS-X5403).
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Examples
This example shows how to set port security with a learned MAC address:
Console> (enable) set port security 3/1 enablePort 3/1 port security enabled with the learned mac address.Console> (enable)This example shows how to set port security with a specific MAC address:
Console> (enable) set port security 3/1 enable 01-02-03-04-05-06Port 3/1 port security enabled with 01-02-03-04-05-06 as the secure mac address.Console> (enable)Related Commands
set port speed
Use the set port speed command to configure the speed of a port interface. You can configure the speed of an Ethernet interface.
set port speed mod_num/port_num {4 | 10 | 16 | 100 | auto}
Syntax Description
mod_num
Number of the module.
port_num
Number of the port on the module.
4 | 10 | 16 | 100 | auto
Keyword to set a port speed to 4, 10, 16, 100 Mbps, or autospeed detection mode.
Default
The default configuration has all module ports set to auto.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guidelines
You can configure Ethernet interfaces on the 10/100-Mbps Ethernet switching modules to either 10 Mbps or 100 Mbps, or to autosensing mode, allowing them to sense and distinguish between 10-Mbps and 100-Mbps port transmission speeds and full-duplex or half-duplex port transmission types at a remote port connection. If you set the interfaces to autosensing mode, they configure themselves automatically to operate at the proper speed and transmission type.
You can configure Token Ring interfaces on the Token Ring module to either 4 Mbps or 16 Mbps, or to autospeed detection mode, allowing them to sense and distinguish between 4-Mbps and 16-Mbps port transmission speed. If you set the interfaces to autospeed detection mode, they automatically configure themselves to operate at the proper speed.
If you change the transmission speed of a port that is open to 4 or 16 Mbps, the port will close and reopen at the new transmission speed. If a port closes and reopens on an existing ring using a transmission speed different from that which the ring is operating, the ring will beacon.
If you set the port speed to auto, duplex mode is automatically set to auto.
The 4 and 16 port-speed options are not supported by the Catalyst 4000 and 2948G series switches.
If the ports on the Token Ring module are configured to detect the speed of the ring automatically, the first port inserted on the ring does not set the speed, because it is unable to detect the speed.
This command is not supported by the Gigabit Ethernet switching modules; port speed is factory set to 1000.
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Examples
This example shows how to configure port 1 on module 2 to auto:
Console> (enable) set port speed 2/1 autoPort 2/1 speed set to auto-sensing mode.Console> (enable)This example shows how to configure port 2 on module 2 port speed to 10 Mbps:
Console> (enable) set port speed 2/2 10Port 2/2 speed set to 10 Mbps.Console> (enable)This example shows how to configure port 4 on module 3 port speed to 16 Mbps:
Console> (enable) set port speed 3/4 16Port(s) 3/4 speed set to 16Mbps.Console> (enable)Related Commands
set port disable
set port enable
set port name
set port trap
show portset port trap
Use the set port trap command to enable or disable the operation of the standard SNMP link trap (up or down) for a port or range of ports.
set port trap mod_num/port_num {enable | disable}
Syntax Description
mod_num
Number of the module.
port_num
Number of the port.
enable
Keyword to activate the SNMP link trap.
disable
Keyword to deactivate the SNMP link trap.
Default
The default configuration has all port traps disabled.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guideline
The Catalyst 2948G is a fixed configuration switch. All ports are located on module 2; for this reason, if you enter 1/N for the module/port number, an error message is displayed.
Example
This example shows how to enable the SNMP link trap for module 1, port 2:
Console> (enable) set port trap 1/2 enablePort 1/2 up/down trap enabled.Console> (enable)Related Commands
set port disable
set port duplex
set port enable
set port name
set port speed
show portset prompt
Use the set prompt command to change the prompt for the CLI.
set prompt prompt_string
Syntax Description
Default
The default configuration has the prompt set to Console>.
Command Type
Switch command.
Command Mode
Privileged.
Usage Guideline
In Catalyst 5000, 2926G, and 2926 series software release 4.1(1) and later, and Catalyst 4000 and 2948G series software release 4.4 and later, if you use the set system name command to assign a name to the switch, the switch name is used as the prompt string. However, if you specify a different prompt string using the set prompt command, that string is used for the prompt.
Example
This example shows how to set the prompt to system100>:
Console> (enable) set prompt system100>system100> (enable)Related Command
set protocolfilter
Use the set protocolfilter command to activate or deactivate protocol filtering.
set protocolfilter {enable | disable}
Syntax Description
Default
The default configuration has protocol filtering disabled.
Command Type
Switch command.
Command Mode
Privileged.
Examples
This example shows how to activate protocol filtering:
Console> (enable) set protocolfilter enableProtocol filtering enabled on this switch.Console> (enable)This example shows how to deactivate protocol filtering:
Console> (enable) set protocolfilter disableProtocol filtering disabled on this switch.Console> (enable)Related Command
