Page 1
Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) First Published: June 16, 2014 Last Modified: 0, Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387)
Page 2
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks . Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company.
Searching and Filtering Output of show and more Commands Accessing the CLI Accessing the CLI through a Console Connection or through Telnet Layer 2/3 Commands C H A P T E R 2 channel-group Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
A vertical line, called a pipe, indicates a choice within a set of keywords or arguments. [x | y] Optional alternative keywords are grouped in brackets and separated by vertical bars. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 6
Use the statement number provided at the end of each warning to locate its translation in the translated safety warnings that accompanied this device. Statement 1071 SAVE THESE INSTRUCTIONS Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Obtaining Documentation and Submitting a Service Request For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html...
Page 8
Preface Obtaining Documentation and Submitting a Service Request Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) viii OL-32323-01...
Using the Command-Line Interface, page 1 Using the Command-Line Interface This chapter describes the Cisco IOS command-line interface (CLI) and how to use it to configure your switch. Understanding Command Modes The Cisco IOS user interface is divided into many different modes. The commands available to you depend on which mode you are currently in.
Page 10
(with a Ethernet ports. To return to specific interface). privileged EXEC mode, press Ctrl-Z or enter end. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
? Lists the associated arguments for a keyword. Controller(config)# cdp holdtime ? <10-255> Length of time (in sec) that receiver must keep this packet Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
The caret (^) marks the all the commands that are available point of the error. in this command mode. The possible keywords that you can enter with the command appear. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
To recall commands from the history buffer, perform one of the actions listed in this table. These actions are optional. The arrow keys function only on ANSI-compatible terminals such as VT100s. Note Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
To re-enable the enhanced editing mode for the current terminal session, enter this command in privileged EXEC mode: Controller# terminal editing To reconfigure a specific line to have enhanced editing mode, enter this command in line configuration mode: Controller(config-line)# editing Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Delete entries if you make a Press the Delete or Backspace key. Erases the character to the left of mistake or change your mind. the cursor. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 16
Scrolls down one screen. Redisplay the current command Press Ctrl-L or Ctrl-R. Redisplays the current command line if the switch suddenly sends a line. message to your screen. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Vlan1 is up, line protocol is up Vlan10 is up, line protocol is down GigabitEthernet1/0/1 is up, line protocol is down GigabitEthernet1/0/2 is up, line protocol is up Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
After you connect through the console port, through the Ethernet management port, through a Telnet session or through an SSH session, the user EXEC prompt appears on the management station. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
You do not have to use the interface port-channel command in global configuration mode to manually create a port-channel interface. If you create the port-channel Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 22
Do not configure a secure port as part of an EtherChannel or configure an EtherChannel port as a secure port. For a complete list of configuration guidelines, see the “Configuring EtherChannels” chapter in the software configuration guide for this release. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 23
Accesses or creates a port channel. interface port-channel Displays EtherChannel information for a channel. show etherchannel Displays LACP channel-group information. show lacp Displays Port Aggregation Protocol (PAgP) channel-group show pagp information. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
This example shows how to specify LACP as the protocol that manages the EtherChannel: Controller(config-if)# channel-protocol lacp You can verify your settings by entering the show etherchannel [channel-group-number] protocol privileged EXEC command. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 25
Command Description Assigns an Ethernet port to an EtherChannel group, or enables an channel-group EtherChannel mode, or both. Displays EtherChannel information for a channel. show etherchannel Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
You can verify that the information was deleted by entering the show lacp counters or the show lacp channel-group-number counters privileged EXEC command. Related Commands Command Description Displays LACP channel-group information. show lacp Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
You can verify that the information was deleted by entering the show pagp privileged EXEC command. Related Commands Command Description Enables debugging of PAgP. debug pagp Displays Port Aggregation Protocol (PAgP) channel-group information. show pagp Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
To enable debugging on the standby controller without first starting a session on the active controller, use the remote command switch-number LINE command in privileged EXEC mode. Examples This example shows how to display all EtherChannel debug messages: Controller# debug etherchannel all Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 29
This example shows how to display debug messages related to EtherChannel events: Controller# debug etherchannel event Related Commands Command Description Displays EtherChannel information for a channel. show etherchannel Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
This example shows how to display all LACP debug messages: Controller# debug LACP all This example shows how to display debug messages related to LACP events: Controller# debug LACP event Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
To enable debugging on the standby controller without first starting a session on the active controller, use the remote command switch-number LINE command in privileged EXEC mode. Examples This example shows how to display all PAgP debug messages: Controller# debug pagp all Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 32
Layer 2/3 Commands debug pagp This example shows how to display debug messages related to PAgP events: Controller# debug pagp event Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
LINE command in privileged EXEC mode. Examples This example shows how to display debug messages related to the creation and deletion of VLANs: Controller# debug platform pm vlans Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Modification Cisco IOS XE 3.2SE This command was introduced. Usage Guidelines The undebug platform udld command is the same as the no debug platform udld command. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Do not assign bridge groups on the physical ports in a channel group used as a Layer 3 port channel Caution interface because it creates loops. You must also disable spanning tree. Follow these guidelines when you use the interface port-channel command: Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 36
Layer 2/3 Commands interface port-channel • If you want to use the Cisco Discovery Protocol (CDP), you must configure it on the physical port and not on the port channel interface. • Do not configure a port that is an active member of an EtherChannel as an IEEE 802.1x port. If IEEE 802.1x is enabled on a not-yet active port of an EtherChannel, the port does not join the EtherChannel.
Specifies the minimum number of LACP ports that must be in the link-up port-channel min-links state and bundled in the EtherChannel in order for the port channel to become active. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Use the show lacp internal privileged EXEC command to display LACP port priorities and internal port number values. For information about configuring LACP on physical ports, see the configuration guide for this release. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 39
Assigns an Ethernet port to an EtherChannel group, or enables an channel-group EtherChannel mode, or both. Configures the LACP system priority. lacp system-priority Displays LACP channel-group information. show lacp Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
This example shows how to set the LACP system priority: Controller(config)# lacp system-priority 20000 You can verify your settings by entering the show lacp sys-id privileged EXEC command. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 41
Assigns an Ethernet port to an EtherChannel group, or enables an channel-group EtherChannel mode, or both. Configures the port priority for the Link Aggregation Control Protocol lacp port-priority (LACP). Displays LACP channel-group information. show lacp Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
We also recommend that you set the load-distribution method based on the source MAC address by using the port-channel load-balance src-mac global configuration command. Use the pagp learn-method interface configuration command only in this situation. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 43
Related Commands Command Description Selects a port over which all traffic through the EtherChannel is sent. pagp port-priority Displays Port Aggregation Protocol (PAgP) channel-group information. show pagp Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Controller(config-if)# pagp port-priority 200 You can verify your setting by entering the show running-config privileged EXEC command or the show pagp channel-group-number internal privileged EXEC command. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 45
Provides the ability to learn the source address of incoming packets. pagp learn-method Sets the load-distribution method among the ports in the EtherChannel. port-channel load-balance Displays Port Aggregation Protocol (PAgP) channel-group information. show pagp Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Specifies load distribution based on the source host IP address and TCP/UDP src-mixed-ip-port (Layer 4) port number. Specifies load distribution based on the TCP/UDP (Layer 4) port number. src-port Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 47
You can verify your setting by entering the show running-config privileged EXEC command or the show etherchannel load-balance privileged EXEC command. Examples This example shows how to set the load-distribution method to dst-mac: Controller(config)# port-channel load-balance dst-mac Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
(Optional) Specifies load distribution based on the TCP/UDP (Layer 4) port number. Command Default The default is src-mac. Command Modes Global configuration Command History Release Modification Cisco IOS XE 3.2SE This command was introduced. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 49
Usage Guidelines For information about when to use these forwarding methods, see the Layer 2 Configuration Guide (Cisco WLC 5700 Series) for this release. You can verify your setting by entering the show running-config privileged EXEC command or the show etherchannel load-balance privileged EXEC command.
This example shows how to specify a minimum of three active LACP ports before port channel 2 becomes active: Controller(config)# interface port-channel 2 Controller(config-if)# port-channel min-links 3 Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 51
Layer 2/3 Commands port-channel min-links Related Commands Command Description Specifies the maximum number of LACP ports allowed in a port lacp max-bundle channel. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
This is an example of output from the show etherchannel channel-group-number detail command: Controller> show etherchannel 1 detail Group state = L2 Ports: 2 Maxports = 16 Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 53
Logical slot/port = 10/1 Number of ports = 2 Logical slot/port = 10/1 Number of ports = 2 Port state = Port-channel Ag-Inuse Protocol = LACP Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 54
Assigns an Ethernet port to an EtherChannel group, or enables an channel-group EtherChannel mode, or both. Restricts the protocol used on a port to manage channeling. channel-protocol Accesses or creates a port channel. interface port-channel Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Controller> show lacp counters LACPDUs Marker Marker Response LACPDUs Port Sent Recv Sent Recv Sent Recv Pkts --------------------------------------------------------------------- Channel group:1 Gi2/0/1 Gi2/0/2 Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 56
Oper Port Port Port Flags State Priority Number State Gi2/0/1 bndl 32768 0x3D Gi2/0/2 bndl 32768 0x3D The following table describes the fields in the display: Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 57
Oper Key Runtime operational key that is being used by this port. LACP automatically generates this value as a hexadecimal number. Port Number Port number. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 58
The system identification is made up of the system priority and the system MAC address. The first two bytes are the system priority, and the last six bytes are the globally administered individual MAC address associated to the system. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 59
Clears the LACP channel-group information. clear lacp Configures the port priority for the Link Aggregation Control Protocol lacp port-priority (LACP). Configures the LACP system priority. lacp system-priority Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Gi1/0/2 This is an example of output from the show pagp dual-active command: Controller> show pagp dual-active PAgP dual-active detection enabled: Yes PAgP dual-active version: 1.1 Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Use this command only when you are working directly with a technical support representative while troubleshooting a problem. Do not use this command unless a technical support representative asks you to do so. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Use this command only when you are working directly with your technical support representative while troubleshooting a problem. Do not use this command unless your technical support representative asks you to do so. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
The range is from 1 to 4095. interface-id (Optional) ID of the interface and port number. Valid interfaces include physical ports, VLANs, and port channels. neighbors (Optional) Displays neighbor information only. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 65
Otherwise, the enable operational setting depends on the global enable setting. Port enable operational state Operational state that shows whether UDLD is actually running on this port. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 66
The port number ID of the neighbor from which the echo originated. Message interval The rate, in seconds, at which the neighbor is sending advertisement messages. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 67
Resets all interfaces shut down by UDLD and permits traffic to pass through again. udld reset Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Layer 2 port. Then you can enter the switchport access vlan and switchport mode commands. The switchport command is not used on platforms that do not support Cisco-routed ports. All physical ports on such platforms are assumed to be Layer 2-switched interfaces.
Page 69
Layer 2/3 Commands switchport Examples This example shows how to cause an interface to cease operating as a Layer 2 port and become a Cisco-routed port: Controller(config-if)# no switchport This example shows how to cause the port interface to cease operating as a Cisco-routed port and convert to...
A configuration that uses the access,or trunk keywords takes effect only when you configure the port in the appropriate mode by using the switchport mode command. The static-access and trunk configuration are saved, but only one configuration is active at a time. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 72
Controller(config)# interface gigabitethernet2/0/1 Controller(config-if)# switchport mode dynamic desirable This example shows how to configure a port for trunk mode: Controller(config)# interface gigabitethernet2/0/1 Controller(config-if)# switchport mode trunk Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 73
Layer 2/3 Commands switchport mode Related Commands Command Description Configures a port as a static-access port. switchport access vlan Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
This example shows how to cause a port to refrain from negotiating trunking mode and to act as a trunk or access port (depending on the mode set): Controller(config)# interface gigabitethernet2/0/1 Controller(config-if)# switchport nonegotiate Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 75
You can verify your setting by entering the show interfaces interface-id switchport privileged EXEC command. Related Commands Command Description Configures the VLAN membership mode of a port. switchport mode Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
You can use these commands to reset an interface shut down by UDLD: • The udld reset privileged EXEC command to reset all interfaces shut down by UDLD. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 77
Resets all interfaces shut down by UDLD and permits traffic to pass through udld reset again. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
You can use these commands to reset an interface shut down by UDLD: • The udld reset privileged EXEC command resets all interfaces shut down by UDLD. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Page 79
Enables aggressive or normal mode in UDLD or sets the configurable message udld timer time. Resets all interfaces shut down by UDLD and permits traffic to pass through udld reset again. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...
Enables aggressive or normal mode in UDLD or sets the configurable message udld timer time. Enables UDLD on an individual interface or prevents a fiber-optic interface from udld port being enabled by the udld global configuration command. Layer 2/3 Command Reference, Cisco IOS XE Release 3E (Cisco WLC 5700 Series) OL-32323-01...