enfence.powerha_aix.vg (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/changes volume_group resource in PowerHA cluster.

This module was added in 1.1.3.

Usage examples

Scanned by Steampunk Spotter

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

# find a disk with LDEV 25B6 and create vg01 on it
- name: find disk for vg01
  enfence.powerha_aix.pv_info:
    ldev: 25B6
  register: hdisk

Scanned by Steampunk Spotter

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

- name: stop if the hdisk is not found
  ansible.builtin.fail:
    msg: hdisk for the volume group is not found
  when: hdisk.pv | length == 0

Scanned by Steampunk Spotter

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

- name: create shared volume group
  enfence.powerha_aix.vg:
    name: vg01
    nodes:
      - node1
      - node2
    volumes: "{{ hdisk.pv }}"
    rg: rg_oracle

Scanned by Steampunk Spotter

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

# delete volume group vg01
- name: delete vg01
  enfence.powerha_aix.vg:
    name: vg01
    state: absent

Inputs

    
mp:
    aliases:
    - mirror_pool
    - mirror_pool_name
    description: the name of the mirror pool.
    required: false
    type: str

rg:
    aliases:
    - resource_group
    description:
    - resource group for the volume group.
    - required if state is C(rgadd) or C(rgremove).
    required: false
    type: str

ltg:
    aliases:
    - ltg_size
    choices:
    - 128
    - 256
    - 512
    - 1024
    description: logical track group size.
    required: false
    type: int

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

type:
    choices:
    - original
    - big
    - scalable
    - legacy
    default: scalable
    description: volume group type.
    required: false
    type: str

major:
    aliases:
    - major_number
    - number
    description: major number of the volume group device.
    required: false
    type: int

nodes:
    description:
    - list of nodes where volume group can be activated.
    - required if the state is C(present).
    elements: str
    required: false
    type: list

state:
    choices:
    - present
    - absent
    - rgadd
    - rgremove
    default: present
    description:
    - the desired state of the volume group - C(present), C(absent).
    - additional states C(rgadd) and C(rgremove) to add and remove the volume group from
      a resource group.
    required: false
    type: str

max_lv:
    aliases:
    - maxlv
    - max_logical_volumes
    choices:
    - 256
    - 512
    - 1024
    - 2048
    - 4096
    description: maximum number of logical volumes in the volume group.
    required: false
    type: int

max_pp:
    aliases:
    - maxpp
    - max_physical_partitions
    choices:
    - 32
    - 64
    - 128
    - 256
    - 512
    - 768
    - 1024
    description: maximum number of physical partitions in the volume group.
    required: false
    type: int

notify:
    aliases:
    - notify_method
    - notifymethod
    description: script to call if the C(on_failure) action is C(notify).
    required: false
    type: path

quorum:
    aliases:
    - quorum_needed
    description: if the volume group must be automatically varied off after losing its
      quorum of physical volumes.
    required: false
    type: bool

pp_size:
    aliases:
    - ppart_size
    - ppsize
    - pp
    choices:
    - 1
    - 2
    - 4
    - 8
    - 16
    - 32
    - 64
    - 128
    - 256
    - 512
    - 1024
    description: size of the physical partition in MB.
    required: false
    type: int

volumes:
    aliases:
    - physical_volumes
    - pv
    - pvs
    - volume
    description:
    - list of physical volumes to add into the volume group.
    - required if the state is C(present).
    elements: str
    required: false
    type: list

critical:
    description: enable critical vg flag on the volume group.
    required: false
    type: bool

strict_mp:
    aliases:
    - strict_mirror_pools
    choices:
    - 'yes'
    - 'no'
    - super
    description:
    - enable mirror pool strictness on the volume group.
    - C(no) means disable mirror pool strictness.
    - C(yes) means mirror pools must be used.
    - C(super) means mirror pools will be enforced.
    required: false
    type: str

encryption:
    aliases:
    - lv_encryption
    - enable_lv_encryption
    description: enalbe LV encryption on the volume group
    required: false
    type: bool

on_failure:
    aliases:
    - failureaction
    - failure_action
    choices:
    - halt
    - notify
    - fence
    - stoprg
    - moverg
    description: action on failure of the critical volume group.
    required: false
    type: str

preferred_read:
    aliases:
    - lvm_preferred_read
    - prefered_read
    - lvm_prefered_read
    choices:
    - roundrobin
    - favorcopy
    - siteaffinity
    description: read preference to the copy of logical volumes.
    required: false
    type: str

activate_on_restart:
    description: activate the volume group on system startup.
    required: false
    type: bool

migrate_failed_disks:
    choices:
    - 'false'
    - one
    - pool
    - remove
    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