public inbox for
help / color / mirror / Atom feed
* LVM2 ./WHATS_NEW man/ man/lvchange. ...
@ 2006-08-18 21:49 agk
  0 siblings, 0 replies; only message in thread
From: agk @ 2006-08-18 21:49 UTC (permalink / raw)
  To: lvm2-cvs

CVSROOT:	/cvs/lvm2
Module name:	LVM2
Changes by:	2006-08-18 21:49:19

Modified files:
	.              : WHATS_NEW 
	man            : lvchange.8 lvcreate.8 lvextend.8 
	                 lvreduce.8 vgchange.8 
Added files:
	man            : lvconvert.8 

Log message:
	Add mirroring into man pages


--- LVM2/WHATS_NEW	2006/08/18 21:19:54	1.427
+++ LVM2/WHATS_NEW	2006/08/18 21:49:19	1.428
@@ -1,5 +1,7 @@
 Version 2.02.10 - 
+  Add lvconvert man page.
+  Add mirror options to man pages.
   Prevent mirror renames.
   Move CMDLIB code into separate file and record whether static build.
/cvs/lvm2/LVM2/man/lvconvert.8,v  -->  standard output
revision 1.1
--- LVM2/man/lvconvert.8
+++ -	2006-08-18 21:49:20.788862000 +0000
@@ -0,0 +1,59 @@
+.TH LVCONVERT 8 "LVM TOOLS" "Red Hat, Inc" \" -*- nroff -*-
+lvconvert \- convert a logical volume between linear and mirror
+.B lvconvert
+[\-m/\-\-mirrors Mirrors [\-\-corelog]]
+[\-A/\-\-alloc AllocationPolicy]
+LogicalVolume[Path] [PhysicalVolume[Path]...]
+lvconvert will change a linear logical volume to a mirror
+logical volume or vis versa.  It is also used to add and
+remove disk logs from mirror devices.
+See \fBlvm\fP for common options.
+.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.
+.I \-\-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.
+.SH 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
+.BR lvm (8),
+.BR vgcreate (8),
+.BR lvremove (8),
+.BR lvrename (8),
+.BR lvextend (8),
+.BR lvreduce (8),
+.BR lvdisplay (8),
+.BR lvscan (8)
--- LVM2/man/	2005/10/31 02:35:08	1.15
+++ LVM2/man/	2006/08/18 21:49:19	1.16
@@ -17,7 +17,8 @@
 VPATH = @srcdir@
-MAN8=lvchange.8 lvcreate.8 lvdisplay.8 lvextend.8 lvm.8 lvmchange.8 \
+MAN8=lvchange.8 lvconvert.8 lvcreate.8 lvdisplay.8 lvextend.8 lvm.8
+	lvmchange.8 \
 	lvmdiskscan.8 lvreduce.8 lvremove.8 lvrename.8 lvresize.8 lvs.8 \
 	lvscan.8 pvchange.8 pvcreate.8 pvdisplay.8 pvmove.8 pvremove.8 \
 	pvresize.8 pvs.8 pvscan.8 vgcfgbackup.8 vgcfgrestore.8 vgchange.8 \
--- LVM2/man/lvchange.8	2004/11/16 18:09:31	1.6
+++ LVM2/man/lvchange.8	2006/08/18 21:49:19	1.7
@@ -9,6 +9,7 @@
 [\-C/\-\-contiguous y/n] [\-d/\-\-debug] [\-\-deltag Tag]
+[\-\-monitor {y|n}]
 [\-M/\-\-persistent y/n] [\-\-minor minor]
 [\-P/\-\-partial y/n]
 [\-p/\-\-permission r/w] [\-r/\-\-readahead ReadAheadSectors]
@@ -42,6 +43,11 @@
 .I \-\-minor minor
 Set the minor number.
+.I \-\-monitor y/n
+Controls whether the mirrored logical volume is monitored by
+dmeventd.  If monitored (the default), a failed mirror device
+will automatically be removed from the volume group.
 .I \-M, \-\-persistent y/n
 Set to y to make the minor number specified persistent.
--- LVM2/man/lvcreate.8	2006/04/29 22:08:43	1.8
+++ LVM2/man/lvcreate.8	2006/08/18 21:49:19	1.9
@@ -11,6 +11,7 @@
 {\-l/\-\-extents LogicalExtentsNumber |
  \-L/\-\-size LogicalVolumeSize[kKmMgGtT]}
 [\-M/\-\-persistent y/n] [\-\-minor minor]
+[\-m/\-\-mirrors Mirrors [\-\-nosync] [\-\-corelog]]
 [\-n/\-\-name LogicalVolumeName]
 [\-p/\-\-permission r/rw] [\-r/\-\-readahead ReadAheadSectors]
 [-R|--regionsize MirrorLogRegionSize]
