enfence.powerha_aix.rg (1.3.2) — module

manage resource groups in PowerHA cluster

| "added in version" 1.0.0 of enfence.powerha_aix"

Authors: Andrey Klyachkin (@aklyachkin)

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 or deletes resource group in PowerHA cluster.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# create a new resource group
- name: create a new resource group
  enfence.powerha_aix.rg:
    name: rg_oracle
    nodes:
      - node1
      - node2
    startup: OHN
    fallover: FNPN
    fallback: NFB
    service: ['serviceip']
    application: ['ac_ora']
    volgrp:
      - vg01
      - vg02
      - vg03
    state: present
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# bring resource group online
- name: starting resource group
  enfence.powerha_aix.rg:
    name: rg_oracle
    state: started
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# bring resource group offline
- name: stopping resource group
  enfence.powerha_aix.rg:
    name: rg_oracle
    state: stopped
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# delete an existing resource group
- name: delete an existing resource group
  enfence.powerha_aix.rg:
    name: rg_oracle
    state: absent

Inputs

    
fs:
    aliases:
    - filesystem
    - filesystems
    description: .
    elements: str
    required: false
    type: list

disk:
    aliases:
    - disks
    description: .
    elements: str
    required: false
    type: list

name:
    description: name of the resource group.
    required: true
    type: str

tape:
    aliases:
    - shared_tape
    - shared_tape_resources
    description: .
    elements: str
    required: false
    type: list

wpar:
    aliases:
    - wpar_name
    description: .
    required: false
    type: str

nodes:
    description: list of the nodes where the resource group can be started. required if
      resource group is created.
    elements: str
    required: false
    type: list

state:
    choices:
    - present
    - absent
    - started
    - stopped
    - online
    - offline
    default: present
    description:
    - the desired state of the resource - C(present), C(absent), C(started), C(stopped).
    - If the resource is already defined, it will not be changed.
    required: false
    type: str

volgrp:
    aliases:
    - vg
    - volume_group
    description: list of volume groups for the resource group.
    elements: str
    required: false
    type: list

service:
    aliases:
    - service_ip
    - service_label
    description: list of service labels for the resource group.
    elements: str
    required: false
    type: list

startup:
    aliases:
    - start
    choices:
    - OHN
    - OFAN
    - OAAN
    - OUDP
    description:
    - startup policy for the resource group. One of C(OHN), C(OFAN), C(OAAN), or C(OUDP).
    - C(OHN) - Online Home Node (default).
    - C(OFAN) - Online on First Available Node.
    - C(OAAN) - Online on All Available Nodes (concurrent).
    - C(OUDP) - Online Using Node Distribution Policy.
    required: false
    type: str

fallback:
    choices:
    - NFB
    - FBHPN
    description:
    - fallback policy for the resource group. One of C(NFB), or C(FBHPN).
    - C(NFB) - Never Fallback.
    - C(FBHPN) - Fallback to Higher Priority Node (default).
    required: false
    type: str

fallover:
    choices:
    - FNPN
    - FUDNP
    - BO
    description:
    - fallover policy for the resource group. One of C(FNPN), C(FUDNP), or C(BO).
    - C(FNPN) - Fallover to Next Priority Node (default).
    - C(FUDNP) - Fallover Using Dynamic Node Priority.
    - C(BO) - Bring Offline (On Error Node Only).
    required: false
    type: str

secnodes:
    aliases:
    - secondary_nodes
    - secondarynodes
    description:
    - secondary nodes
    - added in 1.1.3
    elements: str
    required: false
    type: list

mount_nfs:
    aliases:
    - mount_fs
    - mount_filesystem
    description: .
    elements: str
    required: false
    type: list

export_nfs:
    aliases:
    - export_fs
    - export_filesystem
    description: .
    elements: str
    required: false
    type: list

sitepolicy:
    aliases:
    - site_policy
    choices:
    - ignore
    - primary
    - either
    - both
    description:
    - site policy
    - added in 1.1.3
    required: false
    type: str

application:
    aliases:
    - app
    - applications
    description: list of application controllers for the resource group.
    elements: str
    required: false
    type: list

export_nfs4:
    aliases:
    - export_fs4
    - export_fs_v4
    - export_filesystem_v4
    description: .
    elements: str
    required: false
    type: list

fallback_at:
    description: .
    required: false
    type: str

nfs_network:
    description: .
    required: false
    type: str

prio_policy:
    aliases:
    - node_priority_policy
    - priority_policy
    - priopolicy
    choices:
    - default
    - mem
    - disk
    - cpu
    - least
    - most
    description:
    - node priority policy, if fallover set to FUDNP. One of C(default), C(mem), C(disk),
      C(cpu), C(least), C(most)
    - C(default) - next node in the nodes list.
    - C(mem) - node with most available memory.
    - C(disk) - node with least disk activity.
    - C(cpu) - node with most cpu cycles available.
    - C(least) - node where the dynamic node priority script returns the lowest value.
    - C(most) - node where the dynamic node priority script returns the highest value.
    - added in 1.1.3
    required: false
    type: str

mirror_group:
    description: .
    required: false
    type: str

forced_varyon:
    description: .
    required: false
    type: bool

vg_auto_import:
    description: .
    required: false
    type: bool

fs_before_ipaddr:
    description: .
    required: false
    type: bool

prio_policy_script:
    aliases:
    - node_priority_policy_script
    - priority_policy_script
    description:
    - path to script to determine the C(prio_policy)
    - added in 1.1.3
    required: false
    type: path

prio_policy_timeout:
    aliases:
    - node_priority_policy_timeout
    - priority_policy_timeout
    description:
    - added in 1.1.3
    required: false
    type: int

stable_storage_path:
    description: .
    required: false
    type: str

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