mellanox.onyx.onyx_igmp_vlan – Configures IGMP Vlan parameters

Note

This plugin is part of the mellanox.onyx collection (version 1.0.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install mellanox.onyx.

To use it in a playbook, specify: mellanox.onyx.onyx_igmp_vlan.

Synopsis

  • This module provides declarative management of IGMP vlan configuration on Mellanox ONYX network devices.

Parameters

Parameter Choices/Defaults Comments
mrouter
string
Configure ip igmp snooping mrouter port on vlan
name
string / required
Configure mrouter interface
state
string
    Choices:
  • enabled
  • disabled
Enable IGMP snooping mrouter on vlan interface.
querier
string
Configure the IGMP querier parameters
address
string
Update IP address for the querier
interval
string
Update time interval between querier queries, range 60-600
state
string
    Choices:
  • enabled
  • disabled
Enable IGMP snooping querier on vlan in the switch.
state
string
    Choices:
  • enabled
  • disabled
IGMP state.
static_groups
string
List of IGMP static groups.
multicast_ip_address
string / required
Configure static IP multicast group, range 224.0.1.0-239.255.255.25.
name
string
interface name to configure static groups on it.
sources
string
List of IP sources to be configured
version
string
    Choices:
  • V2
  • V3
IGMP snooping operation version on this vlan
vlan_id
string / required
VLAN ID, vlan should exist.

Notes

Note

  • Tested on ONYX 3.7.0932-01

Examples

- name: Configure igmp vlan
  onyx_igmp_vlan:
    state: enabled
    vlan_id: 10
    version:
      V2
    querier:
      state: enabled
      interval: 70
      address: 10.11.121.13
    mrouter:
      state: disabled
      name: Eth1/2
    static_groups:
      - multicast_ip_address: 224.5.5.8
        name: Eth1/1
        sources:
          - 1.1.1.1
          - 1.1.1.2

Return Values

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

Key Returned Description
commands
list / elements=string
always
The list of configuration mode commands to send to the device.

Sample:
['vlan 10 ip igmp snooping', 'vlan 10 ip igmp snooping static-group 224.5.5.5 interface ethernet 1/1']


Authors

  • Anas Badaha (@anasbadaha)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/mellanox/onyx/onyx_igmp_vlan_module.html