User login |
lvconvert (8)
LVCONVERT(8) LVCONVERT(8)
NAME
lvconvert - convert a logical volume from linear to mirror or snapshot
SYNOPSIS
lvconvert -m/--mirrors Mirrors [--mirrorlog {disk|core}] [--corelog]
[-R/--regionsize MirrorLogRegionSize] [-A/--alloc AllocationPolicy]
[-h/-?/--help] [-v/--verbose] [--version]
LogicalVolume[Path] [PhysicalVolume[Path]...]
lvconvert -s/--snapshot [-c/--chunksize ChunkSize] [-h/-?/--help]
[-v/--verbose] [-Z/--zero y/n] [--version]
OriginalLogicalVolume[Path] SnapshotLogicalVolume[Path]
DESCRIPTION
lvconvert will change a linear logical volume to a mirror logical vol-
ume or to a snapshot of linear volume and vice versa. It is also used
to add and remove disk logs from mirror devices.
OPTIONS
See lvm for common options.
Exactly one of --mirrors or --snapshot arguments required.
-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.
--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 regener-
ated by copying the data from the first device again every time
the device is activated - perhaps, for example, after every
reboot.
--corelog
The optional argument "--corelog" is the same as specifying
"--log core".
-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.
-s, --snapshot
Create a snapshot from existing logical volume using another
existing logical volume as its origin.
-c, --chunksize ChunkSize
Power of 2 chunk size for the snapshot logical volume between 4k
and 512k.
-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.
Examples
"lvconvert -m1 vg00/lvol1"
converts the linear logical volume "vg00/lvol1" to a two-way mirror
logical volume.
"lvconvert --log core vg00/lvol1"
converts a mirror with a disk log to a mirror with an in-memory log.
"lvconvert --log disk vg00/lvol1"
converts a mirror with an in-memory log to a mirror with a disk log.
"lvconvert -m0 vg00/lvol1"
converts a mirror logical volume to a linear logical volume.
"lvconvert -s vg00/lvol1 vg00/lvol2"
converts logical volume "vg00/lvol2" to snapshot of original volume
"vg00/lvol1"
SEE ALSO
lvm(8), vgcreate(8), lvremove(8), lvrename(8), lvextend(8), lvre-
duce(8), lvdisplay(8), lvscan(8)
Red Hat, Inc LVM TOOLS LVCONVERT(8)
|