Manages LVM thin pools (which are simply logical volumes created with the --thinpool
argument to lvcreate
).
Action | Description |
---|---|
:create |
(default) Create a new thin pool logical volume |
:resize |
Resize an existing thin pool logical volume (resizing only handles extending existing, this action will not shrink volumes due to the lvextend command being passed) |
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 thin pool 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 |
thin_volume |
Proc | nil |
Shortcut for creating a new lvm_thin_volume definition (the volumes will be created in the order they are declared) |
If using a Hash, it must contain the following keys:
location
- (required) the directory to mount the volume onoptions
- the mount options for the volumedump
- the dump field for the fstab entrypass
- the pass field for the fstab entry
lvm_thin_pool 'home' do
group 'vg00'
size '25%VG'
filesystem 'ext4'
mount_point '/home'
stripes 3
mirrors 2
end