mellanox.onyx.onyx_bfd module – Configures BFD parameters

Note

This module 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 mellanox.onyx 0.2.0

Synopsis

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

Parameters

Parameter

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

Administratively shut down BFD protection.

Choices:

  • false

  • true

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

Description

commands

list / elements=string

The list of configuration mode commands to send to the device.

Returned: always

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)