community.general.aix_lvg module – Manage LVM volume groups on AIX

Note

This module is part of the community.general collection (version 8.6.8).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.aix_lvg.

Synopsis

  • This module creates, removes or resize volume groups on AIX LVM.

Aliases: system.aix_lvg

Parameters

Parameter

Comments

force

boolean

Force volume group creation.

Choices:

  • false ← (default)

  • true

pp_size

integer

The size of the physical partition in megabytes.

pvs

list / elements=string

List of comma-separated devices to use as physical devices in this volume group.

Required when creating or extending (present state) the volume group.

If not informed reducing (absent state) the volume group will be removed.

state

string

Control if the volume group exists and volume group AIX state varyonvg varyon or varyoffvg varyoff.

Choices:

  • "absent"

  • "present" ← (default)

  • "varyoff"

  • "varyon"

vg

string / required

The name of the volume group.

vg_type

string

The type of the volume group.

Choices:

  • "big"

  • "normal" ← (default)

  • "scalable"

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

  • AIX will permit remove VG only if all LV/Filesystems are not busy.

  • Module does not modify PP size for already present volume group.

Examples

- name: Create a volume group datavg
  community.general.aix_lvg:
    vg: datavg
    pp_size: 128
    vg_type: scalable
    state: present

- name: Removing a volume group datavg
  community.general.aix_lvg:
    vg: datavg
    state: absent

- name: Extending rootvg
  community.general.aix_lvg:
    vg: rootvg
    pvs: hdisk1
    state: present

- name: Reducing rootvg
  community.general.aix_lvg:
    vg: rootvg
    pvs: hdisk1
    state: absent

Authors

  • Kairo Araujo (@kairoaraujo)