Try SpotterManage High Availability configuration in Radware Alteon
| "added in version" 1.0.0 of radware.radware_alteon"
Authors: Leon Meguira (@leonmeguira), Nati Fridman (@natifridman)
stableinterface | supported by certified
Install with ansible-galaxy collection install radware.radware_alteon:==1.1.2
collections:
- name: radware.radware_alteon
version: 1.1.2Manage High Availability configuration in Radware Alteon
- name: alteon configuration command
radware.radware_alteon.alteon_config_high_availability:
provider:
server: 192.168.1.1
user: admin
password: admin
validate_certs: false
https_port: 443
ssh_port: 22
timeout: 5
state: present
parameters:
mode: switch
advertise_bgp_routes_on_backup: enabled
holdoff_timer_second: 15
advertisement_interval_second: 2
fail_back_mode: always
preferred_state: active
sync_dynamic_data_store: enabled
sync_persistent_sessions: enabled
sync_session_interval_seconds: 20
unicast_session_mirroring: enabled
mirroring_primary_interface: 1
advertising_interfaces:
- 1
tracked_interfaces:
- 1
state:
choices:
- present
- absent
- read
- overwrite
- append
default: null
description:
- When C(present), guarantees that the object exists with the provided attributes.
- When C(absent), when applicable removes the object.
- When C(read), when exists read object from configuration to parameter format.
- When C(overwrite), removes the object if exists then recreate it
- When C(append), append object configuration with the provided parameters
required: true
type: str
provider:
description:
- Radware Alteon connection details.
required: true
suboptions:
https_port:
default: null
description:
- Radware Alteon https port.
required: true
password:
default: null
description:
- Radware Alteon password.
required: true
server:
default: null
description:
- Radware Alteon IP address.
required: true
ssh_port:
default: null
description:
- Radware Alteon ssh port.
required: true
timeout:
default: null
description:
- Timeout for connection.
required: true
user:
default: null
description:
- Radware Alteon username.
required: true
validate_certs:
default: null
description:
- If C(false), SSL certificates will not be validated.
- This should only set to C(false) used on personally controlled sites using self-signed
certificates.
required: true
type: bool
type: dict
parameters:
description:
- Parameters for HA configuration.
suboptions:
advertise_bgp_routes_on_backup:
choices:
- enabled
- disabled
default: disabled
description:
- Specifies whether a backup Alteon advertises the virtual IP address (virtual
server router) routes to a Border Gateway Protocol peer.
- This option is intended for cases where bi-directional forwarding (BFD) is activated
on BGP peers in a multiple-site topology.
- When BGP failure detection is faster than high availability failover, this option
prevents the BGP router from redirecting traffic to another site.
- The backup Alteon advertises its virtual IP addresses, but does not process
network traffic for these VIPS until it changes roles from backup to master
- (for example, it does not respond to ARPs until it has become active).
- The purpose of this advertisement is for BGP purposes only, and does not affect
Alteon high availability capabilities.
required: false
advertisement_interval_second:
default: null
description:
- Sets the length of time, in seconds, between Alteon master advertisements.
required: false
type: int
advertising_interfaces:
default: null
description:
- Sets an IP interface for communication between the Alteon platforms in the HA
pair.
- Make sure that you set a peer IP address for each interface.
- Radware recommends using more than a single advertisement interface.
elements: int
required: false
type: list
cluster_master_election_priority:
default: 255
description:
- Extended HA mode is an extension of Switch HA mode that enables failover within
a cluster of more than two (and up to four) Alteons.
- There is always a single master in a cluster, based on priority and a Failback/Failover
order value, as follows
- When there is a single Alteon with the highest priority, this Alteon becomes
the master. (Priority is not configurable, and is derived from real servers
and gateway tracking.)
- When multiple Alteons share the highest priority, the Alteon among them with
the lowest Failback/Failover order value becomes the master.
- When multiple Alteons share the highest priority and the lowest Failback/Failover
order value, there is an internal bidding process that takes place to determine
the master.
- In topologies with multiple Alteon peers, session mirroring should be in broadcast
mode, not unicast.
- To avoid a broadcast storm over the network due to session mirroring, Radware
recommends allocating a special VLAN for this purpose.
required: false
type: int
fail_back_mode:
choices:
- onfailure
- always
default: onfailure
description:
- Defines the Alteon failback mode.
- Onfailure means that failback does not occur if all tracked resources are available
on the active Alteon.
- Always means that failback to the Alteon with preferred state set to active
occurs when that Alteon becomes available.
required: false
gateway_tracking_state:
choices:
- enabled
- disabled
default: disabled
description:
- Enable or disable tracking of gateways.
required: false
holdoff_timer_second:
default: 0
description:
- Sets the length of time, in seconds, that the master Alteon waits before forwarding
traffic to the default gateway and real servers.
required: false
type: int
mirroring_primary_interface:
default: null
description:
- Sets the primary interface for unicast session failover.
- You must configure a peer IP address for all IP interfaces participating in
session failover.
- This option is available only when the Unicast Session Mirroring is enabled.
required: false
type: int
mirroring_secondary_interface:
default: null
description:
- Sets the secondary interface for unicast session failover.
- You must configure a peer IP address for all IP interfaces participating in
session failover.
- This option is available only when the Unicast Session Mirroring is enabled.
required: false
type: int
mode:
choices:
- disabled
- vrrp
- switch
- service
- extendedHA
default: null
description:
- Set the high availability mode.
- Disabled means that High availability is not configured.
- Switch HA is a switch-based group aggregates all virtual IP addresses on an
Alteon as a single entity. The active Alteon supports all traffic or services.
The backup Alteon acts as a standby for services on the active master Alteon.
If the master Alteon fails, the backup Alteon takes over processing for all
services.
- Service HA is Several VIPs grouped together and behave as a single entity for
failover purposes. A service group is comprised of several VIPs and their associated
floating IP addresses. You can define up to 64 service groups on a single Alteon
platform.
- Extended HA is an extension of Switch HA mode that enables failover within a
cluster of more than two (and up to four) Alteons.
- Legacy VRRP is A legacy mode that maintains the Alteon high availability module
as implemented in software versions earlier than 30.1.
required: false
preferred_state:
choices:
- active
- standby
default: standby
description:
- Defines the Alteon preferred initial state.
- The preferred initial state is relevant and configurable only when the failback
mode is Always.
- The preferred initial state should be Active for one of the Alteons in an HA
pair, and Standby for the other.
- If both Alteon platforms have the same preferred initial state, the system arbitrarily
selects the active Alteon.
required: false
real_server_tracking_state:
choices:
- enabled
- disabled
default: disabled
description:
- Enable or disable Layer 4 tracking of all real servers.
required: false
send_garp_nwclss_proxy_ips:
choices:
- enabled
- disabled
default: disabled
description:
- Specifies whether to send Gratuitous ARP (GARP) messages for all proxy IP addresses
in the network class range.
- Gratuitous ARP packets are used to force a next-hop router to learn an IP and
MAC pair.
- For security reasons, this option can only be used for an IP address belonging
to a VIP, PIP, or interface.
required: false
sync_dynamic_data_store:
choices:
- enabled
- disabled
default: disabled
description:
- Enable or disable synchronizing the dynamic data store that includes persistence
data and/or user-defined dynamic data created and updated via AppShape++ scripts.
required: false
sync_persistent_sessions:
choices:
- enabled
- disabled
default: enabled
description:
- Enable or disable stateful failover for synchronizing the persistent session
state.
required: false
sync_session_interval_seconds:
default: 30
description:
- Sets the stateful failover update interval in seconds.
- The active Alteon sends update packets of new persistent binding entries, if
any, to the backup Alteon at the specified update interval.
- This option available only when the Sync Persistent Sessions checkbox is selected.
required: false
type: int
tracked_gateways:
default: null
description:
- Select the gateways to be tracked.
elements: int
required: false
type: list
tracked_interfaces:
default: null
description:
- Select the Layer 3 interface to be tracked.
- Always enabled.
elements: int
required: false
type: list
unicast_session_mirroring:
choices:
- enabled
- disabled
default: disabled
description:
- Enables SFO unicast mode.
- The Unicast Session Mirroring option enables UDP unicast communication between
the active and standby Alteons.
- You must define the interface over which mirroring takes place.
- Radware recommends defining a secondary interface for backup. Interfaces used
for session mirroring must have a peer IP address configured.
required: false
type: dict
revert_on_error:
default: false
description:
- If an error occurs, perform revert on alteon.
required: false
type: bool
write_on_change:
default: false
description:
- Executes Alteon write calls only when an actual change has been evaluated.
required: false
type: bool
obj: description: parameters object type returned: changed, read type: dict status: description: Message detailing run result returned: success sample: object deployed successfully type: str