Gitweb: http://git.fedorahosted.org/git/?p=lvm2.git;a=commitdiff;h=42ba7974c5e85f3b…
Commit: 42ba7974c5e85f3b86807dacaf5f70a722475b52
Parent: cfd1b8eae2e2cf30768603d11756f6ec9316958a
Author: David Teigland <teigland(a)redhat.com>
AuthorDate: Fri Feb 20 16:55:27 2015 -0600
Committer: David Teigland <teigland(a)redhat.com>
CommitterDate: Fri Feb 20 16:55:27 2015 -0600
man lvmsystemid: update changing the system_id
---
man/lvmsystemid.7.in | 29 ++++++++++++++++++-----------
1 files changed, 18 insertions(+), 11 deletions(-)
diff --git a/man/lvmsystemid.7.in b/man/lvmsystemid.7.in
index 9e3e6f8..c0dd78b 100644
--- a/man/lvmsystemid.7.in
+++ b/man/lvmsystemid.7.in
@@ -5,10 +5,10 @@ lvmsystemid \(em LVM system id
.SH DESCRIPTION
-Local VG's may exist on shared storage where they are visible to multiple
-hosts. These VG's are intended to be used by only a single machine, even
+Local VGs may exist on shared storage where they are visible to multiple
+hosts. These VGs are intended to be used by only a single machine, even
though they are visible to many. A system_id identifying a single host
-can be assigned to a VG to indicate the VG's owner. The VG owner can use
+can be assigned to a VG to indicate the VGs owner. The VG owner can use
the VG as usual, and all other hosts will ignore it. This protects the VG
from accidental use by other hosts.
@@ -29,7 +29,7 @@ A VG without a system_id can be used by any host, and a VG with a
system_id can only be used by a host with a matching system_id. A
.B foreign VG
is a VG with a system_id as viewed by a host with a system_id
-that does not match the VG's system_id. (Or from a host without a
+that does not match the VGs system_id. (Or from a host without a
system_id.)
Valid system_id characters are the same as valid VG name characters. If a
@@ -236,8 +236,9 @@ devices.
The system_id of a VG is displayed with the "systemid" reporting option.
Report/display commands ignore foreign VGs by default. To report foreign
-VGs, the --foreign option can be used. This causes all VGs to be read
-from disk.
+VGs, the --foreign option can be used. This causes the VGs to be read
+from disk. Because lvmetad caching is not used, this option can cause
+poor performance.
.B vgs --foreign -o+systemid
@@ -265,16 +266,22 @@ imported VG as foreign.
.SS vgchange
-If a VG has a system_id, changing it with vgchange requires --force.
-vgchange --systemid is accepted just as with vgcreate.
+A host can change the system_id of its own VGs, but the command requires
+confirmation because the host may lose access to the VG being changed:
-If a host's system_id is changed, the system_id of its own VG's can be
-changed to match. Using allow_system_id is a way to avoid using force
-with vgchange.
+.B vgchange --systemid
+.I SystemID VG
+
+A host cannot directly change the system_id of a foreign VG.
To move a VG from one host to another, vgexport and vgimport should be
used.
+To forcibly gain ownership of a foreign VG, a host can add the foreign
+system_id to its allow_system_id list, change the system_id of the foreign
+VG to its own, and remove the foreign system_id from its allow_system_id
+list.
+
.SS clustered VGs
A "clustered" VG should have no system_id set, allowing multiple hosts to
Gitweb: http://git.fedorahosted.org/git/?p=lvm2.git;a=commitdiff;h=cfd1b8eae2e2cf30…
Commit: cfd1b8eae2e2cf30768603d11756f6ec9316958a
Parent: 37a47c0eec68fe3b7abf760be87e619aa51bc544
Author: David Teigland <teigland(a)redhat.com>
AuthorDate: Fri Feb 20 16:26:04 2015 -0600
Committer: David Teigland <teigland(a)redhat.com>
CommitterDate: Fri Feb 20 16:26:04 2015 -0600
man lvm: document --foreign option
---
man/lvm.8.in | 6 ++++++
1 files changed, 6 insertions(+), 0 deletions(-)
diff --git a/man/lvm.8.in b/man/lvm.8.in
index 7bc4c6b..766b8aa 100644
--- a/man/lvm.8.in
+++ b/man/lvm.8.in
@@ -243,6 +243,12 @@ will be made to communicate with the device-mapper kernel driver, so
this option is unable to report whether or not Logical Volumes are
actually in use.
.TP
+.B \-\-foreign
+Cause the command to access foreign VGs, that would otherwise be skipped.
+It can be used to report or display a VG that is owned by another host.
+This option can cause a command to perform poorly because lvmetad caching
+is not used and metadata is read from disks.
+.TP
.B \-\-addtag \fITag
Add the tag \fITag\fP to a PV, VG or LV.
Supply this argument multiple times to add more than one tag at once.
Gitweb: http://git.fedorahosted.org/git/?p=lvm2.git;a=commitdiff;h=3361e662f4b05096…
Commit: 3361e662f4b05096ca6cae9f4d96bbeec8ec4862
Parent: 55dd45239a52a7349f8a2380b3e29dc3beee39f5
Author: David Teigland <teigland(a)redhat.com>
AuthorDate: Fri Feb 20 14:58:01 2015 -0600
Committer: David Teigland <teigland(a)redhat.com>
CommitterDate: Fri Feb 20 14:58:01 2015 -0600
man: systemid option for vgcreate and vgchange
---
man/vgchange.8.in | 8 ++++++++
man/vgcreate.8.in | 13 ++++++++++++-
2 files changed, 20 insertions(+), 1 deletions(-)
diff --git a/man/vgchange.8.in b/man/vgchange.8.in
index 5014300..e6e850a 100644
--- a/man/vgchange.8.in
+++ b/man/vgchange.8.in
@@ -47,6 +47,8 @@ vgchange \(em change attributes of a volume group
.IR PhysicalExtentSize [ bBsSkKmMgGtTpPeE ]]
.RB [ \-S | \-\-select
.IR Selection ]
+.RB [ \-\-systemid
+.IR SystemID ]
.RB [ \-\-refresh ]
.RB [ \-t | \-\-test ]
.RB [ \-v | \-\-verbose ]
@@ -243,6 +245,12 @@ impact on I/O performance to the logical volume. The smallest PE is 1KiB.
The 2.4 kernel has a limitation of 2TiB per block device.
.TP
+.BR \-\-systemid " " \fISystemID
+Changes the system ID of the VG. Using this option requires caution
+because the VG may become foreign to the host running the command,
+leaving the host unable to access it. See
+.BR lvmsystemid (7).
+.TP
.BR \-\-refresh
If any logical volume in the volume group is active, reload its metadata.
This is not necessary in normal operation, but may be useful
diff --git a/man/vgcreate.8.in b/man/vgcreate.8.in
index d850659..c55dbfe 100644
--- a/man/vgcreate.8.in
+++ b/man/vgcreate.8.in
@@ -27,6 +27,8 @@ vgcreate \(em create a volume group
.IR NumberOfCopies | unmanaged | all ]
.RB [ \-s | \-\-physicalextentsize
.IR PhysicalExtentSize [ bBsSkKmMgGtTpPeE ]]
+.RB [ \-\-systemid
+.IR SystemID ]
.RB [ \-t | \-\-test ]
.RB [ \-v | \-\-verbose ]
.RB [ \-\-version ]
@@ -110,7 +112,6 @@ power of 2 of at least 1 sector (where the sector size is the largest sector
size of the PVs currently used in the VG) or, if not a power of 2, at least
128KiB. For the older LVM1 format, it must be a power of 2 of at least 8KiB.
The default is 4 MiB.
-
Once this value has been set, it is difficult to change it without recreating
the volume group which would involve backing up and restoring data on any
logical volumes. However, if no extents need moving for the new
@@ -126,6 +127,16 @@ impact on I/O performance to the logical volume. The smallest PE is 1KiB
The 2.4 kernel has a limitation of 2TiB per block device.
+.TP
+.BR \-\-systemid " " \fISystemID
+Specifies the system ID that will be given to the new VG, overriding the
+system ID of the host running the command. A VG is normally created
+without this option, in which case the new VG is given the system ID of
+the host creating it. Using this option requires caution because the
+system ID of the new VG may not match the system ID of the host running
+the command, leaving the VG inaccessible to the host. See
+.BR lvmsystemid (7).
+
.SH PHYSICAL DEVICE OPTIONS
The following options are available for initializing physical devices in the
volume group. These options are further described in the \fBpvcreate\fP(8)