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

Note

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

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
Parameters
Attributes
Notes
Examples

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 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)

Collection links

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