LACP

Configure LACP (Link Aggregation Control Protocol) settings on IOS-XR devices. LACP is used to dynamically manage link aggregation groups (LAGs) and provides a standardized method for bundling multiple physical links into a single logical link.

Diagram

Classes

iosxr

Name	Type	Constraint	Mandatory	Default Value
devices	List	devices	No
device_groups	List	device_groups	No
global	Class	global	No

devices (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

device_groups (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

global (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

configuration (iosxr.devices)

Name	Type	Constraint	Mandatory	Default Value
lacp	Class	lacp	No

lacp (iosxr.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
system_mac	String		No
system_priority	Integer	min: 1, max: 65535	No

Guidelines and Limitations

Data Normalization

MAC Address Formats

Fields that accept MAC addresses can be in any of three formats:

1. colon-separated (e.g., "01:01:01:01:01:01")
2. dash-separated (e.g., "01-01-01-01-01-01")
3. dotted (e.g., "0101.0101.0101")

All 3 formats can be used interchangeably. The normalization layer coverts the user-specified format to colon-separated before sending to the device.

Example YAML Code:

Example-1: Configure basic LACP system settings with custom MAC address and priority.

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: router-1
        lacp:
          system_mac: 00:11:00:11:00:11
          system_priority: 1

Example-2: Configure LACP with different priority settings for different devices.

iosxr:
  devices:
    - name: core-router-1
      host: 10.10.10.1:57400
      configuration:
        hostname: core-router-1
        lacp:
          system_mac: 00:11:00:11:00:11
          system_priority: 100
    - name: edge-router-1
      host: 10.10.10.2:57400
      configuration:
        hostname: edge-router-1
        lacp:
          system_mac: 00-22-00-22-00-22
          system_priority: 200