carrier ethernet command reference, cisco ios xe release 3se

Carrier Ethernet Command Reference, Cisco IOS XE Release 3SE(Catalyst 3850 Switches)First Published: January 22, 2013

Last Modified: January 22, 2013

Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000 800 553-NETS (6387)Fax: 408 527-0883

C O N T E N T S

C H A P T E R 1 A through Z 1

channel-group (interface) 2

clear lldp 8

lacp fast-switchover 10

lacp max-bundle 12

lacp min-bundle 14

lacp port-priority 16

lacp rate 18

lacp system-priority 20

lldp 22

lldp (interface) 25

location (interface) 27

show lacp 29

show lldp 36

Carrier Ethernet Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches) iii

Carrier Ethernet Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches)iv

Contents

A through Z

• channel-group (interface), page 2

• clear lldp, page 8

• lacp fast-switchover, page 10

• lacp max-bundle, page 12

• lacp min-bundle, page 14

• lacp port-priority, page 16

• lacp rate, page 18

• lacp system-priority, page 20

• lldp, page 22

• lldp (interface), page 25

• location (interface), page 27

• show lacp, page 29

• show lldp, page 36

Carrier Ethernet Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches) 1

channel-group (interface)To assign and configure an EtherChannel interface to an EtherChannel group, use the channel-group commandin interface configuration mode. To remove the channel-group configuration from the interface, use the noform of this command.

channel-group channel-group-numbermode {active| on| passive}

no channel-group channel-group-number

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers

channel-group channel-group-numbermode on


Cisco ASR 1000 Series Routers

channel-group channel-group-numbermode {active| passive}

no channel-group

Cisco Catalyst Switches

channel-group channel-group-numbermode {active| on| auto [non-silent]| desirable [non-silent]| passive}


Syntax Description Integer that identifies the channel-group. Valid valuesare from 1 to 256; the maximum number of integersthat can be used is 64.

• For Fast EtherChannel groups, the number isan integer from 1 to 4. This number is the onepreviously assigned to the port-channelinterface.

• On the Cisco ASR 1000 series router, validvalues are from 1 to 64.

channel-group-number

Specifies the EtherChannel mode of the interface.mode

Enables Link Aggregation Control Protocol (LACP)unconditionally.

active

Enables EtherChannel only.on

Places a port into a passive negotiating state in whichthe port responds to Port Aggregation Protocol(PAgP) packets that it receives but does not initiatePAgP packet negotiation.

auto

Carrier Ethernet Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches)2

A through Zchannel-group (interface)

(Optional) Used with the auto or desirable modewhen traffic is expected from the other device.

non-silent

Places a port into an active negotiating state in whichthe port initiates negotiations with other ports bysending PAgP packets.

desirable

Enables LACP only when an LACP device isdetected. This is the default state.

passive

Command Default No channel groups are assigned.

Command Modes Interface configuration (config-if)

Command History ModificationRelease

This command was introduced.11.1CA

Support for this command was implemented on Cisco Catalyst 6000 seriesswitches.

12.0(7)XE

The number of valid values for the numberargumentwas changed; see the“Usage Guidelines” section for valid values.

12.1(3a)E3

This command was implemented on the Cisco 2600 series, Cisco 3600 series,and Cisco 3700 series routers.

12.2(2)XT

Support for this command was implemented on the Cisco 2600 series, theCisco 3600 series, and the Cisco 3700 series routers and integrated into CiscoIOS Release 12.2(8)T .

12.2(8)T

Support for this command was implemented on the Supervisor Engine 720.12.2(14)SX

Support for this command on the Supervisor Engine 2 was integrated intoCisco IOS Release 12.2(17d)SXB.

12.2(17d)SXB

This command was changed to support advanced QinQ translation on QinQlink bundles using GE-WAN interfaces on an OSM-2+4GE-WAN+ OSMon Cisco 7600 series routers.

12.2(18)SXE

This command was integrated into Cisco IOS Release 12.2(33)SRA.12.2(33)SRA

This command was integrated into Cisco IOS Release 12.2(31)SB2.12.2(31)SB2

Support for this command on the Cisco 7600 router was integrated into CiscoIOS Release 12.2(33)SRB.

12.2(33)SRB



ModificationRelease

This command was integrated into Cisco IOS XE Release 2.4.Cisco IOS XE Release 2.4

Usage Guidelines OSMs are not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32.

IP Address for the Physical Interface

You do not have to disable the IP address that is assigned to a physical interface that is part of a channel group,but Cisco highly recommends doing so.

Layer 2 and Layer 3 Port Channels

You can create both Layer 2 and Layer 3 port channels by entering the interface port-channel command or,when the channel-group gets its first physical interface assignment. The port channels are not created at runtime, nor are they created dynamically.

You do not have to create a port-channel interface before assigning a physical interface to a channel group.A port-channel interface is automatically created when the channel group gets its first physical interface, if itis not already created.

Propagation of Configuration and Attribute Changes

Any configuration or attribute changes you make to the port-channel interface are propagated to all interfaceswithin the same channel group as the port channel. (for example, configuration changes are also propagatedto the physical interfaces that are not part of the port-channel, but are part of the channel group.)

The on Keyword

When you use the onkeyword, a usable EtherChannel exists only when a port group in on mode is connectedto another port group in the on mode.

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers

You do not have to create a port-channel interface before assigning a physical interface to a channel group.A port-channel interface is created automatically when the channel group gets its first physical interface, if itis not already created.

Cisco ASR 1000 Series Routers

The Cisco ASR 1000 series router has the following prerequisites and restriction:

• A port-channel must be created before member links are assigned to it.

• IP addresses must be disabled on member links before those links can be included in a port-channel.

• Fast Ethernet interfaces are not supported.

Cisco Catalyst Switches

