arubanetworks.aoscx.aoscx_lag_interface (4.3.2) — module

Module for configuring LAG Interfaces in AOS-CX switches.

| "added in version" 4.1.0 of arubanetworks.aoscx"

Authors: Aruba Networks (@ArubaNetworks)

preview | supported by certified

Install collection

Install with ansible-galaxy collection install arubanetworks.aoscx:==4.3.2


Add to requirements.yml

  collections:
    - name: arubanetworks.aoscx
      version: 4.3.2

Description

This module provides the functionality for configuring LAG Interfaces on AOS-CX devices.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create LAG Interface 1.
  aoscx_lag_interface:
    name: lag1
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Set LAG 1 as dynamic.
  aoscx_lag_interface:
    name: lag1
    lacp_mode: active
    lacp_rate: fast
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Set 6 interfaces to LAG Interface 1.
  aoscx_lag_interface:
    state: update
    name: lag1
    interfaces:
      - 1/1/1
      - 1/1/2
      - 1/1/3
      - 1/1/4
      - 1/1/5
      - 1/1/6
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Set 3 interfaces to LAG Interface 1.
  aoscx_lag_interface:
    state: override
    name: lag1
    interfaces:
      - 1/1/1
      - 1/1/2
      - 1/1/3
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create MCLAG Interface 64 with  3 interfaces.
  aoscx_lag_interface:
    state: create
    name: lag64
    interfaces:
      - 1/1/1
      - 1/1/2
      - 1/1/3
    multi_chassis: true
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create Static MCLAG Interface 32 with  3 interfaces.
  aoscx_lag_interface:
    state: create
    name: lag32
    interfaces:
      - 1/1/1
      - 1/1/2
      - 1/1/3
    multi_chassis: true
    static_multi_chassis: true
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Remove all interfaces from LAG Interface 1.
  aoscx_lag_interface:
    state: override
    name: lag1
    interfaces: []
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create MCLAG with LACP fallback mode set.
  aoscx_lag_interface:
    state: create
    name: lag256
    multi_chassis: true
    lacp_fallback: true
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update static MCLAG, unset LACP fallback mode.
  aoscx_lag_interface:
    state: create
    name: lag256
    multi_chassis: true
    lacp_fallback: false
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Create static MCLAG with LACP fallback mode.
  aoscx_lag_interface:
    state: create
    name: lag2
    multi_chassis: true
    static_multi_chassis: true
    lacp_fallback: true
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Update static MCLAG, unset LACP fallback mode.
  aoscx_lag_interface:
    state: update
    name: lag256
    multi_chassis: true
    static_multi_chassis: true
    lacp_fallback: false
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Delete LAG Interface 128.
  aoscx_lag_interface:
    state: delete
    name: lag128

Inputs

    
name:
    description: 'LAG Interface Name, the ID portion should be no lower than 1. Check
      your hardware specifications for its limitations. example: lag1, or lag256.

      '
    required: true
    type: str

state:
    choices:
    - create
    - update
    - delete
    default: create
    description: 'Create, Update or Delete the Interface. After that a physical interface
      is removed from a LAG, interface will be shutdown (admin state in down). LAG interface

      '
    required: false
    type: str

lacp_mode:
    choices:
    - active
    - passive
    - disabled
    description: 'Configures Link Aggregation Control Procotol (LACP) mode on this interface,
      `active` ports are allowed to initiate LACP negotiations. `passive` ports can participate
      in LACP negotiations initiated by a remote switch, but not initiate such negotiations.
      If LACP is enabled on a port whose partner switch does not support LACP, the bond
      will be disabled. Defaults to disabled.

      '
    required: false
    type: str

lacp_rate:
    choices:
    - slow
    - fast
    description: 'Configures Link Aggregation Control Protocol (LACP) rate on this Interface,
      by default LACP rate is `slow` and LAPCDUs will be sent every 30 seconds; if LACP
      rate is `fast` LACPDUs will be sent every second. This value can not be set if lacp
      mode is disabled.

      '
    type: str

interfaces:
    description: 'List of interfaces in the LAG. Each interface added to a LAG interface
      will inherit the LAG manager state of the LAG, wether it is "up" or "down".

      '
    elements: str
    required: false
    type: list

lacp_fallback:
    description: 'Enable LACP fallback mode, specified only for multi-chassis LAG.

      '
    required: false
    type: bool

multi_chassis:
    description: 'Option to specify whether the LAG is an MCLAG. This option is mutually
      exclusive with the `lacp_mode` option. As an MCLAG forces the lacp_mode to `active`.

      '
    required: false
    type: bool

static_multi_chassis:
    description: 'Whether the MCLAG is static. Ignored if `multi_chassis` is not specified.

      '
    required: false
    type: bool