LAG commands

lag

Syntax

[no] lag [lag-id]

Context

config

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command configures Link Aggregation Group (LAG) attributes.

A LAG can be used to group two or more ports into one logical link. The number of ports supported in a LAG depends on the platform. The aggregation of multiple physical links allows for load sharing and provides seamless redundancy. If one of the links fails, traffic is redistributed over the remaining links.

The no form of this command deletes the LAG from the configuration. Deleting a LAG is only allowed while the LAG is administratively shut down. Any dependencies, such as IP interface configurations, must be removed from the configuration before the no lag command can be issued.

Parameters

lag-id

Specifies the LAG identifier, expressed as a decimal integer.

Values

1 to 25 (7210 SAS-T, 7210 SAS-Mxp)

1 to 125 (7210 SAS-R6 and 7210 SAS-R12)

1 to 125 (7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE)

bfd

Syntax

bfd

Context

config>lag

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command enables the context to configure BFD over the associated LAG links.

disable-soft-reset-extension

Syntax

[no] disable-soft-reset-extension

Context

config>lag>bfd

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command enables BFD over LAG links; additional parameter configuration is required to make the links operational.

BFD session timers are automatically extended during a soft-reset operation on IOMs and IMMs to prevent BFD sessions from timing out and causing protocol events. However, in some cases this behavior is not wanted because it can delay fast reroute transitions, if they are in place. The optional disable-soft-reset-extension command disables the behavior so that the BFD timers are not automatically extended.

The no form of this command disables the automatic extension of BFD timers during an IOM/IMM soft-reset.

Default

no disable-soft-reset-extension

family

Syntax

family {ipv4}

Context

config>lag>bfd

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command configures the address family for the micro-BFD session over the associated LAG links.

Default

family ipv4

Parameters

ipv4

Keyword to configure IPv4 encapsulation for the micro-BFD session.

bfd-on-distributing-only

Syntax

[no] bfd-on-distributing-only

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command enables restricting micro-BFD sessions to links in Link Aggregation Control Protocol (LACP) state distributing.

The no form of this command disables restricting micro-BFD sessions.

Default

no bfd-on-distributing-only

local-ip-address

Syntax

local-ip-address ip-address

no local-ip-address

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command specifies the IPv4 address of the BFD source.

The no form of this command removes this address from the configuration.

Default

no local-ip-address

Parameters

ip-address

Specifies the IP address.

Values

ipv4-address:

a.b.c.d

max-admin-down-time

Syntax

max-admin-down-time [down-interval]

max-admin-down-time infinite

no max-admin-down-time

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command specifies the maximum interval of time the router will continue to forward traffic over a link after the micro-BFD sessions have transitioned to a down state because the router received an ADMIN-DOWN state from the far end. The timer provides the administrator the configured amount of time to disable or deprovision the micro-BFD session on the local node before forwarding is halted over the associated links.

The no form of this command removes the time interval from the configuration.

Default

max-admin-down-time 0

Parameters

down-interval

Specifies the amount of time, in seconds.

Values

1 to 3600

infinite

Keyword to specify that there is no end time to forward traffic.

max-setup-time

Syntax

max-setup-time [up-interval]

max-setup-time infinite

no max-setup-time

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command specifies the maximum interval of time the router will forward traffic over a link that has transitioned from standby to active state before the micro-BFD session must be fully established (up state).

The no form of this command reverts the up-interval parameter to the default, which indicates that forwarding will not start until the BFD session is established.

Default

max-setup-time infinite

Parameters

up-interval

Specifies the amount of time, in milliseconds.

Values

1 to 60000

Default

0

infinite

Keyword to specify that there is no end time to forward traffic over the link; the router will continue to forward traffic over the link infinitely after the micro-BFD session transitions to the down state.

multiplier

Syntax

multiplier [multiplier]

no multiplier

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command specifies the detect multiplier used for a micro-BFD session over the associated LAG links. The session is declared administratively down if a BFD control packet is not received for a period determined by the following equation:

multiplier × receive-interval

The no form of this command removes the multiplier from the configuration.

Default

multiplier 3

Parameters

multiplier

Specifies the multiplier value.

Values