The number of valid values for numberdepends on the software release. For software releases prior to CiscoIOS Release 12.1(3a)E3, valid values are from 1 to 256; for Cisco IOS Release 12.1(3a)E3, 12.1(3a)E4, and12.1(4)E1, valid values are from 1 to 64. Cisco IOS Release 12.1 E and later releases support a maximum of64 values ranging from 1 to 256.

The channel-group number is global and is shared between all the channeling protocols. If a specific channelnumber is used for the PAgP-enabled interfaces of a channel group, that same channel number cannot be usedfor configuring a channel that has LACP-enabled interfaces or vice versa.



Entering the auto or desirable keyword enables PAgP on the specified interface; the command will be rejectedif it is issued on an LACP-enabled interface.

The active and passive keywords are valid on PAgP-disabled interfaces only.

You can change the mode for an interface only if it is the only interface that is designated to the specifiedchannel group.

The on keyword forces the bundling of the interface on the channel without any negotiation.

You can manually configure a switch with PAgP on one side and LACP on the other side in the on mode.

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

If you enter the channel group command on an interface that is added to a channel with a different protocolthan the protocol you are entering, the command is rejected.

If the interface belongs to a channel, the no form of this command is rejected.

All ports in the same channel group must use the same protocol; you cannot run two protocols on one channelgroup.

PAgP and LACP are not compatible; both ends of a channel must use the same protocol.

You can change the protocol at any time, but this change causes all existing EtherChannels to reset to thedefault channel mode for the new protocol.

Configure all ports in an EtherChannel to operate at the same speed and duplex mode (full duplex only forLACP mode).

All ports in a channel must be on the same DFC-equipped module. You cannot configure any of the ports tobe on other modules.

On systems that are configured with nonfabric-enabled modules and fabric-enabled modules, you can bundleports across all modules, but those bundles cannot include a DFC-equipped module port.

You do not have to create a port-channel interface before assigning a physical interface to a channel group.A port-channel interface is created automatically when the channel group gets its first physical interface, if itis not already created.

You do not have to disable the IP address that is assigned to a physical interface that is part of a channel group,but it is highly recommended.

You can create both Layer 2 and Layer 3 port channels by entering the interface port-channel command orwhen the channel group gets its first physical interface assignment. The port channels are not created at runtimeor dynamically.

Any configuration or attribute changes that you make to the port-channel interface are propagated to allinterfaces within the same channel group as the port channel (for example, configuration changes are alsopropagated to the physical interfaces that are not part of the port channel but are part of the channel group).

When configuring Layer 2 EtherChannels, you cannot put Layer 2 LANports intomanually created port-channellogical interfaces.

Only the on mode is supported when using this command with GE-WAN ports on the OSM-2+4GE-WAN+OSM to create QinQ link bundles for advanced QinQ translation. Also, you cannot use the channel-groupcommand on GE-WAN interfaces if MPLS is configured. You must remove all IP, MPLS, and other Layer3 configuration commands before using the channel-group command with GE-WAN interfaces.



The GE-WAN interfaces on an OSM-2+4GE-WAN+OSMbehave slightly differently than other interfacesif you want to move the interface from one group to another. To move most other interfaces, you can enterthe channel-group command again to delete the interface from the old group and move it to the newgroup. For GE-WAN ports, however, you must manually remove the interface from the group by enteringthe no channel-group command before assigning it to a new group.

Note

Do not enable Layer 3 addresses on the physical EtherChannel interfaces. Assigning bridge groups on thephysical EtherChannel interfaces causes loops in your network.

Caution

For a complete list of guidelines, see the “Configuring EtherChannel” section of theCisco 7600 Series RouterCisco IOS Software Configuration Guide.

Fast EtherChannel

Before you assign a Fast Ethernet interface to a Fast EtherChannel group, you must first create a port-channelinterface. To create a port-channel interface, use the interface port-channel global configuration command.

If the Fast Ethernet interface has an IP address assigned, you must disable it before adding the Fast Ethernetinterface to the Fast EtherChannel. To disable an existing IP address on the Fast Ethernet interface, use theno ip addresscommand in interface configuration mode.

The Fast EtherChannel feature allows multiple Fast Ethernet point-to-point links to be bundled into one logicallink to provide bidirectional bandwidth of up to 800 Mbps. Fast EtherChannel can be configured betweenCisco 7500 series routers and Cisco 7000 series routers with the 7000 Series Route Switch Processor (RSP7000)and 7000 Series Chassis Interface (RSP7000CI) or between a Cisco 7500 series router or a Cisco 7000 seriesrouter with the RSP7000 and RSP700CI and a Cisco Catalyst 5000 switch.

A maximum of four Fast Ethernet interfaces can be added to a Fast EtherChannel group.

The port-channel interface is the routed interface. Do not enable Layer 3 addresses on the physical FastEthernet interfaces. Do not assign bridge groups on the physical Fast Ethernet interfaces because it createsloops. Also, you must disable spanning tree.

Caution

To display information about the Fast EtherChannel, use the show interfaces port-channelEXEC command.

For more guidelines see the “Configuring EtherChannel” section of the Cisco 7600 Series Router Cisco IOSSoftware Configuration Guide and the “Configuring EtherChannel” section of theCatalyst 6500 Series SwitchCisco IOS Software Configuration Guide

Examples This example shows how to add EtherChannel interface 1/0 to the EtherChannel group that is specified byport-channel 1:

Router(config-if)#channel-group 1 mode onRouter(config-if)#The following example shows how to add interface Fast Ethernet 1/0 to the Fast EtherChannel group specifiedby port-channel 1:

Router(config)#interface port-channel 1Router(config-if)#



exitRouter(config)#interface fastethernet 1/0Router(config-if)#channel-group 1

Related Commands DescriptionCommand

Creates a port-channel virtual interface and puts theCLI in interface configuration mode when theport-channel keyword is used.

interface

Sets a primary or secondary IP address on aninterface.

