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:
parent
3ca8ed66a7
commit
e6be10ffd2
@ -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)
|
||||||
|
@ -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)
|
||||||
|
@ -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.
|
||||||
|
@ -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),
|
||||||
|
@ -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)
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user