Commands For Port Channel

2.6 Commands for Port Channel

 

2.6.1 debug port-channel

Command: debug port-channel <port-group-number> {all | event | fsm | packet | timer}
no debug port-channel [<port-group-number>] Function: Open the port-channel debug switch.
Parameters:

  • <port-group-number>: the group number of the port-channel. The valid range is from 1 to 128.
  • all: all debug information.
  • event: debug event information.
  • fsm: debug the state machine.
  • packet: debug LACP packet information.
  • timer: debug the timer information.

Command mode: Admin Mode
Default: Disable port-channel debugging.
Usage guide: Open the debug switch to check port-channel debugging.
Examples:
Debug the state machine for port-group 1.

active500EM#debug port-channel 1 fsm

Debug LACP packet information for port-group 2.

active500EM#debug port-channel 2 packet

Debug all for port-group 1.

active500EM#debug port-channel 1 all

 

2.6.2 interface port-channel

Command: interface port-channel <port-channel-number>
Function: Enter port-channel configuration mode.
Parameters: None.
Command mode: Global Mode
Default: None.
Usage guide: On entering aggregated port mode, configuration to GVRP or spanning tree modules will apply to aggregated ports. If the aggregated port does not exist (i.e., ports have not been aggregated), an error message will be displayed and configuration will be saved and will be restored until the ports are aggregated. This restoration will be performed only once. If an aggregated group is ungrouped and aggregated again, the initial user configuration will not be restored. If the configuration is for modules, such as shutdown configuration, then the configuration to the current port will apply to all member ports in the corresponding port group.
Example: Enter configuration mode for port-channel 1.

active500EM(config)#interface port-channel 1
active500EM(config-if-port-channel1)#

 

2.6.3 lacp port-priority

Command: lacp port-priority <port-priority>
no lacp port-priority
Function: Set the LACP protocol port priority . The no command restores the default value.
Parameter:

  • <port-priority>: the LACP protocol port priority. The valid range is from 0 to 65535.

Command mode: Port Mode
Default: Priority is 32768.
Usage guide: Use this command to modify the LACP protocol port priority.
Example: Set the LACP protocol port priority.

active500EM(config-if-ethernet1/0/1)#lacp port-priority 30000

 

2.6.4 lacp system-priority

Command: lacp system-priority <system-priority>
no lacp system-priority
Function: Set the LACP protocol system priority. The no command restores the default value.
Parameter:

  • <system-priority>: the LACP protocol system priority. The valid range is from 0 to 65535.

Command mode: Global Mode
Default: Priority is 32768.
Usage guide: Use this command to modify the LACP protocol system priority.
Example: Set the LACP protocol system priority.

active500EM(config)#lacp system-priority 30000

 

2.6.5 lacp timeout

Command: lacp timeout {short | long}
no lacp timeout
Function: Set the LACP protocol timeout mode.
Parameter:

  • timeout: includes long and short.

Command mode: Port Mode
Default: Long.
Usage guide: Sets the LACP protocol timeout mode.
Example: Set the LACP protocol timeout mode.

active500EM(config-if-ethernet1/0/1)#lacp timeout short

 

2.6.6 load-balance

Command: load-balance {src-mac | dst-mac | dst-src-mac | src-ip | dst-ip | dst-src-ip}
Function: Set the load balance mode for the port-group.
Parameters:

  • src-mac: performs load balancing according to the source MAC address.
  • dst-mac: performs load balancing according to the destination MAC address.
  • dst-src-mac: performs load balancing according to the source and destination MAC addresses.
  • src-ip performs load balancing according to the source IP address.
  • dst-ip performs load balancing according to the destination IP address.
  • dst-src-ip performs load balancing according to the destination and source IP address.

Command mode: Aggregation Port Mode
Default: Perform load balancing according to the source and destination MAC addresses.
Usage guide: Use port-channel to implement load balancing. The user can configure the load balance mode according to their needs. If the specific command line load balance mode is different with the current port-group load balance mode, then modify the port-group load balance as the specific load balance of the command line. Otherwise, a message will be received that the current mode is already configured.
Example: Set the port-group load balance mode.

active500EM(config)#interface port-channel 1
active500EM(config-if-port-channel1)#load-balance src-mac

 

2.6.7 port-group

Command: port-group <port-group-number>
no port-group <port-group-number>
Function: Creates a port group. The no command deletes that group.
Parameter:

  • <port-group-number>: the group number of a port channel. The valid values are from 1-128.

Command mode: Global Mode
Default: There is no port-group.
Usage guide: Creates a port group.
Example: Create a port group.

active500EM(config)# port-group 1

Delete a port group.

active500EM(config)#no port-group 1

 

2.6.8 port-group mode

