community.network.pn_trunk – CLI command to create/delete/modify a trunk.

Note

This plugin is part of the community.network collection (version 1.3.2).

To install it use: ansible-galaxy collection install community.network.

To use it in a playbook, specify: community.network.pn_trunk.

DEPRECATED

Removed in

version 2.0.0

Why

Doesn’t support latest Pluribus Networks netvisor

Alternative

Latest modules will be pushed in Ansible future versions.

Synopsis

  • Execute trunk-create or trunk-delete command.

  • Trunks can be used to aggregate network links at Layer 2 on the local switch. Use this command to create a new trunk.

Parameters

Parameter Choices/Defaults Comments
pn_broadcast_level
string
Specify a broadcast level in percent. The default value is 100%.
pn_clipassword
string
Provide login password if user is not root.
pn_cliswitch
string
Default:
"local"
Target switch(es) to run the cli on.
pn_cliusername
string
Provide login username if user is not root.
pn_description
string
Specify a description for the trunk configuration.
pn_edge_switch
boolean
    Choices:
  • no
  • yes
Specify if the switch is an edge switch.
pn_egress_rate_limit
string
Specify an egress port data rate limit for the configuration.
pn_host
boolean
    Choices:
  • no
  • yes
Host facing port control setting.
pn_jumbo
boolean
    Choices:
  • no
  • yes
Specify if the port can receive jumbo frames.
pn_lacp_fallback
string
    Choices:
  • bundle
  • individual
Specify the LACP fallback mode as bundles or individual.
pn_lacp_fallback_timeout
string
Specify the LACP fallback timeout in seconds. The range is between 30 and 60 seconds with a default value of 50 seconds.
pn_lacp_mode
string
    Choices:
  • off
  • passive
  • active
Specify the LACP mode for the configuration.
pn_lacp_priority
string
Specify the LACP priority. This is a number between 1 and 65535 with a default value of 32768.
pn_lacp_timeout
string
    Choices:
  • slow
  • fast
Specify the LACP time out as slow (30 seconds) or fast (4seconds). The default value is slow.
pn_loopback
boolean
    Choices:
  • no
  • yes
Specify loopback if you want to use loopback.
pn_loopvlans
string
Specify a list of looping vlans.
pn_mirror_receive
boolean
    Choices:
  • no
  • yes
Specify if the configuration receives mirrored traffic.
pn_name
string / required
Specify the name for the trunk configuration.
pn_pause
boolean
    Choices:
  • no
  • yes
Specify if pause frames are sent.
pn_port_macaddr
string
Specify the MAC address of the port.
pn_ports
string
Specify the port number(s) for the link(s) to aggregate into the trunk.
Required for trunk-create.
pn_routing
boolean
    Choices:
  • no
  • yes
Specify if the port participates in routing on the network.
pn_speed
string
    Choices:
  • disable
  • 10m
  • 100m
  • 1g
  • 2.5g
  • 10g
  • 40g
Specify the port speed or disable the port.
pn_unknown_mcast_level
string
Specify an unknown multicast level in percent. The default value is 100%.
pn_unknown_ucast_level
string
Specify an unknown unicast level in percent. The default value is 100%.
state
string / required
    Choices:
  • present
  • absent
  • update
State the action to perform. Use 'present' to create trunk, 'absent' to delete trunk and 'update' to modify trunk.

Examples

- name: Create trunk
  community.network.pn_trunk:
    state: 'present'
    pn_name: 'spine-to-leaf'
    pn_ports: '11,12,13,14'

- name: Delete trunk
  community.network.pn_trunk:
    state: 'absent'
    pn_name: 'spine-to-leaf'

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
changed
boolean
always
Indicates whether the CLI caused changes on the target.

command
string
always
The CLI command run on the target node(s).

stderr
list / elements=string
on error
The set of error responses from the trunk command.

stdout
list / elements=string
always
The set of responses from the trunk command.



Status

  • This module will be removed in version 2.0.0. [deprecated]

  • For more information see DEPRECATED.

Authors

  • Pluribus Networks (@amitsi)