enfence.powerha_aix.cluster (1.3.2) — module

Install collection

Install with ansible-galaxy collection install enfence.powerha_aix:==1.3.2

Add to requirements.yml

  collections:
    - name: enfence.powerha_aix
      version: 1.3.2

Description

This module creates/deletes/starts or stops a PowerHA cluster. Depending on the state different set of attributes are required.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

# create a new cluster if it doesn't exist
- name: create a new cluster
  enfence.powerha_aix.cluster:
    name: cluster1
    state: present
    nodes:
      - node1
      - node2
    repos:
      - hdisk2
      - hdisk3

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: delete an existing cluster
  enfence.powerha_aix.cluster:
    name: cluster1
    state: absent

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: start cluster
  enfence.powerha_aix.cluster:
    name: cluster1
    state: started

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: stop cluster
  enfence.powerha_aix.cluster:
    name: cluster1
    state: stopped

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: synchronize cluster
  enfence.powerha_aix.cluster:
    name: cluster1
    fix: true
    state: synced

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: bring cluster apps in unmanaged state
  enfence.powerha_aix.cluster:
    name: cluster1
    state: stopped
    manage: unmanage

Inputs

    
caa:
    description:
    - Should CAA be started prior to the cluster start or stopped after cluster stop.
    - Can be used only if C(state) I(started) or I(stopped).
    required: false
    type: bool

fix:
    description: automatically fix errors during synchronization
    required: false
    type: bool

name:
    description: name of the cluster.
    required: true
    type: str

type:
    choices:
    - nsc
    - sc
    - lc
    default: nsc
    description:
    - type of the cluster. used only when the cluster is created
    - added in 1.1.1
    required: false
    type: str

when:
    choices:
    - now
    - restart
    - both
    description:
    - Taking the cluster online or offline, should be it done only I(now), at I(restart)
      or I(both) - now and at restart.
    - Can be used only if C(state) I(started) or I(stopped).
    required: false
    type: str

nodes:
    description: list of nodes to be in the cluster. used only when the cluster is created
    elements: str
    required: false
    type: list

repos:
    aliases:
    - repo
    - repository
    - repositories
    description: list of repository disks. used only when the cluster is created
    elements: str
    required: false
    type: list

state:
    choices:
    - present
    - absent
    - started
    - stopped
    - synced
    description: the desired state of the cluster - present, absent, started, stopped,
      synced
    required: true
    type: str

manage:
    choices:
    - auto
    - manual
    - delayed
    - offline
    - move
    - unmanage
    description:
    - What to do with resource groups if the cluser is going online or offline.
    - Can be used only if C(state) I(started) or I(stopped).
    - If C(state) is I(started) the following values are possible - I(auto), I(manual),
      I(delayed).
    - If C(state) is I(stopped) the following values are possible - I(offline), I(move),
      I(unmanage).
    required: false
    type: str

timeout:
    description:
    - Number of seconds to wait till the operation completes.
    - Can be used only if C(state) I(started) or I(stopped).
    required: false
    type: int

broadcast:
    description:
    - Broadcast information about changing cluster state to all logged in users.
    - Can be used only if C(state) I(started) or I(stopped).
    required: false
    type: bool

clusterip:
    aliases:
    - cluster_ip
    description: cluster ip for heartbeating.
    required: false
    type: str

heartbeat:
    choices:
    - unicast
    - multicast
    default: unicast
    description:
    - hearbeat type for the cluster. used only when the cluster is created
    - added in 1.1.1
    required: false
    type: str

lpm_policy:
    choices:
    - manage
    - unmanage
    description: .
    required: false
    type: str

grace_period:
    description: .
    required: false
    type: str

temp_hostname:
    choices:
    - allow
    - disallow
    description: .
    required: false
    type: str

caa_repos_mode:
    choices:
    - assert
    - event
    description: .
    required: false
    type: str

max_event_time:
    description: .
    required: false
    type: int

fc_sync_interval:
    description: .
    required: false
    type: int

rg_settling_time:
    description: .
    required: false
    type: int

caa_auto_start_dr:
    description: .
    required: false
    type: bool

site_grace_period:
    description: .
    required: false
    type: str

verification_node:
    description: .
    required: false
    type: str

caa_config_timeout:
    description: .
    required: false
    type: int

daily_verification:
    description: .
    required: false
    type: bool

lvm_preferred_read:
    choices:
    - roundrobin
    - favorcopy
    - siteaffinity
    description: .
    required: false
    type: str

heartbeat_frequency:
    description: .
    required: false
    type: str

site_heartbeat_cycle:
    description: .
    required: false
    type: str

caa_pvm_watchdog_timer:
    choices:
    - disable
    - dump_restart
    - hard_reset
    - hard_power_off
    description: .
    required: false
    type: str

max_rg_processing_time:
    description: .
    required: false
    type: int

verification_debugging:
    description: .
    required: false
    type: bool

site_policy_notify_method:
    description: .
    required: false
    type: path

site_policy_failure_action:
    choices:
    - fallover
    - notify
    description: .
    required: false
    type: str

heartbeat_frequency_during_lpm:
    description: .
    required: false
    type: int

network_failure_detection_time:
    description: .
    required: false
    type: int

crit_daemon_restart_grace_period:
    description: .
    required: false
    type: int

skip_event_processing_manage_node:
    description: .
    required: false
    type: bool

Outputs

changed:
  description: set to true if the resource was changed
  returned: always
  type: bool
msg:
  description: error and informational messages
  returned: always
  type: str
rc:
  description: return code of the last executed command
  returned: always
  type: int
stderr:
  description: standard error of the last executed command
  returned: always
  type: str
stdout:
  description: standard output of the last executed command
  returned: always
  type: str