shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-21 13:34:40 +03:00
Code Releases Activity

man: include info about disabled lvmetad

Browse Source
This commit is contained in:
David Teigland 2016-08-03 15:39:43 -05:00
parent 8b1a368b59
commit 2b01dca28a
1 changed files with 24 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
man/lvmetad.8.in
View File

@ -19,35 +19,45 @@ lvmetad \(em LVM metadata cache daemon
.SH DESCRIPTION .SH DESCRIPTION
The lvmetad daemon caches LVM metadata, so that LVM commands can read The lvmetad daemon caches LVM metadata so that LVM commands can read
metadata without scanning disks. metadata from the cache rather than scanning disks. This can be an
advantage because scanning disks is time consuming and may interfere with
the normal work of the system. lvmetad can be a disadvantage when disk
event notifications from the system are unreliable.
Metadata caching can be an advantage because scanning disks is time lvmetad does not read metadata from disks itself. Instead, it relies on
consuming and may interfere with the normal work of the system and disks. an LVM command, like pvscan \-\-cache, to read metadata from disks and
send it to lvmetad to be cached.
lvmetad does not read metadata from disks itself. The 'pvscan \-\-cache' New LVM disks that appear on the system must be scanned before lvmetad
command scans disks, reads the LVM metadata and sends it to lvmetad. knows about them. If lvmetad does not know about a disk, then LVM
New LVM disks that appear on the system must be scanned by pvscan before
lvmetad knows about them. If lvmetad does not know about a disk, then LVM
commands using lvmetad will also not know about it. When disks are added commands using lvmetad will also not know about it. When disks are added
or removed from the system, lvmetad must be updated. or removed from the system, lvmetad must be updated.
lvmetad is usually combined with event-based system services that lvmetad is usually combined with event\-based system services that
automatically run pvscan \-\-cache on new disks. This way, the lvmetad automatically run pvscan \-\-cache on disks added or removed. This way,
cache is automatically updated with metadata from new disks when they the cache is automatically updated with metadata from new disks when they
appear. LVM udev rules and systemd services implement this automation. appear. LVM udev rules and systemd services implement this automation.
Automatic scanning is usually combined with automatic activation. For Automatic scanning is usually combined with automatic activation. For
more information, see more information, see
.BR pvscan (8). .BR pvscan (8).
If lvmetad is started or restarted after disks have been added to the If lvmetad is started or restarted after disks have been added to the
system, or if the global_filter has changed, the cache must be updated by system, or if the global_filter has changed, the cache must be updated.
running 'pvscan \-\-cache'. This can be done by running pvscan \-\-cache, or it will be done
automatically by the next LVM command that's run.
When lvmetad is not used, LVM commands revert to scanning disks for LVM When lvmetad is not used, LVM commands revert to scanning disks for LVM
metadata. metadata.
In some cases, lvmetad will be temporarily disabled while it continues
running. In this state, LVM commands will ignore the lvmetad cache and
revert to scanning disks. A warning will also be printed which includes
the reason why lvmetad is not being used. The most common reason is the
existence of duplicate PVs (lvmetad cannot cache data for duplicate PVs.)
Once duplicates have been resolved, the lvmetad cache is can be updated
with pvscan \-\-cache and commands will return to using the cache.
Use of lvmetad is enabled/disabled by: Use of lvmetad is enabled/disabled by:
.br .br
.BR lvm.conf (5) .BR lvm.conf (5)