# salt.states.lvm

## Management of Linux logical volumes

A state module to manage LVMs

    /dev/sda:
      lvm.pv_present

    my_vg:
      lvm.vg_present:
        - devices: /dev/sda

    lvroot:
      lvm.lv_present:
        - vgname: my_vg
        - size: 10G
        - stripes: 5
        - stripesize: 8K

salt.states.lvm.lv_absent(name, vgname=None)

  Remove a given existing Logical Volume from a named existing volume group

  name

    The Logical Volume to remove

  vgname

    The name of the Volume Group on which the Logical Volume resides

salt.states.lvm.lv_present(name, vgname=None, size=None, extents=None, snapshot=None, pv='', thinvolume=False, thinpool=False, force=False, resizefs=False, **kwargs)

  Ensure that a Logical Volume is present, creating it if absent.

  name

    The name of the Logical Volume

  vgname

    The name of the Volume Group on which the Logical Volume resides

  size

    The size of the Logical Volume in megabytes, or use a suffix such as S, M, G, T, P for 512 byte sectors, megabytes, gigabytes or terabytes respectively. The suffix is case insensitive.

  extents

    The number of logical extents allocated to the Logical Volume It can be a percentage allowed by lvcreate's syntax, in this case it will set the Logical Volume initial size and won't be resized.

  snapshot

    The name of the snapshot

  pv

    The Physical Volume to use

  kwargs

    Any supported options to lvcreate. See `linux_lvm` for more details.

  Added in version 2016.11.0.

  thinvolume

    Logical Volume is thinly provisioned

  thinpool

    Logical Volume is a thin pool

  Added in version 2018.3.0.

  force

    Assume yes to all prompts

  Added in version 3002.

  resizefs

    Use fsadm to resize the logical volume filesystem if needed

salt.states.lvm.pv_absent(name)

  Ensure that a Physical Device is not being used by lvm

  name

    The device name to initialize.

salt.states.lvm.pv_present(name, **kwargs)

  Set a Physical Device to be used as an LVM Physical Volume

  name

    The device name to initialize.

  kwargs

    Any supported options to pvcreate. See `linux_lvm` for more details.

salt.states.lvm.vg_absent(name)

  Remove an LVM volume group

  name

    The volume group to remove

salt.states.lvm.vg_present(name, devices=None, **kwargs)

  Create an LVM Volume Group

  name

    The Volume Group name to create

  devices

    A list of devices that will be added to the Volume Group

  kwargs

    Any supported options to vgcreate. See `linux_lvm` for more details.