LVCONVERT

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

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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Examples
SEE ALSO

linux.jgfs.net manual pages