ip address

Displays the EtherChannel information for a channel.show etherchannel

Displays traffic that is seen by a specific port channel.show interfaces port-channel



clear lldpTo reset either the Link Layer Discovery Protocol (LLDP) traffic counters or the table that contains LLDPinformation about neighbors, use the clear lldp command in privileged EXEC mode.

clear lldp {counters| table}

Syntax Description Specifies that the traffic counters are cleared.counters

Specifies that the LLDP table is cleared.table

Command Default The LLDP traffic counters are not reset, and the table of LLDP information is not cleared.

Command Modes Privileged EXEC (#)


This command was introduced.12.2(33)SXH

This command was integrated into Cisco IOS Release 15.2(3)T.15.2(3)T

This command was integrated into Cisco IOS XE Release 3.8S.Cisco IOS XE Release 3.8S

Usage Guidelines Use this command for informational purposes or to test a symptom of network malfunction such as packetloss.

Examples The following example shows how to clear the LLDP counters and display LLDP traffic. The output fromthe show lldp traffic command shows that all the traffic counters have been reset to zero.

Device# clear lldp countersDevice# show lldp trafficLLDP traffic statistics:

Total frames out: 0Total entries aged: 0Total frames in: 0Total frames received in error: 0Total frames discarded: 0Total TLVs unrecognized: 0

The following example shows how to clear the LLDP table. The output of the show lldp neighbors commandshows that all information has been deleted from the table.

Device# clear lldp tableDevice# show lldp neighbors


A through Zclear lldp

Capability codes:(R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device(W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other

Device ID Local Intf Hold-time Capability Port ID


Displays information about LLDP in the network.show lldp


A through Zclear lldp

lacp fast-switchoverTo enable Link Aggregation Control Protocol (LACP) 1:1 link redundancy, use the lacp fast-switchovercommand in interface configuration mode. To dis able LACP 1:1 link redundancy, use the no form of thiscommand.

lacp fast-switchover

no lacp fast-switchover

Syntax Description This command has no arguments or keywords.

Command Default LACP 1:1 link redundancy is disabled by default.




This command was integrated into Cisco IOS Release 12.2(33)SRC.12.2(33)SRC

Support for this command was implemented on the Cisco 10000 seriesrouter and integrated into Cisco IOS Release 12.2(33)SB. The time allowedfor a link switchover was modified from the default of 2 seconds to 250milliseconds.

12.2(33)SB

This command was integrated into Cisco IOS XE Release 2.5Cisco IOS XE Release 2.5

Usage Guidelines Prior to entering the lacp fast-switchover command, you must ensure the following:

• The port channel protocol type is LACP.

• The lacp max-bundle 1command has been entered on the port channel. The lacp fast-switchovercommand will not affect the lacp max-bundle command.

When you enable LACP 1:1 link redundancy, based on the system priority and port priority, the port with thehigher system priority chooses the link as the active link and the other link as the standby link. When theactive link fails, the standby link is selected as the new active link without taking down the port channel.When the original active link recovers, it reverts to its active link status. During this change-over, the portchannel is also up.


A through Zlacp fast-switchover

We recommend that you configure two ports only (one active and one hot-standby) in the bundle foroptimum performance.

Note

You can enter this command on any port channels with different EtherChannel protocol types of LACP, PortAggregation Protocol (PAgP), or Fast EtherChannel (FEC).

Examples This example shows how to enable LACP 1:1 link redundancy:

Router(config-if)# lacp fast-switchoverThis example shows how to disable LACP 1:1 link redundancy:

Router(config-if)# no lacp fast-switchover


Assigns and configures an EtherChannel interface toan EtherChannel group.

lacp max-bundle



A through Zlacp fast-switchover

lacp max-bundleTo define the maximum number of active bundled Link Aggregation Control Protocol (LACP) ports allowedin a port channel, use the lacpmax-bundle command in interface configuration mode. To return to the defaultsettings, use the no form of this command.

lacp max-bundle max-bundles

no lacp max-bundle

Syntax Description Maximum number of active bundled ports allowedin the port channel. Valid values are from 1 to 8. Onthe Cisco ASR 1000 series router, valid values are 1to 4.

The default settings are as follows:

• Maximum of 8 bundled ports per port channel.

• Maximum of 8 bundled ports and 8 hot-standbyports per port channel if the port channels onboth sides of the LACP bundle are configuredin the same way.

• On the Cisco 10000 series router, maximum of8 bundled ports per port channel.

max-bundles

Command Default A maximum number of active bundled ports is not configured.



Support for this command was introduced on the Supervisor Engine 720.12.2(18)SXD


Support for this command was implemented on the Cisco 10000 seriesrouter and integrated into Cisco IOS Release 12.2(31)SB2.

12.2(31)SB2

Support for this command on the Cisco 7600 router was integrated intoCisco IOS Release 12.2(33)SRB.

12.2(33)SRB

On the Cisco 10000 series router, the maximum number of bundled portsper port channel was increased from 4 to 8.

12.2(33)SB


A through Zlacp max-bundle

ModificationRelease


This command was integrated into Cisco IOS Release 12.2(33)SRE.12.2(33)SRE

Usage Guidelines The value specified in the max-bundles argument determines the number of active links that are bundled inthe port channel. The remaining links are in hot-standby mode.

On the Cisco 10000 series router, this command requires a Performance Routing Engine 2 (PRE2) or PRE3.

Examples This example shows how to set 3 ports to bundle in port channel 2:

Router(config)# interface port-channel 2Router(config-if)# lacp max-bundle 3Router(config-if)#


Creates a port-channel virtual interface and puts theCLI in interface configuration mode.

interface port-channel


ip address




A through Zlacp max-bundle

lacp min-bundleTo set the minimum number of active links in a Link Aggregation Control Protocol (LACP) bundle, use thelacp min-bundle command in interface configuration mode. To return to the default settings, use the no formof this command.

lacp min-bundle min-bundle

no lacp min-bundle

Syntax Description Minimum number of bundled ports allowed in theport channel. Valid values are from 1 to 8. The defaultis 1.

min-bundle

Command Default The port-channel operational state will be “Down” only when there are no active links in the channel. If thereare one or more active links, the port-channel state will be “Up.”



This command was introduced.12.2(33)SB


This commandwas integrated into Cisco IOSRelease 12.2(33)SRE.12.2(33)SRE

Usage Guidelines Use the lacp min-bundle command to configure the minimum number of active links allowed in an LACPbundle. When the number of active links falls below this minimum threshold, the port channel shuts down.

LACP and the same minimum bundle value must be configured on each peer in order for both sides ofthe port channel to be brought down.

Note

Cisco 10000 Series Router

This command requires a Performance Routing Engine 2 (PRE2) or PRE3.

Examples This example shows how to set the minimum number of active links to 5 ports:Device(config-if)# lacp min-bundle 5


A through Zlacp min-bundle


Creates a port-channel virtual interface and entersinterface configuration mode.

interface port-channel


ip address




A through Zlacp min-bundle

lacp port-priorityTo set the priority for a physical interface, use the lacp port-priority command in interface configurationmode. To return to the default setting, use the no form of this command.

lacp port-priority priority

no lacp port-priority

Syntax Description Integer from 1 to 65535 that indicates the priority forthe physical interface. The default is 32768.

• On the Cisco ASR 1000 series router, the rangeis 0 to 65535.

priority

Command Default The default port priority is set.



This commandwas introduced on the Cisco Catalyst 4500 series switches.12.1(13)EW

Support for this command on the Supervisor Engine 720 was integratedinto Cisco IOS Release12.2(14)SX.

12.2(14)SX

Support for this command on the Supervisor Engine 2 was integrated intoCisco IOS Release12.2(17d) SXB.

12.2(17d)SXB




12.2(33)SRB


This commandwas implemented on the CiscoASR 901 Series AggregationServices Router.

15.1(2)SNG


A through Zlacp port-priority

Usage Guidelines You may assign a port priority to each port on a device running Link Aggregation Control Protocol (LACP).You can specify the port priority by using the lacp port-priority command at the command-line interface(CLI) or use the default port priority (32768) that is carried as part of the LACP protocol data unit (PDU)exchanged with the partner. Port priority is used to decide which ports should be put in standby mode whena hardware limitation or the lacp max-bundle command configuration prevents all compatible ports fromaggregating. Priority is supported only on port channels with LACP-enabled physical interfaces.

A high priority number means a low priority.Note

Port priority together with port number form a port identifier.

To verify the configured port priority, issue the show lacp command.

Examples This example shows how to set a priority of 23700 for an interface:

Device> enableDevice# configure terminalDevice(config)# interface ethernet0/0Device(config-if)# lacp port-priority 23700Device(config-if)#



channel-group

Enables debugging of LACP activities.debug lacp

Defines the maximum number of active bundledLACP ports allowed in a port channel.

lacp max-bundle

Sets the priority of the system.lacp system-priority

Displays information about LACP activity on thedevice.

show lacp


A through Zlacp port-priority

lacp rateTo set the rate at which Link Aggregation Control Protocol (LACP) control packets are ingressed to anLACP-supported interface, use the lacp rate command in interface configuration mode. To return to thedefault settings, use the no form of this command.

lacp rate {normal| fast}

no lacp rate

Syntax Description Specifies that LACP control packets are ingressed atthe normal rate, every 30 seconds after the link isbundled.

normal

Specifies that LACP control packets are ingressed atthe fast rate, once every 1 second.

fast

Command Default The default ingressed rate for control packets is 30 seconds after the link is bundled.



This command was introduced on the Catalyst 6500 series switch.12.2(18)SXF2

This command was integrated into Cisco IOS Release 12.2(33)SRC.12.2(33)SRC

Usage Guidelines Use this command to modify the duration of a LACP timeout. The LACP timeout value is set on Cisco switchesto a value of 90 seconds. Using the lacp rate command, you can select the LACP timeout value for a switchto be either 30 seconds or 1 second.

This command is supported only on LACP-enabled interfaces.

Examples This example shows how to specify the fast (1-second) ingress rate on interface Ethernet 0/1:

Router(config)# interface ethernet 0/1Router(config-if)# lacp rate fast


A through Zlacp rate


Displays LACP information.show lacp


A through Zlacp rate

lacp system-priorityTo set the priority for a system, use the lacp system-priority command in global configuration mode. Toreturn to the default setting, use the no form of this command.

lacp system-priority priority

no lacp system-priority

Syntax Description Integer from 1 to 65535 that indicates the priority forthe system. The default is 32768.

• On the Cisco ASR 1000 series router, the rangeis 0 to 65535.

priority

Command Default The default system priority is set.

Command Modes Global configuration (config)


This commandwas introduced on the Cisco Catalyst 4500 series switches.12.1(13)EW

Support for this command on the Supervisor Engine 720 was integratedinto Cisco IOS Release12.2(14)SX.

12.2(14)SX

Support for this command on the Supervisor Engine 2 was integrated intoCisco IOS Release12.2(17d) SXB.

12.2(17d)SXB




12.2(33)SRB



15.1(2)SNG


A through Zlacp system-priority

Usage Guidelines You can assign a system priority to each device running Link Aggregation Control Protocol (LACP). Youcan specify the system priority by using the lacp system-priority command at the command-line interface(CLI) or use the default system priority (32768) that is carried as part of the LACP protocol data unit (PDU)exchanged with the partner. System priority is used with the MAC address of the device to form the systemID and also is used during negotiation with other systems. Priority is supported only on port channels withLACP-enabled physical interfaces.

A high priority number means a low priority.Note

To verify the configured system priority, issue the show lacp command.

Examples The following example shows how to set a system priority of 25500 for a device:

Router> enableRouter# configure terminalRouter(config)# lacp system-priority 25500



channel-group

Enables debugging of LACP activities.debug lacp

Sets the priority of a port.lacp port-priority

Displays information about LACP activity on thedevice.

show lacp


A through Zlacp system-priority

lldpTo enable and configure Link Layer Discovery Protocol (LLDP), use the lldp command in global configurationmode. To disable LLDP, use the no form of this command.

lldp {holdtime seconds| reinit delay| run| timer rate| tlv-select tlv}

no lldp {holdtime| reinit| run| timer| tlv-select tlv}

Syntax Description Specifies the length of time that the receiver mustkeep the packet.

holdtime

Integer in the range from 0 to 65535 that specifies thelength of time, in seconds, that the receiver must keepthe packet. The default is 120.

seconds

Specifies a delay for LLDP initialization on aninterface.

reinit

Integer in the range from 2 to 5 that specifies thelength of time, in seconds, that LLDP should wait toinitialize. The default is 2.

delay

Enables LLDP.run

Specifies a rate at which LLDP packets are sent.timer

Integer in the range from 5 to 65534 that specifieshow often, in seconds, the Cisco IOS software sendsLLDP updates. The default is 30.

rate

Specifies the time-length-value (TLV) elements tosend.

tlv-select


A through Zlldp

String that identifies the TLV element to use. Validvalues are:

• mac-phy-cfg --IEEE 802.3 MAC/Phyconfiguration/status TLV

• management-address --Management addressTLV

• port-description --Port description TLV

• port-vlan --Port VLAN ID TLV

• system-capabilities --System capabilities TLV

• system-description --System description TLV

• system-name --System name TLV

tlv

Command Default LLDP is globally disabled. No LLDP advertisements are sent.

Command Modes Global configuration (config)


This command was introduced.12.2(37)SE

This command was modified. The command default was changed todisabled.

12.2(44)SE

This command was integrated into Cisco IOS Release 12.2(44)SG.12.2(44)SG

This command was integrated into Cisco IOS Release 12.2(33)SXH.12.2(33)SXH


This command was integrated into Cisco IOS Release XE3.8SCisco IOS XE Release 3.8S

Usage Guidelines To enable LLDP, use this command with the run keyword.

LLDP packets are sent with a hold-time value. The receiving device ages the LLDP information about theneighbor after the hold time has elapsed.

LLDP is an industry standard version for Cisco Discovery Protocol (CDP). Non-Cisco phones use LLDP toconfigure voice VLANs. If you install a non-Cisco phone that supports LLDP and do not want to configurea voice VLAN on the phone, then you can use LLDP.


A through Zlldp

Examples The following example shows how to configure a hold time of 100 seconds:

Device(config)# lldp holdtime 100The following example shows how to set the timer to send LLDP updates every 75 seconds:

Device(config)# lldp timer 75


Displays global LLDP information.show lldp


A through Zlldp

lldp (interface)To enable Link Layer Discovery Protocol (LLDP) on an interface, use the lldpcommand in interfaceconfiguration mode. To disable LLDP on an interface, use the no form of this command.

lldp {med-tlv-select tlv| receive| transmit}

no lldp {med-tlv-select tlv| receive| transmit}

Syntax Description Selects an LLDP Media Endpoint Discovery (MED)time-length-value (TLV) element to send.

med-tlv-select

String that identifies the TLV element. Valid valuesare the following:

• inventory-management--LLDP MEDInventory Management TLV

• network-policy --LLDPMEDNetwork PolicyTLV

• power-management --LLDP MED PowerManagement TLV

tlv

Enables an interface to receive LLDP transmissions.receive

Enables LLDP transmission on an interface.transmit

Command Default LLDP is enabled on supported interfaces.




Usage Guidelines This command is supported on 802.1 media types.

Examples The following example shows how to disable LLDP transmission on interface Ethernet 0/1:

Router# configure terminal


A through Zlldp (interface)

Router(config)# interface ethernet 0/1Router(config-if)# no lldp transmit

The following example shows how to enable LLDP transmission on interface Ethernet 0/1:

Router# configure terminalRouter(config)# interface ethernet 0/1Router(config-if)# lldp transmit


Enables LLDP globally.lldp


A through Zlldp (interface)

location (interface)To configure location information for an interface, use the locationcommand in interface configuration mode.To remove the location information for an interface, use the no form of this command.

location {additional-location-information word| civic-location-id id [port-location]| elin-location-id id}

no location {additional-location-information word| civic-location-id id [port-location]| elin-location-idid}

Syntax Description Configures additional information for a location orplace.

additional-location-information

A word or phrase that provides additional locationinformation.

word

Configures civic location information for an interface.civic-location-id

(Optional) Specifies port-specific attributes.port-location

Configures emergency location identifier number(ELIN) for an interface.

elin-location-id

The ID for the civic location or the ELIN location.The ID range is from 1 to 4095.

The identifier for the civic location in theLink-Layer Discovery Protocol-MediaEndpoint Discovery (LLDP-MED) TLV islimited to 250 bytes or less. To avoid errormessages about available buffer space duringswitch configuration, be sure that the totallength of all civic location informationspecified for each civic location ID does notexceed 250 bytes.

Note

id

Command Default Location information for interfaces is not enabled.



This command was introduced.12.2(40)SE

This command was modified. The port-location keyword was added.12.2(55)SE


A through Zlocation (interface)

ModificationRelease

This command was integrated into Cisco IOS Release 15.1(1)SY.15.1(1)SY

Usage Guidelines You can use the location command to configure location support for interfaces. When you configure thelocation command on a specific interface or on several interfaces, the location TLVs are transmitted on therespective interfaces every time CDP messages are sent. After entering the location civic-location-ididport-location command, you enter civic location port configuration mode. In this mode, you can enteradditional location information for every port. Use the help feature (?) for details on the additional informationthat you can configure in this mode. You can configure the common attributes globally and specific attributesper port. If an attribute is configured both globally and on a port, the port configuration has higher priority.

The civic location identifier must not exceed 250 bytes.

Examples The following example shows how to enter civic location information for an interface, and to configureadditional information for civic location identifier:

Device(config)# interface gigabitethernet1/0/1Device(config-if)# location civic-location-id 1 port-locationDevice(config-if-port)# number 3560Device(config-if-port)# building 10You can verify your settings by entering the show location civic interface command.


Configures the location information for an endpoint.location

Displays the location information for an endpoint.show location


A through Zlocation (interface)

show lacpTo display Link Aggregation Control Protocol (LACP) and multi-chassis LACP (mLACP) information, usethe show lacp command in either user EXEC or privileged EXEC mode.

show lacp {channel-group-number {counters| internal [detail]| neighbor [detail]}|multi-chassis[load-balance] {group number| port-channel number}| sys-id}

Cisco ASR 901 Series Aggregation Services Router

show lacp {channel-group-number {counters| internal [detail]| neighbor [detail]| sys-id}}

Syntax Description (Optional) Number of the channel group. Thefollowing are valid values:

• Cisco IOS 12.2 SB and Cisco IOS XE 2.4Releases--from 1 to 64

• Cisco IOS 12.2 SR Releases--from 1 to 308

• Cisco IOS 12.2 SX Releases--from 1 to 496

• Cisco IOS 15.1S Releases—from 1 to 564

• Cisco ASR 901 Series Aggregation ServicesRouter—from 1 to 8

channel-group- number

Displays information about the LACP traffic statistics.counters

Displays LACP internal information.internal

Displays information about the LACP neighbor.neighbor

(Optional) Displays detailed internal informationwhen used with the internal keyword and detailedLACP neighbor information when used with theneighbor keyword.

detail

Displays information about mLACP.multi-chassis

Displays mLACP load balance information.load-balance

Displays mLACP redundancy group information,group


A through Zshow lacp

Integer value used with the group and port-channelkeywords.

• Values from 1 to 4294967295 identify theredundancy group.

• Values from 1 to 564 identify the port-channelinterface.

number

Displays mLACP port-channel information.port-channel

Displays the LACP system identification. It is acombination of the port priority and theMAC addressof the device

sys-id

Command Modes User EXEC (>) Privileged EXEC (#)


Support for this command was introduced on the Supervisor Engine 720.12.2(14)SX

Support for this command on the Supervisor Engine 2 was extended toCisco IOS Release 12.2(17d)SXB.

12.2(17d)SXB




12.2(33)SRB


This command was modified. Themulti-chassis, group, andport-channelkeywords and number argument were added.

12.2(33)SRE

This command was modified. The load-balance keyword was added.15.1(3)S


15.1(2)SNG

Usage Guidelines Use the show lacp command to troubleshoot problems related to LACP in a network.

If you do not specify a value for the argument channel-group-number, all channel groups are displayed. Valuesin the range of 257 to 282 are supported on the CSM and the FWSM only.



Examples

Examples This example shows how to display the LACP system identification using the show lacp sys-idcommand:

Device> show lacp sys-id

8000,AC-12-34-56-78-90The system identification is made up of the system priority and the system MAC address. The first two bytesare the system priority, and the last six bytes are the globally administered individual MAC address that isassociated to the system.

Examples This example shows how to display the LACP statistics for a specific channel group:

Device# show lacp 1 counters

LACPDUs Marker LACPDUsPort Sent Recv Sent Recv Pkts Err---------------------------------------------------Channel group: 1Fa4/1 8 15 0 0 3 0Fa4/2 14 18 0 0 3 0Fa4/3 14 18 0 0 0Fa4/4 13 18 0 0 0

The output displays the following information:

• The LACPDUs Sent and Recv columns display the LACPDUs that are sent and received on each specificinterface.

• The LACPDUs Pkts and Err columns display the marker-protocol packets.

The following example shows output from a show lacpchannel-group-numbercounterscommand:

Device1# show lacp 5 counters

LACPDUs Marker Marker Response LACPDUsPort Sent Recv Sent Recv Sent Recv Pkts Err---------------------------------------------------------------------Channel group: 5Gi5/0/0 21 18 0 0 0 0 0The following table describes the significant fields shown in the display.

Table 1: show lacp channel-group-number counters Field Descriptions

DescriptionField

Number of LACP PDUs sent and received.LACPDUs Sent Recv

Attempts to avoid data loss when a member link isremoved from an LACP bundle.

Marker Sent Recv

Cisco IOS response to the Marker protocol.Marker Response Sent Recv

Number of LACP PDU packets transmitted and thenumber of packet errors.

LACPDUs Pkts Err



The following example shows output from a show lacp internalcommand:

Device1# show lacp 5 internal

Flags: S - Device is requesting Slow LACPDUsF - Device is requesting Fast LACPDUsA - Device is in Active mode P - Device is in Passive mode

Channel group 5LACP port Admin Oper Port Port

Port Flags State Priority Key Key Number StateGi5/0/0 SA bndl 32768 0x5 0x5 0x42 0x3DThe following table describes the significant fields shown in the display.

Table 2: show lacp internal Field Descriptions

DescriptionField

Meanings of each flag value, which indicates a deviceactivity.

Flags

Port on which link bundling is configured.Port

Indicators of device activity.Flags

Activity state of the port. States can be any of thefollowing:

• Bndl--Port is attached to an aggregator andbundled with other ports.

• Susp--Port is in suspended state, so it is notattached to any aggregator.

• Indep--Port is in independent state (not bundledbut able to switch data traffic). This conditiondiffers from the previous state because in thiscase LACP is not running on the partner port.

• Hot-sby--Port is in hot standby state.

• Down--Port is down.

State

Priority assigned to the port.LACP port Priority

Defines the ability of a port to aggregate with otherports.

Admin Key

Determines the aggregation capability of the link.Oper Key

Number of the port.Port Number



DescriptionField

State variables for the port that are encoded asindividual bits within a single octet with the followingmeaning:

• bit0: LACP_Activity

• bit1: LACP_Timeout

• bit2: Aggregation

• bit3: Synchronization

• bit4: Collecting

• bit5: Distributing

• bit6: Defaulted

• bit7: Expired

Port State

Examples This example shows how to display internal information for the interfaces that belong to a specific channel:

Device# show lacp 1 internal

Flags: S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate.A - Device is in Active mode. P - Device is in Passive mode.

Channel group 1LACPDUs LACP Port Admin Oper Port Port

Port Flags State Interval Priority Key Key Number StateFa4/1 saC bndl 30s 32768 100 100 0xc1 0x75Fa4/2 saC bndl 30s 32768 100 100 0xc2 0x75Fa4/3 saC bndl 30s 32768 100 100 0xc3 0x75Fa4/4 saC bndl 30s 32768 100 100 0xc4 0x75Device#The following table describes the significant fields shown in the display.



Table 3: show lacp internal Field Descriptions

DescriptionField

Current state of the port; allowed values are asfollows:

• bndl--Port is attached to an aggregator andbundled with other ports.

• susp--Port is in a suspended state; it is notattached to any aggregator.

• indep--Port is in an independent state (notbundled but able to switch data traffic. In thiscase, LACP is not running on the partner port).

• hot-sby--Port is in a hot-standby state.

• down--Port is down.

State

Interval setting.LACPDUs Interval

Port-priority setting.LACP Port Priority


Admin Key


Port number.Port Number

Activity state of the port.

• See the Port State description in the show lacpinternal Field Descriptions table for statevariables.

Port State

Examples This example shows how to display the information about the LACP neighbors for a specific port channel:

Device# show lacp 1 neighbors

Flags: S - Device sends PDUs at slow rate. F - Device sends PDUs at fast rate.A - Device is in Active mode. P - Device is in Passive mode.

Channel group 1 neighborsPartner Partner

Port System ID Port Number Age FlagsFa4/1 8000,00b0.c23e.d84e 0x81 29s PFa4/2 8000,00b0.c23e.d84e 0x82 0s PFa4/3 8000,00b0.c23e.d84e 0x83 0s PFa4/4 8000,00b0.c23e.d84e 0x84 0s P

Port Admin Oper PortPriority Key Key State

Fa4/1 32768 200 200 0x81



Fa4/2 32768 200 200 0x81Fa4/3 32768 200 200 0x81Fa4/4 32768 200 200 0x81Device#The following table describes the significant fields shown in the display.

Table 4: show lacp neighbors Field Descriptions

DescriptionField

Port on which link bundling is configured.Port

Peer’s LACP system identification (sys-id). It is acombination of the system priority and the MACaddress of the peer device.

Partner System ID

Port number on the peer devicePartner Port Number

Number of seconds since the last LACP PDU wasreceived on the port.

Age

Indicators of device activity.Flags

Port priority setting.Port Priority


Admin Key


Activity state of the port.

See the Port State description in the show lacp internalField Descriptions table for state variables.

Port State

If no PDUs have been received, the default administrative information is displayed in braces.


Clears the statistics for all interfaces belonging to aspecific channel group.

clear lacp counters

Sets the priority for the physical interfaces.lacp port-priority

Sets the priority of the system.lacp system-priority



show lldpTo display information about one or all neighboring devices discovered using Link Layer Discovery Protocol(LLDP), use the show lldpcommand in privileged EXEC mode.

show lldp [entry {*| word}| errors| interface [ethernet number]| neighbors [ethernet number| detail]|traffic]

Syntax Description (Optional) Displays detailed information for a specificneighbor entry.

entry

(Optional) Displays detailed information about all theLLDP neighbors.

*

(Optional) Name of the neighbor about whichinformation is requested.

word

(Optional) Displays LLDP computational errors andoverflows.

errors

(Optional) Displays status and configuration of aninterface on which LLDP is enabled.

interface

(Optional) Displays an IEEE 802.3 interface onwhichLLDP is enabled.

ethernet

(Optional) Integer that identifies the interface.number

(Optional) Displays neighbor entries.

If the device ID has more than 20 characters,the ID will be truncated to 20 characters incommand output because of displayconstraints.

Note

neighbors

(Optional) Displays detailed information about aneighbor (or neighbors) including network address,enabled capabilities, hold time, and software version.

detail

(Optional) Displays LLDP statistics.traffic

Command Modes Privileged EXEC (#)


A through Zshow lldp



Modified show lldp neighbors detail output to parse and displaymanagement addresses OID in ASN.1 notation.

12.2(50)SY


This command was implemented on the Cisco ASR 901 SeriesAggregation Services Router.

15.1(2)SNG

This command was integrated into Cisco IOS XE Release 3.8S.Cisco IOS XE Release 3.8S

Usage Guidelines Use this command to monitor LLDP activity in a network.

When you use the neighbors keyword, the device ID is truncated to 20 characters in the command outputbecause of display constraints. The show lldp neighbors command functions correctly; only the device IDdisplay is truncated. For detailed neighbor information, use the show lldp neighbors detail command.

Examples The following is sample output from the show lldp entry * command. Information about all the LLDPneighbors is displayed, including device ID, capabilities, addresses, hold time, and version.

Device# show lldp entry *


Chassis id: aabb.cc00.1f01Port id: Et1/0Port Description: Ethernet1/0System Name: R1.example.comSystem Description:Cisco IOS Software, Solaris Software (UNIX-JS-M)12.2(20070524:210936) [user1-sierra-0522 105]Copyright (c) 1986-2007 by Cisco Systems, Inc.Compiled Fri 25-May-07 10:52 by user1Time remaining: 136 secondsSystem Capabilities: B,REnabled Capabilities: RManagement Addresses - not advertisedAuto Negotiation - not supportedPhysical media capabilities - not advertisedMedia Attachment Unit type - not advertised---------------------------------------------Total entries displayed: 1The table below describes the significant fields in the output.



Table 5: show lldp entry * Field Descriptions

DescriptionField

Type of device that can be discovered. Possible valuesare as follows:

R--Router

B--Bridge

T--Telephone

C--DOCSIS Cable Device

W--WLAN Access Point

P--Repeater

S--Station

O--Other

Capability Codes

Identifier assigned to the device.Chassis id

Identifier of the interface.Port id

Description of the interface.Port Description

Name of the device within the network.System Name

Description of the software operating on the device.System Description

Time remaining before the information is aged out.Time remaining

Possible capabilities of the device.System Capabilities

Subset of possible capabilities that are enabled.Enabled Capabilities

Layer 3 addresses of the management interface.Management Addresses

Supported and enabled status of all interfaceautonegotiation capabilities.

Auto Negotiation

Physical characteristics of the interface on whichLLDP operates.

Physical media capabilities

Numeric value representing the type of the mediaattachment unit.

Media Attachment Unit type

Number of neighbor devices for which informationis displayed.

Total entries displayed



The following is sample output from the show lldp neighbors command showing information about neighboringdevices discovered using LLDP.

Device# show lldp neighbors


Device ID Local Intf Hold-time Capability Port IDR1 Et1/0 150 R Et1/0

Total entries displayed: 1

The table below describes the significant fields shown in the output.

Table 6: show lldp neighbors Field Descriptions

DescriptionField

See the show lldp entry * Field Descriptions table fordetails.

Capability Codes

Name of the neighbor device.

If the device ID has more than 20 characters,the ID will be truncated to 20 characters incommand output because of displayconstraints.

Note

Device ID

Local interface through which this neighbor isconnected.

Local Intf

Amount of time (in seconds) the current device willhold the LLDP advertisement from a sending devicebefore discarding it.

Hold-time

Type of device listed in the LLDP Neighbors table.Values correspond to the values of the capabilitycodes.

Capability

Interface and port number of the neighboring device.Port ID

Number of neighbor devices for which informationis displayed.

Total entries displayed

The following is sample output from the show lldp neighbors command showing information about neighboringdevices discovered using LLDP:Device# show lldp neighbors detail

------------------------------------------------Chassis id: aabb.cc00.6502Port id: Et2/0Port Description: Ethernet2/0System Name: r101

System Description:



Cisco IOS Software, Solaris Software (UNIX-P-M), Experimental Version 12.2(20081021:182811)[yonhan-CSCsm33589-flo_dsgs7 105]Copyright (c) 1986-2008 by Cisco Systems, Inc.Compiled Fri 31-Oct-08 11:20 by yonhan

Time remaining: 105 secondsSystem Capabilities: B,REnabled Capabilities: RManagement Addresses:

IP: 192.168.1.1OID:

1.3.6.1.4.1.16361.1.69.2.2.AutoThe table below describes the significant fields shown in the output.

Table 7: show lldp neighbors detail Field Descriptions

DescriptionField

Identifier assigned to the device.Chassis id

Identifier of the interface.Port id

Description of the interface.Port Description

Name of the device within the network.System Name

Description of the software operating on the device.System Description

Time remaining before the information is aged out.Time remaining

Possible capabilities of the device.System Capabilities

Subset of possible capabilities that are enabled.Enabled Capabilities

Layer 3 addresses of the management interface.Management Addresses

Supported and enabled status of all interfaceautonegotiation capabilities.

Auto

The following is sample output from the show lldp interface command for Ethernet interface 0/1:

Device# show lldp interface ethernet 0/1

Ethernet0/1:Tx: enabledRx: enabledTx state: IDLERx state: WAIT FOR FRAME


Table 8: show lldp interface Field Descriptions

DescriptionField

Ability of the interface to transmit advertisements.Tx



DescriptionField

Ability of the interface to receive advertisements.Rx

Current finite state machine state of the interface intransmit mode.

Tx state

Current finite state machine state of the interface inreceive mode.

Rx state

The following is sample output from the show lldp errors command:

Device# show lldp errors

LLDP errors/overflows:Total memory allocation failures: 0Total encapsulation failures: 0Total input queue overflows: 0Total table overflows: 0


Table 9: show lldp errors Field Descriptions

DescriptionField

Number of memory allocation failures.Total memory allocation failures

Number of LLDP packet encapsulation failures.Total encapsulation failures

Number of times incoming advertisements exceededthe capacity of the LLDP input queue.

Total input queue overflows

Number of times the LLDP table rejectedadvertisements because it was full.

Total table overflows

The following is sample output from the show lldp trafficcommand:

Device# show lldp traffic

LLDP traffic statistics:Total frames out: 277Total entries aged: 0Total frames in: 328Total frames received in error: 0Total frames discarded: 0Total TLVs unrecognized: 0


Table 10: show lldp traffic Field Descriptions

DefinitionField

Number of advertisements sent from the device.Total frames out



DefinitionField

Number of neighbor device entries aged out.Total entries aged

Number of advertisements received by the device.Total frames in

Number of times the LLDP advertisements containederrors of any type.

Total frames received in error

Number of times the LLDP process discarded anincoming advertisement.

Total frames discarded

Number of TLVs that could not be processed becausethe content of the TLV was not recognized by thedevice or the content fields were incorrectly specified.

Total TLVs unrecognized



carrier ethernet command reference, cisco ios xe release 3se

Documents