mirror of
git://sourceware.org/git/lvm2.git
synced 2025-01-03 05:18:29 +03:00
19583d115c
log type. Previously, we had a '--corelog' argument that would change the default type from 'disk' to 'core'. I think that creates too much confusion - especially when doing conversions on mirrors. The new argument '--log' takes either "disk" or "core" as a parameter. This could be expanded in the future for additional logging types as well. Examples: # Creating a 2-way mirror $> lvcreate -m1 ... # implicitly use default disk logging $> lvcreate -m1 --log disk ... # explicit disk logging $> lvcreate -m1 --log core ... # specify core logging $> lvcreate -m1 --corelog ... # old way still works # Conversion examples $> lvconvert --log core ... # convert to core logging $> lvconvert --log disk ... # convert to disk logging $> lvconvert -mX --corelog ... # old way still works $> lvconvert -mX ... # old way of converting to disk logging still works Changes are reflected in the man pages.
97 lines
2.6 KiB
Groff
97 lines
2.6 KiB
Groff
.TH LVCONVERT 8 "LVM TOOLS" "Red Hat, Inc" \" -*- nroff -*-
|
|
.SH NAME
|
|
lvconvert \- convert a logical volume from linear to mirror or snapshot
|
|
.SH SYNOPSIS
|
|
.B lvconvert
|
|
\-m/\-\-mirrors Mirrors [\-\-log {disk|core}] [\-R/\-\-regionsize MirrorLogRegionSize]
|
|
[\-A/\-\-alloc AllocationPolicy]
|
|
[\-h/\-?/\-\-help]
|
|
[\-v/\-\-verbose]
|
|
[\-\-version]
|
|
.br
|
|
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 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 \-\-log disk/core
|
|
This optional argument gives the ability to switch the
|
|
logging type that is used by a mirror. The logging type
|
|
can be either "disk" (persistent) or "core" (non-persistent).
|
|
.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.
|
|
.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-legged mirror logical volume.
|
|
|
|
"lvconvert --log core vg00/lvol1"
|
|
.br
|
|
converts a mirror with a disk log to a
|
|
mirror with an in-memory log.
|
|
|
|
"lvconvert --log 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)
|