de80c6
# Configures where to put the kdump /proc/vmcore files
de80c6
#
de80c6
# This file contains a series of commands to perform (in order) when a
de80c6
# kernel crash has happened and the kdump kernel has been loaded.  Directives in
de80c6
# this file are only applicable to the kdump initramfs, and have no effect if
de80c6
# the root filesystem is mounted and the normal init scripts are processed
de80c6
#
de80c6
# Currently only one dump target and path may be configured at once
de80c6
# if the configured dump target fails, the default action will be preformed
de80c6
# the default action may be configured with the default directive below.  If the
de80c6
# configured dump target succedes 
de80c6
#
de80c6
# Basics commands supported are:
de80c6
# raw <partition>	- Will dd /proc/vmcore into <partition>.
de80c6
#			  Use persistent device names for partition devices,
de80c6
#			  such as /dev/vg/<devname>.
de80c6
#
de80c6
# nfs <nfs mount>	- Will mount fs and copy /proc/vmcore to
de80c6
#			  <mnt>/var/crash/%HOST-%DATE/, supports DNS.
de80c6
#
de80c6
# ssh <user@server>	- Will scp /proc/vmcore to
de80c6
#			  <user@server>:/var/crash/%HOST-%DATE/, supports DNS
de80c6
#			  NOTE: make sure user has necessary write
de80c6
#			  permissions on server
de80c6
#
de80c6
# sshkey <path>		- Will use the sshkey to do ssh dump
de80c6
#			  Specifies the path of the ssh key you want to use
de80c6
#			  when do ssh dump, the default value is
de80c6
#			  /root/.ssh/kdump_id_rsa.
de80c6
#
de80c6
# <fs type> <partition> - Will mount -t <fs type> <partition> /mnt and copy
de80c6
#		 	  /proc/vmcore to /mnt/var/crash/%DATE/.
de80c6
#			  NOTE: <partition> can be a device node, label or uuid.
de80c6
#			  It's recommended to use persistent device names
de80c6
#			  such as /dev/vg/<devname>.
de80c6
#			  Otherwise it's suggested to use label or uuid.
de80c6
#
de80c6
# path <path> 		- "path" represents the file system path in which
de80c6
#                         vmcore will be saved. If a dump target is specified
de80c6
#                         in kdump.conf, then "path" is relative to the
de80c6
#                         specified dump target. Interpretation of path
de80c6
#                         changes a bit if user has not specified a dump
de80c6
#                         target explicitly in kdump.conf. In this case, 
de80c6
#                         "path" represents the absolute path from root.
de80c6
#                         And dump target and adjusted path are arrived
de80c6
#                         at automatically depending on what's mounted
de80c6
#                         in the current system.
de80c6
#                         Ignored for raw device dumps.  If unset, will
de80c6
#                         default to /var/crash.
de80c6
#
de80c6
# core_collector <command> <options>
de80c6
#			- This allows you to specify the command to copy
de80c6
#			  the vmcore.  You could use the dump filtering
de80c6
#			  program makedumpfile, the default one, to retrieve
de80c6
#			  your core, which on some arches can drastically
de80c6
#			  reduce core file size. See /sbin/makedumpfile --help
de80c6
#			  for a list of options. Note that the -i and -g
de80c6
#			  options are not needed here, as the initrd will
de80c6
#			  automatically be populated with a config file
de80c6
#			  appropriate for the running kernel.
de80c6
#			  Default core_collector for raw/ssh dump is:
de80c6
#			  "makedumpfile -F -l --message-level 1 -d 31".
de80c6
#			  Default core_collector for other targets is:
de80c6
#			  "makedumpfile -l --message-level 1 -d 31".
de80c6
#			  For core_collector format details please refer to
de80c6
#			  kexec-kdump-howto.txt or kdump.conf manpage.
de80c6
#
de80c6
# kdump_post <binary | script>
de80c6
# 			- This directive allows you to run a specified
de80c6
# 			  executable just after the memory dump process
de80c6
# 			  terminates. The exit status from the dump process
de80c6
# 			  is fed to the kdump_post executable, which can be
de80c6
# 			  used to trigger different actions for success or
de80c6
# 			  failure.
de80c6
#
de80c6
# kdump_pre <binary | script>
de80c6
#			- works just like the kdump_post directive, but instead
de80c6
#			  of running after the dump process, runs immediately
de80c6
#			  before.  Exit status of this binary is interpreted
de80c6
#			  as follows:
de80c6
#			  0 - continue with dump process as usual
de80c6
#			  non 0 - reboot the system
de80c6
#
de80c6
# extra_bins <binaries | shell scripts>
de80c6
# 			- This directive allows you to specify additional
de80c6
# 			  binaries or shell scripts you'd like to include in
de80c6
# 			  your kdump initrd. Generally only useful in
de80c6
# 			  conjunction with a kdump_post binary or script that
de80c6
# 			  relies on other binaries or scripts.
de80c6
#
de80c6
# extra_modules <module(s)>
de80c6
# 			- This directive allows you to specify extra kernel
de80c6
# 			  modules that you want to be loaded in the kdump
de80c6
# 			  initrd, typically used to set up access to
de80c6
# 			  non-boot-path dump targets that might otherwise
de80c6
# 			  not be accessible in the kdump environment. Multiple
de80c6
# 			  modules can be listed, separated by a space, and any
de80c6
# 			  dependent modules will automatically be included.
de80c6
#
de80c6
# default <reboot | halt | poweroff | shell | dump_to_rootfs>
de80c6
#			- Action to preform in case dumping to intended target
de80c6
#			  fails. If no default action is specified, "reboot" 
de80c6
#			  is assumed default.
de80c6
#			  reboot: If the default action is reboot simply reboot
de80c6
#				  the system and loose the core that you are
de80c6
#				  trying to retrieve.
de80c6
#			  halt:   If the default action is halt, then simply
de80c6
#				  halt the system after attempting to capture
de80c6
#				  a vmcore, regardless of success or failure.
de80c6
#			  poweroff: The system will be powered down
de80c6
#			  shell:  If the default action is shell, then drop to
de80c6
#				  an shell session inside the initramfs from
de80c6
#				  where you can try to record the core manually.
de80c6
#				  Exiting this shell reboots the system.
de80c6
#				  Note: kdump uses bash as the default shell.
de80c6
#			  dump_to_rootfs: If non-root dump target is specified,
de80c6
#				  the default action can be set as dump_to_rootfs.
de80c6
#				  That means when dump to target fails, dump vmcore
de80c6
#				  to rootfs from initramfs context and reboot. 
de80c6
#
de80c6
# force_rebuild <0 | 1>
de80c6
#			- By default, kdump initrd only will be rebuilt when
de80c6
#			  necessary. Specify 1 to force rebuilding kdump
de80c6
#			  initrd every time when kdump service starts.
de80c6
#
de80c6
#override_resettable <0 | 1>
de80c6
#			- Usually a unresettable block device can't be dump target.
de80c6
#			Specifying 1 means though block target is unresettable, user
de80c6
#			understand this situation and want to try dumping. By default,
de80c6
#			it's set to 0, means not to try a destined failure.
de80c6
#
de80c6
# dracut_args <arg(s)>
de80c6
#			- Pass extra dracut options when rebuilding kdump
de80c6
#			  initrd.
de80c6
#
de80c6
# fence_kdump_args <arg(s)>
de80c6
#			- Command line arguments for fence_kdump_send (it can contain
de80c6
#			all valid arguments except hosts to send notification to).
de80c6
#
de80c6
# fence_kdump_nodes <node(s)>
de80c6
# 			- List of cluster node(s) separated by space to send fence_kdump
de80c6
# 			notification to (this option is mandatory to enable fence_kdump).
de80c6
#
de80c6
de80c6
#raw /dev/vg/lv_kdump
de80c6
#ext4 /dev/vg/lv_kdump
de80c6
#ext4 LABEL=/boot
de80c6
#ext4 UUID=03138356-5e61-4ab3-b58e-27507ac41937
de80c6
#nfs my.server.com:/export/tmp
de80c6
#ssh user@my.server.com
de80c6
#sshkey /root/.ssh/kdump_id_rsa
de80c6
path /var/crash
de80c6
core_collector makedumpfile -l --message-level 1 -d 31
de80c6
#core_collector scp
de80c6
#kdump_post /var/crash/scripts/kdump-post.sh
de80c6
#kdump_pre /var/crash/scripts/kdump-pre.sh
de80c6
#extra_bins /usr/bin/lftp
de80c6
#extra_modules gfs2
de80c6
#default shell
de80c6
#force_rebuild 1
de80c6
#dracut_args --omit-drivers "cfg80211 snd" --add-drivers "ext2 ext3"
de80c6
#fence_kdump_args -p 7410 -f auto -c 0 -i 10
de80c6
#fence_kdump_nodes node1 node2