LVCONVERT(8)

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

SYNOPSIS
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]

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.

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.

--corelog
    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.

Examples
"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"

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