@@ -79,6 +80,23 @@
 .I \-M, \-\-persistent y/n
 Set to y to make the minor number specified persistent.
+.I \-m, \-\-mirrors Mirrors
+Creates a mirrored logical volume with "Mirrors" copies.  For example,
+specifying "-m 1" would result in a mirror with two-sides; that is, a
+linear volume plus one copy.
+Specifying the optional argument "--nosync" will cause the creation
+of the mirror to skip the initial resynchronization.  Any data written
+afterwards will be mirrored, but the original contents will not be
+copied.  This is useful for skipping a potentially long and resource
+intensive initial sync.
+Specifying the optional argument "--corelog" will create a mirror with
+an in-memory log verses a disk-based (persistent) log.  While this
+removes the need for an extra log device and *may* be slightly faster,
+it requires that the entire mirror be resynchronized upon each
+instantiation (e.g. a reboot).
 .I \-n, \-\-name LogicalVolumeName
 The name for the new logical volume.
@@ -122,10 +140,15 @@
 Warning: trying to mount an unzeroed logical volume can cause the system to
 .SH Examples
-"lvcreate -i 3 -I 8 -L 100 vg00" tries to create a striped logical
+"lvcreate -i 3 -I 8 -L 100M vg00" tries to create a striped logical
 volume with 3 stripes, a stripesize of 8KB and a size of 100MB in the volume
 group named vg00. The logical volume name will be chosen by lvcreate.
+"lvcreate -m1 -L 500M vg00" tries to create a mirror logical volume
+with 2 sides with a useable size of 500 MiB.  This operation would
+require 3 devices - two for the mirror devices and one for the disk
 "lvcreate --size 100m --snapshot --name snap /dev/vg00/lvol1"
 creates a snapshot logical volume named /dev/vg00/snap which has access to the
--- LVM2/man/lvextend.8	2004/11/16 18:09:31	1.4
+++ LVM2/man/lvextend.8	2006/08/18 21:49:19	1.5
@@ -15,6 +15,11 @@
 Extension of snapshot logical volumes (see
 .B lvcreate(8)
 for information to create snapshots) is supported as well.
+You can not use lvextend to increase the number of mirrors in a
+mirrored logical volume.  For that, see
+.BR lvconvert (8).
 See \fBlvm\fP for common options.
@@ -48,6 +53,7 @@
 .BR lvm (8), 
 .BR lvcreate (8), 
+.BR lvconvert (8), 
 .BR lvreduce (8), 
 .BR lvresize (8), 
 .BR lvchange (8)
--- LVM2/man/lvreduce.8	2004/12/09 16:59:18	1.7
+++ LVM2/man/lvreduce.8	2006/08/18 21:49:19	1.8
@@ -25,6 +25,11 @@
 Sizes will be rounded if necessary - for example, the volume size must
 be an exact number of extents and the size of a striped segment must
 be a multiple of the number of stripes.
+You can not use lvreduce to reduce the number of mirrors in a
+mirrored logical volume.  For that, see
+.BR lvconvert (8).
 See \fBlvm\fP for common options.
@@ -49,6 +54,7 @@
 in volume group vg00 by 3 logical extents.
 .BR lvchange (8),
+.BR lvconvert (8), 
 .BR lvcreate (8), 
 .BR lvextend (8), 
 .BR lvm (8), 
--- LVM2/man/vgchange.8	2006/08/16 14:41:41	1.8
+++ LVM2/man/vgchange.8	2006/08/18 21:49:19	1.9
@@ -9,6 +9,7 @@
 .IR AllocationPolicy ]
 .RB [ \-A | \-\-autobackup " {" y | n }]
 .RB [ \-a | \-\-available " [e|l] {" y | n }]
+.RB [ \-\-monitor " {" y | n }]
 .RB [ \-d | \-\-debug]
 .RB [ \-\-deltag
 .IR Tag ]
@@ -59,6 +60,12 @@
 Logical volumes with single-host snapshots are always activated
 exclusively because they can only be used on one node at once.
+.BR \-\-monitor { y | n }
+Controls whether the mirrored logical volumes in the volume
+group are monitored by dmeventd.  If monitored (the default),
+a failed mirror device will automatically be removed from the
+volume group.
 .BR \-l ", " \-\-logicalvolume " " \fIMaxLogicalVolumes\fR
 Changes the maximum logical volume number of an existing inactive
 volume group.

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2006-08-18 21:49 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2006-08-18 21:49 LVM2 ./WHATS_NEW man/ man/lvchange. agk

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).