diff options
author | David Teigland <teigland@redhat.com> | 2020-06-11 17:01:01 -0500 |
---|---|---|
committer | David Teigland <teigland@redhat.com> | 2020-06-22 11:24:02 -0500 |
commit | 3bd9d81b29fb8ba490d87b3557861bf00047855d (patch) | |
tree | 30e89ce5301993cc6269a341cb5416a17c57f6e2 | |
parent | ae5634a8be3eedb556325a4b81540896fa6cac16 (diff) | |
download | lvm2-3bd9d81b29fb8ba490d87b3557861bf00047855d.tar.gz |
man: lvmcache info about cachedevice usage
-rw-r--r-- | man/lvmcache.7_main | 30 |
1 files changed, 28 insertions, 2 deletions
diff --git a/man/lvmcache.7_main b/man/lvmcache.7_main index 425904e4a..244ea1e48 100644 --- a/man/lvmcache.7_main +++ b/man/lvmcache.7_main @@ -34,8 +34,6 @@ LVM refers to this using the LV type \fBwritecache\fP. .SH USAGE -Both kinds of caching use similar lvm commands: - .B 1. Identify main LV that needs caching The main LV may already exist, and is located on larger, slower devices. @@ -133,6 +131,22 @@ attached. main vg -wi------- linear /dev/slow_hhd .fi +.SS Create a new LV with caching. + +A new LV can be created with caching attached at the time of creation +using the following command: + +.nf +$ lvcreate --type cache|writecache -n Name -L Size + --cachedevice /dev/fast_ssd vg /dev/slow_hhd +.fi + +The main LV is created with the specified Name and Size from the slow_hhd. +A hidden fast LV is created on the fast_ssd and is then attached to the +new main LV. If the fast_ssd is unused, the entire disk will be used as +the cache unless the --cachesize option is used to specify a size for the +fast LV. The --cachedevice option can be repeated to use multiple disks +for the fast LV. .SH OPTIONS @@ -162,6 +176,18 @@ that cannot be used directly. If a standard LV is passed with this option, lvm will first convert it to a cache pool by combining it with another LV to use for metadata. This option can be used with dm-cache. +.B --cachedevice +.I PV +.br + +This option can be used in place of --cachevol, in which case a cachevol +LV will be created using the specified device. This option can be +repeated to create a cachevol using multiple devices, or a tag name can be +specified in which case the cachevol will be created using any of the +devices with the given tag. If a named cache device is unused, the entire +device will be used to create the cachevol. To create a cachevol of a +specific size from the cache devices, include the --cachesize option. + \& .SS dm-cache block size |