1LVMDUMP(8)                  System Manager's Manual                 LVMDUMP(8)
2
3
4

NAME

6       lvmdump — create lvm2 information dumps for diagnostic purposes
7

SYNOPSIS

9       lvmdump [-a] [-c] [-d directory] [-h] [-l] [-m] [-p] [-s] [-u]
10

DESCRIPTION

12       lvmdump  is a tool to dump various information concerning LVM2.  By de‐
13       fault, it creates a tarball suitable for submission along with a  prob‐
14       lem report.
15
16       The content of the tarball is as follows:
17       - dmsetup info
18       - table of currently running processes
19       - recent entries from /var/log/messages (containing system messages)
20       - complete lvm configuration and cache (content of /etc/lvm)
21       - list of device nodes present under /dev
22       - list of files present /sys/block
23       - list of files present /sys/devices/virtual/block
24       - if enabled with -m, metadata dump will be also included
25       -  if  enabled  with -a, debug output of vgscan, pvscan and list of all
26       available volume groups, physical volumes and logical volumes  will  be
27       included
28       - if enabled with -l, lvmetad state if running
29       - if enabled with -p, lvmpolld state if running
30       - if enabled with -s, system info and context
31       - if enabled with -u, udev info and context
32

OPTIONS

34       -a     Advanced collection.  WARNING: if lvm is already hung, then this
35              script may hang as well if -a is used.
36
37       -d directory
38              Dump into a directory instead of  tarball  By  default,  lvmdump
39              will  produce a single compressed tarball containing all the in‐
40              formation. Using this option, it can be instructed to only  pro‐
41              duce the raw dump tree, rooted in directory.
42
43       -h     Print help message
44
45       -l     Include  lvmetad(8)  daemon dump if it is running. The dump con‐
46              tains cached information that is currently stored in lvmetad: VG
47              metadata,  PV  metadata  and  various  mappings in between these
48              metadata for quick access.
49
50       -m     Gather LVM metadata from the PVs This  option  generates  a  1:1
51              dump  of  the  metadata area from all PVs visible to the system,
52              which can cause the dump to increase in size considerably.  How‐
53              ever,  the metadata dump may represent a valuable diagnostic re‐
54              source.
55
56       -p     Include lvmpolld(8) daemon dump if it is running. The dump  con‐
57              tains  all in-progress operation currently monitored by the dae‐
58              mon and partial history  for  all  yet  uncollected  results  of
59              polling operations already finished including reason.
60
61       -s     Gather system info and context. Currently, this encompasses info
62              gathered by calling lsblk command and various systemd  info  and
63              context:  overall  state of systemd units present in the system,
64              more detailed status of units controlling LVM functionality  and
65              the content of systemd journal for current boot.
66
67       -u     Gather  udev  info  and  context: /etc/udev/udev.conf file, udev
68              daemon version (output of  'udevadm  info  --version'  command),
69              udev   rules   currently   used   in   the  system  (content  of
70              /lib/udev/rules.d  and  /etc/udev/rules.d  directory),  list  of
71              files  in  /lib/udev directory and dump of current udev database
72              content (the output of 'udevadm info --export-db' command).
73

ENVIRONMENT VARIABLES

75       LVM_BINARY
76              The LVM2 binary to use.  Defaults to "lvm".  Sometimes you might
77              need to set this to "/usr/lvm/lvm.static", for example.
78
79       DMSETUP_BINARY
80              The dmsetup binary to use.  Defaults to "dmsetup".
81

SEE ALSO

83       lvm(8)
84
85
86
87Red Hat, Inc.          LVM TOOLS 2.03.11(2) (2021-01-08)            LVMDUMP(8)
Impressum