mellanox.onyx.onyx_bfd – Configures BFD 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_bfd.

New in version 0.2.0: of mellanox.onyx

Synopsis

  • This module provides declarative management of BFD protocol params on Mellanox ONYX network devices.

Parameters

Parameter Choices/Defaults Comments
interval_min_rx
integer
Minimum desired receive rate, should be between 50 and 6000.
interval_multiplier
integer
Desired detection multiplier, should be between 3 and 50.
interval_transmit_rate
integer
Minimum desired transmit rate, should be between 50 and 60000.
iproute_mask_length
integer
Configures the mask length of the ip route network prefix, e.g 24.
iproute_network_prefix
string
Configures the ip route network prefix, e.g 1.1.1.1.
iproute_next_hop
string
Configures the ip route next hop, e.g 2.2.2.2.
shutdown
boolean
    Choices:
  • no
  • yes
Administratively shut down BFD protection.
vrf
string
Specifys the vrf name.

Examples

- name: Configures bfd
  onyx_bfd:
    shutdown: yes
    vrf: 5
    interval_min_rx: 55
    interval_multiplier: 8
    interval_transmit_rate: 88
    iproute_network_prefix: 1.1.1.0
    iproute_mask_length: 24
    iproute_next_hop: 3.2.2.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:
['ip bfd shutdown', 'no ip bfd shutdown', 'ip bfd shutdown vrf <vrf_name>', 'no ip bfd shutdown vrf <vrf_name>', 'ip bfd vrf <vrf_name> interval min-rx <min_rx> multiplier <multiplier> transmit-rate <transmit_rate> force', 'ip bfd interval min-rx <min_rx> multiplier <multiplier> transmit-rate <transmit_rate> force', 'ip route vrf <vrf_name> <network_prefix>/<mask_length> <next_hop> bfd', 'ip route <network_prefix>/<mask_length> <next_hop> bfd']


Authors

  • Sara Touqan (@sarato)