Section: Maintenance Commands (8)
Updated: LVM TOOLS
Index Return to Main Contents


lvconvert - convert a logical volume from linear to mirror or snapshot  


lvconvert -m/--mirrors Mirrors [--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]  


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.  


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.
This optional argument tells lvconvert to switch the mirror from using a disk-based (persistent) log to an in-memory log. You may only specify this option when the --mirror argument is the same degree of the mirror you are changing.
-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.


"lvconvert -m1 vg00/lvol1"
converts the linear logical volume "vg00/lvol1" to a mirror logical volume. This command could also be used to convert a two-way mirror with an in-memory log to a two-way mirror with a disk log.

"lvconvert -m1 --corelog vg00/lvol1"
converts a two-way mirror with a disk log to a two-way mirror with an in-memory 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"



lvm(8), vgcreate(8), lvremove(8), lvrename(8), lvextend(8), lvreduce(8), lvdisplay(8), lvscan(8)



SEE ALSO manual pages