3 to 20

receive-interval

Syntax

receive-interval interval

no receive-interval

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command specifies the receive timer used for micro-BFD sessions over the associated LAG links.

The no form of this command removes the receive timer from the configuration.

Default

receive-interval 100

Parameters

interval

Specifies the interval value, in milliseconds.

Values

10 to 100000

Default

100 for CPM3 or later, 1000 for all others

remote-ip-address

Syntax

remote-ip-address ip-address

no remote-ip-address

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command configures the IPv4 address of the BFD destination.

The no form of this command removes this address from the configuration.

Default

no remote-ip-address

Parameters

ip-address

Specifies the IP address.

Values

ipv4-address:

a.b.c.d

shutdown

Syntax

shutdown

no shutdown

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command disables micro-BFD sessions for this address family.

The no form of this command re-enables micro-BFD sessions for this address family.

Default

shutdown

transmit-interval

Syntax

transmit-interval transmit-interval

no transmit-interval

Context

config>lag>bfd>family

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone), 7210 SAS-Sx 10/100GE (standalone), and 7210 SAS-T

Description

This command specifies the transmit timer used for a micro-BFD session over the associated LAG links.

The no form of this command removes the transmit timer from the configuration.

Default

transmit-interval 100

Parameters

transmit-interval

Specifies the transmit interval value, in milliseconds.

Values

10 to 100000

Default

100 for CPM3 or later, 1000 for all others

dynamic-cost

Syntax

[no] dynamic-cost

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document.

Description

This command enables OSPF costing of a Link Aggregation Group (LAG) based on the available aggregated, operational bandwidth.

The path cost is dynamically calculated based on the interface bandwidth. OSPF path cost can be changed through the interface metric or the reference bandwidth.

If dynamic cost is configured, then costing is applied based on the total number of links configured and the cost advertised is inversely proportional to the number of links available at the time. This is provided that the number of links that are up exceeds the configured LAG threshold value at which time the configured threshold action determines if, and at what cost, this LAG will be advertised.

For example:

Assume a physical link in OSPF has a cost associated with it of 100, and the LAG consists of four physical links. The cost associated with the logical link is 25. If one link fails then the cost would automatically be adjusted to 33.

If dynamic cost is not configured and OSPF autocost is configured, then costing is applied based on the total number of links configured. This cost will remain static provided the number of links that are up exceeds the configured LAG threshold value at which time the configured threshold action determines if and at what cost this LAG will be advertised.

If dynamic-cost is configured and OSPF autocost is not configured, the cost is determined by the cost configured on the OSPF metric provided the number of links available exceeds the configured LAG threshold value at which time the configured threshold action determines if this LAG will be advertised.

If neither dynamic-cost nor OSPF autocost are configured, the cost advertised is determined by the cost configured on the OSPF metric. This is provided that the number of links available exceeds the configured LAG threshold value, at which time the configured threshold action determines if this LAG will be advertised.

The no form of this command removes dynamic costing from the LAG.

Default

no dynamic-cost

encap-type

Syntax

encap-type {dot1q | null | qinq}

no encap-type

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the encapsulation method used to distinguish customer traffic on a LAG. The encapsulation type is configurable on a LAG port. The LAG port and the port member encapsulation types must match when adding a port member.

If the encapsulation type of the LAG port is changed, the encapsulation type on all the port members will also change. The encapsulation type can be changed on the LAG port only if there is no interface associated with it. If the MTU is set to a non default value, it will be reset to the default value when the encap type is changed.All traffic on the port belongs to a single service or VLAN.

The no form of this command reverts to the default.

Default

null

Parameters

dot1q

Specifies that ingress frames carry 802.1Q tags where each tag signifies a different service.

null

Specifies that ingress frames will not use any tags to delineate a service. As a result, only one service can be configured on a port with a null encapsulation type.

qinq

Specifies QinQ encapsulation for QinQ access SAPs.

hold-time

Syntax

hold-time down hold-down-time

no hold-time

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the timer, in tenths of seconds, which controls the delay between detecting that a LAG is down (all active ports are down) and reporting it to the higher levels.

