bionic (8) lvmdump.8.gz

Provided by: lvm2_2.02.176-4.1ubuntu3.18.04.3_amd64 bug

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)