lvg – Configure LVM volume groups

From Get docs
Ansible/docs/2.7/modules/lvg module


lvg – Configure LVM volume groups

Synopsis

  • This module creates, removes or resizes volume groups.

Parameters

Parameter Choices/Defaults Comments

force

boolean

  • no

  • yes

If yes, allows to remove volume group with logical volumes.

pesize

-

Default:

4

The size of the physical extent. pesize must be a power of 2, or multiple of 128KiB. Since version 2.6, pesize can be optionally suffixed by a UNIT (k/K/m/M/g/G), default unit is megabyte.

pv_options

-

added in 2.4

Additional options to pass to pvcreate when creating the volume group.

pvs

-

List of comma-separated devices to use as physical devices in this volume group. Required when creating or resizing volume group.

The module will take care of running pvcreate if needed.

state

-

  • absent
  • present

Control if the volume group exists.

vg

- / required

The name of the volume group.

vg_options

-

added in 1.6

Additional options to pass to vgcreate when creating the volume group.



Notes

Note

  • This module does not modify PE size for already present volume group.


Examples

- name: Create a volume group on top of /dev/sda1 with physical extent size = 32MB
  lvg:
    vg: vg.services
    pvs: /dev/sda1
    pesize: 32

- name: Create a volume group on top of /dev/sdb with physical extent size = 128KiB
  lvg:
    vg: vg.services
    pvs: /dev/sdb
    pesize: 128K

# If, for example, we already have VG vg.services on top of /dev/sdb1,
# this VG will be extended by /dev/sdc5.  Or if vg.services was created on
# top of /dev/sda5, we first extend it with /dev/sdb1 and /dev/sdc5,
# and then reduce by /dev/sda5.
- name: Create or resize a volume group on top of /dev/sdb1 and /dev/sdc5.
  lvg:
    vg: vg.services
    pvs: /dev/sdb1,/dev/sdc5

- name: Remove a volume group with name vg.services
  lvg:
    vg: vg.services
    state: absent

Status

Authors

  • Alexander Bulimov (@abulimov)

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/lvg_module.html