A non-zero value can be configured, for example, when active/standby signaling is used in a 1:1 fashion to avoid informing higher levels during the small time interval between detecting that the LAG is down and the time needed to activate the standby link.

Default

0

Parameters

down hold-down-time

Specifies the hold-time for event reporting.

Values

0 to 2000

lacp

Syntax

lacp [mode] [administrative-key admin-key][system-id system-id] [system-priority priority]

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the Link Aggregation Control Protocol (LACP) mode for aggregated Ethernet interfaces only. Per the IEEE 802.3ax standard (formerly 802.3ad), the LACP provides a standardized means for exchanging information between Partner Systems on a link. This allow their Link Aggregation Control instances to reach agreement on the identity of the Link Aggregation Group to which the link belongs, move the link to that Link Aggregation Group, and enable its transmission and reception functions in an orderly manner.

Default

no lacp

Parameters

mode

Specifies the mode in which LACP will operate.

Values

passive — Starts transmitting LACP packets only after receiving packets.

active — Initiates the transmission of LACP packets.

administrative-key admin-key

Specifies an administrative key value to identify the channel group on each port configured to use LACP. This value should be configured only in exceptional cases. If it is not specified, a random key is assigned.

Values

1 to 65535

system-id

Specifies a 6 byte value expressed in the same notation as MAC address.

Values

xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx

priority

Specifies the system priority to be used for the LAG in the context of the MC-LAG.

Values

0 to 65535

lacp-xmit-interval

Syntax

[no] lacp-xmit-interval {slow | fast}

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies the interval signaled to the peer and tells the peer at which rate it should transmit.

Default

fast

Parameters

slow

Specifies that packets are transmitted every 30 seconds.

fast

Specifies that packets are transmitted every second.

lacp-xmit-stdby

Syntax

[no] lacp-xmit-stdby

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command enables LACP message transmission on standby links.

The no form of this command disables LACP message transmission. This command should be disabled for compatibility when using active/standby groups. This forces a timeout of the standby links by the peer. Use the no form if the peer does not implement the correct behavior regarding the lacp sync bit.

Default

lacp-xmit-stdby

lag

Syntax

lag

Context

config>system

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone and standalone-VC), and 7210 SAS-Sx 10/100GE (standalone)

Description

Commands in this context configure the system-wide LAG hashing algorithm version.

lb-hash-1-version

Syntax

lb-hash-1-version version

no lb-hash-1-version

Context

config>system>lag

Platforms

7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone and standalone-VC), and 7210 SAS-Sx 10/100GE (standalone)

Description

This command configures the LAG load-balancing hash-1 algorithm version.

The no form of this command reverts to the default value.

Default

lb-hash-1-version v1

Parameters

version

Specifies the version of the hash-1 algorithm. The v1 and v2 options are supported only when configure>lag>load-balancing is set to hash-1. If load-balancing is set to hash-2, the system ignores the v1 or v2 configuration.

Values

v1 — Configures version 1 of the hash-1 algorithm. This version maintains backwards compatibility with earlier releases of the 7210 SAS.

v2 — Configures version 2 of the hash-1 algorithm. This version enables the use of IP address fields and L4 ports with the hash-1 algorithm, which provides better load-balancing of IP traffic in specific scenarios.

load-balancing

Syntax

load-balancing hash parameters

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command provides an option per LAG to select the load-balancing hash function to use. For more details about the packet header fields used when the hash function is set to one of these values, see LAG and ECMP hashing.

Note:

For non-unicast traffic, the hashing parameters are used as an input to the hash-2 algorithm regardless of the setting for this value on platforms that support use of packet fields and perform hash computation in hardware.

Default

default

Parameters

hash parameters

Specifies the load-balancing hashing options.

Values

hash-1 — Specifies that the load-balancing function uses hash-1.

hash-2 — Specifies that the load-balancing function uses hash-2.

default —Specifies that, for unicast traffic with LAG mode set to access or hybrid, the default value is hash-1; for all other traffic, the default is hash-2.

port

Syntax

port port-id [port-id...] [priority priority] [subgroup sub-group-id]

no port port-id [port-id...]

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command adds ports to a Link Aggregation Group (LAG).

