2008-10-08 16:50:13 +04:00
.TH LVCONVERT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc" \" -*- nroff -*-
2006-08-19 01:49:19 +04:00
.SH NAME
2014-06-11 13:06:30 +04:00
lvconvert \(em convert a logical volume from linear to mirror or snapshot
2006-08-19 01:49:19 +04:00
.SH SYNOPSIS
.B lvconvert
2012-04-11 16:42:10 +04:00
.BR \- m | \- \- mirrors
.I Mirrors
2014-07-08 00:28:43 +04:00
.RB [ \- \- type
.IR SegmentType ]
2012-04-11 16:42:10 +04:00
.RB [ \- \- mirrorlog
.RI { disk | core | mirrored }]
.RB [ \- \- corelog ]
.RB [ \- R | \- \- regionsize
.IR MirrorLogRegionSize ]
2014-07-08 00:28:43 +04:00
.RB [ \- \- stripes
.I Stripes
.RB [ \- I | \- \- stripesize
.IR StripeSize ]]
2012-04-11 16:42:10 +04:00
.RB [ \- A | \- \- alloc
.IR AllocationPolicy ]
.RB [ \- b | \- \- background ]
.RB [ \- f | \- \- force ]
.RB [ \- i | \- \- interval
.IR Seconds ]
2014-07-08 00:28:43 +04:00
.RB [ \- \- commandprofile
.IR ProfileName ]
2012-04-11 16:42:10 +04:00
.RB [ \- h | \- ? | \- \- help ]
.RB [ \- \- noudevsync ]
.RB [ \- v | \- \- verbose ]
.RB [ \- y | \- \- yes ]
.RB [ \- \- version ]
.IR LogicalVolume [ Path ]
2014-06-11 13:06:30 +04:00
.RI [ PhysicalVolume [ Path ][ :PE [ \- PE ]]...]
2012-04-11 16:42:10 +04:00
.sp
2014-10-06 16:43:25 +04:00
.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
2012-04-11 16:42:10 +04:00
.B lvconvert \- \- splitmirrors \fI Images
.RB [ \- \- name
.IR SplitLogicalVolumeName ]
.RB [ \- \- trackchanges ]
.IR MirrorLogicalVolume [ Path ]
2014-07-08 00:28:43 +04:00
.RB [ \- \- commandprofile
.IR ProfileName ]
2014-06-11 13:06:30 +04:00
.RI [ SplittablePhysicalVolume [ Path ][ :PE [ \- PE ]]...]
2012-04-11 16:42:10 +04:00
.sp
2009-08-03 01:01:51 +04:00
.B lvconvert
2013-12-04 06:09:37 +04:00
.BR \- \- splitsnapshot
2014-05-21 16:53:56 +04:00
.RB [ \- \- commandprofile
.IR ProfileName ]
2013-12-04 06:09:37 +04:00
.RB [ \- h | \- ? | \- \- help ]
.RB [ \- \- noudevsync ]
.RB [ \- v | \- \- verbose ]
.RB [ \- \- version ]
.IR SnapshotLogicalVolume [ Path ]
.sp
.B lvconvert
2012-04-11 16:42:10 +04:00
.BR \- s | \- \- snapshot
.RB [ \- c | \- \- chunksize
2012-10-30 21:11:59 +04:00
.IR ChunkSize [ bBsSkK ]]
2014-07-08 00:28:43 +04:00
.RB [ \- Z | \- \- zero
.RI { y | n }]
.RB [ \- \- commandprofile
.IR ProfileName ]
2012-04-11 16:42:10 +04:00
.RB [ \- h | \- ? | \- \- help ]
.RB [ \- \- noudevsync ]
.RB [ \- v | \- \- verbose ]
.RB [ \- \- version ]
.IR OriginalLogicalVolume [ Path ]
.IR SnapshotLogicalVolume [ Path ]
.sp
.B lvconvert \- \- merge
.RB [ \- b | \- \- background ]
.RB [ \- i | \- \- interval
.IR Seconds ]
2014-07-08 00:28:43 +04:00
.RB [ \- \- commandprofile
.IR ProfileName ]
2012-04-11 16:42:10 +04:00
.RB [ \- h | \- ? | \- \- help ]
.RB [ \- v | \- \- verbose ]
.RB [ \- \- version ]
.IR LogicalVolume [ Path ]...
.sp
.B lvconvert \- \- repair
2012-12-11 18:50:25 +04:00
.RB [ \- \- stripes
.I Stripes
.RB [ \- I | \- \- stripesize
.IR StripeSize ]]
2014-07-08 00:28:43 +04:00
.RB [ \- \- commandprofile
.IR ProfileName ]
.RB [ \- h | \- ? | \- \- help ]
2012-04-11 16:42:10 +04:00
.RB [ \- v | \- \- verbose ]
.RB [ \- \- version ]
.IR LogicalVolume [ Path ]
.RI [ PhysicalVolume [ Path ]...]
.sp
.B lvconvert \- \- replace \fI PhysicalVolume
2014-05-21 16:53:56 +04:00
.RB [ \- \- commandprofile
.IR ProfileName ]
2012-04-11 16:42:10 +04:00
.RB [ \- h | \- ? | \- \- help ]
.RB [ \- v | \- \- verbose ]
.RB [ \- \- version ]
.IR LogicalVolume [ Path ]
.RI [ PhysicalVolume [ Path ]...]
2012-10-30 21:11:59 +04:00
.sp
2014-07-08 00:28:43 +04:00
.B lvconvert
2014-08-14 13:11:14 +04:00
.RB [{ \- \- type
.BR \fI thin [ \fI \- pool ]| \- T | \- \- thin }
2014-07-08 00:28:43 +04:00
.RB [ \- \- originname
.IR NewExternalOriginVolumeName ]]
.RB [ \- \- thinpool
2012-10-30 21:11:59 +04:00
.IR ThinPoolLogicalVolume { Name | Path }
.RB [ \- c | \- \- chunksize
.IR ChunkSize [ bBsSkKmMgG ]]
.RB [ \- \- discards
.RI { ignore | nopassdown | passdown }]
2014-03-26 17:04:44 +04:00
.RB [{ \- \- poolmetadata
.IR ThinPoolMetadataLogicalVolume { Name | Path }
2012-10-30 21:11:59 +04:00
|
2014-03-26 17:04:44 +04:00
.B \- \- poolmetadatasize
.IR ThinPoolMetadataSize [ bBsSkKmMgG ]}]
2012-10-30 21:11:59 +04:00
.RB [ \- r | \- \- readahead
.RI { ReadAheadSectors | auto | none }]
2014-07-08 00:28:43 +04:00
.RB [ \- \- stripes \ \fI Stripes
.RB [ \- I | \- \- stripesize \ \fI StripeSize ]]]
2014-07-22 19:31:22 +04:00
.RB [ \- \- poolmetadataspare
.RI { y | n }]
2014-07-08 00:28:43 +04:00
.RB [ \- Z | \- \- zero \ { \fI y | \fI n }]]
.RB [ \- \- commandprofile
.IR ProfileName ]
2013-04-05 14:24:32 +04:00
.RB [ \- h | \- ? | \- \- help ]
.RB [ \- v | \- \- verbose ]
.RB [ \- \- version ]
2014-10-06 16:43:25 +04:00
.RI [[ ExternalOrigin | ThinPool ] LogicalVolume { Name | Path }]
.RI [ PhysicalVolume [ Path ][ :PE
.RI [ \- PE ]]...]
2012-10-30 21:11:59 +04:00
.sp
2014-07-08 00:28:43 +04:00
.B lvconvert
2014-08-14 13:11:14 +04:00
.RB [ \- \- type
2014-10-06 16:43:25 +04:00
.BR \fI cache [ \fI \- pool ]| \- H | \- \- cache ]
2014-10-07 16:48:38 +04:00
.RB [{ \- \- cachepool
2014-10-06 16:43:25 +04:00
.IR CachePoolLogicalVolume { Name | Path }]
2014-10-07 16:48:38 +04:00
|
.B \- \- pooldatasize
.IR CachePoolMetadataSize [ bBsSkKmMgGtTpPeE ]}]
2014-02-12 20:29:07 +04:00
.RB [ \- c | \- \- chunksize
.IR ChunkSize [ bBsSkKmMgG ]]
.RB [ \- \- cachemode
.RI { writeback | writethrough }]
2014-03-26 17:04:44 +04:00
.RB [{ \- \- poolmetadata
.IR CachePoolMetadataLogicalVolume { Name | Path }
2014-02-12 20:29:07 +04:00
|
2014-03-26 17:04:44 +04:00
.B \- \- poolmetadatasize
.IR CachePoolMetadataSize [ bBsSkKmMgG ]}]
2014-07-22 19:31:22 +04:00
.RB [ \- \- poolmetadataspare
.RI { y | n }]
2014-05-21 16:53:56 +04:00
.RB [ \- \- commandprofile
.IR ProfileName ]
2014-02-12 20:29:07 +04:00
.RB [ \- h | \- ? | \- \- help ]
.RB [ \- v | \- \- verbose ]
.RB [ \- \- version ]
2014-10-06 16:43:25 +04:00
.IR LogicalVolume { Name | Path }
.RI [ PhysicalVolume [ Path ][ :PE [ \- PE ]]...]
2014-02-12 20:29:07 +04:00
.sp
2011-11-30 06:02:10 +04:00
2006-08-19 01:49:19 +04:00
.SH DESCRIPTION
2011-01-05 00:41:35 +03:00
lvconvert is used to change the segment type (i.e. linear, mirror, etc) or
characteristics of a logical volume. For example, it can add or remove the
redundant images of a logical volume, change the log type of a mirror, or
designate a logical volume as a snapshot repository.
2009-10-26 16:41:13 +03:00
.br
If the conversion requires allocation of physical extents (for
example, when converting from linear to mirror) and you specify
one or more PhysicalVolumes (optionally with ranges of physical
extents), allocation of physical extents will be restricted to
these physical extents. If the conversion frees physical extents
(for example, when converting from a mirror to a linear, or reducing
mirror legs) and you specify one or more PhysicalVolumes,
the freed extents come first from the specified PhysicalVolumes.
2006-08-19 01:49:19 +04:00
.SH OPTIONS
2012-04-11 16:42:10 +04:00
See \fB lvm\fP (8) for common options.
2007-01-10 17:13:46 +03:00
.br
2013-04-05 14:24:32 +04:00
Exactly one of
2014-07-08 00:28:43 +04:00
.BR \- \- cache ,
2014-07-11 16:09:32 +04:00
.BR \- \- corelog ,
2013-04-05 14:24:32 +04:00
.BR \- \- merge ,
2014-07-11 16:09:32 +04:00
.BR \- \- mirrorlog ,
2013-04-05 14:24:32 +04:00
.BR \- \- mirrors ,
.BR \- \- repair ,
.BR \- \- replace ,
.BR \- \- snapshot ,
2014-10-06 16:43:25 +04:00
.BR \- \- split ,
.BR \- \- splitcache ,
.BR \- \- splitsnapshot ,
2014-05-15 12:25:15 +04:00
.BR \- \- splitmirrors ,
2014-10-06 16:43:25 +04:00
.BR \- \- thin ,
2014-05-15 12:25:15 +04:00
.BR \- \- type
2014-10-06 16:43:25 +04:00
or
.BR \- \- uncache
2012-10-30 21:11:59 +04:00
arguments is required.
2006-08-19 01:49:19 +04:00
.TP
2013-04-05 14:24:32 +04:00
.BR \- b ", " \- \- background
Run the daemon in the background.
.TP
2014-10-06 16:43:25 +04:00
.BR \- H ", " \- \- cache ", " \- \- type\ \fI cache
2014-07-08 00:28:43 +04:00
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 \fB lvmcache\fP (8).
.TP
2014-05-15 12:25:15 +04:00
.BR \- \- cachepool " " \fI CachePoolLV
2014-02-25 22:17:03 +04:00
This argument is necessary when converting a logical volume to a cache LV.
2014-07-08 00:28:43 +04:00
For more information on cache pool LVs and cache LVs, see \fB lvmcache\fP (8).
2014-02-12 20:29:07 +04:00
.TP
2012-04-11 16:42:10 +04:00
.BR \- m ", " \- \- mirrors " " \fI Mirrors
2006-08-19 01:49:19 +04:00
Specifies the degree of the mirror you wish to create.
2014-06-11 13:06:30 +04:00
For example, "\fB \- m 1\fP " would convert the original logical
2006-08-19 01:49:19 +04:00
volume to a mirror volume with 2-sides; that is, a
2013-08-06 23:13:55 +04:00
linear volume plus one copy. There are two implementations of mirroring
2014-07-08 00:28:43 +04:00
which correspond to the "\fI raid1\fP " and "\fI mirror\fP " segment types. The default
mirroring segment type is "\fI raid1\fP ". If the legacy "\fI mirror\fP " segment type
2013-08-06 23:13:55 +04:00
is desired, the \fB \- \- type\fP argument must be used to explicitly
select the desired type. The \fB \- \- mirrorlog\fP and \fB \- \- corelog\fP
2014-07-08 00:28:43 +04:00
options below are only relevant to the legacy "\fI mirror\fP " segment type.
2006-08-19 01:49:19 +04:00
.TP
2012-04-11 16:42:10 +04:00
.IR \fB \- \- mirrorlog " {" disk | core | mirrored }
2007-08-25 01:01:52 +04:00
Specifies the type of log to use.
2013-04-05 14:24:32 +04:00
The default is \fI disk\fP , which is persistent and requires
2007-08-25 01:01:52 +04:00
a small amount of storage space, usually on a separate device
2013-04-05 14:24:32 +04:00
from the data being mirrored.
\fI Core\fP may be useful for short-lived mirrors: It means the mirror is
2007-08-25 01:01:52 +04:00
regenerated by copying the data from the first device again every
time the device is activated - perhaps, for example, after every reboot.
2013-04-05 14:24:32 +04:00
Using \fI mirrored\fP will create a persistent log that is itself mirrored.
2007-08-10 00:43:29 +04:00
.TP
2012-04-11 16:42:10 +04:00
.B \- \- corelog
2013-04-05 14:24:32 +04:00
The optional argument \fB \- \- corelog\fP is the same as specifying
\fB \- \- mirrorlog\fP \fI core\fP .
2006-10-07 14:47:05 +04:00
.TP
2012-04-11 16:42:10 +04:00
.BR \- R ", " \- \- regionsize " " \fI MirrorLogRegionSize
2006-10-07 14:47:05 +04:00
A mirror is divided into regions of this size (in MB), and the mirror log
uses this granularity to track which regions are in sync.
2007-12-22 15:13:29 +03:00
.TP
2012-04-11 16:42:10 +04:00
.B \- \- type \fI SegmentType
2014-05-15 12:25:15 +04:00
Used to convert a logical volume to another segment type, like
.IR cache ,
2014-07-08 00:28:43 +04:00
.IR cache-pool ,
2014-05-15 12:25:15 +04:00
.IR raid1 ,
2014-07-08 00:28:43 +04:00
.IR snapshot ,
.IR thin ,
2014-05-15 12:25:15 +04:00
or
.IR thin-pool .
When converting a logical volume to a cache LV, the
.B \- \- cachepool
argument is required.
2014-07-08 00:28:43 +04:00
When converting a logical volume to a thin LV, the
.B \- \- thinpool
argument is required.
2014-06-10 13:05:51 +04:00
See \fB lvmcache\fP (7) for more info about caching support
and \fB lvmthin\fP (7) for thin provisioning support.
2011-10-25 17:24:23 +04:00
.TP
2012-04-11 16:42:10 +04:00
.BR \- i ", " \- \- interval " " \fI Seconds
2007-12-22 15:13:29 +03:00
Report progress as a percentage at regular intervals.
2007-01-10 17:13:46 +03:00
.TP
2012-04-11 16:42:10 +04:00
.B \- \- noudevsync
2013-04-05 14:24:32 +04:00
Disables udev synchronisation. The
2009-08-04 12:09:52 +04:00
process will not wait for notification from udev.
It will continue irrespective of any possible udev processing
in the background. You should only use this if udev is not running
or has rules that ignore the devices LVM2 creates.
.TP
2012-04-11 16:42:10 +04:00
.B \- \- splitmirrors \fI Images
2014-05-20 14:54:19 +04:00
The number of redundant \fI Images\fP of a mirror to be split off and used
This patch adds the capability to split off a mirror legs.
It is pretty much the same as reducing the number of
mirror legs, but we just don't delete them afterwards.
The following command line interface is enforced:
prompt> lvconvert --splitmirror <n> -n <name> <VG>/<LV>
where 'n' is the number of images to split off, and
where 'name' is the name of the newly split off logical volume.
If more than one leg is split off, a new mirror will be the
result. The newly split off mirror will have a 'core' log.
Example:
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_1(0),lv_mimage_2(0),lv_mimage_3(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_1] /dev/sdc1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mimage_3] /dev/sde1(0)
[lv_mlog] /dev/sdi1(0)
[root@bp-01 LVM2]# lvconvert --splitmirrors 2 --name split vg/lv /dev/sd[ce]1
Logical volume lv converted.
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_2(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mlog] /dev/sdi1(0)
split 100.00 split_mimage_0(0),split_mimage_1(0)
[split_mimage_0] /dev/sde1(0)
[split_mimage_1] /dev/sdc1(0)
It can be seen that '--splitmirror <n>' is exactly the same
as '--mirrors -<n>' (note the minus sign), except there is the
additional notion to keep the image being detached from the
mirror instead of just throwing it away.
Signed-off-by: Jonathan Brassow <jbrassow@redhat.com>
2010-01-09 01:00:31 +03:00
to form a new logical volume. A name must be supplied for the
2012-04-11 16:42:10 +04:00
newly-split-off logical volume using the \fB \- \- name\fP argument, unless
the \fB \- \- trackchanges\fP argument is given.
This patch adds the capability to split off a mirror legs.
It is pretty much the same as reducing the number of
mirror legs, but we just don't delete them afterwards.
The following command line interface is enforced:
prompt> lvconvert --splitmirror <n> -n <name> <VG>/<LV>
where 'n' is the number of images to split off, and
where 'name' is the name of the newly split off logical volume.
If more than one leg is split off, a new mirror will be the
result. The newly split off mirror will have a 'core' log.
Example:
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_1(0),lv_mimage_2(0),lv_mimage_3(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_1] /dev/sdc1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mimage_3] /dev/sde1(0)
[lv_mlog] /dev/sdi1(0)
[root@bp-01 LVM2]# lvconvert --splitmirrors 2 --name split vg/lv /dev/sd[ce]1
Logical volume lv converted.
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_2(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mlog] /dev/sdi1(0)
split 100.00 split_mimage_0(0),split_mimage_1(0)
[split_mimage_0] /dev/sde1(0)
[split_mimage_1] /dev/sdc1(0)
It can be seen that '--splitmirror <n>' is exactly the same
as '--mirrors -<n>' (note the minus sign), except there is the
additional notion to keep the image being detached from the
mirror instead of just throwing it away.
Signed-off-by: Jonathan Brassow <jbrassow@redhat.com>
2010-01-09 01:00:31 +03:00
.TP
2013-04-05 14:24:32 +04:00
.BR \- n ", " \- \- name\ \fI Name
This patch adds the capability to split off a mirror legs.
It is pretty much the same as reducing the number of
mirror legs, but we just don't delete them afterwards.
The following command line interface is enforced:
prompt> lvconvert --splitmirror <n> -n <name> <VG>/<LV>
where 'n' is the number of images to split off, and
where 'name' is the name of the newly split off logical volume.
If more than one leg is split off, a new mirror will be the
result. The newly split off mirror will have a 'core' log.
Example:
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_1(0),lv_mimage_2(0),lv_mimage_3(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_1] /dev/sdc1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mimage_3] /dev/sde1(0)
[lv_mlog] /dev/sdi1(0)
[root@bp-01 LVM2]# lvconvert --splitmirrors 2 --name split vg/lv /dev/sd[ce]1
Logical volume lv converted.
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_2(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mlog] /dev/sdi1(0)
split 100.00 split_mimage_0(0),split_mimage_1(0)
[split_mimage_0] /dev/sde1(0)
[split_mimage_1] /dev/sdc1(0)
It can be seen that '--splitmirror <n>' is exactly the same
as '--mirrors -<n>' (note the minus sign), except there is the
additional notion to keep the image being detached from the
mirror instead of just throwing it away.
Signed-off-by: Jonathan Brassow <jbrassow@redhat.com>
2010-01-09 01:00:31 +03:00
The name to apply to a logical volume which has been split off from
a mirror logical volume.
2011-08-18 23:38:26 +04:00
.TP
2012-04-11 16:42:10 +04:00
.B \- \- trackchanges
Used with \fB \- \- splitmirrors\fP on a raid1 device, this tracks changes so
that the read-only detached image can be merged efficiently back into
2013-12-17 22:26:10 +04:00
the mirror later. Only the regions of the detached device where
2012-04-11 16:42:10 +04:00
the data changed get resynchronized.
2011-08-19 21:36:13 +04:00
Please note that this feature is only supported with the new md-based mirror
implementation and not with the original device-mapper mirror implementation.
2009-04-23 20:56:21 +04:00
.TP
2014-10-06 16:43:25 +04:00
.B \- \- split
Separates \fI SplitableLogicalVolume\fP .
Option is agregating various split commands and tries to detect necessary split
operation from its arguments.
.TP
2014-10-07 16:48:38 +04:00
.BR \- \- splitcache
2014-10-06 16:43:25 +04:00
Separates \fI CacheLogicalVolume\fP from cache pool.
2014-10-07 16:48:38 +04:00
Before the logical volume becomes uncached, cache is flushed.
The cache pool volume is then left unused and
could be used e.g. to caching another volume.
See also the option \fB \- \- uncache\fP for uncaching and removing
cache pool with one command.
2014-10-06 16:43:25 +04:00
.TP
2013-12-04 06:09:37 +04:00
.B \- \- splitsnapshot
2014-05-20 14:54:19 +04:00
Separates \fI SnapshotLogicalVolume\fP from its origin.
2013-12-04 06:09:37 +04:00
The volume that is split off contains the chunks that differ from the origin
along with the metadata describing them. This volume can be wiped and then
destroyed with lvremove.
2014-05-20 14:54:19 +04:00
The inverse of \fB \- \- snapshot\fP .
2013-12-04 06:09:37 +04:00
.TP
2014-07-08 00:28:43 +04:00
.BR \- s ", " \- \- snapshot ", " \- \- type\ \fI snapshot
2013-12-04 06:09:37 +04:00
Recreates a snapshot from constituent logical volumes (or copies of them) after
2014-05-15 12:25:15 +04:00
having been separated using \fB \- \- splitsnapshot\fP .
For this to work correctly, no changes may be made to the contents
of either volume after the split.
2007-01-10 17:13:46 +03:00
.TP
2012-10-30 21:11:59 +04:00
.BR \- c ", " \- \- chunksize " " \fI ChunkSize [ \fI bBsSkKmMgG ]
2014-07-08 00:28:43 +04:00
Gives the size of chunk for snapshot, cache pool and thin pool logical volumes.
2013-04-05 14:24:32 +04:00
Default unit is in kilobytes.
2014-07-08 00:28:43 +04:00
.sp
2012-10-30 21:11:59 +04:00
For snapshots the value must be power of 2 between 4KiB and 512KiB
and the default value is 4.
2014-07-08 00:28:43 +04:00
.sp
For cache pools the value must be between 32KiB and 1GiB and
the default value is 64.
.sp
2012-10-30 21:11:59 +04:00
For thin pools the value must be between 64KiB and
1GiB and the default value starts with 64 and scales
2013-04-05 14:24:32 +04:00
up to fit the pool metadata size within 128MiB,
2012-10-30 21:11:59 +04:00
if the pool metadata size is not specified.
2014-07-08 00:28:43 +04:00
The value must be a multiple of 64KiB.
2013-05-15 04:50:42 +04:00
(Early kernel support until thin target version 1.4 required the value
to be a power of 2. Discards weren't supported for non-power of 2 values
until thin target version 1.5.)
2012-10-30 21:11:59 +04:00
.TP
.BR \- \- discards " {" \fI ignore | \fI nopassdown | \fI passdown }
2013-05-15 04:50:42 +04:00
Specifies whether or not discards will be processed by the thin layer in the
kernel and passed down to the Physical Volume.
2014-10-07 16:48:38 +04:00
Options is currently supported only with thin pools.
2012-10-30 21:11:59 +04:00
Default is \fI passdown\fP .
2007-01-10 17:13:46 +03:00
.TP
2012-04-11 16:42:10 +04:00
.BR \- Z ", " \- \- zero " {" \fI y | \fI n }
2013-12-12 13:01:37 +04:00
Controls zeroing of the first 4KiB of data in the snapshot.
2007-01-10 22:56:39 +03:00
If the volume is read-only the snapshot will not be zeroed.
2012-10-30 21:11:59 +04:00
For thin pool volumes it controls zeroing of provisioned blocks.
2014-07-08 00:28:43 +04:00
Note: Provisioning of large zeroed chunks negatively impacts performance.
2010-01-13 04:55:05 +03:00
.TP
2012-04-11 16:42:10 +04:00
.B \- \- merge
2011-08-19 21:36:13 +04:00
Merges a snapshot into its origin volume or merges a raid1 image that has
2012-04-11 16:42:10 +04:00
been split from its mirror with \fB \- \- trackchanges\fP back into its mirror.
2011-08-18 23:43:08 +04:00
To check if your kernel supports the snapshot merge feature, look
for 'snapshot-merge' in the output
2012-04-11 16:42:10 +04:00
of \fB dmsetup targets\fP . If both the origin and snapshot volume are not
2010-10-14 01:26:37 +04:00
open the merge will start immediately. Otherwise, the merge will start
2010-01-13 04:55:05 +03:00
the first time either the origin or snapshot are activated and both are closed.
Merging a snapshot into an origin that cannot be closed, for example a root
filesystem, is deferred until the next time the origin volume is activated.
When merging starts, the resulting logical volume will have the origin's name,
minor number and UUID. While the merge is in progress, reads or writes to the
origin appear as they were directed to the snapshot being merged. When the
2010-02-06 01:44:37 +03:00
merge finishes, the merged snapshot is removed. Multiple snapshots may
be specified on the commandline or a @tag may be used to specify
multiple snapshots be merged to their respective origin.
This patch adds the capability to split off a mirror legs.
It is pretty much the same as reducing the number of
mirror legs, but we just don't delete them afterwards.
The following command line interface is enforced:
prompt> lvconvert --splitmirror <n> -n <name> <VG>/<LV>
where 'n' is the number of images to split off, and
where 'name' is the name of the newly split off logical volume.
If more than one leg is split off, a new mirror will be the
result. The newly split off mirror will have a 'core' log.
Example:
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_1(0),lv_mimage_2(0),lv_mimage_3(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_1] /dev/sdc1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mimage_3] /dev/sde1(0)
[lv_mlog] /dev/sdi1(0)
[root@bp-01 LVM2]# lvconvert --splitmirrors 2 --name split vg/lv /dev/sd[ce]1
Logical volume lv converted.
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_2(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mlog] /dev/sdi1(0)
split 100.00 split_mimage_0(0),split_mimage_1(0)
[split_mimage_0] /dev/sde1(0)
[split_mimage_1] /dev/sdc1(0)
It can be seen that '--splitmirror <n>' is exactly the same
as '--mirrors -<n>' (note the minus sign), except there is the
additional notion to keep the image being detached from the
mirror instead of just throwing it away.
Signed-off-by: Jonathan Brassow <jbrassow@redhat.com>
2010-01-09 01:00:31 +03:00
.TP
2013-02-05 14:26:27 +04:00
.B \- \- originname \fI NewExternalOriginVolumeName\fP
2014-07-08 00:28:43 +04:00
The new name for original logical volume, which becomes external origin volume
for a thin logical volume that will use given \fB \- \- thinpool\fP .
2013-02-05 14:26:27 +04:00
.br
2014-07-08 00:28:43 +04:00
Without this option a default name of "lvol<n>" will be generated where
<n> is the LVM internal number of the logical volume.
2013-04-05 14:24:32 +04:00
This volume will be read-only and cannot be further modified as long,
2014-07-08 00:28:43 +04:00
as it is being used as the external origin.
2013-02-05 14:26:27 +04:00
.TP
2014-10-07 16:48:38 +04:00
.IR \fB \- \- pooldatasize " " PoolDataVolumeSize [ bBsSkKmMgGtTpPeE ]
Sets the size of pool's data logical volume.
The option \fB \- \- size\fP could be still used with thin pools.
.TP
2014-10-06 16:43:25 +04:00
.BR \- \- poolmetadata " " \fI PoolMetadataLogicalVolume { \fI Name | \fI Path }
2014-07-08 00:28:43 +04:00
Specifies cache or thin pool metadata logical volume.
2012-10-30 21:11:59 +04:00
The size should be in between 2MiB and 16GiB.
2014-07-08 00:28:43 +04:00
Cache pool is specified with the option
\fB \- \- cachepool\fP .
2012-10-30 21:11:59 +04:00
Thin pool is specified with the option
\fB \- \- thinpool\fP .
2014-07-08 00:28:43 +04:00
When the specified pool already exists,
the pool's metadata volume will be swapped with the given LV.
Pool properties (like chunk size, discards or zero)
2012-12-02 19:40:07 +04:00
are preserved by default in this case.
2014-07-08 00:28:43 +04:00
It can be useful for pool metadata repair or its offline resize,
since the metadata volume is available as regular volume for a user with
thin provisioning tools
.BR cache_dump (8),
.BR cache_repair (8),
.BR cache_restore (8),
.BR thin_dump (8),
.BR thin_repair (8)
and
.BR thin_restore (8).
2012-10-30 21:11:59 +04:00
.TP
2014-10-06 16:43:25 +04:00
.BR \- \- poolmetadatasize " " \fI PoolMetadataSize [ \fI bBsSkKmMgG ]
Sets the size of cache or thin pool's metadata logical volume,
2012-10-30 21:11:59 +04:00
if the pool metadata volume is undefined.
2014-10-06 16:43:25 +04:00
Pool is specified with the option
2014-11-12 15:39:36 +03:00
\fB \- \- cachepool\fP or \fB \- \- thinpool\fP .
2014-10-06 16:43:25 +04:00
For thin pool supported value is in the range between 2MiB and 16GiB.
2012-10-30 21:11:59 +04:00
The default value is estimated with this formula
(Pool_LV_size / Pool_LV_chunk_size * 64b).
Default unit is megabytes.
.TP
2014-07-22 19:31:22 +04:00
.IR \fB \- \- poolmetadataspare " {" y | n }
Controls creation and maintanence of pool metadata spare logical volume
that will be used for automated pool recovery.
Only one such volume is maintained within a volume group
with the size of the biggest pool metadata volume.
Default is \fI y\fP es.
.TP
2012-10-30 21:11:59 +04:00
.IR \fB \- r ", " \fB \- \- readahead " {" ReadAheadSectors | auto | none }
Sets read ahead sector count of thin pool metadata logical volume.
2014-05-15 12:25:15 +04:00
The default value is "\fI auto\fP " which allows the kernel to choose
2012-10-30 21:11:59 +04:00
a suitable value automatically.
2014-05-15 12:25:15 +04:00
"\fI None\fP " is equivalent to specifying zero.
2012-10-30 21:11:59 +04:00
.TP
2012-04-11 16:42:10 +04:00
.B \- \- repair
2014-03-26 17:04:14 +04:00
Repair a mirror after suffering a disk failure or try to fix thin pool metadata.
The mirror will be brought back into a consistent state.
By default, the original number of mirrors will be
2012-04-11 16:42:10 +04:00
restored if possible. Specify \fB \- y\fP on the command line to skip
the prompts. Use \fB \- f\fP if you do not want any replacement.
2013-04-25 01:41:05 +04:00
Additionally, you may use \fB \- \- use\- policies\fP to use the device
2012-04-11 16:42:10 +04:00
replacement policy specified in \fB lvm.conf\fP (5),
This patch adds the capability to split off a mirror legs.
It is pretty much the same as reducing the number of
mirror legs, but we just don't delete them afterwards.
The following command line interface is enforced:
prompt> lvconvert --splitmirror <n> -n <name> <VG>/<LV>
where 'n' is the number of images to split off, and
where 'name' is the name of the newly split off logical volume.
If more than one leg is split off, a new mirror will be the
result. The newly split off mirror will have a 'core' log.
Example:
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_1(0),lv_mimage_2(0),lv_mimage_3(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_1] /dev/sdc1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mimage_3] /dev/sde1(0)
[lv_mlog] /dev/sdi1(0)
[root@bp-01 LVM2]# lvconvert --splitmirrors 2 --name split vg/lv /dev/sd[ce]1
Logical volume lv converted.
[root@bp-01 LVM2]# !lvs
lvs -a -o name,copy_percent,devices
LV Copy% Devices
lv 100.00 lv_mimage_0(0),lv_mimage_2(0)
[lv_mimage_0] /dev/sdb1(0)
[lv_mimage_2] /dev/sdd1(0)
[lv_mlog] /dev/sdi1(0)
split 100.00 split_mimage_0(0),split_mimage_1(0)
[split_mimage_0] /dev/sde1(0)
[split_mimage_1] /dev/sdc1(0)
It can be seen that '--splitmirror <n>' is exactly the same
as '--mirrors -<n>' (note the minus sign), except there is the
additional notion to keep the image being detached from the
mirror instead of just throwing it away.
Signed-off-by: Jonathan Brassow <jbrassow@redhat.com>
2010-01-09 01:00:31 +03:00
viz. activation/mirror_log_fault_policy or
activation/mirror_device_fault_policy.
2014-03-26 17:04:14 +04:00
Thin pool repair automates the use of \fB thin_repair\fP (8) tool.
Only inactive thin pool volumes can be repaired.
There is no validation of metadata between kernel and lvm2.
This requires further manual work.
After successfull repair the old unmodified metadata are still
2014-07-08 00:28:43 +04:00
available in "<pool>_meta<n>" LV.
2011-11-30 06:02:10 +04:00
.TP
2012-04-11 16:42:10 +04:00
.B \- \- replace \fI PhysicalVolume
Remove the specified device (\fI PhysicalVolume\fP ) and replace it with one
that is available in the volume group or from the specific list provided.
This option is only available to RAID segment types
2014-10-07 16:48:38 +04:00
(e.g.
2014-07-08 00:28:43 +04:00
.IR raid1 ,
.IR raid5 ,
etc).
2012-10-30 21:11:59 +04:00
.TP
.BR \- \- stripes " " \fI Stripes
Gives the number of stripes.
This is equal to the number of physical volumes to scatter
2012-12-11 18:50:25 +04:00
the logical volume. This does not apply to existing allocated
space, only newly allocated space can be striped.
2012-10-30 21:11:59 +04:00
.TP
.BR \- I ", " \- \- stripesize " " \fI StripeSize
Gives the number of kilobytes for the granularity of the stripes.
.br
StripeSize must be 2^n (n = 2 to 9) for metadata in LVM1 format.
For metadata in LVM2 format, the stripe size may be a larger
power of 2 but must not exceed the physical extent size.
.TP
2014-07-08 00:28:43 +04:00
.IR \fB \- T ", " \fB \- \- thin ", " \fB \- \- type " " thin
2013-04-05 14:24:32 +04:00
Converts the logical volume into a thin logical volume of the thin pool
specified with \fB \- \- thinpool\fP . The original logical volume
.I ExternalOriginLogicalVolume
is renamed into a new read-only logical volume.
2014-07-08 00:28:43 +04:00
For the non-default name for this volume use \fB \- \- originname\fP .
2013-04-05 14:24:32 +04:00
The volume cannot be further modified as long as it is used as an
external origin volume for unprovisioned areas of any thin logical volume.
2013-02-05 14:26:27 +04:00
.TP
2012-10-30 21:11:59 +04:00
.IR \fB \- \- thinpool " " ThinPoolLogicalVolume { Name | Path }
2014-07-08 00:28:43 +04:00
Specifies or converts logical volume into a thin pool's data volume.
2014-05-15 12:25:15 +04:00
Content of converted volume is lost.
Thin pool's metadata logical volume can be specified with the option
2012-10-30 21:11:59 +04:00
\fB \- \- poolmetadata\fP or allocated with \fB \- \- poolmetadatasize\fP .
2014-06-10 13:05:51 +04:00
See \fB lvmthin\fP (7) for more info about thin provisioning support.
2014-10-07 16:48:38 +04:00
.TP
.BR \- \- uncache
Uncaches \fI CacheLogicalVolume\fP .
Before the volume becomes uncached, cache is flushed.
Unlike with \fB \- \- splitcache\fP the cache pool volume is removed.
This option could seen as an inverse of \fB \- \- cache\fP .
2011-11-30 06:02:10 +04:00
2006-08-19 01:49:19 +04:00
.SH Examples
2012-04-11 16:42:10 +04:00
Converts the linear logical volume "vg00/lvol1" to a two-way mirror
logical volume:
.sp
.B lvconvert \- m1 vg00/lvol1
2006-08-19 01:49:19 +04:00
2012-04-11 16:42:10 +04:00
Converts the linear logical volume "vg00/lvol1" to a two-way RAID1
logical volume:
.sp
.B lvconvert \- \- type raid1 \- m1 vg00/lvol1
2007-08-02 01:01:06 +04:00
2012-04-11 16:42:10 +04:00
Converts a mirror with a disk log to a mirror with an in-memory log:
.sp
.B lvconvert \- \- mirrorlog core vg00/lvol1
2006-08-19 01:49:19 +04:00
2012-04-11 16:42:10 +04:00
Converts a mirror with an in-memory log to a mirror with a disk log:
.sp
.B lvconvert \- \- mirrorlog disk vg00/lvol1
2007-01-10 17:13:46 +03:00
2012-04-11 16:42:10 +04:00
Converts a mirror logical volume to a linear logical volume:
.sp
.B lvconvert \- m0 vg00/lvol1
2006-08-19 01:49:19 +04:00
2012-04-11 16:42:10 +04:00
Converts a mirror logical volume to a RAID1 logical volume with the same
number of images:
.sp
.B lvconvert \- \- type raid1 vg00/mirror_lv
2009-08-10 21:23:04 +04:00
2012-04-11 16:42:10 +04:00
Converts logical volume "vg00/lvol2" to snapshot of original volume
"vg00/lvol1":
.sp
.B lvconvert \- s vg00/lvol1 vg00/lvol2
2009-10-26 16:41:13 +03:00
2012-04-11 16:42:10 +04:00
Converts linear logical volume "vg00/lvol1" to a two-way mirror,
2014-06-11 13:06:30 +04:00
using physical extents /dev/sda:0\- 15 and /dev/sdb:0\- 15 for allocation
2012-04-11 16:42:10 +04:00
of new extents:
.sp
2014-06-11 13:06:30 +04:00
.B lvconvert \- m1 vg00/lvol1 /dev/sda:0\-15 /dev/sdb:0\-15
2010-01-13 04:55:05 +03:00
2012-04-11 16:42:10 +04:00
Converts mirror logical volume "vg00/lvmirror1" to linear, freeing physical
extents from /dev/sda:
.sp
.B lvconvert \- m0 vg00/lvmirror1 /dev/sda
Merges "vg00/lvol1_snap" into its origin:
.sp
.B lvconvert \- \- merge vg00/lvol1_snap
If "vg00/lvol1", "vg00/lvol2" and "vg00/lvol3" are all tagged with "some_tag"
2013-04-05 14:24:32 +04:00
each snapshot logical volume will be merged serially,
2012-04-11 16:42:10 +04:00
e.g.: "vg00/lvol1", then "vg00/lvol2", then "vg00/lvol3".
If \- \- background were used it would start
2010-02-06 01:44:37 +03:00
all snapshot logical volume merges in parallel.
2012-04-11 16:42:10 +04:00
.sp
.B lvconvert \- \- merge @some_tag
2010-02-06 01:44:37 +03:00
2012-04-11 16:42:10 +04:00
Extracts one image from the mirror, making it a new logical volume named
2011-08-18 23:43:08 +04:00
"lv_split". The mirror the image is extracted from is reduced accordingly.
If it was a 2-way mirror (created with '-m 1'), then the resulting original
volume will be linear.
2012-04-11 16:42:10 +04:00
.sp
.B lvconvert \- \- splitmirrors 1 \- \- name lv_split vg00/lvmirror1
2011-08-18 23:43:08 +04:00
2012-04-11 16:42:10 +04:00
A mirrored logical volume created with \- \- type raid1 can use the
\- \- trackchanges argument when splitting off an image.
2011-08-19 21:36:13 +04:00
Detach one image from the mirrored logical volume lv_raid1 as a separate
read-only device and track the changes made to the mirror while it is detached.
The split-off device has a name of the form lv_raid1_rimage_N, where N is
a number, and it cannot be renamed.
2012-04-11 16:42:10 +04:00
.sp
.B lvconvert \- \- splitmirrors 1 \- \- trackchanges vg00/lv_raid1
2011-08-18 23:43:08 +04:00
2012-04-11 16:42:10 +04:00
Merge an image that was detached temporarily from its mirror with
the \- \- trackchanges argument back into its original mirror and
2011-08-19 21:36:13 +04:00
bring its contents back up-to-date.
2012-04-11 16:42:10 +04:00
.sp
.B lvconvert \- \- merge vg00/lv_raid1_rimage_1
2011-08-18 23:43:08 +04:00
2012-04-11 16:42:10 +04:00
Replaces the physical volume "/dev/sdb1" in the RAID1 logical volume "my_raid1"
2011-11-30 06:02:10 +04:00
with the specified physical volume "/dev/sdf1". Had the argument "/dev/sdf1"
been left out, lvconvert would attempt to find a suitable device from those
available in the volume group.
2012-04-11 16:42:10 +04:00
.sp
.B lvconvert \- \- replace /dev/sdb1 vg00/my_raid1 /dev/sdf1
2011-11-30 06:02:10 +04:00
2013-02-05 14:26:27 +04:00
Convert the logical volume "vg00/lvpool" into a thin pool with chunk size 128KiB
and convert "vg00/lv1" into a thin volume using this pool. Original "vg00/lv1"
is used as an external read-only origin, where all writes to such volume
are stored in the "vg00/lvpool".
.sp
2014-07-08 00:28:43 +04:00
.B lvconvert \- \- type thin \- \- thinpool vg00/lvpool \- c 128 lv1
2013-02-05 14:26:27 +04:00
Convert the logical volume "vg00/origin" into a thin volume from the thin pool
"vg00/lvpool". This thin volume will use "vg00/origin" as an external origin
volume for unprovisioned areas in this volume.
For the read-only external origin use the new name "vg00/external".
.sp
2014-07-08 00:28:43 +04:00
.B lvconvert \- T \- \- thinpool vg00/lvpool \- \- originname external vg00/origin
2013-02-05 14:26:27 +04:00
2014-02-25 22:17:03 +04:00
Convert an existing logical volume to a cache pool LV using the
given cache metadata LV.
2014-02-12 20:29:07 +04:00
.sp
2014-06-11 13:06:30 +04:00
.B lvconvert \- \- type cache-pool \- \- poolmetadata vg00/lvx_meta vg00/lvx_data
2014-02-25 22:17:03 +04:00
.br
.B lvrename vg00/lvx_data vg00/lvx_cachepool
2014-10-06 16:43:25 +04:00
.sp
2014-02-25 22:17:03 +04:00
Convert an existing logical volume to a cache LV using the given
2014-10-06 16:43:25 +04:00
cache pool LV and chunk size 128KiB.
.sp
2014-10-07 16:48:38 +04:00
.B lvconvert \- \- cache \- \- cachepool vg00/lvx_cachepool -c 128 vg00/lvx
2014-10-06 16:43:25 +04:00
.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".
2014-02-12 20:29:07 +04:00
.sp
2014-10-06 16:43:25 +04:00
.B lvconvert \- \- uncache vg00/lvol1
2014-02-12 20:29:07 +04:00
2006-08-19 01:49:19 +04:00
.SH SEE ALSO
.BR lvm (8),
2013-04-05 14:24:32 +04:00
.BR lvm.conf (5),
2014-06-10 13:05:51 +04:00
.BR lvmcache (7),
.BR lvmthin (7),
2013-04-05 14:24:32 +04:00
.BR lvdisplay (8),
2006-08-19 01:49:19 +04:00
.BR lvextend (8),
.BR lvreduce (8),
2013-04-05 14:24:32 +04:00
.BR lvremove (8),
.BR lvrename (8),
2012-12-02 19:40:07 +04:00
.BR lvscan (8),
2013-04-05 14:24:32 +04:00
.BR vgcreate (8),
2014-07-08 00:28:43 +04:00
.BR cache_dump (8),
.BR cache_repair (8),
.BR cache_restore (8),
2013-04-05 14:24:32 +04:00
.BR thin_dump (8),
2014-07-08 00:28:43 +04:00
.BR thin_repair (8),
2013-04-05 14:24:32 +04:00
.BR thin_restore (8)