:source: fortios_system_cluster_sync.py
:orphan:
.. fortios_system_cluster_sync:
fortios_system_cluster_sync -- Configure FortiGate Session Life Support Protocol (FGSP) session synchronization in Fortinet's FortiOS and FortiGate.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
.. versionadded:: 2.0.0
.. contents::
:local:
:depth: 1
Synopsis
--------
- This module is able to configure a FortiGate or FortiOS (FOS) device by allowing the user to set and modify system feature and cluster_sync category. Examples include all parameters and values need to be adjusted to datasources before usage. Tested with FOS v6.0.0
Requirements
------------
The below requirements are needed on the host that executes this module.
- ansible>=2.16
Tips
----
Using member operation to add an element to an existing object.
FortiOS Version Compatibility
-----------------------------
Supported Version Ranges: v6.0.0 -> v7.2.0
Parameters
----------
.. raw:: html
- access_token - Token-based authentication. Generated from GUI of Fortigate. type: str required: false
- enable_log - Enable/Disable logging for task. type: bool required: false default: False
- vdom - Virtual domain, among those defined previously. A vdom is a virtual instance of the FortiGate that can be configured and used as a different unit. type: str default: root
- member_path - Member attribute path to operate on. type: str
- member_state - Add or delete a member under specified attribute path. type: str choices: present, absent
- state - Indicates whether to create or remove the object. type: str required: true choices: present, absent
- system_cluster_sync - Configure FortiGate Session Life Support Protocol (FGSP) session synchronization. type: dict
more...
| Supported Version Ranges |
| system_cluster_sync |
v6.0.0 -> v7.2.0 |
- down_intfs_before_sess_sync - List of interfaces to be turned down before session synchronization is complete. type: list member_path: down_intfs_before_sess_sync:name
more...
| Supported Version Ranges |
| down_intfs_before_sess_sync |
v6.0.0 -> v7.2.0 |
- name - Interface name. Source system.interface.name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v6.0.0 -> v7.2.0 |
- hb_interval - Heartbeat interval (1 - 10 sec). type: int
more...
|
Supported Version Ranges |
| hb_interval |
v6.0.0 -> v7.2.0 |
- hb_lost_threshold - Lost heartbeat threshold (1 - 10). type: int
more...
|
Supported Version Ranges |
| hb_lost_threshold |
v6.0.0 -> v7.2.0 |
- ike_heartbeat_interval - IKE heartbeat interval (1 - 60 secs). type: int
more...
|
Supported Version Ranges |
| ike_heartbeat_interval |
v7.0.0 -> v7.0.7 |
v7.2.0 -> v7.2.0 |
- ike_monitor - Enable/disable IKE HA monitor. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| ike_monitor |
v7.0.0 -> v7.0.7 |
v7.2.0 -> v7.2.0 |
| [enable] |
v7.0.0 -> v7.0.7 |
| [disable] |
v7.0.0 -> v7.0.7 |
- ike_monitor_interval - IKE HA monitor interval (10 - 300 secs). type: int
more...
|
Supported Version Ranges |
| ike_monitor_interval |
v7.0.0 -> v7.0.7 |
v7.2.0 -> v7.2.0 |
- ike_seqjump_speed - ESP jump ahead factor (1G - 10G pps equivalent). type: int
more...
|
Supported Version Ranges |
| ike_seqjump_speed |
v7.0.0 -> v7.0.0 |
- ipsec_tunnel_sync - Enable/disable IPsec tunnel synchronization. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| ipsec_tunnel_sync |
v6.2.0 -> v7.2.0 |
| [enable] |
v6.2.0 -> v7.2.0 |
| [disable] |
v6.2.0 -> v7.2.0 |
- peerip - IP address of the interface on the peer unit that is used for the session synchronization link. type: str
more...
|
Supported Version Ranges |
| peerip |
v6.0.0 -> v7.2.0 |
- peervd - VDOM that contains the session synchronization link interface on the peer unit. Usually both peers would have the same peervd. Source system.vdom.name. type: str
more...
|
Supported Version Ranges |
| peervd |
v6.0.0 -> v7.2.0 |
- secondary_add_ipsec_routes - Enable/disable IKE route announcement on the backup unit. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| secondary_add_ipsec_routes |
v7.0.1 -> v7.2.0 |
| [enable] |
v7.0.1 -> v7.2.0 |
| [disable] |
v7.0.1 -> v7.2.0 |
- session_sync_filter - Add one or more filters if you only want to synchronize some sessions. Use the filter to configure the types of sessions to synchronize. type: dict
more...
| Supported Version Ranges |
| session_sync_filter |
v6.0.0 -> v7.2.0 |
- custom_service - Only sessions using these custom services are synchronized. Use source and destination port ranges to define these custom services. type: list member_path: session_sync_filter/custom_service:id
more...
| Supported Version Ranges |
| custom_service |
v6.0.0 -> v7.2.0 |
- dst_port_range - Custom service destination port range. type: str
more...
|
Supported Version Ranges |
| dst_port_range |
v6.0.0 -> v7.2.0 |
- id - Custom service ID. see Notes. type: int required: true
more...
|
Supported Version Ranges |
| id |
v6.0.0 -> v7.2.0 |
- src_port_range - Custom service source port range. type: str
more...
|
Supported Version Ranges |
| src_port_range |
v6.0.0 -> v7.2.0 |
- dstaddr - Only sessions to this IPv4 address are synchronized. type: str
more...
|
Supported Version Ranges |
| dstaddr |
v6.0.0 -> v7.2.0 |
- dstaddr6 - Only sessions to this IPv6 address are synchronized. type: str
more...
|
Supported Version Ranges |
| dstaddr6 |
v6.0.0 -> v7.2.0 |
- dstintf - Only sessions to this interface are synchronized. Source system.interface.name. type: str
more...
|
Supported Version Ranges |
| dstintf |
v6.0.0 -> v7.2.0 |
- srcaddr - Only sessions from this IPv4 address are synchronized. type: str
more...
|
Supported Version Ranges |
| srcaddr |
v6.0.0 -> v7.2.0 |
- srcaddr6 - Only sessions from this IPv6 address are synchronized. type: str
more...
|
Supported Version Ranges |
| srcaddr6 |
v6.0.0 -> v7.2.0 |
- srcintf - Only sessions from this interface are synchronized. Source system.interface.name. type: str
more...
|
Supported Version Ranges |
| srcintf |
v6.0.0 -> v7.2.0 |
- slave_add_ike_routes - Enable/disable IKE route announcement on the backup unit. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| slave_add_ike_routes |
v6.0.0 -> v7.0.0 |
| [enable] |
v6.0.0 -> v7.0.0 |
| [disable] |
v6.0.0 -> v7.0.0 |
- sync_id - Sync ID. see Notes. type: int required: true
more...
|
Supported Version Ranges |
| sync_id |
v6.0.0 -> v7.2.0 |
- syncvd - Sessions from these VDOMs are synchronized using this session synchronization configuration. type: list member_path: syncvd:name
more...
| Supported Version Ranges |
| syncvd |
v6.0.0 -> v7.2.0 |
- name - VDOM name. Source system.vdom.name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v6.0.0 -> v7.2.0 |
Notes
-----
.. note::
- We highly recommend using your own value as the sync_id instead of 0, while '0' is a special placeholder that allows the backend to assign the latest available number for the object, it does have limitations. Please find more details in Q&A.
- Legacy fortiosapi has been deprecated, httpapi is the preferred way to run playbooks
- The module supports check_mode.
Examples
--------
.. code-block:: yaml+jinja
- name: Configure FortiGate Session Life Support Protocol (FGSP) session synchronization.
fortinet.fortios.fortios_system_cluster_sync:
vdom: "{{ vdom }}"
state: "present"
access_token: ""
system_cluster_sync:
down_intfs_before_sess_sync:
-
name: "default_name_4 (source system.interface.name)"
hb_interval: "2"
hb_lost_threshold: "3"
ike_heartbeat_interval: "3"
ike_monitor: "enable"
ike_monitor_interval: "15"
ike_seqjump_speed: "10"
ipsec_tunnel_sync: "enable"
peerip: ""
peervd: " (source system.vdom.name)"
secondary_add_ipsec_routes: "enable"
session_sync_filter:
custom_service:
-
dst_port_range: ""
id: "18"
src_port_range: ""
dstaddr: ""
dstaddr6: ""
dstintf: " (source system.interface.name)"
srcaddr: ""
srcaddr6: ""
srcintf: " (source system.interface.name)"
slave_add_ike_routes: "enable"
sync_id: ""
syncvd:
-
name: "default_name_29 (source system.vdom.name)"
Return Values
-------------
Common return values are documented: https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values, the following are the fields unique to this module:
.. raw:: html
- build - Build number of the fortigate image returned: always type: str sample: 1547
- http_method - Last method used to provision the content into FortiGate returned: always type: str sample: PUT
- http_status - Last result given by FortiGate on last operation applied returned: always type: str sample: 200
- mkey - Master key (id) used in the last call to FortiGate returned: success type: str sample: id
- name - Name of the table used to fulfill the request returned: always type: str sample: urlfilter
- path - Path of the table used to fulfill the request returned: always type: str sample: webfilter
- revision - Internal revision number returned: always type: str sample: 17.0.2.10658
- serial - Serial number of the unit returned: always type: str sample: FGVMEVYYQT3AB5352
- status - Indication of the operation's result returned: always type: str sample: success
- vdom - Virtual domain used returned: always type: str sample: root
- version - Version of the FortiGate returned: always type: str sample: v5.6.3
Status
------
- This module is not guaranteed to have a backwards compatible interface.
Authors
-------
- Link Zheng (@chillancezen)
- Jie Xue (@JieX19)
- Hongbin Lu (@fgtdev-hblu)
- Frank Shen (@frankshen01)
- Miguel Angel Munoz (@mamunozgonzalez)
- Nicolas Thomas (@thomnico)
.. hint::
If you notice any issues in this documentation, you can create a pull request to improve it.