Link Aggregation Group (LAG) Configuration Module

This configuration module configures a link aggregation group (LAG) between a pair of devices. It does not support MC-LAG.

LAG is currently supported on these platforms:

Operating system	LACP	Static	Passive LACP
Arista EOS ❗	✅	✅	✅
Cumulus Linux	✅	✅	❌
FRR	✅	✅	❌

Parameters

The following parameters can be set globally, per node or per LAG link:

• lag.mode: lag mode, one of 802.3ad (IEEE LAG standard with LACP, default value), balance-xor (Linux non-LACP bonding mode) or active-backup

• lag.lacp: LACP protocol interval: fast (1-second LACP timer, default value), slow (30-second LACP timer) or off (LACP is disabled).

Tip

The link down condition is not easily detectable in a virtual environment. You should always use LACP.

• lag.lacp_mode: active (default) or passive (only one of the nodes can be passive)

The following parameters can be set on individual links:

• lag.members: Mandatory list of links that form the LAG. It uses the same format as the topology links list.

• lag.ifindex: Optional parameter that controls the naming of the LAG (bonding, port-channel) interface.

This configuration module creates a virtual link with the link type set to lag between the lag.members and appends the links described in the lag.members list to the topology links list.

Example

The following example creates a LAG consisting of 2 links between r1 and r2:

module: [ lag ]

nodes: [ r1, r2 ]

links:
- lag.members: [ r1-r2, r1-r2 ]

You can specify any link parameter on the lag link.

If you require additional physical interface attributes on individual member links (or interfaces), use the dictionary link format in the lag.members list. The following example sets ifindex on every Ethernet interface that is part of the LAG to change the Ethernet interface name.

links:
- lag.members:
  - r1:
     ifindex: 49  # Use 100G links 1/1/49 and 1/1/50
    r2:
     ifindex: 49
  - r1:
     ifindex: 50
    r2:
     ifindex: 50