NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | SEE ALSO | COLOPHON

LVMDUMP(8)                 System Manager's Manual                LVMDUMP(8)

NAME         top

       lvmdump — create lvm2 information dumps for diagnostic purposes

SYNOPSIS         top

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

DESCRIPTION         top

       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         top

       -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         top

       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         top

       lvm(8)

COLOPHON         top

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨http://www.sourceware.org/lvm2/⟩.  If you have a bug report for this
       manual page, send it to linux-lvm@redhat.com.  This page was obtained
       from the project's upstream Git repository 
       ⟨git://sourceware.org/git/lvm2.git⟩ on 2017-07-05.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org

Red Hat, Inc.      LVM TOOLS 2.02.173(2)-git (2017-06-28)         LVMDUMP(8)

Pages that refer to this page: lvchange(8)lvconvert(8)lvcreate(8)lvdisplay(8)lvextend(8)lvm(8)lvmconfig(8)lvmdiskscan(8)lvm-fullreport(8)lvm-lvpoll(8)lvreduce(8)lvremove(8)lvrename(8)lvresize(8)lvs(8)lvscan(8)pvchange(8)pvck(8)pvcreate(8)pvdisplay(8)pvmove(8)pvremove(8)pvresize(8)pvs(8)pvscan(8)vgcfgbackup(8)vgcfgrestore(8)vgchange(8)vgck(8)vgconvert(8)vgcreate(8)vgdisplay(8)vgexport(8)vgextend(8)vgimport(8)vgimportclone(8)vgmerge(8)vgmknodes(8)vgreduce(8)vgremove(8)vgrename(8)vgs(8)vgscan(8)vgsplit(8)