| Sun Ethernet Fabric Operating System CLI Base Reference Manual
|
   
|
LA |
LA is a method of combining physical network links into a single logical link for increased bandwidth. LA increases the capacity and availability of the communications channel between devices (both switches and end devices) using existing Gigabit Ethernet technology. LA also provides load balancing where the processing and communication activity is distributed across several links in a trunk, so that no single link is overwhelmed. By taking multiple LAN connections and treating them as a unified, aggregated link, practical benefits in many applications can be achieved. LA provides the following important benefits:
- Higher link availability
- Increased link capacity
- Improvements are obtained using existing hardware (no upgrading to higher-capacity link technology is necessary)
5.1 LA Commands
The list of CLI commands for the configuration of LA is as follows:
5.1.1 set port-channel
Enables or disables link aggregation in the switch.
set port-channel {enable | disable}
|
|
Syntax Description
|
enable - Enables link aggregation in the switch.
disable - Disables link aggregation in the switch.
|
|
Mode
|
Global Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS(config)# set port-channel enable
|
show etherchannel - Displays Etherchannel information
channel-protocol - Enables link aggregation
5.1.2 channel-protocol
Enables link aggregation in the switch. The no form of the command disables link aggregation in the switch. This command operates similar to that of the command set port-channel.
|
Syntax Description
|
lacp - Specifies LACP (Link Aggregation Control Protocol) to manage channeling.
|
|
Mode
|
Global Configuration
|
|
Defaults
|
Disabled
|
|
Example
|
SEFOS(config)# channel-protocol lacp
|
show etherchannel - Displays Etherchannel information
set port-channel - Enables port-channel
5.1.3 lacp system-priority
Sets the LACP priority for the system. The no form of the command sets the LACP priority for the system to the default value. System priority represents a 2-octet value indicating the priority value associated with the system involved in link aggregation.
lacp system-priority 0-65535
|
|
Mode
|
Global Configuration
|
|
Defaults
|
0x8000 or 32768.
|
|
Example
|
SEFOS(config)# lacp system-priority 5
|
|
Notes
|
- The switch with the lowest system priority value decides the standby and active links in the aggregation.
- Although this is a Global Configuration command, the priority only takes effect on Etherchannels that have physical interfaces with LACP enabled.
|
show etherchannel - Displays LACP system-priority value
5.1.4 interface port-channel
Create a port-channel. The no form of the command deletes a port channel.
interface port-channel port-channel-id_1-65535
|
no interface port-channel port-channel-id_1-65535
|
|
Mode
|
Interface Configuration
|
|
Example
|
SEFOS(config)# interface port-channel 5
|
|
Notes
|
The MAC address configured must not be a null MAC address or a multicast MAC address.
|
5.1.5 lacp system-identifier
Sets the global LACP system ID. The no form of the command sets the global LACP system identifier to the default value.
lacp system-identifier aa:aa:aa:aa:aa:aa
|
no lacp system-identifier
|
|
Mode
|
Interface Configuration
|
|
Example
|
SEFOS(config)# lacp system-identifier 00:14:4F:7C:63:0A
|
|
Notes
|
The MAC address configured must not be a null MAC address or a multicast MAC address.
|
5.1.6 port-channel load-balance
Sets the load balancing policy for aggregated ports on each of the previously created port channels. The no form of the command sets the load balancing policy to the default value.
port-channel load-balance {src-mac | dest-mac | src-dest-mac | src-ip | dest-ip | src-dest-ip | vlan-id | src-dest-ip-port-proto} [port-channel-index_1-65535]
|
no port-channel load-balance port-channel-index_1-65535
|
|
Syntax Description
|
src-mac - Load distribution is based on the source MAC address. Packets from different hosts use different ports in the channel, but packets from the same host use the same port.
dest-mac - Load distribution is based on the destination host MAC address. 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 - Load distribution is based on the source and destination MAC address.
src-ip - Load distribution is based on the source IP address.
dest-ip - Load distribution is based on the destination IP address.
src-dest-ip - Load distribution is based on the source and destination IP address.
vlan-id - Load distribution is based on VLAN identifier.
src-dest-ip-port-proto - Load distribution is based on the source IP address, source port, destination IP address, destination port and transport protocol. (The keyword src-dest-ip-port-proto can be used only with the Sun Network 10GbE Switch 72p.)
port-channel-index - Port channel number.
|
|
Mode
|
Global Configuration
|
|
Defaults
|
Source and destination IP address based.
|
|
Example
|
SEFOS(config)# port-channel load-balance dest-mac 200
|
|
Notes
|
- If the port-channel index is not mentioned in this command, the load-balancing must apply for all port-channels configured in the system.
- Initially, the port channel interface must have been configured for this command.
|
show etherchannel - Displays Etherchannel load balance information
5.1.7 lacp port-priority
Sets the LACP port priority. The no form of the command sets the LACP port priority to the default value. Port priority determines whether the link is an active link or a standby link when the number of ports in the aggregation exceeds the maximum number supported by the hardware.
lacp port-priority 0-65535
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
port-priority - 128
|
|
Example
|
SEFOS(config-if)# lacp port-priority 1
|
|
Notes
|
- This command takes effect only on Etherchannel interfaces that are already configured for LACP.
- If the number of links in an aggregation exceeds the maximum supported by the hardware, then the links with lower priority become active links.
|
5.1.8 lacp port-identifier
Sets the LACP actor admin port to be filled in the LACP PDUs.
lacp port-identifier 1-65535
|
|
Mode
|
Interface Configuration
|
|
Example
|
SEFOS(config-if)# lacp port-identifier 2
|
5.1.9 channel-group
Configures an Etherchannel. The no form of the command removes an interface from the Etherchannel.
channel-group 1-65535 mode {on | active | passive}
|
|
Syntax Description
|
mode - Represents any one of the following:
- active - LACP negotiation is started unconditionally.
- passive - LACP negotiation is started only when an LACP packet is received from a peer.
- on - Force the interface to channel without LACP. This is equivalent to manual aggregation.
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS(config-if)# channel-group 1 mode active
|
|
Notes
|
If the port-channel is not present, the port-channel must be created.
|
show etherchannel - Displays Etherchannel detailed and port information
5.1.10 lacp wait-time
Sets the LACP wait-time. The no form of the command sets the LACP wait-time to the default value.
|
Mode
|
Interface Configuration
|
|
Defaults
|
2
|
|
Example
|
SEFOS(config-if)# lacp wait-time 1
|
|
Notes
|
Configuring the wait-time value as 0 ensures that links get aggregated immediately.
|
show etherchannel - Displays Etherchannel detailed and port information
5.1.11 lacp timeout
Sets the LACP timeout period and the no form of the command sets the LACP timeout period to the default value.
lacp timeout {long | short}
|
|
Syntax Description
|
long - Long timeout value.
short - Short timeout value.
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
long
|
|
Example
|
SEFOS(config-if)# lacp timeout short
|
|
Notes
|
- The long timeout value means that LACP PDU will be sent every 30 seconds and LACP timeout value (no packet is received from peer) is 90 seconds.
- The short timeout value sends LACP PDU every 1 second and the timeout value is 3 seconds.
|
show etherchannel - Displays Etherchannel detailed and port information
5.1.12 lacp rate
Sets the LACP timeout period. The no form of the command sets the LACP timeout period to the default value This command operates similar to that of the command lacp timeout.
lacp rate {normal | fast }
|
|
Syntax Description
|
normal - LACP control packets are ingressed at the normal rate. That is, LACP PDU will be sent every 30 seconds and the timeout value will be set as 90 seconds.
fast - LACP control packets are ingressed at the fast rate. That is, LACP PDU will be sent every 1 second and the timeout value will be set as 3 seconds.
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS(config-if)# lacp rate fast
|
|
Notes
|
- The normal timeout value means that LACP PDU will be sent every 30 seconds and LACP timeout value (no packet is received from peer) is 90 seconds.
- The fast timeout value means that LACP PDU will be sent every 1 second and timeout value is 3 seconds.
|
show etherchannel - Displays Etherchannel detailed and port information
5.1.13 default port
Configures the default physical interface for the port channel and the no form of the command removes default port for a port channel.
default port interface-type interface-id
|
|
Syntax Description
|
interface-type - Interface type.
interface-id - Interface identifier.
|
|
Mode
|
Port Channel Interface Configuration
|
|
Defaults
|
Disabled.
|
|
Example
|
SEFOS(config-if)# default port extreme-ethernet 0/1
|
lacp - Sets the LACP Actor Admin key and/or LACP mode for the port
show etherchannel - Displays Etherchannel information
5.1.14 lacp
Sets the LACP actor admin key and LACP mode for the port.
lacp [admin-key 1-65535] [mode {active | passive}]
|
|
Syntax Description
|
admin-key - LACP actor admin key.
mode - LACP mode.
|
|
Mode
|
Port Channel Interface Configuration
|
|
Defaults
|
mode - active
|
|
Example
|
SEFOS(config-if)# lacp admin-key 1 mode active
|
|
Notes
|
This command can be configured only after configuring the default port.
|
default port - Configures the default physical interface for the port channel.
5.1.15 port-channel max-ports
Configures the maximum number of ports for a port channel.
port-channel max-ports 2-16
|
|
Mode
|
Interface Configuration
|
|
Defaults
|
8
|
|
Example
|
SEFOS(config-if)# port-channel max-ports 5
|
5.1.16 shutdown port-channel
Shuts down link aggregation in the switch. The no form of the command starts and enables link aggregation in the switch.
|
Mode
|
Global Configuration
|
|
Example
|
SEFOS(config)# shutdown port-channel
|
|
Notes
|
When shutdown, all resources used by the link aggregation module are released to the system.
|
5.1.17 debug lacp
Enables trace messages for link aggregation. The no form of the command disables trace messages for link aggregation.
debug lacp [{init-shutdown | mgmt | data | events | packet | os | failall | buffer | all}]
|
no debug lacp [{ init-shutdown | mgmt | data | events | packet | os | failall | buffer | all}]
|
|
Syntax Description
|
init-shutdown - Initialization and shutdown traces.
mgmt - Management traces.
data - Data path traces.
events - Event traces.
packet - Packet dump traces.
os - Traces related to all resources except buffers.
failall - All failure traces.
buffer - Buffer traces.
all - All traces.
|
|
Mode
|
Privileged EXEC
|
|
Defaults
|
init-shutdown
|
|
Example
|
SEFOS# debug lacp data
|
5.1.18 debug etherchannel
Enables trace messages for link aggregation. The no form of the command disables trace messages for link aggregation.
This command operates similar to that of the command debug lacp.
debug etherchannel {[all] [detail] [error] [event] [idb]}
|
no debug etherchannel {[all] [detail] [error] [event] [idb]}
|
|
Syntax Description
|
all - All traces.
detail - Detailed debug traces.
error - All failure traces.
event - Event traces.
idb - Interface descriptor block messages.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# debug etherchannel detail
|
5.1.19 show etherchannel
Displays Etherchannel information.
show etherchannel [[channel-group-number] {detail | load-balance | port | port-channel | summary | protocol}]
|
|
Syntax Description
|
channel-group-number - Number of the channel group. Valid numbers range from maximum number of ports in the system to maximum number of aggregations supported.
detail - Detailed Etherchannel information.
load-balance - Load-balance or frame-distribution scheme among ports in the port channel.
port - Etherchannel port information.
port-channel - Port channel information.
summary - Protocol that is being used in the Etherchannel.
protocol - One-line summary per channel-group.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show etherchannel
Port-channel Module Admin Status is enabled
Port-channel Module Oper Status is enabled
Port-channel System Identifier is 00:01:02:03:04:01
Channel Group Listing
---------------------
Group : 1
----------
Protocol : LACP
SEFOS# show etherchannel 1 detail
Port-channel Module Admin Status is enabled
Port-channel Module Oper Status is enabled
Port-channel System Identifier is 00:01:02:03:04:01
LACP System Priority: 32768
Channel Group Listing
---------------------
|
|
|
Group: 1
----------
Protocol :LACP
Ports in the Group
------------------
Port : Ex0/1
-------------
|
|
|
Port State = Up in Bundle
Channel Group : 1
Mode : Active
Pseudo port-channel = Po1
LACP port-priority = 128
LACP Wait-time = 2 secs
LACP Activity : Active
LACP Timeout : Long
|
|
|
Aggregation State : Aggregation, Sync, Collecting, Distributing, Defaulted
LACP Port Admin Oper Port Port
Port State Priority Key Key Number State
------------------------------------------------
Ex0/1 Bundle 128 1 1 0x1 0xbe
Port-channel : Po1
------------------
Number of Ports = 1
HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
Aggregator-MAC 00:01:02:03:04:19
Default Port = None
|
|
|
SEFOS# show etherchannel 1 port
Channel Group Listing
---------------------
Group: 1
----------
Protocol :LACP
Ports in the Group
------------------
Port : Ex0/1
-------------
|
|
|
Port State = Up in Bundle
Channel Group : 1
Mode : Active
port-channel = Po1
Pseudo port-channel = Po1
LACP port-priority = 128
LACP Wait-time = 2 secs
LACP Port Identifier = 2
LACP Activity : Active
LACP Timeout : Long
|
|
|
Aggregation State : Aggregation, Sync, Collecting, Distributing,
Port : Ex0/2
-------------
Port State = Up in Bundle
Channel Group : 1
Mode : Active
port-channel = Po1
Pseudo port-channel = Po1
LACP port-priority = 128
LACP Wait-time = 2 secs
LACP Activity : Active
LACP Timeout : Long
|
|
|
Aggregation State : Aggregation, Sync, Collecting, Distributing,
LACP Port Admin Oper Port Port
Port State Priority Key Key Number State
------------------------------------------------
Ex0/1 Bundle 128 1 1 0x1 0xbc
Ex0/2 Bundle 128 1 1 0x2 0xbc
SEFOS# show etherchannel 1 port-channel
Port-channel Module Admin Status is enabled
Port-channel Module Oper Status is enabled
Port-channel System Identifier is 00:01:02:03:04:01
Channel Group Listing
---------------------
|
|
|
Group : 1
----------
Port-channels in the group:
---------------------------
Port-channel : Po1
-------------------
|
|
|
Number of Ports = 1
HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
Aggregator-MAC 00:01:02:03:04:19
Default Port = None
SEFOS# show etherchannel 1 summary
Flags:
D - down P - in port-channel
I - stand-alone S - suspended
H - Hot-standby (LACP only)
Port-channel is enabled
Port-channel System Identifier is 00:14:4F:7C:63:0A
|
|
|
Number of channel-groups in use: 1
Number of aggregators: 1
Group Port-channel Protocol Ports
----------------------------------------------------------
1 Po1(P) LACP Ex0/1(P),Ex0/2(P)
SEFOS# show etherchannel 1 protocol
Channel Group Listing
---------------------
Group : 1
----------
Protocol : LACP
SEFOS# show etherchannel load-balance
|
|
|
Channel Group Listing
---------------------
Group : 1
----------
Source & Destination MAC Address
|
|
Notes
|
If the channel group number is not specified details on all channels are displayed.
|
5.1.20 show etherchannel - redundancy
Displays Etherchannel information.
show etherchannel [[channel-group-number] {detail | load-balance | port | port-channel | summary | protocol | redundancy}]
|
|
Syntax Description
|
channel-group-number - Number of the channel group. Valid numbers range from maximum number of ports in the system to maximum number of aggregations supported.
detail - Detailed Etherchannel information.
load-balance - Load-balance or frame-distribution scheme among ports in the port channel.
port - Etherchannel port information.
port-channel - Port channel information.
summary - Protocol that is being used in the Etherchannel.
protocol - One-line summary per channel-group.
redundancy - Synced messages. The keyword redundancy is not supported.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show etherchannel redundancy
Actor Information for Port : Ex0/1
----------------------------------
Channel Group : 1
Pseudo port-channel = Po1
CurrentWhile Split Interval Tmr Count = 1
Synced Partner Information for Port : Ex0/1
-----------------------------------
|
|
|
Partner System ID : 00:11:22:33:44:55
Flags : A
LACP Partner Port Priority : 128
LACP Partner Oper Key : 1
Port State Flags Decode
------------------------
Activity : Active
LACP Timeout : Long
Aggregation State : Aggregation, Sync, Collecting, Distributing,
|
|
|
Actor Information for Port : Ex0/2
-------------
Channel Group : 1
Pseudo port-channel = Po1
CurrentWhile Split Interval Tmr Count = 1
Synced Partner Information for Port : Ex0/2
-------------
Partner System ID : 00:11:22:33:44:55
Flags : A
LACP Partner Port Priority : 128
LACP Partner Oper Key : 1
|
|
|
Port State Flags Decode
------------------------
Activity : Active
LACP Timeout : Long
Aggregation State : Aggregation, Sync, Collecting, Distributing,
----------------------------------------------------------------
|
|
Notes
|
If the channel group number is not specified, details on all channels are displayed.
|
5.1.21 show interfaces
Displays interface specific port-channel information.
show interfaces interface-type interface-id etherchannel
|
|
Syntax Description
|
ehterchannel - Interface Etherchannel information.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show interfaces extreme-ethernet 0/1 etherchannel
Port : Ex0/1
-------------
Port State = Up in Bundle
Channel Group : 2
Mode : Active
Pseudo port-channel = Po2
LACP port-priority = 128
LACP Port Identifier = 2
LACP Wait-time = 2 secs
LACP Activity : Passive
LACP Timeout : Long
Aggregation State : Aggregation, Sync, Collecting, Distributing,
LACP Port Admin Oper Port Port
Port State Priority Key Key Number State
-------------------------------------------------------------
Ex0/1 Bundle 128 2 2 0x1 0x3c
|
|
|
SEFOS# show interfaces etherchannel
Port : Ex0/1
-------------
Port State = Up in Bundle
Channel Group : 2
Mode : Active
Pseudo port-channel = Po2
LACP port-priority = 128
LACP Wait-time = 2 secs
LACP Activity : Passive
LACP Timeout : Long
Aggregation State : Aggregation, Sync, Collecting, Distributing,
Port : Ex0/2
-------------
Port State = Up in Bundle
Channel Group : 2
|
|
|
Mode : Active
Pseudo port-channel = Po2
LACP port-priority = 128
LACP Wait-time = 2 secs
LACP Activity : Passive
LACP Timeout : Long
Aggregation State : Aggregation, Sync, Collecting, Distributing,
LACP Port Admin Oper Port Port
Port State Priority Key Key Number State
-------------------------------------------------------------
Ex0/1 Bundle 128 2 2 0x1 0x3c
Ex0/2 Bundle 128 2 2 0x2 0x3c
|
|
|
Port-channel : Po2
-------------------
Number of Ports = 2
HotStandBy port = null
Port state = Port-channel Ag-Inuse
Protocol = LACP
Aggregator-MAC 00:01:02:03:04:23
Default Port = None
|
|
Notes
|
- Expressions are case sensitive.
- The port channel range is 1 to 64.
|
5.1.22 show lacp
Displays port-channel traffic and neighbor information.
show lacp [port-channel_1-65535] {counters | neighbor [detail]}
|
|
Syntax Description
|
port-channel - Number of the channel group.
counters - disable - Traffic information.
neighbor - Neighbor information.
detail - Neighbor detail information.
|
|
Mode
|
Privileged EXEC
|
|
Example
|
SEFOS# show lacp 1 counters
LACPDUs Marker Marker Response LACPDUs
Port Sent Recv Sent Recv Sent Recv Pkts Err
------------------------------------------
Channel group: 1
------------------
Ex0/1 394 352 0 0 0 0 0 0
Ex0/2 318 297 0 0 0 0 0 0
SEFOS# show lacp neighbor detail
Flags:
|
|
|
A - Device is in Active mode
P - Device is in Passive mode
Channel group 1 neighbors
Port Ex0/1
----------
Partner System ID : 00:01:02:03:04:21
Flags : P
LACP Partner Port Priority : 128
LACP Partner Oper Key : 2
LACP Partner Port State : 0x3c
Port State Flags Decode
------------------------
|
|
|
Activity : Passive
LACP Timeout : Long
Aggregation State : Aggregation, Sync, Collecting, Distributing
Port Ex0/2
|
|
|
----------
Partner System ID : 00:01:02:03:04:21
Flags : P
LACP Partner Port Priority : 128
LACP Partner Oper Key : 2
LACP Partner Port State : 0x3c
Port State Flags Decode
------------------------
Activity : Passive
LACP Timeout : Long
Aggregation State : Aggregation, Sync, Collecting, Distributing
|
|
Notes
|
Expressions are case sensitive.
|
| Sun Ethernet Fabric Operating System CLI Base Reference Manual
|
E26513-03
|
|
Copyright © 2013, Oracle and/or its affiliates. All rights reserved.