lvm2/man/lvconvert.8

.TH LVCONVERT 8 "LVM TOOLS" "Red Hat, Inc" \" -*- nroff -*-
.SH NAME
lvconvert \- convert a logical volume from linear to mirror or snapshot
.SH SYNOPSIS
.B lvconvert
\-m/\-\-mirrors Mirrors [\-\-log {disk|core}] [\-\-corelog] [\-R/\-\-regionsize MirrorLogRegionSize]
[\-A/\-\-alloc AllocationPolicy]
[\-h/\-?/\-\-help]
[\-v/\-\-verbose]
[\-\-version]
.br
LogicalVolume[Path] [PhysicalVolume[Path]...]
.br

.br
.B lvconvert
\-s/\-\-snapshot [\-c/\-\-chunksize ChunkSize]
[\-h/\-?/\-\-help]
[\-v/\-\-verbose]
[\-Z/\-\-zero y/n]
[\-\-version]
.br
OriginalLogicalVolume[Path] SnapshotLogicalVolume[Path]
.SH 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.
.SH OPTIONS
See \fBlvm\fP for common options.
.br
Exactly one of \-\-mirrors or \-\-snapshot arguments required.
.br
.TP
.I \-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.
.TP
.I \-\-log disk/core
This optional argument switches the logging type of a
mirror.  The logging type can be either "disk" (persistent)
or "core" (non-persistent).  The default logging type is "disk".
.TP
.I \-\-corelog
The optional argument "--corelog" is the same as specifying "--log core".
.TP
.I \-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.
.br
.TP
.I \-s, \-\-snapshot
Create a snapshot from existing logical volume using another
existing logical volume as its origin.
.TP
.I \-c, \-\-chunksize ChunkSize
Power of 2 chunk size for the snapshot logical volume between 4k and 512k.
.TP
.I \-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.
.br
.SH Examples
"lvconvert -m1 vg00/lvol1"
.br
converts the linear logical volume "vg00/lvol1" to
a two-way mirror logical volume.

"lvconvert --log core vg00/lvol1"
.br
converts a mirror with a disk log to a
mirror with an in-memory log.

"lvconvert --log disk vg00/lvol1"
.br
converts a mirror with an in-memory log
to a mirror with a disk log.

"lvconvert -m0 vg00/lvol1"
.br
converts a mirror logical volume to a linear logical
volume.
.br

.br
"lvconvert -s vg00/lvol1 vg00/lvol2"
.br
converts logical volume "vg00/lvol2" to snapshot of original volume "vg00/lvol1"

.SH SEE ALSO
.BR lvm (8),
.BR vgcreate (8),
.BR lvremove (8),
.BR lvrename (8),
.BR lvextend (8),
.BR lvreduce (8),
.BR lvdisplay (8),
.BR lvscan (8)
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`.TH LVCONVERT 8 "LVM TOOLS" "Red Hat, Inc" \" -- nroff --`
			`.SH NAME`
Print warning instead of error message if cannot zero volume Update lvconvert man page (snapshot option) 2007-01-10 14:13:46 +00:00			`lvconvert \- convert a logical volume from linear to mirror or snapshot`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`.SH SYNOPSIS`
			`.B lvconvert`
minor updates to the lvcreate/lvconvert man pages. - put back reference to '--corelog'. It now says that it is the same as '--log core'. - other minor touches 2007-08-09 20:43:29 +00:00			`\-m/\-\-mirrors Mirrors [\-\-log {disk\|core}] [\-\-corelog] [\-R/\-\-regionsize MirrorLogRegionSize]`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`[\-A/\-\-alloc AllocationPolicy]`
			`[\-h/\-?/\-\-help]`
			`[\-v/\-\-verbose]`
			`[\-\-version]`
Print warning instead of error message if cannot zero volume Update lvconvert man page (snapshot option) 2007-01-10 14:13:46 +00:00			`.br`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`LogicalVolume[Path] [PhysicalVolume[Path]...]`
Print warning instead of error message if cannot zero volume Update lvconvert man page (snapshot option) 2007-01-10 14:13:46 +00:00			`.br`

			`.br`
			`.B lvconvert`
			`\-s/\-\-snapshot [\-c/\-\-chunksize ChunkSize]`
			`[\-h/\-?/\-\-help]`
			`[\-v/\-\-verbose]`
			`[\-Z/\-\-zero y/n]`
			`[\-\-version]`
			`.br`
			`OriginalLogicalVolume[Path] SnapshotLogicalVolume[Path]`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`.SH DESCRIPTION`
			`lvconvert will change a linear logical volume to a mirror`
Print warning instead of error message if cannot zero volume Update lvconvert man page (snapshot option) 2007-01-10 14:13:46 +00:00			`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.`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`.SH OPTIONS`
			`See \fBlvm\fP for common options.`
Print warning instead of error message if cannot zero volume Update lvconvert man page (snapshot option) 2007-01-10 14:13:46 +00:00			`.br`
			`Exactly one of \-\-mirrors or \-\-snapshot arguments required.`
			`.br`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`.TP`
			`.I \-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.`
			`.TP`
