Purpose:

Creates, modifies, enables, disables or deletes LAG port for LACP

Synopsis:
sth::emulation_lag_config
[-port_handle <ALPHANUM>]
[-lag_handle <ALPHANUM>]
[-mode {create | enable | disable | modify | delete}]
[-protocol {none lacp bfd lacp_bfd}]
[-lacp_port_mac_addr <ANY>]
[-lacp_port_mac_addr_step <ANY>]
[-lacp_actor_key <0-65535>]
[-lacp_actor_key_step <0-65535>]
[-lacp_actor_port_priority <0-65535>]
[-lacp_actor_port_priority_step <0-65535>]
[-lacp_actor_port_number <0-65535>]
[-lacp_actor_port_step <0-65535>]
[-lacp_timeout {long short}]
[-lacp_activity {passive active}]
[-actor_system_priority <0-65535>]
[-actor_system_id <ANY>]
[-lag_name <ANY>]
[-transmit_algorithm {hashing round_robin}]
[-l2_hash_option <ANY>]
[-l3_hash_option <ANY>]
[-aggregatorresult {member | aggregated}]
Arguments:
-port_handle
Specifies the port under which to create the LAG port. This argu
ment
is mandatory for -mode create.
-lag_handle
The LAG port handle returned by the current function
-mode
Specifies the action to perform.This argument is mandatory. The m
odes are described below:
create
Creates the lag port handle. You must specify -port
_handle
modify
Modifies the LAG port handle specified by -lag_handl
e.
enable
Enables the lag port handle. You must specify -lag_
handle
disable
Disables the lag port handle. You must specify -lag_
handle
delete
Deletes the lag_handle and release port_handle .
The default value is create
-protocol
Specifies the type of LAG protocol to be created.
Possible values: none, lacp, bfd, lacp_bfd
The default value is lacp
-lacp_port_mac_addr
Start MAC address of the actor port
The default value is 00:10:94:00:00:02

-lacp_port_mac_addr_step
The step value by which to generate subsequent MAC
The default value is 00:00:00:00:00:01
-lacp_actor_port_key
Operational key value for the actor port
Range: 0-65535
The default value is 1
-lacp_actor_key_step
Step value by which to generate subsequent key values
Range: 0-65535
The default value is 1
-actor_lacp_port_priority
Priority assigned to this actor port
Range: 0-65535
The default value is 1
-lacp_actor_port_priority_step
Step value by which to generate subsequent priority values
Range: 0-65535
The default value is 1
-lacp_actor_port_number
Port number assigned to the actor port
Range: 0-65535
The default value is 1
-lacp_actor_port_step
Step value by which to generate subsequent port numbers
Range: 0-65535
The default value is 1
-actor_lacp_timeout
Time-out value for this link.
Possible values: long (90 seconds) short (90 seconds)
The default value is long
-lacp_activity
Activity control value for this link
Possible values: passive, active
The default value is active
-actor_system_priority
The system priority of the LACP Group.
Range: 0-65535
The default value is 1
-actor_system_id
The System ID of the LACP Group.
The default value is 00:00:00:00:00:01
-lag_name
The LAG port handle name
-transmit_algorithm
Select the algorithm that determines which port in the
aggregation group transmits the packet for cut-through traff

ic.
Possible values are hashing round_robin
hashing:
Determines the transmit port on a packet-per
-packet basis
by creating a hash value from the specified
fields in the outgoing packet. The hash valu
e is
then used to select one of the available por
ts in
the aggregation group. Depending on the cont
ent
of the packet, either L2 or L3 hashing is us
ed,
but never both on any given packet.
round_robin

Determines the transmit port by round robin

cycling
through all of the available ports in the ag
gregation
group, on a packet by packet basis.
The default value is hashing
-l2_hash_option
Available when Traffic Algorithm is set to Hashing.
Select one or more fields to be used when hashing Layer 2 fr
ames.
These settings are used only on frames that do not contain
Layer 3 packets.
possible values are:
ETH_SRC
Hash based on the Ethernet Source Address
ETH_DS
Hash based on the Ethernet Destination Address
VLAN
Hash based on the VLAN Tag Control Infor
mation (TCI)
MPLS

field for all VLAN tags in the frame

Hash based on the 20-bit label in all MP

LS headers
in the frame
The default value is ETH_SRC|ETH_DST|VLAN|MPLS
-l3_hash_option
Available when trasmit_algorithm is set to Hashing.
Specifies one or more options to be used when hashing Layer
3
packets. These settings are used on any frame that contains
a
Layer 3 packet.
possible values are:
ETH_SRC
Hash based on the Ethernet Source Address
ETH_DST
Hash based on the Ethernet Destination Address
VLAN
Hash based on the VLAN Tag Control Infor
mation (TCI)
MPLS
LS headers in the frame
IPV4_SRC
IPV4_DST
IPV6_SRC
IPV6_DST

field for all VLAN tags in the frame

Hash based on the 20-bit label in all MP
Hash
Hash
Hash
Hash

based
based
based
based

on
on
on
on

the
the
the
the

IPv4
IPv4
IPv6
IPv6

Source Address
Destination Address
Source Address
Destination Address

UDP

Hash based on the UDP Source and Destina

TCP

Hash based on the TCP Source and Destina

tion port numbers

tion port numbers
The default value is IPV4_SRC|IPV4_DST|IPV6_SRC|IPV6_DST|UDP
|TCP
-aggregatorresult
Specifies the type of traffic stats will be collected. Possi
ble
values are member and aggregated
member
The traffic stats will be collected by the
membership port handle
aggregated
The traffic stats will be collected by
the lag handle
The default value is aggregated.
Return Values:
lag_handle
status

The LAG port handle returned

Success (1) or failure (0) of the operation

log

An error message (if the operation failed)

Examples:
To create the LAG port:
set cmdReturn1 [sth::emulation_lag_config\
-port_handle "port1 port2" \
-mode create \
-protocol "lacp"\
-lacp_port_mac_addr "00-94-01-00-00-02" \
-lacp_actor_port_key 100 \
-actor_lacp_port_priority 101 \
-lacp_actor_port_number 10 \
-actor_lacp_timeout short \
-lacp_activity active \
-actor_system_priority 1000 \
-actor_system_id "00-00-00-00-01-01" \
-lag_name "LAG1" \
-transmit_algorithm "hashing" \
-l2_hash_option "ETH_SRC|ETH_DST|VLAN|MPLS"\
-l3_hash_option "VLAN|MPLS|IPV4_SRC|IPV4_DST|IPV6_SRC|IPV6_DST|UDP|TCP"\
]
To modify the lag port:
set cmdReturn2 [sth::emulation_lag_config\
-lag_handle $lag1_handle \
-mode modify \
-aggregatorresult member \
]
To disable the LAG port:
set cmdReturn3 [sth::emulation_lag_config\

-lag_handle $lag1_handle \
-mode disable]
To delete the lag port:
set cmdReturn3 [sth::emulation_lag_config\
-lag_handle $lag1_handle \
-mode delete]