community.fortios.fmgr_ha – Manages the High-Availability State of FortiManager Clusters and Nodes.

Note

This plugin is part of the community.fortios collection (version 1.0.0).

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

To use it in a playbook, specify: community.fortios.fmgr_ha.

Synopsis

  • Change HA state or settings of FortiManager nodes (Standalone/Master/Slave).

Parameters

Parameter Choices/Defaults Comments
fmgr_ha_cluster_id
string
Default:
1
Sets the ID number of the HA cluster. Defaults to 1.
fmgr_ha_cluster_pw
string
Sets the password for the HA cluster. Only required once. System remembers between HA mode switches.
fmgr_ha_file_quota
string
Default:
4096
Sets the File quota in MB (2048-20480).
fmgr_ha_hb_interval
string
Default:
5
Sets the heartbeat interval (1-255).
fmgr_ha_hb_threshold
string
Default:
3
Sets heartbeat lost threshold (1-255).
fmgr_ha_mode
string
    Choices:
  • standalone
  • master
  • slave
Sets the role of the FortiManager host for HA.
fmgr_ha_peer_ipv4
string
Sets the IPv4 address of a HA peer.
fmgr_ha_peer_ipv6
string
Sets the IPv6 address of a HA peer.
fmgr_ha_peer_sn
string
Sets the HA Peer Serial Number.
fmgr_ha_peer_status
string
    Choices:
  • enable
  • disable
Sets the peer status to enable or disable.

Examples

- name: SET FORTIMANAGER HA NODE TO MASTER
  community.fortios.fmgr_ha:
    fmgr_ha_mode: "master"
    fmgr_ha_cluster_pw: "fortinet"
    fmgr_ha_cluster_id: "1"

- name: SET FORTIMANAGER HA NODE TO SLAVE
  community.fortios.fmgr_ha:
    fmgr_ha_mode: "slave"
    fmgr_ha_cluster_pw: "fortinet"
    fmgr_ha_cluster_id: "1"

- name: SET FORTIMANAGER HA NODE TO STANDALONE
  community.fortios.fmgr_ha:
    fmgr_ha_mode: "standalone"

- name: ADD FORTIMANAGER HA PEER
  community.fortios.fmgr_ha:
    fmgr_ha_peer_ipv4: "192.168.1.254"
    fmgr_ha_peer_sn: "FMG-VM1234567890"
    fmgr_ha_peer_status: "enable"

- name: CREATE CLUSTER ON MASTER
  community.fortios.fmgr_ha:
    fmgr_ha_mode: "master"
    fmgr_ha_cluster_pw: "fortinet"
    fmgr_ha_cluster_id: "1"
    fmgr_ha_hb_threshold: "10"
    fmgr_ha_hb_interval: "15"
    fmgr_ha_file_quota: "2048"

Return Values

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

Key Returned Description
api_result
string
always
full API response, includes status code and message


Authors

  • Luke Weighall (@lweighall)

  • Andrew Welsh (@Ghilli3)

  • Jim Huber (@p4r4n0y1ng)