Multiple ports can be added in one command as long as the limit is not exceeded. On the 7210 SAS-Mxp and 7210 SAS-T, up to four ports can be added to a LAG. On the 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE (standalone and standalone-VC) and 7210 SAS-Sx 10/100GE, up to eight ports can be added.

The port configuration of the first port added to the LAG is used as a basis to compare with subsequently added ports. If a discrepancy is found with a newly added port, that port will not added to the LAG.

All ports added to a LAG must share the same characteristics (speed, duplex mode, and so on). An error message is displayed when adding ports that do not share the same characteristics.

Note:

All ports in a LAG group must have autonegotiation disabled or set to limited mode to guarantee a specific port speed. Autonegotiation is configured using the autonegotiate command under the config>port>ethernet context.

The no form of this command removes ports from the LAG.

Parameters

port-id

Specifies the physical port ID in the slot/mda/port format.

priority priority

Specifies the port priority used by LACP. The port priority is also used to determine the primary port. The port with the lowest priority is the primary port. In the event of a tie, the lowest port ID becomes the primary port.

Values

1 to 65535

subgroup sub-group-id

Specifies the LAG subgroup identifier. When using subgroups in a LAG, they should only be configured on one side of the LAG, not both. Only having one side perform the active/standby selection will guarantee a consistent selection and fast convergence. The active/standby selection will be signaled through LACP to the other side. The hold time should be configured when using subgroups to prevent the LAG going down when switching between active and standby links in case no links are usable for a short time, especially if a subgroup consists of one member.

Values

1 to 2

port-threshold

Syntax

port-threshold value [action {dynamic-cost | down}]

no port-threshold

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command configures the behavior for the Link Aggregation Group (LAG) if the number of operational links is equal to or below a threshold level.

The no form of this command reverts to the default values.

Default

‟0” action down

Parameters

value

Specifies the decimal integer threshold number of operational links for the LAG at or below which the configured action will be invoked. If the number of operational links exceeds the port-threshold value, any action taken for being below the threshold value will cease.

Values

0 to 3

action [{dynamic-cost | down}]

Specifies the action to take if the number of active links in the LAG is at or below the threshold value.

When the dynamic-cost action is specified, then dynamic costing will be activated. As a result the LAG will remain operationally up with a cost relative to the number of operational links. The link will only be regarded as operationally down when all links in the LAG are down.

When the down action is specified, then the LAG will be brought operationally down if the number of operational links is equal to or less than the configured threshold value. The LAG will only be regarded as up once the number of operational links exceeds the configured threshold value.

Note:

  • The down parameter is supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode.

  • The dynamic-cost parameter is only supported on 7210 SAS platforms operating in network mode.

selection-criteria

Syntax

selection-criteria [{highest-count | highest-weight | best-port}] [slave-to-partner]

no selection-criteria

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies which selection criteria should be used to select the active sub-group.

Default

highest-count

Parameters

highest-count

Specifies sub-group with the highest number of eligible members.

highest-weight

Specifies sub-group with the highest aggregate weight.

best-port

Specifies the selection criteria used with power-off mode of operation. The sub-group containing the port with highest priority port. In case of equal port priorities the sub-group containing the port with the lowest port-id is taken

slave-to-partner

Specifies that, together with the selection criteria, the slave-to-partner keyword should be used to select the active sub-group. An eligible member is a lag-member link which can potentially become active. This means it is operationally up (not disabled) for use by the remote side. The slave-to-partner parameter can be used to control whether this latter condition is taken into account.

standby-signaling

Syntax

standby-signaling {lacp | power-off}

no standby-signaling

Context

config>lag

Platforms

Supported on all 7210 SAS platforms as described in this document, including platforms configured in the access-uplink operating mode

Description

This command specifies how the state of a member port is signaled to the remote side when the status corresponding to this member port has the standby value.

Default

lacp

Parameters

lacp

Specifies that LACP protocol is used to signal standby links of the LAG.

power-off

Specifies that the lasers of the standby links in the LAG are shutoff to indicate standby status. It allows user to use LAG standby link feature without LACP, if the peer node does not support LACP. This parameter is not supported on 7210 SAS platforms configured in the access-uplink operating mode.