community.general.pn_vlag (0.1.1) — module

Install collection

Install with ansible-galaxy collection install community.general:==0.1.1

Add to requirements.yml

  collections:
    - name: community.general
      version: 0.1.1

Description

Execute vlag-create/vlag-delete/vlag-modify command.

A virtual link aggregation group (VLAG) allows links that are physically connected to two different Pluribus Networks devices to appear as a single trunk to a third device. The third device can be a switch, server, or any Ethernet device. A VLAG can provide Layer 2 multipathing, which allows you to create redundancy by increasing bandwidth, enabling multiple parallel paths between nodes and loadbalancing traffic where alternative paths exist.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: create a VLAG
  pn_vlag:
    state: 'present'
    pn_name: spine-to-leaf
    pn_port: 'spine01-to-leaf'
    pn_peer_port: 'spine02-to-leaf'
    pn_peer_switch: spine02
    pn_mode: 'active-active'

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: delete VLAGs
  pn_vlag:
    state: 'absent'
    pn_name: spine-to-leaf

Inputs

    
state:
    choices:
    - present
    - absent
    - update
    description:
    - State the action to perform. Use 'present' to create vlag, 'absent' to delete vlag
      and 'update' to modify vlag.
    required: true

pn_mode:
    choices:
    - active-active
    - active-standby
    description:
    - Specify the mode for the VLAG. Active-standby indicates one side is active and the
      other side is in standby mode. Active-active indicates that both sides of the vlag
      are up by default.

pn_name:
    description:
    - The C(pn_name) takes a valid name for vlag configuration.
    required: true

pn_port:
    description:
    - Specify the local VLAG port.
    - Required for vlag-create.

pn_cliswitch:
    default: local
    description:
    - Target switch(es) to run this command on.

pn_lacp_mode:
    choices:
    - 'off'
    - passive
    - active
    description:
    - Specify the LACP mode.

pn_peer_port:
    description:
    - Specify the peer VLAG port.
    - Required for vlag-create.

pn_clipassword:
    description:
    - Provide login password if user is not root.
    required: false

pn_cliusername:
    description:
    - Provide login username if user is not root.
    required: false

pn_peer_switch:
    description:
    - Specify the fabric-name of the peer switch.

pn_lacp_timeout:
    choices:
    - slow
    - fast
    description:
    - Specify the LACP timeout as slow(30 seconds) or fast(4 seconds).

pn_lacp_fallback:
    choices:
    - bundle
    - individual
    description:
    - Specify the LACP fallback mode as bundles or individual.

pn_failover_action:
    choices:
    - move
    - ignore
    description:
    - Specify the failover action as move or ignore.

pn_lacp_fallback_timeout:
    description:
    - Specify the LACP fallback timeout in seconds. The range is between 30 and 60 seconds
      with a default value of 50 seconds.

Outputs

changed:
  description: Indicates whether the CLI caused changes on the target.
  returned: always
  type: bool
command:
  description: The CLI command run on the target node(s).
  returned: always
  type: str
stderr:
  description: The set of error responses from the vlag command.
  returned: on error
  type: list
stdout:
  description: The set of responses from the vlag command.
  returned: always
  type: list