This patch changes the arguments that specify the mirror log type. Previously, we had a '--corelog' argument that would change the default type from 'disk' to 'core'. I think that creates too much confusion - especially when doing conversions on mirrors. The new argument '--log' takes either "disk" or "core" as a parameter. This could be expanded in the future for additional logging types as well. Examples: # Creating a 2-way mirror $> lvcreate -m1 ... # implicitly use default disk logging $> lvcreate -m1 --log disk ... # explicit disk logging $> lvcreate -m1 --log core ... # specify core logging $> lvcreate -m1 --corelog ... # old way still works # Conversion examples $> lvconvert --log core ... # convert to core logging $> lvconvert --log disk ... # convert to disk logging $> lvconvert -mX --corelog ... # old way still works $> lvconvert -mX ... # old way of converting to disk logging still works Changes are reflected in the man pages. 2007-08-01 21:01:06 +00:00			`.I \-\-log disk/core`
minor updates to the lvcreate/lvconvert man pages. - put back reference to '--corelog'. It now says that it is the same as '--log core'. - other minor touches 2007-08-09 20:43:29 +00:00			`This optional argument switches the logging type of a`
			`mirror. The logging type can be either "disk" (persistent)`
			`or "core" (non-persistent). The default logging type is "disk".`
			`.TP`
			`.I \-\-corelog`
			`The optional argument "--corelog" is the same as specifying "--log core".`
Accept regionsize with lvconvert 2006-10-07 10:47:05 +00:00			`.TP`
			`.I \-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.`
Print warning instead of error message if cannot zero volume Update lvconvert man page (snapshot option) 2007-01-10 14:13:46 +00:00			`.br`
			`.TP`
			`.I \-s, \-\-snapshot`
			`Create a snapshot from existing logical volume using another`
			`existing logical volume as its origin.`
			`.TP`
			`.I \-c, \-\-chunksize ChunkSize`
			`Power of 2 chunk size for the snapshot logical volume between 4k and 512k.`
			`.TP`
			`.I \-Z, \-\-zero y/n`
			`Controls zeroing of the first KB of data in the snapshot.`
Prevent permission changes on active mirrors. 2007-01-10 19:56:39 +00:00			`If the volume is read-only the snapshot will not be zeroed.`
Print warning instead of error message if cannot zero volume Update lvconvert man page (snapshot option) 2007-01-10 14:13:46 +00:00			`.br`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`.SH Examples`
			`"lvconvert -m1 vg00/lvol1"`
			`.br`
			`converts the linear logical volume "vg00/lvol1" to`
minor updates to the lvcreate/lvconvert man pages. - put back reference to '--corelog'. It now says that it is the same as '--log core'. - other minor touches 2007-08-09 20:43:29 +00:00			`a two-way mirror logical volume.`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00
This patch changes the arguments that specify the mirror log type. Previously, we had a '--corelog' argument that would change the default type from 'disk' to 'core'. I think that creates too much confusion - especially when doing conversions on mirrors. The new argument '--log' takes either "disk" or "core" as a parameter. This could be expanded in the future for additional logging types as well. Examples: # Creating a 2-way mirror $> lvcreate -m1 ... # implicitly use default disk logging $> lvcreate -m1 --log disk ... # explicit disk logging $> lvcreate -m1 --log core ... # specify core logging $> lvcreate -m1 --corelog ... # old way still works # Conversion examples $> lvconvert --log core ... # convert to core logging $> lvconvert --log disk ... # convert to disk logging $> lvconvert -mX --corelog ... # old way still works $> lvconvert -mX ... # old way of converting to disk logging still works Changes are reflected in the man pages. 2007-08-01 21:01:06 +00:00			`"lvconvert --log core vg00/lvol1"`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00			`.br`
This patch changes the arguments that specify the mirror log type. Previously, we had a '--corelog' argument that would change the default type from 'disk' to 'core'. I think that creates too much confusion - especially when doing conversions on mirrors. The new argument '--log' takes either "disk" or "core" as a parameter. This could be expanded in the future for additional logging types as well. Examples: # Creating a 2-way mirror $> lvcreate -m1 ... # implicitly use default disk logging $> lvcreate -m1 --log disk ... # explicit disk logging $> lvcreate -m1 --log core ... # specify core logging $> lvcreate -m1 --corelog ... # old way still works # Conversion examples $> lvconvert --log core ... # convert to core logging $> lvconvert --log disk ... # convert to disk logging $> lvconvert -mX --corelog ... # old way still works $> lvconvert -mX ... # old way of converting to disk logging still works Changes are reflected in the man pages. 2007-08-01 21:01:06 +00:00			`converts a mirror with a disk log to a`
			`mirror with an in-memory log.`

			`"lvconvert --log disk vg00/lvol1"`
			`.br`
			`converts a mirror with an in-memory log`
			`to a mirror with a disk log.`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00
			`"lvconvert -m0 vg00/lvol1"`
			`.br`
			`converts a mirror logical volume to a linear logical`
			`volume.`
Print warning instead of error message if cannot zero volume Update lvconvert man page (snapshot option) 2007-01-10 14:13:46 +00:00			`.br`

			`.br`
			`"lvconvert -s vg00/lvol1 vg00/lvol2"`
			`.br`
			`converts logical volume "vg00/lvol2" to snapshot of original volume "vg00/lvol1"`
Add mirroring into man pages 2006-08-18 21:49:19 +00:00
			`.SH SEE ALSO`
			`.BR lvm (8),`
			`.BR vgcreate (8),`
			`.BR lvremove (8),`
			`.BR lvrename (8),`
			`.BR lvextend (8),`
			`.BR lvreduce (8),`
			`.BR lvdisplay (8),`
			`.BR lvscan (8)`