gfs2_lockcapture(8) capture locking information from GFS2 file systems and DLM.

SYNOPSIS

gfs2_lockcapture [-dqyP] [-o output directory] [-r number of runs] [-s seconds to sleep] [-n name of GFS2 file system]

gfs2_lockcapture [-dqyi]

DESCRIPTION

gfs2_lockcapture is used to capture the GFS2 lockdump data and corresponding DLM data for GFS2 file systems. The number of captures and their frequency can be configured. By default all of the mounted GFS2 file systems will have their data collected unless GFS2 file systems are specified.

Please note that sysrq -t (thread) and -m (memory) dumps and the pid directories in /proc are collected unless they are disabled with the -P option.

OPTIONS

-h, --help
Prints out a short usage message and exits.
-d, --debug
Enables debug logging.
-q, --quiet
Disables logging to console.
-y, --no_ask
Disables all questions and assumes yes.
-i, --info
Prints information about the mounted GFS2 file systems.
-P, --disable_process_gather
The gathering of process information will be disabled.
-o <output directory>, --path_to_output_dir=<output directory>
The directory where all the collect data will be stored.
-r <number of runs>, --num_of_runs=<number of runs>
The number of runs capturing the lockdump data. The default is 3 runs.
-s <seconds to sleep>, --seconds_sleep=<seconds to sleep>
The number of seconds to sleep between runs of capturing the lockdump data. The default is 120 seconds.
-n <name of GFS2 filesystem>, --fs_name=<name of GFS2 filesystem>
The name of the GFS2 filesystem(s) that will have their lockdump data captured. By default, all mounted GFS2 file systems will have their data captured.

NOTES

The output of the following commands will be captured:
  • uname -a
  • uptime
  • ps h -AL -o "tid,s,cmd"
  • df -h
  • lsof
  • mount -l
  • dlm_tool ls
  • dlm_tool lockdebug -v -s -w <lockspace name>
  • echo "t" > /proc/sysrq-trigger (If /proc/1/stack does not exist)
  • echo "m" > /proc/sysrq-trigger (If /proc/1/stack does not exist)

AUTHOR

Shane Bradley <[email protected]>

FILES

/proc/mounts
/proc/slabinfo
/sys/kernel/config/dlm/cluster/lkbtbl_size
/sys/kernel/config/dlm/cluster/dirtbl_size
/sys/kernel/config/dlm/cluster/rsbtbl_size
/sys/kernel/debug/gfs2/
/sys/kernel/debug/dlm/
/proc/<int>/ (If /proc/1/stack does exists)
/var/log/messages
/var/log/cluster/