shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2025-03-10 16:58:47 +03:00
Code Releases Activity

man: lvconvert new split options

Browse Source 
Update man page with info how to split/uncache cached logical
volumes.

lvconvert: splitsnapshot support --yes

Allow to use --yes to skip prompt.
This commit is contained in:
Zdenek Kabelac 2014-10-06 14:43:25 +02:00
parent cb49dd4aa4
commit fbf14b12d8
1 changed files with 65 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

86
man/lvconvert.8.in
View File

@ -32,6 +32,25 @@ lvconvert \(em convert a logical volume from linear to mirror or snapshot
.IR LogicalVolume [ Path ]
.RI [ PhysicalVolume [ Path ][ :PE [ \-PE ]]...]
.sp
.B lvconvert
.BR \-\-split
.RB [ \-\-commandprofile
.IR ProfileName ]
.RB [ \-h | \-? | \-\-help ]
.RB [ \-\-noudevsync ]
.RB [ \-v | \-\-verbose ]
.IR SplitableLogicalVolume { Name | Path }
.sp
.B lvconvert
.BR \-\-splitcache | \-\-uncache
.RB [ \-\-commandprofile
.IR ProfileName ]
.RB [ \-h | \-? | \-\-help ]
.RB [ \-\-noudevsync ]
.RB [ \-v | \-\-verbose ]
.RB [ \-\-version ]
.IR CacheLogicalVolume { Name | Path }
.sp
.B lvconvert \-\-splitmirrors \fIImages
.RB [ \-\-name
.IR SplitLogicalVolumeName ]
@ -122,20 +141,20 @@ lvconvert \(em convert a logical volume from linear to mirror or snapshot
.RB [ \-\-poolmetadataspare
.RI { y | n }]
.RB [ \-Z | \-\-zero \ { \fIy | \fIn }]]
.RI [[ ExternalOrigin | ThinPool ] LogicalVolume { Name | Path }]
.RI [ PhysicalVolume [ Path ][ :PE
.RI [ \-PE ]]...]
.RB [ \-\-commandprofile
.IR ProfileName ]
.RB [ \-h | \-? | \-\-help ]
.RB [ \-v | \-\-verbose ]
.RB [ \-\-version ]
.RI [[ ExternalOrigin | ThinPool ] LogicalVolume { Name | Path }]
.RI [ PhysicalVolume [ Path ][ :PE
.RI [ \-PE ]]...]
.sp
.B lvconvert
.RB [ \-\-type
.BR \fIcache [ \fI\-pool ]| \-\-cache ]
.BR \fIcache [ \fI\-pool ]| \-H | \-\-cache ]
.RB [ \-\-cachepool
.IR CachePoolLV { Name | Path }]
.IR CachePoolLogicalVolume { Name | Path }]
.RB [ \-c | \-\-chunksize
.IR ChunkSize [ bBsSkKmMgG ]]
.RB [ \-\-cachemode
@ -147,13 +166,13 @@ lvconvert \(em convert a logical volume from linear to mirror or snapshot
.IR CachePoolMetadataSize [ bBsSkKmMgG ]}]
.RB [ \-\-poolmetadataspare
.RI { y | n }]
.IR LogicalVolume { Name | Path }
.RI [ PhysicalVolume [ Path ][ :PE [ \-PE ]]...]
.RB [ \-\-commandprofile
.IR ProfileName ]
.RB [ \-h | \-? | \-\-help ]
.RB [ \-v | \-\-verbose ]
.RB [ \-\-version ]
.IR LogicalVolume { Name | Path }
.RI [ PhysicalVolume [ Path ][ :PE [ \-PE ]]...]
.sp
.SH DESCRIPTION
@ -181,18 +200,21 @@ Exactly one of
.BR \-\-mirrors ,
.BR \-\-repair ,
.BR \-\-replace ,
.BR \-\-splitsnapshot ,
.BR \-\-snapshot ,
.BR \-\-split ,
.BR \-\-splitcache ,
.BR \-\-splitsnapshot ,
.BR \-\-splitmirrors ,
.BR \-\-thin
or
.BR \-\-thin ,
.BR \-\-type
or
.BR \-\-uncache
arguments is required.
.TP
.BR \-b ", " \-\-background
Run the daemon in the background.
.TP
.BR \-\-cache ", " \-\-type\ \fIcache
.BR \-H ", " \-\-cache ", " \-\-type\ \fIcache
Converts logical volume to a cached LV with the use of cache pool
specified with \fB\-\-cachepool\fP.
For more information on cache pool LVs and cache LVs, see \fBlvmcache\fP(8).
@ -277,6 +299,19 @@ the data changed get resynchronized.
Please note that this feature is only supported with the new md-based mirror
implementation and not with the original device-mapper mirror implementation.
.TP
.B \-\-split
Separates \fISplitableLogicalVolume\fP.
Option is agregating various split commands and tries to detect necessary split
operation from its arguments.
.TP
.BR \-\-splitcache ", " \-\-uncache
Separates \fICacheLogicalVolume\fP from cache pool.
Before volume becomes uncached, cache is flushed.
With \-\-split the cache pool volume is then left unused and
could be i.e. used for caching other volumes.
The inverse of \-\-cache is \-\-uncache where the cache pool
component volumes are automatically removed.
.TP
.B \-\-splitsnapshot
Separates \fISnapshotLogicalVolume\fP from its origin.
The volume that is split off contains the chunks that differ from the origin
@ -347,7 +382,7 @@ Without this option a default name of "lvol<n>" will be generated where
This volume will be read-only and cannot be further modified as long,
as it is being used as the external origin.
.TP
.BR \-\-poolmetadata " " \fIThinPoolMetadataLogicalVolume { \fIName | \fIPath }
.BR \-\-poolmetadata " " \fIPoolMetadataLogicalVolume { \fIName | \fIPath }
Specifies cache or thin pool metadata logical volume.
The size should be in between 2MiB and 16GiB.
Cache pool is specified with the option
@ -369,12 +404,12 @@ thin provisioning tools
and
.BR thin_restore (8).
.TP
.BR \-\-poolmetadatasize " " \fIThinPoolMetadataSize [ \fIbBsSkKmMgG ]
Sets the size of thin pool's metadata logical volume,
.BR \-\-poolmetadatasize " " \fIPoolMetadataSize [ \fIbBsSkKmMgG ]
Sets the size of cache or thin pool's metadata logical volume,
if the pool metadata volume is undefined.
Thin pool is specified with the option
\fB\-\-thinpool\fP.
Supported value is in the range between 2MiB and 16GiB.
Pool is specified with the option
\B\-\-cachepool\P or \fB\-\-thinpool\fP.
For thin pool supported value is in the range between 2MiB and 16GiB.
The default value is estimated with this formula
(Pool_LV_size / Pool_LV_chunk_size * 64b).
Default unit is megabytes.
@ -554,11 +589,20 @@ given cache metadata LV.
.B lvconvert \-\-type cache-pool \-\-poolmetadata vg00/lvx_meta vg00/lvx_data
.br
.B lvrename vg00/lvx_data vg00/lvx_cachepool
Convert an existing logical volume to a cache LV using the given
cache pool LV.
.sp
.B lvconvert \-\-cache \-\-cachepool vg00/lvx_cachepool vg00/lvx
Convert an existing logical volume to a cache LV using the given
cache pool LV and chunk size 128KiB.
.sp
.B lvconvert \-\-cache \-\-cachepool vg00/lvx_cachepool -c 128 vg00/lvx
.sp
Detach cache pool from an existing cached logical volume "vg00/lvol1" and
leave cache pool unused.
.sp
.B lvconvert \-\-splitcache vg00/lvol1
.sp
Drop cache pool from an existing cached logical volume "vg00/lvol1".
.sp
.B lvconvert \-\-uncache vg00/lvol1
.SH SEE ALSO
.BR lvm (8),