lvg – Configure LVM volume groups
Synopsis
- This module creates, removes or resizes volume groups.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
force boolean |
| 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 - |
| 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
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
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