NAME

       lvmdump — create lvm2 information dumps for diagnostic purposes

SYNOPSIS

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

DESCRIPTION

       lvmdump  is  a tool to dump various information concerning LVM2.  By default, it creates a
       tarball suitable for submission along with a problem report.

       The content of the tarball is as follows:
       - dmsetup info
       - table of currently running processes
       - recent entries from /var/log/messages (containing system messages)
       - complete lvm configuration and cache (content of /etc/lvm)
       - list of device nodes present under /dev
       - list of files present /sys/block
       - list of files present /sys/devices/virtual/block
       - if enabled with -m, metadata dump will be also included
       - if enabled with -a, debug output of vgscan, pvscan and  list  of  all  available  volume
       groups, physical volumes and logical volumes will be included
       - if enabled with -c, cluster status info
       - if enabled with -l, lvmetad state if running
       - if enabled with -p, lvmpolld state if running
       - if enabled with -s, system info and context
       - if enabled with -u, udev info and context

OPTIONS

       -a     Advanced collection.  WARNING: if lvm is already hung, then this script may hang as
              well if -a is used.

       -c     If clvmd is running, gather cluster data as well.

       -d directory
              Dump into a directory instead of tarball By default, lvmdump will produce a  single
              compressed  tarball  containing  all  the information. Using this option, it can be
              instructed to only produce the raw dump tree, rooted in directory.

       -h     Print help message

       -l     Include lvmetad(8)  daemon  dump  if  it  is  running.  The  dump  contains  cached
              information  that  is  currently  stored  in  lvmetad: VG metadata, PV metadata and
              various mappings in between these metadata for quick access.

       -m     Gather LVM metadata from the PVs This option generates a 1:1 dump of  the  metadata
              area  from  all  PVs visible to the system, which can cause the dump to increase in
              size considerably.  However, the metadata dump may represent a valuable  diagnostic
              resource.

       -p     Include lvmpolld(8) daemon dump if it is running. The dump contains all in-progress
              operation currently monitored by  the  daemon  and  partial  history  for  all  yet
              uncollected results of polling operations already finished including reason.

       -s     Gather  system  info  and  context.  Currently,  this  encompasses info gathered by
              calling lsblk command and various  systemd  info  and  context:  overall  state  of
              systemd  units present in the system, more detailed status of units controlling LVM
              functionality and the content of systemd journal for current boot.

       -u     Gather udev info and context: /etc/udev/udev.conf file, udev daemon version (output
              of  'udevadm  info  --version'  command),  udev  rules currently used in the system
              (content of /lib/udev/rules.d and /etc/udev/rules.d directory), list  of  files  in
              /lib/udev  directory  and  dump  of  current  udev  database content (the output of
              'udevadm info --export-db' command).

ENVIRONMENT VARIABLES

       LVM_BINARY
              The LVM2 binary to use.  Defaults to "lvm".  Sometimes you might need to  set  this
              to "/sbin/lvm.static", for example.

       DMSETUP_BINARY
              The dmsetup binary to use.  Defaults to "dmsetup".

SEE ALSO

       lvm(8)