Command: port-group <port-group-number> mode {active | passive | on}
no port-group
Function: Add a physical port to a port channel. The no command removes the specified port from the port channel.
Parameters:

  • <port-group-number>: the group number of the port channel. The valid values are from 1 to 128.
  • active: enables LACP on the port and sets it to active mode.
  • passive: enables LACP on the port and sets it to passive mode.
  • on: forces the port to join a port channel without enabling LACP.

Command mode: Port Mode
Default: Switch ports do not belong to a port channel by default. LACP is not enabled.
Usage guide: If the specified port group does not exist, then an error message is displayed. All ports in a port group must be added in the same mode. For example, all ports use the mode used by the first port added. Adding a port via ?on? mode is a ?forced? action, which means the local end switch port aggregation does not rely on the information at the other end. Port aggregation will be successful if all ports have consistent VLAN information. Adding a port in ?active? or ?passive? mode enables LACP. Ports at one end must be added in ?active? mode. If ports at both ends are added in ?passive? mode the ports will never aggregate.
Example: Under Port Mode of Ethernet1/0/1, add the current port to ?port-group 1? in ?active? mode.

active500EM(config-if-ethernet1/0/1)#port-group 1 mode active

 

2.6.9 show port-group

Command: show port-group [<port-group-number>] {brief | detail |}
Function: Display the specified group number or the configuration information of all port-channels which have been configured.
Parameters:

  • <port-group-number>: the group number of port channel to be displayed. The valid values are from 1 to 128.
  • brief: displays summary information.
  • detail: displays detailed information.

Command mode: All Configuration Mode
Default: None.
Usage guide: If the user does not input the port-group-number, the information of all existing port-groups is shown. If the port channel corresponding to the port-group-number parameter does not exist, then an error message is displayed. Otherwise, the current port-channel information of the specified group number is displayed.
Examples:
Display summary information for port-group.

active500EM#show port-group brief
ID  Mode    Partner ID                Ports     Load-balance
-------------------------------------------------------------
1   active  0x8000,00-12-cf-4d-e1-a1  8,1,1     dst-src-mac
10  passive 0x8000,00-12-cf-4d-e1-b2  8,2,0     dst-src-ip
20  on                                8,0,0     src-ip
Displayed Information Explanation
ID Port group number
Mode Port group mode (active/passive)
Ports Port numbers of a port group
1 The first number displayed is the selected port number
10 The second is the standby port number
20 The third is an unselected port number

Display detailed information for port-group 1.

active500EM#show port-group 1 detail
Flags:A -- LACP-Activity,   B -- LACP-timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting,   F -- Distributing,
G -- Defaulted, H -- Expired
Port-group number: 1,  Mode: active,   Load-balance: dst-src-mac
Port-group detail information:
System ID: 0x8000,00-03-0f-0c-16-6d
Local:
Port               Status      Priority  Oper-Key Flag
-----------------------------------------------------------
Ethernet1/0/1      Selected    32768     1        {ACDEF}
Ethernet1/0/2      Selected    32768     1        {ACDEF}
Ethernet1/0/3      Selected    32768     1        {ACDEF}
Ethernet1/0/4      Selected    32768     1        {ACDEF}
Ethernet1/0/5      Selected    32768     1        {ACDEF}
Ethernet1/0/6      Selected    32768     1        {ACDEF}
Ethernet1/0/7      Selected    32768     1        {ACDEF}
Ethernet1/0/8      Selected    32768     1        {ACDEF}
Ethernet1/0/20     Unselected  32768     1        {ACG}
Ethernet1/0/23     Standby     32768     1        {AC}
Remote:
Actor             Partner  Priority  Oper-Key  SystemID                   Flag
--------------------------------------------------------------------------------
Ethernet1/0/1     1        32768     1         0x8000,00-03-0f-01-02-04   {CDEF}
Ethernet1/0/2     2        32768     1         0x8000,00-03-0f-01-02-04   {CDEF}
Ethernet1/0/3     3        32768     1         0x8000,00-03-0f-01-02-04   {CDEF}
Ethernet1/0/4     4        32768     1         0x8000,00-03-0f-01-02-04   {CDEF}
Ethernet1/0/5     5        32768     1         0x8000,00-03-0f-01-02-04   {CDEF}
Ethernet1/0/6     6        32768     1         0x8000,00-03-0f-01-02-04   {CDEF}
Ethernet1/0/7     7        32768     1         0x8000,00-03-0f-01-02-04   {CDEF}
Ethernet1/0/8     8        32768     1         0x8000,00-03-0f-01-02-04   {CDEF}
Ethernet1/0/23    23       32768     1         0x8000,00-03-0f-01-02-04   {C}

 


Return to Controller Wired CLI Table of Contents