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

Note

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

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.

DEPRECATED
Synopsis
Parameters
Attributes
Notes
Examples
Status

DEPRECATED

Removed in:: version 15.0.0
Why:: The module is not actively maintained.
Alternative:: Use ibm.power_aix.lvg instead. See https://ibm.github.io/ansible-power-aix/modules/lvg.html for details.

Synopsis

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

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 is 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	Returns details on what has changed (or possibly needs changing in `check_mode`), when in diff mode.

Notes

Note

AIX allows removing 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

Status

This module will be removed in version 15.0.0. [deprecated]
For more information see DEPRECATED.

Authors

Kairo Araujo (@kairoaraujo)

Collection links

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/aix_lvg_module.html