radware.radware_modules.alteon_config_global_redirection (0.6.12) — module

Manage global traffic redirection in Radware Alteon

| "added in version" 2.9 of radware.radware_modules"

Authors: Leon Meguira (@leonmeguira), Nati Fridman (@natifridman)

stableinterface | supported by certified

Install collection

Install with ansible-galaxy collection install radware.radware_modules:==0.6.12


Add to requirements.yml

  collections:
    - name: radware.radware_modules
      version: 0.6.12

Description

Manage global traffic redirection (GSLB) in Radware Alteon


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: alteon configuration command
  radware.radware_modules.alteon_config_global_redirection:
    provider: 
      server: 192.168.1.1
      user: admin
      password: admin
      validate_certs: no
      https_port: 443
      ssh_port: 22
      timeout: 5
    state: present
    parameters:
      state: on
      global_http_redirection: disabled
      global_proxy_redirection: enabled
      cpu_utilization_threshold_percent: 90
      dssp_version: 5
      dssp_tcp_update_port: 8080
      site_update_interval_second: 45
      site_update_encryption: enabled
      service_down_response: norsp
      dns_redirection_state: enabled
      dns_persistence_cache_sync: enabled
      hostname_matching: enabled
      dns_persist_timeout_minute: 30
      dns_persist_ip4_subnet: 255.255.255.128
      sites:
        - state: enabled
          description: site_x
          site_update_state: enabled
          primary_ip4_address: 8.5.5.5
          secondary_ip4_address: 8.5.5.6
        - state: enabled
          description: ha_peer_device
          site_update_state: enabled
          ha_peer_device: enabled
          primary_ip4_address: 1.1.1.2                

Inputs

    
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

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(no), SSL certificates will not be validated.
        - This should only set to C(no) used on personally controlled sites using self-signed
          certificates.
        required: true
        type: bool

parameters:
    description:
    - Parameters for global redirection configuration.
    suboptions:
      cpu_utilization_threshold_percent:
        default: null
        description:
        - Set CPU utilization capacity threshold (DSSPv2, DSSPv3, DSSPv4 and DSSPv5).
        required: false
        type: int
      dns_persist_ip4_subnet:
        default: null
        description:
        - Set source IP subnet mask for DNS persistence cache.
        required: false
        type: str
      dns_persist_ip6_prefix:
        default: null
        description:
        - Set source IPv6 prefix for DNS persistence cache.
        required: false
        type: int
      dns_persist_timeout_minute:
        default: null
        description:
        - Set timeout in minutes for DNS persistence cache.
        required: false
        type: int
      dns_persistence_cache_sync:
        choices:
        - enabled
        - disabled
        default: null
        description:
        - Enable/disable sync of DNS persistence cache with remote sites.
        required: false
      dns_redirection_state:
        choices:
        - enabled
        - disabled
        default: null
        description:
        - Enable/disable authoritative DNS direct based GSLB.
        required: false
      dssp_tcp_update_port:
        default: null
        description:
        - Set TCP port number for DSSPv2, DSSPv3, DSSPv4 and DSSPv5 remote site updates.
        required: false
        type: int
      dssp_version:
        default: null
        description:
        - Set DSSP version 1 or 2 or 3 or 4 or 5 to send out remote site updates.
        required: false
        type: int
      global_http_redirection:
        choices:
        - enabled
        - disabled
        default: null
        description:
        - Enable/disable HTTP/HTTPS redirection based GSLB.
        required: false
      global_proxy_redirection:
        choices:
        - enabled
        - disabled
        default: null
        description:
        - Enable/disable no remote real SLB.
        required: false
      hostname_matching:
        choices:
        - enabled
        - disabled
        default: null
        description:
        - Enable/disable virtual service hostname matching.
        required: false
      redirect_to_server_name:
        choices:
        - enabled
        - disabled
        default: null
        description:
        - Enable/disable HTTP redirect to remote real server name.
        required: false
      service_down_response:
        choices:
        - norsp
        - srvfail
        default: null
        description:
        - Set response when service down.
        required: false
      session_utilization_threshold_percent:
        default: null
        description:
        - Set sessions utilization capacity threshold (DSSPv2, DSSPv3, DSSPv4 and DSSPv5).
        required: false
        type: int
      site_update_encryption:
        choices:
        - enabled
        - disabled
        default: null
        description:
        - Enable/disable encrypting remote site updates.
        required: false
      site_update_interval_second:
        default: null
        description:
        - Set interval in seconds for remote site updates.
        required: false
        type: int
      sites:
        default: null
        description:
        - Remote site configuration.
        elements: dict
        required: false
        suboptions:
          description:
            default: null
            description:
            - Set descriptive remote site name.
            required: false
            type: str
          ha_peer_device:
            choices:
            - enabled
            - disabled
            default: null
            description:
            - Enable/disable treatment of site as vrrp peer device.
            required: false
          primary_ip4_address:
            default: null
            description:
            - Set primary switch IPv4 address of remote site.
            required: false
            type: str
          primary_ip6_address:
            default: null
            description:
            - Set primary switch IPv6 address of remote site.
            required: false
            type: str
          primary_ip_ver:
            choices:
            - ipv4
            - ipv6
            default: null
            description:
            - Set primary switch IP address of remote site.
            required: false
          secondary_ip4_address:
            default: null
            description:
            - Set secondary switch IPv4 address of remote site.
            required: false
            type: str
          secondary_ip6_address:
            default: null
            description:
            - Set secondary switch IPv6 address of remote site.
            required: false
            type: str
          secondary_ip_ver:
            choices:
            - ipv4
            - ipv6
            default: null
            description:
            - Set secondary switch IP address version of remote site.
            required: false
          site_update_state:
            choices:
            - enabled
            - disabled
            default: null
            description:
            - Enable/disable remote site updates.
            required: false
          state:
            choices:
            - enabled
            - disabled
            default: null
            description:
            - Enable/disable remote site state.
            required: false
      state:
        choices:
        - true
        - false
        default: null
        description:
        - Globally turn Global SLB ON/OFF.
        required: false

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

Outputs

obj:
  description: parameters object type
  returned: changed, read
  type: dictionary
status:
  description: Message detailing run result
  returned: success
  sample: object deployed successfully
  type: str