mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
120 lines
3.6 KiB
Groff
120 lines
3.6 KiB
Groff
.TH LVCONVERT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc" \" -*- nroff -*-
|
|
.SH NAME
|
|
lvconvert \- convert a logical volume from linear to mirror or snapshot
|
|
.SH SYNOPSIS
|
|
.B lvconvert
|
|
\-m|\-\-mirrors Mirrors [\-\-mirrorlog {disk|core}] [\-\-corelog] [\-R|\-\-regionsize MirrorLogRegionSize]
|
|
[\-A|\-\-alloc AllocationPolicy]
|
|
[\-b|\-\-background] [\-f|\-\-force] [\-i|\-\-interval Seconds]
|
|
[\-h|\-?|\-\-help]
|
|
[\-v|\-\-verbose] [\-y|\-\-yes]
|
|
[\-\-version]
|
|
LogicalVolume[Path] [PhysicalVolume[Path]...]
|
|
.br
|
|
|
|
.br
|
|
.B lvconvert
|
|
\-s|\-\-snapshot [\-c|\-\-chunksize ChunkSize]
|
|
[\-h|\-?|\-\-help]
|
|
[\-v|\-\-verbose]
|
|
[\-Z|\-\-zero y|n]
|
|
[\-\-version]
|
|
.br
|
|
OriginalLogicalVolume[Path] SnapshotLogicalVolume[Path]
|
|
.SH DESCRIPTION
|
|
lvconvert will change a linear logical volume to a mirror
|
|
logical volume or to a snapshot of linear volume and vice versa.
|
|
It is also used to add and remove disk logs from mirror devices.
|
|
.SH OPTIONS
|
|
See \fBlvm\fP for common options.
|
|
.br
|
|
Exactly one of \-\-mirrors, \-\-repair or \-\-snapshot arguments required.
|
|
.br
|
|
.TP
|
|
.I \-m, \-\-mirrors Mirrors
|
|
Specifies the degree of the mirror you wish to create.
|
|
For example, "-m 1" would convert the original logical
|
|
volume to a mirror volume with 2-sides; that is, a
|
|
linear volume plus one copy.
|
|
.TP
|
|
.I \-\-mirrorlog {disk|core}
|
|
Specifies the type of log to use.
|
|
The default is disk, which is persistent and requires
|
|
a small amount of storage space, usually on a separate device
|
|
from the data being mirrored.
|
|
Core may be useful for short-lived mirrors: It means the mirror is
|
|
regenerated by copying the data from the first device again every
|
|
time the device is activated - perhaps, for example, after every reboot.
|
|
.TP
|
|
.I \-\-corelog
|
|
The optional argument "--corelog" is the same as specifying "--mirrorlog core".
|
|
.TP
|
|
.I \-R, \-\-regionsize MirrorLogRegionSize
|
|
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.
|
|
.TP
|
|
.I \-b, \-\-background
|
|
Run the daemon in the background.
|
|
.TP
|
|
.I \-i, \-\-interval Seconds
|
|
Report progress as a percentage at regular intervals.
|
|
.br
|
|
.TP
|
|
.I \-\-repair
|
|
Repair a mirror after suffering a disk failure. The mirror will be brought back
|
|
into a consistent state. By default, the original number of mirrors will be
|
|
restored if possible. Specify \-y on the command line to skip the prompts.
|
|
Use \-f if you do not want any replacement. Additionally, you may use
|
|
\-\-use-policies to use the device replacement policy specified in lvm.conf,
|
|
viz. activation/mirror_log_fault_policy or
|
|
activation/mirror_device_fault_policy.
|
|
.br
|
|
.TP
|
|
.I \-s, \-\-snapshot
|
|
Create a snapshot from existing logical volume using another
|
|
existing logical volume as its origin.
|
|
.TP
|
|
.I \-c, \-\-chunksize ChunkSize
|
|
Power of 2 chunk size for the snapshot logical volume between 4k and 512k.
|
|
.TP
|
|
.I \-Z, \-\-zero y|n
|
|
Controls zeroing of the first KB of data in the snapshot.
|
|
If the volume is read-only the snapshot will not be zeroed.
|
|
.br
|
|
.SH Examples
|
|
"lvconvert -m1 vg00/lvol1"
|
|
.br
|
|
converts the linear logical volume "vg00/lvol1" to
|
|
a two-way mirror logical volume.
|
|
|
|
"lvconvert --mirrorlog core vg00/lvol1"
|
|
.br
|
|
converts a mirror with a disk log to a
|
|
mirror with an in-memory log.
|
|
|
|
"lvconvert --mirrorlog disk vg00/lvol1"
|
|
.br
|
|
converts a mirror with an in-memory log
|
|
to a mirror with a disk log.
|
|
|
|
"lvconvert -m0 vg00/lvol1"
|
|
.br
|
|
converts a mirror logical volume to a linear logical
|
|
volume.
|
|
.br
|
|
|
|
.br
|
|
"lvconvert -s vg00/lvol1 vg00/lvol2"
|
|
.br
|
|
converts logical volume "vg00/lvol2" to snapshot of original volume "vg00/lvol1"
|
|
|
|
.SH SEE ALSO
|
|
.BR lvm (8),
|
|
.BR vgcreate (8),
|
|
.BR lvremove (8),
|
|
.BR lvrename (8),
|
|
.BR lvextend (8),
|
|
.BR lvreduce (8),
|
|
.BR lvdisplay (8),
|
|
.BR lvscan (8)
|