Switch CLI Reference Guide

Link Aggregation Commands

lacp system-priority
Command Objective

This command configures the LACP priority associated with actor’s system ID. This priority value ranges between 0 and 65535. The Switch with the lowest LACP decides the standby and active links in the LA.

The no form of the command resets the LACP priority to its default value.

Syntax

lacp system-priority <0-65535>

no lacp system-priority

ModeGlobal Configuration Mode
port-channel load-balance
Command Objective

This command configures the load balancing policy for all port channels created in the Switch.

The policy sets the rule for distributing the Ethernet traffic among the aggregated links to establish load balancing.

The no form of the command resets the load balancing policy to its default value.

Syntax

port-channel load-balance ([src-mac][dest-mac][src-dest-

mac][src-ip][dest-ip][src-dest-ip][dest-l4-port][src-l4-port])

no port-channel load-balance

Parameter Description
  • src-mac - Distributes the load based on the source MAC address. The bits of the source MAC address in the packet are used to select the port in which the traffic should flow. Packets from different hosts use different ports in the channel, but packets from the same host use the same port.

  • dest-mac - Distributes the load based on the destination host MAC address. The bits of the destination MAC address in the packet are used to select the port in which the traffic should flow. Packets to the same destination are sent on the same port, but packets to different destinations are sent on different ports in the channel

  • src-dest-mac - Distributes the load based on the source and destination MAC address. The bits of the source and destination MAC address in the packet are used to select the port in which the traffic should flow.

  • src-ip - Distributes the load based on the source IP address. The bits of the source IP address in the packet are used to select the port in which the traffic should flow.

  • dest-ip - Distributes the load based on the destination IP address. The bits of the destination IP address in the packet are used to select the port in which the traffic should flow.

  • src-dest-ip - Distributes the load based on the source and destination IP address. The bits of the source and destination IP address in the packet are used to select the port in which the traffic should flow.

  • dest-l4-port - Distributes the load based on the destination Layer 4 port. The bits of the destination Layer 4 port in the packet are used to select the port in which the traffic should flow.

  • src-l4-port - Distributes the load based on the source Layer 4 port. The bits of the source Layer 4 port in the packet are used to select the port in which the traffic should flow.

ModePrivileged EXEC Mode
channel-group
Command Objective

This command adds the port as a member of the specified port channel that is already created in the Switch.

The no form of the command deletes the aggregation of the port from all port channels.

Syntax

channel-group <channel-group-number(1-8)> Mode { on | active | passive }

no channel-group

Parameter Description
  • <channel-group-number(1-8)> - Adds the port as a member of the specified port channel. This is a unique value that represents the specific port-channel created. This value ranges from 1 to 8.

  • Mode - Configures the LACP activity for the port:

    • active - Starts LACP negotiation un-conditionally.

    • passive - Starts LACP negotiation only when LACP packet is received from peer.

    • on - Forces the interface to channel without LACP. This is equivalent to manual aggregation.

ModeInterface Configuration Mode (Physical Interface Mode)
lacp timeout
Command Objective

This command configures the LACP timeout period within which LACP PDUs should be received on a port to avoid timing out of the aggregated link.

The no form of the command sets the LACP timeout period to its default value.

Syntax

lacp timeout {long | short }

no lacp timeout

Parameter Description
  • long - Configures the LACP timeout period as 90 seconds. The LACP PDU is sent every 30 seconds.

  • short - Configures the LACP timeout period as 3 seconds. The LACP PDU is sent every second.

ModeInterface Configuration Mode (Physical Interface Mode)
show etherchannel
Command Objective

This command displays Etherchannel information for all port-channel groups created in the Switch. This information contains admin and oper status of port-channel module, and status of protocol operate Mode for each group.

Syntax

show etherchannel [[channel-group-number] { detail | load- balance | port | port-channel | summary | protocol}]

Parameter Description
  • channel-group-number - Displays Etherchannel information for the specified port-channel group. This is a unique value that represents the specific port-channel created. This value ranges from 1 to 8.

  • detail - Displays detailed Etherchannel information. The information contain admin and oper status of port channel module, LACP system priority, status of protocol operate Mode for each group, port details for each group and port channel details. The port details contain port state, group to which the port belongs, port Mode, aggregation state, port-channel ID, pseudo port-channel ID, admin key, oper key, port number, port state, and LACP port-priority, wait- time, port identifier, activity and timeout. The port channel details contain port channel ID, number of member ports, ID of hot standby port, port state, status of protocol operate Mode, aggregator MAC and default port ID.

  • load-balance - Displays the load balancing policy applied for each port-channel groups.

  • port - Displays the status of protocol operate Mode and port details for each group. The port details contain port state, group to which the port belongs, port Mode, aggregation state, port-channel ID, pseudo port-channel ID, admin key, oper key, port number, port state, and LACP port-priority, wait-time, port identifier, activity and timeout.

  • port-channel - Displays the admin and oper status of port channel module, and port channel details. The port channel details contain port channel ID, number of member ports, ID of hot standby port, port state, status of protocol operate Mode, aggregator MAC and default port ID.

  • summary - Displays the admin and oper status of port channel module, number of channel groups used, number of aggregators, group IDs, and port channel ID, status of protocol operate Mode and member ports for each group.

  • protocol - Displays the status of protocol operate Mode for each port-channel group.

ModePrivileged EXEC Mode

Was This Article Helpful?

Help us to improve our support portal

Techdocs Article Helpful form

Techdocs Article NOT Helpful form

  • Still can't find what you're looking for? Try our knowledge base or ask our community for more help.