1
0
mirror of git://sourceware.org/git/lvm2.git synced 2025-01-02 01:18:26 +03:00

man: remove scattered lvmetad references

This commit is contained in:
David Teigland 2018-11-14 09:39:42 -06:00
parent 3ca8ed66a7
commit e6be10ffd2
5 changed files with 26 additions and 65 deletions

View File

@ -192,7 +192,7 @@ Rename a Volume Group.
Report information about Volume Groups. Report information about Volume Groups.
.TP .TP
.B vgscan .B vgscan
Scan all disks for Volume Groups and rebuild caches. Scan all disks for Volume Groups.
.TP .TP
.B vgsplit .B vgsplit
Split a Volume Group into two, moving any logical Split a Volume Group into two, moving any logical
@ -440,12 +440,6 @@ The Volume Group name that is assumed for
any reference to a Logical Volume that doesn't specify a path. any reference to a Logical Volume that doesn't specify a path.
Not set by default. Not set by default.
.TP .TP
.B LVM_LVMETAD_PIDFILE
Path to the file that stores the lvmetad process ID.
.TP
.B LVM_LVMETAD_SOCKET
Path to the socket used to communicate with lvmetad.
.TP
.B LVM_LVMPOLLD_PIDFILE .B LVM_LVMPOLLD_PIDFILE
Path to the file that stores the lvmpolld process ID. Path to the file that stores the lvmpolld process ID.
.TP .TP
@ -547,7 +541,6 @@ Prepends source file name and code line number with libdm debugging.
.BR lvmdump (8) .BR lvmdump (8)
.BR dmeventd (8) .BR dmeventd (8)
.BR lvmetad (8)
.BR lvmpolld (8) .BR lvmpolld (8)
.BR lvmlockd (8) .BR lvmlockd (8)
.BR lvmlockctl (8) .BR lvmlockctl (8)

View File

@ -1,44 +1,39 @@
.TH "LVM2-ACTIVATION-GENERATOR" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\"" .TH "LVM2-ACTIVATION-GENERATOR" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""
.SH "NAME" .SH "NAME"
lvm2-activation-generator - generator for systemd units to activate LVM2 volumes on boot lvm2-activation-generator - generator for systemd units to activate LVM volumes on boot
.SH SYNOPSIS .SH SYNOPSIS
.B #SYSTEMD_GENERATOR_DIR#/lvm2-activation-generator .B #SYSTEMD_GENERATOR_DIR#/lvm2-activation-generator
.sp .sp
.SH DESCRIPTION .SH DESCRIPTION
The lvm2-activation-generator is called by \fBsystemd\fP(1) on boot
to generate systemd units at runtime to activate LVM2 volumes if The lvm2-activation-generator is called by \fBsystemd\fP(1) on boot to
\fBlvmetad\fP(8) is disabled (global/use_lvmetad=0 \fBlvm.conf\fP(5) generate systemd units at runtime to activate LVM Logical Volumes (LVs)
option is used). Otherwise, if \fBlvmetad\fP(8) is enabled, when global/use_lvmetad=0 is set in \fBlvm.conf\fP(5). These units use
the lvm2-activation-generator exits immediately without generating \fBvgchange -ay\fP to activate LVs.
any systemd units and LVM2 fully relies on event-based activation
to activate the LVM2 volumes instead using the \fBpvscan\fP(8) If use_lvmetad=1, the lvm2-activation-generator exits immediately without
(pvscan --cache -aay) call that is a part of \fBudev\fP(8) rules. generating any systemd units, and LVM fully relies on event-based
activation to activate LVs. In this case, event-generated \fBpvscan
--cache -aay\fP commands activate LVs.
These systemd units are generated by lvm2-activation-generator: These systemd units are generated by lvm2-activation-generator:
.sp .sp
\fIlvm2-activation-early.service\fP \fIlvm2-activation-early.service\fP
used for activation of LVM2 volumes that is ordered before systemd's is run before systemd's special \fBcryptsetup.target\fP to activate
special \fBcryptsetup.target\fP to support LVM2 volumes which are not LVs that are not layered on top of encrypted devices.
layered on top of encrypted devices.
\fIlvm2-activation.service\fP \fIlvm2-activation.service\fP
used for activation of LVM2 volumes that is ordered after systemd's is run after systemd's special \fBcryptsetup.target\fP to activate
special \fBcryptsetup.target\fP to support LVM2 volumes which are LVs that are layered on top of encrypted devices.
layered on top of encrypted devices.
\fIlvm2-activation-net.service\fP \fIlvm2-activation-net.service\fP
used for activation of LVM2 volumes that is ordered after systemd's is run after systemd's special \fBremote-fs-pre.target\fP to activate
special \fBremote-fs-pre.target\fP to support LVM2 volumes which are LVs that are layered on attached remote devices.
layered on attached remote devices.
Note that all the underlying devices (Physical Volumes) need to be present Note that all the underlying LVM devices (Physical Volumes) need to be
when the service is run. If the there are any devices presented in the system present when the service is run. If the there are any devices that appear
anytime later, any LVM2 volumes on top of such devices need to be activated to the system later, LVs using these devices need to be activated directly
directly by \fBlvchange\fP(8) or \fBvgchange\fP(8). This limitation does by \fBlvchange\fP(8) or \fBvgchange\fP(8).
not exist when using \fBlvmetad\fP(8) and accompanying event-based activation
since such LVM volumes are activated automatically as soon as the Volume Group
is ready (all the Physical Volumes making up the Volume Group are present
in the system).
The lvm2-activation-generator implements the \fBGenerators Specification\fP The lvm2-activation-generator implements the \fBGenerators Specification\fP
as referenced in \fBsystemd\fP(1). as referenced in \fBsystemd\fP(1).
@ -47,7 +42,6 @@ as referenced in \fBsystemd\fP(1).
.BR lvm.conf (5) .BR lvm.conf (5)
.BR vgchange (8) .BR vgchange (8)
.BR lvchange (8) .BR lvchange (8)
.BR lvmetad (8)
.BR pvscan (8) .BR pvscan (8)
.BR udev (7) .BR udev (7)
.BR systemd (1) .BR systemd (1)

