Skip to content

Latest commit

 

History

History
65 lines (52 loc) · 5.31 KB

lvm_logical_volume.md

File metadata and controls

65 lines (52 loc) · 5.31 KB
Raw

lvm_logical_volume

Back to resource list

Manages LVM logical volumes.

Actions

Action Description
:create (default) Creates a new logical volume
:resize Resize an existing logical volume (resizing only handles extending existing, this action will not shrink volumes due to the 'lvextend' command being passed)
:remove Remove an existing logical volume (optionally clean up the mount location/directory)

Properties

Name Type Default Description
name String name property Name of the logical volume
group String (required) Volume group in which to create the new volume (not required if the volume is declared inside of an lvm_volume_group block)
size String (required) Size of the volume, including units (k, K, m, M, g, G, t, T) or as the percentage of the size of the volume group
filesystem String nil The format for the file system
filesystem_params String nil Optional parameters to use when formatting the file system
mount_point String, Hash nil Either a String containing the path to the mount point, or a Hash
physical_volumes String, Array [] Array of physical volumes that the volume will be restricted to
stripes Integer nil Number of stripes for the volume
stripe_size Integer nil Number of kilobytes per stripe segment (must be a power of 2 less than or equal to the physical extent size for the volume group)
mirrors Integer nil Number of mirrors for the volume
contiguous true, false false Whether or not volume should use the contiguous allocation policy
readahead Integer, String nil The readahead sector count for the volume (can be a value between 2 and 120, 'auto', or 'none')
take_up_free_space true, false false whether to have the LV take up the remainder of free space on the VG. Only valid for resize action
wipe_signatures true, false false Force the creation of the Logical Volume, even if lvm detects existing LV signatures
ignore_skipped_cluster true, false false Continue execution even if lvm detects skipped clustered volume groups
lv_params String nil Optional parameters to be passed to LVM
remove_mount_point true, false false Optional parameter to be passed to LVM during a :remove event to clean up the directory

mount_point

If using a Hash, it must contain the following keys:

  • location - (required) the directory to mount the volume on
  • options - the mount options for the volume
  • dump - the dump field for the fstab entry
  • pass - the pass field for the fstab entry

Examples

lvm_logical_volume 'home' do
  group       'vg00'
  size        '25%VG'
  filesystem  'ext4'
  mount_point '/home'
  stripes     3
  mirrors     2
end

lvm_logical_volume 'test' do
  group               'vg01'
  mount_point         '/mnt/test'
  remove_mount_point  true
  action              :remove
end