lvconvert

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]
       [-b/--background] [-i/--interval	 Seconds]  [-h/-?/--help]  [-v/--ver-
       bose] [--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  regenerated 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
	      "--mirrorlog 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.

       -b, --background
	      Run the daemon in the background.

       -i, --interval Seconds
	      Report progress as a percentage at regular intervals.

       -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 --mirrorlog core vg00/lvol1"
       converts a mirror with a disk log to a mirror with an in-memory log.

       "lvconvert --mirrorlog 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)