'; // Create a banner if we're not on the official docs site if (location.host == "docs.testing.ansible.com") { document.write('

' + '

This is the testing site for Ansible Documentation. Unless you are reviewing pre-production changes, please visit the official documentation website.

' + '

'); } // Create a banner current_url_path = window.location.pathname; var important = false; var msg = '

'; if (startsWith(current_url_path, "/ansible-core/")) { msg += 'You are reading documentation for Ansible Core, which contains no plugins except for those in ansible.builtin. For documentation of the Ansible package, go to the latest documentation.'; } else if (startsWithOneOf(current_url_path, ["/ansible/latest/", "/ansible/11/"])) { /* temp extra banner to advertise something */ banner += extra_banner; msg += 'This is the latest (stable) Ansible community documentation. For Red Hat Ansible Automation Platform subscriptions, see Life Cycle for version details.'; } else if (startsWith(current_url_path, "/ansible/2.9/")) { msg += 'You are reading the latest Red Hat released version of the Ansible documentation. Community users can use this version, or select latest from the version selector to the left for the most recent community version.'; } else if (startsWith(current_url_path, "/ansible/devel/")) { /* temp extra banner to advertise something */ banner += extra_banner; msg += 'You are reading the devel version of the Ansible documentation - this version is not guaranteed stable. Use the version selection to the left if you want the latest (stable) released version.'; } else { msg += 'You are reading an older version of the Ansible documentation. Use the version selection to the left if you want the latest (stable) released version.'; /* temp extra banner to advertise something - this is for testing*/ banner += extra_banner; } msg += '

'; banner += '

'; banner += important ? '
' : ''; banner += msg; banner += important ? '
' : ''; banner += '

'; document.write(banner);

community.general.lvg module – Configure LVM volume groups

Note

This module is part of the community.general collection (version 10.7.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.lvg.

Synopsis 

This module creates, removes or resizes volume groups.

Parameters 

Parameter	Comments
force boolean	If `true`, allows to remove volume group with logical volumes. Choices: `false` ← (default) `true`
pesize string	The size of the physical extent. `pesize` must be a power of 2 of at least 1 sector (where the sector size is the largest sector size of the PVs currently used in the VG), or at least 128KiB. `pesize` can be optionally suffixed by a UNIT (k/K/m/M/g/G), default unit is megabyte. Default: `"4"`
pv_options string	Additional options to pass to `pvcreate` when creating the volume group. Default: `""`
pvresize boolean added in community.general 0.2.0	If `true`, resize the physical volume to the maximum available size. Choices: `false` ← (default) `true`
pvs list / elements=string	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. `remove_extra_pvs` controls whether or not unspecified physical devices are removed from the volume group.
remove_extra_pvs boolean added in community.general 10.4.0	Remove physical volumes from the volume group which are not in `pvs`. Choices: `false` `true` ← (default)
reset_pv_uuid boolean added in community.general 7.1.0	Whether the volume group’s physical volumes’ UUIDs are regenerated. This is not idempotent. Specifying this parameter always results in a change. Choices: `false` ← (default) `true`
reset_vg_uuid boolean added in community.general 7.1.0	Whether the volume group’s UUID is regenerated. This is not idempotent. Specifying this parameter always results in a change. Choices: `false` ← (default) `true`
state string	Control if the volume group exists and its state. The states `active` and `inactive` implies `present` state. Added in 7.1.0. If `active` or `inactive`, the module manages the VG’s logical volumes current state. The module also handles the VG’s autoactivation state if supported unless when creating a volume group and the autoactivation option specified in `vg_options`. Choices: `"absent"` `"present"` ← (default) `"active"` `"inactive"`
vg string / required	The name of the volume group.
vg_options string	Additional options to pass to `vgcreate` when creating the volume group. Default: `""`

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

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
  community.general.lvg:
    vg: vg.services
    pvs: /dev/sda1
    pesize: 32

- name: Create a volume group on top of /dev/sdb with physical extent size = 128KiB
  community.general.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.
  community.general.lvg:
    vg: vg.services
    pvs: /dev/sdb1,/dev/sdc5

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

- name: Create a volume group on top of /dev/sda3 and resize the volume group /dev/sda3 to the maximum possible
  community.general.lvg:
    vg: resizableVG
    pvs: /dev/sda3
    pvresize: true

- name: Deactivate a volume group
  community.general.lvg:
    state: inactive
    vg: vg.services

- name: Activate a volume group
  community.general.lvg:
    state: active
    vg: vg.services

- name: Reset a volume group UUID
  community.general.lvg:
    state: inactive
    vg: vg.services
    reset_vg_uuid: true

- name: Reset both volume group and pv UUID
  community.general.lvg:
    state: inactive
    vg: vg.services
    pvs: /dev/sdb1,/dev/sdc5
    reset_vg_uuid: true
    reset_pv_uuid: true

Authors

Alexander Bulimov (@abulimov)

community.general.lvg module – Configure LVM volume groups

Synopsis 

Parameters 

Attributes 

Notes 

See Also 

Examples 

Authors

Collection links

community.general.lvg module – Configure LVM volume groups

Synopsis

Parameters

Attributes

Notes

See Also

Examples

Authors

Collection links

Synopsis 

Parameters 

Attributes 

Notes 

See Also 

Examples 