View File

@ -828,9 +828,6 @@ on a remote host. (The activation option 'l' is not used.)
.IP \[bu] 2 .IP \[bu] 2
lvmlockd works with thin and cache pools and LVs. lvmlockd works with thin and cache pools and LVs.
.IP \[bu] 2
lvmlockd works with lvmetad.
.IP \[bu] 2 .IP \[bu] 2
lvmlockd saves the cluster name for a shared VG using dlm. Only hosts in lvmlockd saves the cluster name for a shared VG using dlm. Only hosts in
the matching cluster can use the VG. the matching cluster can use the VG.

View File

@ -46,8 +46,7 @@ circumstances (see vgexport and vgimport). Improper changes can result in
a host losing access to its VG, or a VG being accidentally damaged by a host losing access to its VG, or a VG being accidentally damaged by
access from an unintended host. Even limited changes to the VG system ID access from an unintended host. Even limited changes to the VG system ID
may not be perfectly reflected across hosts. A more coherent view of may not be perfectly reflected across hosts. A more coherent view of
shared storage requires an inter-host locking system to coordinate access shared storage requires an inter-host locking system to coordinate access.
and update caches.
Valid system ID characters are the same as valid VG name characters. If a Valid system ID characters are the same as valid VG name characters. If a
system ID contains invalid characters, those characters are omitted and system ID contains invalid characters, those characters are omitted and
@ -294,8 +293,7 @@ The system ID of a VG is displayed with the "systemid" reporting option.
Report/display commands ignore foreign VGs by default. To report foreign Report/display commands ignore foreign VGs by default. To report foreign
VGs, the --foreign option can be used. This causes the VGs to be read 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 from disk.
poor performance.
.B vgs --foreign -o +systemid .B vgs --foreign -o +systemid
@ -306,20 +304,10 @@ standard reporting commands will silently ignore foreign VGs.
.SS vgexport/vgimport .SS vgexport/vgimport
vgexport clears the system ID. vgexport clears the VG system ID when exporting the VG.
Other hosts will continue to see a newly exported VG as foreign because of
local caching (when lvmetad is used). Manually updating the local lvmetad
cache with pvscan --cache will allow a host to recognize the newly
exported VG.
vgimport sets the VG system ID to the system ID of the host doing the vgimport sets the VG system ID to the system ID of the host doing the
import. vgimport automatically scans storage for newly exported VGs. import.
After vgimport, the exporting host may continue to see the VG as exported,
and not owned by the new host. Manually updating the local cache with
pvscan --cache will allow a host to recognize the newly imported VG as
foreign.
.SS vgchange .SS vgchange
@ -373,15 +361,6 @@ Because of this, they are not protected by a system ID, and any host can
use them. Coordination of changes to orphan PVs is beyond the scope of use them. Coordination of changes to orphan PVs is beyond the scope of
system ID. The same is true of any block device that is not a PV. system ID. The same is true of any block device that is not a PV.
The effects of this are especially evident when LVM uses lvmetad caching.
For example, if multiple hosts see an orphan PV, and one host creates a VG
using the orphan, the other hosts will continue to report the PV as an
orphan. Nothing would automatically prevent the other hosts from using
the newly allocated PV and corrupting it. If the other hosts run a
command to rescan devices, and update lvmetad, they would then recognize
that the PV has been used by another host. A command that rescans devices
could be pvscan --cache, or vgs --foreign.
.SH SEE ALSO .SH SEE ALSO
.BR vgcreate (8), .BR vgcreate (8),
.BR vgchange (8), .BR vgchange (8),

View File

@ -53,11 +53,9 @@
.BR lvmdump (8) .BR lvmdump (8)
.BR dmeventd (8) .BR dmeventd (8)
.BR lvmetad (8)
.BR lvmpolld (8) .BR lvmpolld (8)
.BR lvmlockd (8) .BR lvmlockd (8)
.BR lvmlockctl (8) .BR lvmlockctl (8)
.BR clvmd (8)
.BR cmirrord (8) .BR cmirrord (8)
.BR lvmdbusd (8) .BR lvmdbusd (8)