Compare commits
No commits in common. 'c9' and 'i10cs' have entirely different histories.
@ -1,3 +1 @@
|
|||||||
SOURCES/eppic-e8844d3.tar.gz
|
SOURCES/kexec-tools-2.0.29.tar.xz
|
||||||
SOURCES/kexec-tools-2.0.27.tar.xz
|
|
||||||
SOURCES/makedumpfile-1.7.4.tar.gz
|
|
||||||
|
|||||||
@ -1,3 +1 @@
|
|||||||
80ac3f5e77d3c79883edadf14428734db4720009 SOURCES/eppic-e8844d3.tar.gz
|
b05e53b8f63ca039a06b0f8cb8a175b0f447449e SOURCES/kexec-tools-2.0.29.tar.xz
|
||||||
ed15f191adee22ab0721ba62af1cae67eb981670 SOURCES/kexec-tools-2.0.27.tar.xz
|
|
||||||
98cae2b1062871905795918c32b6d46ccd115074 SOURCES/makedumpfile-1.7.4.tar.gz
|
|
||||||
|
|||||||
@ -1,31 +0,0 @@
|
|||||||
#!/usr/bin/bash
|
|
||||||
|
|
||||||
COMMAND="$1"
|
|
||||||
KERNEL_VERSION="$2"
|
|
||||||
|
|
||||||
if ! [[ ${KERNEL_INSTALL_MACHINE_ID-x} ]]; then
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Currently, fadump is supported only in environments with
|
|
||||||
# writable /boot directory.
|
|
||||||
if [[ ! -w "/boot" ]]; then
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
FADUMP_INITRD="/boot/.initramfs-${KERNEL_VERSION}.img.default"
|
|
||||||
FADUMP_INITRD_CHECKSUM="$FADUMP_INITRD.checksum"
|
|
||||||
|
|
||||||
ret=0
|
|
||||||
case "$COMMAND" in
|
|
||||||
add)
|
|
||||||
# Do nothing, fadump initramfs is strictly host only
|
|
||||||
# and managed by kdump service
|
|
||||||
;;
|
|
||||||
remove)
|
|
||||||
rm -f -- "$FADUMP_INITRD"
|
|
||||||
rm -f -- "$FADUMP_INITRD_CHECKSUM"
|
|
||||||
ret=$?
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
exit $ret
|
|
||||||
@ -1,36 +0,0 @@
|
|||||||
#!/usr/bin/bash
|
|
||||||
|
|
||||||
COMMAND="$1"
|
|
||||||
KERNEL_VERSION="$2"
|
|
||||||
KDUMP_INITRD_DIR_ABS="$3"
|
|
||||||
KERNEL_IMAGE="$4"
|
|
||||||
|
|
||||||
if ! [[ ${KERNEL_INSTALL_MACHINE_ID-x} ]]; then
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [[ -d "$KDUMP_INITRD_DIR_ABS" ]]; then
|
|
||||||
KDUMP_INITRD="initrdkdump"
|
|
||||||
else
|
|
||||||
# If `KDUMP_BOOTDIR` is not writable, then the kdump
|
|
||||||
# initrd must have been placed at `/var/lib/kdump`
|
|
||||||
if [[ ! -w "/boot" ]]; then
|
|
||||||
KDUMP_INITRD_DIR_ABS="/var/lib/kdump"
|
|
||||||
else
|
|
||||||
KDUMP_INITRD_DIR_ABS="/boot"
|
|
||||||
fi
|
|
||||||
KDUMP_INITRD="initramfs-${KERNEL_VERSION}kdump.img"
|
|
||||||
fi
|
|
||||||
|
|
||||||
ret=0
|
|
||||||
case "$COMMAND" in
|
|
||||||
add)
|
|
||||||
# Do nothing, kdump initramfs is strictly host only
|
|
||||||
# and managed by kdump service
|
|
||||||
;;
|
|
||||||
remove)
|
|
||||||
rm -f -- "$KDUMP_INITRD_DIR_ABS/$KDUMP_INITRD"
|
|
||||||
ret=$?
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
exit $ret
|
|
||||||
@ -1,13 +0,0 @@
|
|||||||
#!/usr/bin/bash
|
|
||||||
|
|
||||||
COMMAND="$1"
|
|
||||||
KERNEL_VERSION="$2"
|
|
||||||
KDUMP_INITRD_DIR_ABS="$3"
|
|
||||||
KERNEL_IMAGE="$4"
|
|
||||||
|
|
||||||
case "$COMMAND" in
|
|
||||||
add)
|
|
||||||
kdumpctl _reset-crashkernel-for-installed_kernel "$KERNEL_VERSION"
|
|
||||||
exit 0
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
@ -1,16 +0,0 @@
|
|||||||
SUBSYSTEM=="cpu", ACTION=="add", GOTO="kdump_reload"
|
|
||||||
SUBSYSTEM=="cpu", ACTION=="remove", GOTO="kdump_reload"
|
|
||||||
SUBSYSTEM=="memory", ACTION=="online", GOTO="kdump_reload"
|
|
||||||
SUBSYSTEM=="memory", ACTION=="offline", GOTO="kdump_reload"
|
|
||||||
|
|
||||||
GOTO="kdump_reload_end"
|
|
||||||
|
|
||||||
LABEL="kdump_reload"
|
|
||||||
|
|
||||||
# If kdump is not loaded, calling kdump-udev-throttle will end up
|
|
||||||
# doing nothing, but systemd-run will always generate extra logs for
|
|
||||||
# each call, so trigger the kdump-udev-throttler only if kdump
|
|
||||||
# service is active to avoid unnecessary logs
|
|
||||||
RUN+="/bin/sh -c '/usr/bin/systemctl is-active kdump.service || exit 0; /usr/bin/systemd-run --quiet --no-block /usr/lib/udev/kdump-udev-throttler'"
|
|
||||||
|
|
||||||
LABEL="kdump_reload_end"
|
|
||||||
@ -1,22 +0,0 @@
|
|||||||
SUBSYSTEM=="cpu", ACTION=="online", GOTO="kdump_reload_cpu"
|
|
||||||
SUBSYSTEM=="memory", ACTION=="online", GOTO="kdump_reload_mem"
|
|
||||||
SUBSYSTEM=="memory", ACTION=="offline", GOTO="kdump_reload_mem"
|
|
||||||
|
|
||||||
GOTO="kdump_reload_end"
|
|
||||||
|
|
||||||
# If kdump is not loaded, calling kdump-udev-throttle will end up
|
|
||||||
# doing nothing, but systemd-run will always generate extra logs for
|
|
||||||
# each call, so trigger the kdump-udev-throttler only if kdump
|
|
||||||
# service is active to avoid unnecessary logs
|
|
||||||
|
|
||||||
LABEL="kdump_reload_mem"
|
|
||||||
|
|
||||||
RUN+="/bin/sh -c '/usr/bin/systemctl is-active kdump.service || exit 0; /usr/bin/systemd-run --quiet --no-block /usr/lib/udev/kdump-udev-throttler'"
|
|
||||||
|
|
||||||
GOTO="kdump_reload_end"
|
|
||||||
|
|
||||||
LABEL="kdump_reload_cpu"
|
|
||||||
|
|
||||||
RUN+="/bin/sh -c '/usr/bin/systemctl is-active kdump.service || exit 0; ! test -f /sys/kernel/fadump/enabled || cat /sys/kernel/fadump/enabled | grep 0 || exit 0; /usr/bin/systemd-run --quiet --no-block /usr/lib/udev/kdump-udev-throttler'"
|
|
||||||
|
|
||||||
LABEL="kdump_reload_end"
|
|
||||||
@ -1,120 +0,0 @@
|
|||||||
Introduction
|
|
||||||
============
|
|
||||||
|
|
||||||
This document describes features the kexec-tools package provides for setting
|
|
||||||
and estimating the crashkernel value.
|
|
||||||
|
|
||||||
Kdump lives in a pre-reserved chunk of memory, and the size of the reserved
|
|
||||||
memory is specified by the `crashkernel=` kernel parameter. It's hard to
|
|
||||||
estimate an accurate `crashkernel=` value, so it's always recommended to test
|
|
||||||
kdump after you updated the `crashkernel=` value or changed the dump target.
|
|
||||||
|
|
||||||
|
|
||||||
Default crashkernel value
|
|
||||||
=========================
|
|
||||||
|
|
||||||
Latest kexec-tools provides "kdumpctl get-default-crashkernel" to retrieve
|
|
||||||
the default crashkernel value,
|
|
||||||
|
|
||||||
$ echo $(kdumpctl get-default-crashkernel)
|
|
||||||
1G-4G:192M,4G-64G:256M,64G-:512M
|
|
||||||
|
|
||||||
It will be taken as the default value of 'crashkernel=', you can use
|
|
||||||
this value as a reference for setting crashkernel value manually.
|
|
||||||
|
|
||||||
|
|
||||||
New installed system
|
|
||||||
====================
|
|
||||||
|
|
||||||
Anaconda is the OS installer which sets all the kernel boot cmdline on a newly
|
|
||||||
installed system. If kdump is enabled during Anaconda installation, Anaconda
|
|
||||||
will use the default crashkernel value as the default `crashkernel=` value on
|
|
||||||
the newly installed system.
|
|
||||||
|
|
||||||
Users can override the value during Anaconda installation manually.
|
|
||||||
|
|
||||||
|
|
||||||
Auto update of crashkernel boot parameter
|
|
||||||
=========================================
|
|
||||||
|
|
||||||
A new release of kexec-tools could update the default crashkernel value. By
|
|
||||||
default, kexec-tools would reset crashkernel to the new default value if it
|
|
||||||
detects the old default crashkernel value is used by installed kernels. If you
|
|
||||||
don't want kexec-tools to update the old default crashkernel to the new default
|
|
||||||
crashkernel, you can change auto_reset_crashkernel to no in kdump.conf.
|
|
||||||
|
|
||||||
Supported Bootloaders
|
|
||||||
---------------------
|
|
||||||
|
|
||||||
This auto update only works with GRUB2 and ZIPL, as kexec-tools heavily depends
|
|
||||||
on `grubby`. If other boot loaders are used, the user will have to update the
|
|
||||||
`crashkernel=` value manually.
|
|
||||||
|
|
||||||
|
|
||||||
Reset crashkernel to default value
|
|
||||||
==================================
|
|
||||||
|
|
||||||
kexec-tools only perform the auto update of crashkernel value when it can
|
|
||||||
confirm the boot kernel's crashkernel value is using its corresponding default
|
|
||||||
value and auto_reset_crashkernel=yes in kdump.conf. In other cases, the user
|
|
||||||
can reset the crashkernel value by themselves.
|
|
||||||
|
|
||||||
Reset using kdumpctl
|
|
||||||
--------------------
|
|
||||||
|
|
||||||
To make it easier to reset the `crashkernel=` kernel cmdline to this default
|
|
||||||
value properly, `kdumpctl` also provides a sub-command:
|
|
||||||
|
|
||||||
`kdumpctl reset-crashkernel [--kernel=path_to_kernel] [--reboot]`
|
|
||||||
|
|
||||||
This command will reset the bootloader's kernel cmdline to the default value.
|
|
||||||
It will also update bootloader config if the bootloader has a standalone config
|
|
||||||
file. User will have to reboot the machine after this command to make it take
|
|
||||||
effect if --reboot is not specified. For more details, please refer to the
|
|
||||||
reset-crashkernel command in `man kdumpctl`.
|
|
||||||
|
|
||||||
Reset manually
|
|
||||||
--------------
|
|
||||||
|
|
||||||
To reset the crashkernel value manually, it's recommended to use utils like
|
|
||||||
`grubby`. A one liner script for resetting `crashkernel=` value of all installed
|
|
||||||
kernels to the default value is:
|
|
||||||
|
|
||||||
grubby --update-kernel ALL --args "crashkernel=$(kdumpctl get-default-crashkernel)"
|
|
||||||
|
|
||||||
NOTE: On s390x you also need to run zipl for the change to take effect.
|
|
||||||
|
|
||||||
Estimate crashkernel
|
|
||||||
====================
|
|
||||||
|
|
||||||
The best way to estimate a usable crashkernel value is by testing kdump
|
|
||||||
manually. And you can set crashkernel to a large value, then adjust the
|
|
||||||
crashkernel value to an acceptable value gradually.
|
|
||||||
|
|
||||||
`kdumpctl` also provides a sub-command for doing rough estimating without
|
|
||||||
triggering kdump:
|
|
||||||
|
|
||||||
`kdumpctl estimate`
|
|
||||||
|
|
||||||
The output will be like this:
|
|
||||||
|
|
||||||
```
|
|
||||||
Encrypted kdump target requires extra memory, assuming using the keyslot with minimum memory requirement
|
|
||||||
|
|
||||||
Reserved crashkernel: 256M
|
|
||||||
Recommended crashkernel: 655M
|
|
||||||
|
|
||||||
Kernel image size: 47M
|
|
||||||
Kernel modules size: 12M
|
|
||||||
Initramfs size: 19M
|
|
||||||
Runtime reservation: 64M
|
|
||||||
LUKS required size: 512M
|
|
||||||
Large modules:
|
|
||||||
xfs: 1892352
|
|
||||||
nouveau: 2318336
|
|
||||||
WARNING: Current crashkernel size is lower than recommended size 655M.
|
|
||||||
```
|
|
||||||
|
|
||||||
It will generate a summary report about the estimated memory consumption
|
|
||||||
of each component of kdump. The value may not be accurate enough, but
|
|
||||||
would be a good start for finding a suitable crashkernel value.
|
|
||||||
@ -1,65 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
|
|
||||||
. /etc/sysconfig/kdump
|
|
||||||
|
|
||||||
KDUMP_KERNEL=""
|
|
||||||
KDUMP_INITRD=""
|
|
||||||
|
|
||||||
check() {
|
|
||||||
if [[ ! -f /etc/sysconfig/kdump ]] || [[ ! -f /lib/kdump/kdump-lib.sh ]] \
|
|
||||||
|| [[ -n ${IN_KDUMP} ]]; then
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
return 255
|
|
||||||
}
|
|
||||||
|
|
||||||
depends() {
|
|
||||||
echo "base shutdown"
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
prepare_kernel_initrd() {
|
|
||||||
. /lib/kdump/kdump-lib.sh
|
|
||||||
|
|
||||||
prepare_kdump_bootinfo
|
|
||||||
|
|
||||||
# $kernel is a variable from dracut
|
|
||||||
if [[ $KDUMP_KERNELVER != "$kernel" ]]; then
|
|
||||||
dwarn "Using kernel version '$KDUMP_KERNELVER' for early kdump," \
|
|
||||||
"but the initramfs is generated for kernel version '$kernel'"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
install() {
|
|
||||||
prepare_kernel_initrd
|
|
||||||
if [[ ! -f $KDUMP_KERNEL ]]; then
|
|
||||||
derror "Could not find required kernel for earlykdump," \
|
|
||||||
"earlykdump will not work!"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
if [[ ! -f $KDUMP_INITRD ]]; then
|
|
||||||
derror "Could not find required kdump initramfs for earlykdump," \
|
|
||||||
"please ensure kdump initramfs is generated first," \
|
|
||||||
"earlykdump will not work!"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
inst_multiple tail find cut dirname hexdump
|
|
||||||
inst_simple "/etc/sysconfig/kdump"
|
|
||||||
inst_binary "/usr/sbin/kexec"
|
|
||||||
inst_binary "/usr/bin/gawk" "/usr/bin/awk"
|
|
||||||
inst_binary "/usr/bin/logger" "/usr/bin/logger"
|
|
||||||
inst_binary "/usr/bin/printf" "/usr/bin/printf"
|
|
||||||
inst_binary "/usr/bin/xargs" "/usr/bin/xargs"
|
|
||||||
inst_script "/lib/kdump/kdump-lib.sh" "/lib/kdump-lib.sh"
|
|
||||||
inst_script "/lib/kdump/kdump-lib-initramfs.sh" "/lib/kdump/kdump-lib-initramfs.sh"
|
|
||||||
inst_script "/lib/kdump/kdump-logger.sh" "/lib/kdump-logger.sh"
|
|
||||||
inst_hook cmdline 00 "$moddir/early-kdump.sh"
|
|
||||||
inst_binary "$KDUMP_KERNEL"
|
|
||||||
inst_binary "$KDUMP_INITRD"
|
|
||||||
|
|
||||||
ln_r "$KDUMP_KERNEL" "/boot/kernel-earlykdump"
|
|
||||||
ln_r "$KDUMP_INITRD" "/boot/initramfs-earlykdump"
|
|
||||||
|
|
||||||
chmod -x "${initdir}/$KDUMP_KERNEL"
|
|
||||||
}
|
|
||||||
@ -1,79 +0,0 @@
|
|||||||
#! /bin/sh
|
|
||||||
|
|
||||||
KEXEC=/sbin/kexec
|
|
||||||
standard_kexec_args="-p"
|
|
||||||
|
|
||||||
EARLY_KDUMP_INITRD=""
|
|
||||||
EARLY_KDUMP_KERNEL=""
|
|
||||||
EARLY_KDUMP_CMDLINE=""
|
|
||||||
EARLY_KDUMP_KERNELVER=""
|
|
||||||
EARLY_KEXEC_ARGS=""
|
|
||||||
|
|
||||||
. /etc/sysconfig/kdump
|
|
||||||
. /lib/dracut-lib.sh
|
|
||||||
. /lib/kdump-lib.sh
|
|
||||||
. /lib/kdump-logger.sh
|
|
||||||
|
|
||||||
# initiate the kdump logger
|
|
||||||
if ! dlog_init; then
|
|
||||||
echo "failed to initiate the kdump logger."
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
prepare_parameters()
|
|
||||||
{
|
|
||||||
EARLY_KDUMP_CMDLINE=$(prepare_cmdline "${KDUMP_COMMANDLINE}" "${KDUMP_COMMANDLINE_REMOVE}" "${KDUMP_COMMANDLINE_APPEND}")
|
|
||||||
EARLY_KDUMP_KERNEL="/boot/kernel-earlykdump"
|
|
||||||
EARLY_KDUMP_INITRD="/boot/initramfs-earlykdump"
|
|
||||||
}
|
|
||||||
|
|
||||||
early_kdump_load()
|
|
||||||
{
|
|
||||||
if ! check_kdump_feasibility; then
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
if is_fadump_capable; then
|
|
||||||
dwarn "WARNING: early kdump doesn't support fadump."
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
if is_kernel_loaded "kdump"; then
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
prepare_parameters
|
|
||||||
|
|
||||||
EARLY_KEXEC_ARGS=$(prepare_kexec_args "${KEXEC_ARGS}")
|
|
||||||
|
|
||||||
# Here, only output the messages, but do not save these messages
|
|
||||||
# to a file because the target disk may not be mounted yet, the
|
|
||||||
# earlykdump is too early.
|
|
||||||
ddebug "earlykdump: $KEXEC ${EARLY_KEXEC_ARGS} $standard_kexec_args \
|
|
||||||
--command-line=$EARLY_KDUMP_CMDLINE --initrd=$EARLY_KDUMP_INITRD \
|
|
||||||
$EARLY_KDUMP_KERNEL"
|
|
||||||
|
|
||||||
if $KEXEC $EARLY_KEXEC_ARGS $standard_kexec_args \
|
|
||||||
--command-line="$EARLY_KDUMP_CMDLINE" \
|
|
||||||
--initrd=$EARLY_KDUMP_INITRD $EARLY_KDUMP_KERNEL; then
|
|
||||||
dinfo "kexec: loaded early-kdump kernel"
|
|
||||||
return 0
|
|
||||||
else
|
|
||||||
derror "kexec: failed to load early-kdump kernel"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
set_early_kdump()
|
|
||||||
{
|
|
||||||
if getargbool 0 rd.earlykdump; then
|
|
||||||
dinfo "early-kdump is enabled."
|
|
||||||
early_kdump_load
|
|
||||||
else
|
|
||||||
dinfo "early-kdump is disabled."
|
|
||||||
fi
|
|
||||||
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
set_early_kdump
|
|
||||||
@ -1,48 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
export PATH=/usr/bin:/usr/sbin
|
|
||||||
export SYSTEMD_IN_INITRD=lenient
|
|
||||||
|
|
||||||
[ -e /proc/mounts ] ||
|
|
||||||
(mkdir -p /proc && mount -t proc -o nosuid,noexec,nodev proc /proc)
|
|
||||||
|
|
||||||
grep -q '^sysfs /sys sysfs' /proc/mounts ||
|
|
||||||
(mkdir -p /sys && mount -t sysfs -o nosuid,noexec,nodev sysfs /sys)
|
|
||||||
|
|
||||||
grep -q '^none / ' /proc/mounts || grep -q '^rootfs / ' /proc/mounts && ROOTFS_IS_RAMFS=1
|
|
||||||
|
|
||||||
if [ -f /proc/device-tree/rtas/ibm,kernel-dump ] || [ -f /proc/device-tree/ibm,opal/dump/mpipl-boot ]; then
|
|
||||||
mkdir /newroot
|
|
||||||
mount -t ramfs ramfs /newroot
|
|
||||||
|
|
||||||
if [ $ROOTFS_IS_RAMFS ]; then
|
|
||||||
for FILE in $(ls -A /fadumproot/); do
|
|
||||||
mv /fadumproot/$FILE /newroot/
|
|
||||||
done
|
|
||||||
exec switch_root /newroot /init
|
|
||||||
else
|
|
||||||
mkdir /newroot/sys /newroot/proc /newroot/dev /newroot/run /newroot/oldroot
|
|
||||||
|
|
||||||
grep -q '^devtmpfs /dev devtmpfs' /proc/mounts && mount --move /dev /newroot/dev
|
|
||||||
grep -q '^tmpfs /run tmpfs' /proc/mounts && mount --move /run /newroot/run
|
|
||||||
mount --move /sys /newroot/sys
|
|
||||||
mount --move /proc /newroot/proc
|
|
||||||
|
|
||||||
cp --reflink=auto --sparse=auto --preserve=mode,timestamps,links -dfr /fadumproot/. /newroot/
|
|
||||||
cd /newroot && pivot_root . oldroot
|
|
||||||
|
|
||||||
loop=1
|
|
||||||
while [ $loop ]; do
|
|
||||||
unset loop
|
|
||||||
while read -r _ mp _; do
|
|
||||||
case $mp in
|
|
||||||
/oldroot/*) umount -d "$mp" && loop=1 ;;
|
|
||||||
esac
|
|
||||||
done </proc/mounts
|
|
||||||
done
|
|
||||||
umount -d -l oldroot
|
|
||||||
|
|
||||||
exec /init
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
exec /init.dracut
|
|
||||||
fi
|
|
||||||
@ -1,23 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
|
|
||||||
check() {
|
|
||||||
return 255
|
|
||||||
}
|
|
||||||
|
|
||||||
depends() {
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
install() {
|
|
||||||
mv -f "$initdir/init" "$initdir/init.dracut"
|
|
||||||
inst_script "$moddir/init-fadump.sh" /init
|
|
||||||
chmod a+x "$initdir/init"
|
|
||||||
|
|
||||||
# Install required binaries for the init script (init-fadump.sh)
|
|
||||||
inst_multiple sh modprobe grep mkdir mount
|
|
||||||
if dracut_module_included "squash"; then
|
|
||||||
inst_multiple cp pivot_root umount
|
|
||||||
else
|
|
||||||
inst_multiple ls mv switch_root
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
@ -1,30 +0,0 @@
|
|||||||
# This file is part of systemd.
|
|
||||||
#
|
|
||||||
# systemd is free software; you can redistribute it and/or modify it
|
|
||||||
# under the terms of the GNU Lesser General Public License as published by
|
|
||||||
# the Free Software Foundation; either version 2.1 of the License, or
|
|
||||||
# (at your option) any later version.
|
|
||||||
|
|
||||||
[Unit]
|
|
||||||
Description=Kdump Vmcore Save Service
|
|
||||||
After=initrd.target initrd-parse-etc.service sysroot.mount
|
|
||||||
After=dracut-initqueue.service dracut-pre-mount.service dracut-mount.service dracut-pre-pivot.service
|
|
||||||
Before=initrd-cleanup.service
|
|
||||||
ConditionPathExists=/etc/initrd-release
|
|
||||||
OnFailure=emergency.target
|
|
||||||
OnFailureJobMode=isolate
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Environment=DRACUT_SYSTEMD=1
|
|
||||||
Environment=NEWROOT=/sysroot
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/bin/kdump.sh
|
|
||||||
StandardInput=null
|
|
||||||
StandardOutput=syslog
|
|
||||||
StandardError=syslog+console
|
|
||||||
KillMode=process
|
|
||||||
RemainAfterExit=yes
|
|
||||||
|
|
||||||
# Bash ignores SIGTERM, so we send SIGHUP instead, to ensure that bash
|
|
||||||
# terminates cleanly.
|
|
||||||
KillSignal=SIGHUP
|
|
||||||
@ -1,27 +0,0 @@
|
|||||||
# This service will run the real kdump error handler code. Executing the
|
|
||||||
# failure action configured in kdump.conf
|
|
||||||
|
|
||||||
[Unit]
|
|
||||||
Description=Kdump Error Handler
|
|
||||||
DefaultDependencies=no
|
|
||||||
After=systemd-vconsole-setup.service
|
|
||||||
Wants=systemd-vconsole-setup.service
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Environment=HOME=/
|
|
||||||
Environment=DRACUT_SYSTEMD=1
|
|
||||||
Environment=NEWROOT=/sysroot
|
|
||||||
WorkingDirectory=/
|
|
||||||
ExecStart=/bin/kdump.sh --error-handler
|
|
||||||
ExecStopPost=-/bin/rm -f -- /.console_lock
|
|
||||||
Type=oneshot
|
|
||||||
StandardInput=tty-force
|
|
||||||
StandardOutput=inherit
|
|
||||||
StandardError=inherit
|
|
||||||
KillMode=process
|
|
||||||
IgnoreSIGPIPE=no
|
|
||||||
TasksMax=infinity
|
|
||||||
|
|
||||||
# Bash ignores SIGTERM, so we send SIGHUP instead, to ensure that bash
|
|
||||||
# terminates cleanly.
|
|
||||||
KillSignal=SIGHUP
|
|
||||||
@ -1,14 +0,0 @@
|
|||||||
# This file is part of systemd.
|
|
||||||
#
|
|
||||||
# systemd is free software; you can redistribute it and/or modify it
|
|
||||||
# under the terms of the GNU Lesser General Public License as published by
|
|
||||||
# the Free Software Foundation; either version 2.1 of the License, or
|
|
||||||
# (at your option) any later version.
|
|
||||||
|
|
||||||
[Unit]
|
|
||||||
Description=Emergency Mode
|
|
||||||
Documentation=man:systemd.special(7)
|
|
||||||
Requires=emergency.service
|
|
||||||
After=emergency.service
|
|
||||||
AllowIsolate=yes
|
|
||||||
IgnoreOnIsolate=yes
|
|
||||||
@ -1,618 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
#
|
|
||||||
# The main kdump routine in capture kernel, bash may not be the
|
|
||||||
# default shell. Any code added must be POSIX compliant.
|
|
||||||
|
|
||||||
. /lib/dracut-lib.sh
|
|
||||||
. /lib/kdump-logger.sh
|
|
||||||
. /lib/kdump-lib-initramfs.sh
|
|
||||||
|
|
||||||
#initiate the kdump logger
|
|
||||||
if ! dlog_init; then
|
|
||||||
echo "failed to initiate the kdump logger."
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
KDUMP_PATH="/var/crash"
|
|
||||||
KDUMP_LOG_FILE="/run/initramfs/kexec-dmesg.log"
|
|
||||||
CORE_COLLECTOR=""
|
|
||||||
DEFAULT_CORE_COLLECTOR="makedumpfile -l --message-level 7 -d 31"
|
|
||||||
DMESG_COLLECTOR="/sbin/vmcore-dmesg"
|
|
||||||
FAILURE_ACTION="systemctl reboot -f"
|
|
||||||
DATEDIR=$(date +%Y-%m-%d-%T)
|
|
||||||
HOST_IP='127.0.0.1'
|
|
||||||
DUMP_INSTRUCTION=""
|
|
||||||
SSH_KEY_LOCATION="/root/.ssh/kdump_id_rsa"
|
|
||||||
DD_BLKSIZE=512
|
|
||||||
FINAL_ACTION="systemctl reboot -f"
|
|
||||||
KDUMP_PRE=""
|
|
||||||
KDUMP_POST=""
|
|
||||||
NEWROOT="/sysroot"
|
|
||||||
OPALCORE="/sys/firmware/opal/mpipl/core"
|
|
||||||
KDUMP_CONF_PARSED="/tmp/kdump.conf.$$"
|
|
||||||
|
|
||||||
# POSIX doesn't have pipefail, only apply when using bash
|
|
||||||
# shellcheck disable=SC3040
|
|
||||||
[ -n "$BASH" ] && set -o pipefail
|
|
||||||
|
|
||||||
DUMP_RETVAL=0
|
|
||||||
|
|
||||||
kdump_read_conf > $KDUMP_CONF_PARSED
|
|
||||||
|
|
||||||
get_kdump_confs()
|
|
||||||
{
|
|
||||||
while read -r config_opt config_val; do
|
|
||||||
# remove inline comments after the end of a directive.
|
|
||||||
case "$config_opt" in
|
|
||||||
path)
|
|
||||||
KDUMP_PATH="$config_val"
|
|
||||||
;;
|
|
||||||
core_collector)
|
|
||||||
[ -n "$config_val" ] && CORE_COLLECTOR="$config_val"
|
|
||||||
;;
|
|
||||||
sshkey)
|
|
||||||
if [ -f "$config_val" ]; then
|
|
||||||
SSH_KEY_LOCATION=$config_val
|
|
||||||
fi
|
|
||||||
;;
|
|
||||||
kdump_pre)
|
|
||||||
KDUMP_PRE="$config_val"
|
|
||||||
;;
|
|
||||||
kdump_post)
|
|
||||||
KDUMP_POST="$config_val"
|
|
||||||
;;
|
|
||||||
fence_kdump_args)
|
|
||||||
FENCE_KDUMP_ARGS="$config_val"
|
|
||||||
;;
|
|
||||||
fence_kdump_nodes)
|
|
||||||
FENCE_KDUMP_NODES="$config_val"
|
|
||||||
;;
|
|
||||||
failure_action | default)
|
|
||||||
case $config_val in
|
|
||||||
shell)
|
|
||||||
FAILURE_ACTION="kdump_emergency_shell"
|
|
||||||
;;
|
|
||||||
reboot)
|
|
||||||
FAILURE_ACTION="systemctl reboot -f && exit"
|
|
||||||
;;
|
|
||||||
halt)
|
|
||||||
FAILURE_ACTION="halt && exit"
|
|
||||||
;;
|
|
||||||
poweroff)
|
|
||||||
FAILURE_ACTION="systemctl poweroff -f && exit"
|
|
||||||
;;
|
|
||||||
dump_to_rootfs)
|
|
||||||
FAILURE_ACTION="dump_to_rootfs"
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
;;
|
|
||||||
final_action)
|
|
||||||
case $config_val in
|
|
||||||
reboot)
|
|
||||||
FINAL_ACTION="systemctl reboot -f"
|
|
||||||
;;
|
|
||||||
halt)
|
|
||||||
FINAL_ACTION="halt"
|
|
||||||
;;
|
|
||||||
poweroff)
|
|
||||||
FINAL_ACTION="systemctl poweroff -f"
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
done < "$KDUMP_CONF_PARSED"
|
|
||||||
|
|
||||||
if [ -z "$CORE_COLLECTOR" ]; then
|
|
||||||
CORE_COLLECTOR="$DEFAULT_CORE_COLLECTOR"
|
|
||||||
if is_ssh_dump_target || is_raw_dump_target; then
|
|
||||||
CORE_COLLECTOR="$CORE_COLLECTOR -F"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
# store the kexec kernel log to a file.
|
|
||||||
save_log()
|
|
||||||
{
|
|
||||||
dmesg -T > $KDUMP_LOG_FILE
|
|
||||||
|
|
||||||
if command -v journalctl > /dev/null; then
|
|
||||||
journalctl -ab >> $KDUMP_LOG_FILE
|
|
||||||
fi
|
|
||||||
chmod 600 $KDUMP_LOG_FILE
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: dump path, must be a mount point
|
|
||||||
dump_fs()
|
|
||||||
{
|
|
||||||
ddebug "dump_fs _mp=$1"
|
|
||||||
|
|
||||||
if ! is_mounted "$1"; then
|
|
||||||
dinfo "dump path '$1' is not mounted, trying to mount..."
|
|
||||||
if ! mount --target "$1"; then
|
|
||||||
derror "failed to dump to '$1', it's not a mount point!"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Remove -F in makedumpfile case. We don't want a flat format dump here.
|
|
||||||
case $CORE_COLLECTOR in
|
|
||||||
*makedumpfile*)
|
|
||||||
CORE_COLLECTOR=$(echo "$CORE_COLLECTOR" | sed -e "s/-F//g")
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
_dump_fs_path=$(echo "$1/$KDUMP_PATH/$HOST_IP-$DATEDIR/" | tr -s /)
|
|
||||||
dinfo "saving to $_dump_fs_path"
|
|
||||||
|
|
||||||
# Only remount to read-write mode if the dump target is mounted read-only.
|
|
||||||
_dump_mnt_op=$(get_mount_info OPTIONS target "$1" -f)
|
|
||||||
case $_dump_mnt_op in
|
|
||||||
ro*)
|
|
||||||
dinfo "Remounting the dump target in rw mode."
|
|
||||||
mount -o remount,rw "$1" || return 1
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
mkdir -p "$_dump_fs_path" || return 1
|
|
||||||
|
|
||||||
save_vmcore_dmesg_fs ${DMESG_COLLECTOR} "$_dump_fs_path"
|
|
||||||
save_opalcore_fs "$_dump_fs_path"
|
|
||||||
|
|
||||||
dinfo "saving vmcore"
|
|
||||||
$CORE_COLLECTOR /proc/vmcore "$_dump_fs_path/vmcore-incomplete"
|
|
||||||
_dump_exitcode=$?
|
|
||||||
if [ $_dump_exitcode -eq 0 ]; then
|
|
||||||
sync -f "$_dump_fs_path/vmcore-incomplete"
|
|
||||||
_sync_exitcode=$?
|
|
||||||
if [ $_sync_exitcode -eq 0 ]; then
|
|
||||||
mv "$_dump_fs_path/vmcore-incomplete" "$_dump_fs_path/vmcore"
|
|
||||||
dinfo "saving vmcore complete"
|
|
||||||
else
|
|
||||||
derror "sync vmcore failed, exitcode:$_sync_exitcode"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
derror "saving vmcore failed, exitcode:$_dump_exitcode"
|
|
||||||
fi
|
|
||||||
|
|
||||||
dinfo "saving the $KDUMP_LOG_FILE to $_dump_fs_path/"
|
|
||||||
save_log
|
|
||||||
mv "$KDUMP_LOG_FILE" "$_dump_fs_path/"
|
|
||||||
if [ $_dump_exitcode -ne 0 ]; then
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
# improper kernel cmdline can cause the failure of echo, we can ignore this kind of failure
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: dmesg collector
|
|
||||||
# $2: dump path
|
|
||||||
save_vmcore_dmesg_fs()
|
|
||||||
{
|
|
||||||
dinfo "saving vmcore-dmesg.txt to $2"
|
|
||||||
if $1 /proc/vmcore > "$2/vmcore-dmesg-incomplete.txt"; then
|
|
||||||
mv "$2/vmcore-dmesg-incomplete.txt" "$2/vmcore-dmesg.txt"
|
|
||||||
chmod 600 "$2/vmcore-dmesg.txt"
|
|
||||||
|
|
||||||
# Make sure file is on disk. There have been instances where later
|
|
||||||
# saving vmcore failed and system rebooted without sync and there
|
|
||||||
# was no vmcore-dmesg.txt available.
|
|
||||||
sync
|
|
||||||
dinfo "saving vmcore-dmesg.txt complete"
|
|
||||||
else
|
|
||||||
if [ -f "$2/vmcore-dmesg-incomplete.txt" ]; then
|
|
||||||
chmod 600 "$2/vmcore-dmesg-incomplete.txt"
|
|
||||||
fi
|
|
||||||
derror "saving vmcore-dmesg.txt failed"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: dump path
|
|
||||||
save_opalcore_fs()
|
|
||||||
{
|
|
||||||
if [ ! -f $OPALCORE ]; then
|
|
||||||
# Check if we are on an old kernel that uses a different path
|
|
||||||
if [ -f /sys/firmware/opal/core ]; then
|
|
||||||
OPALCORE="/sys/firmware/opal/core"
|
|
||||||
else
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
dinfo "saving opalcore:$OPALCORE to $1/opalcore"
|
|
||||||
if ! cp $OPALCORE "$1/opalcore"; then
|
|
||||||
derror "saving opalcore failed"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
sync
|
|
||||||
dinfo "saving opalcore complete"
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
dump_to_rootfs()
|
|
||||||
{
|
|
||||||
|
|
||||||
if [ "$(systemctl status dracut-initqueue | sed -n "s/^\s*Active: \(\S*\)\s.*$/\1/p")" = "inactive" ]; then
|
|
||||||
dinfo "Trying to bring up initqueue for rootfs mount"
|
|
||||||
systemctl start dracut-initqueue
|
|
||||||
fi
|
|
||||||
|
|
||||||
dinfo "Clean up dead systemd services"
|
|
||||||
systemctl cancel
|
|
||||||
dinfo "Waiting for rootfs mount, will timeout after 90 seconds"
|
|
||||||
systemctl start --no-block sysroot.mount
|
|
||||||
|
|
||||||
_loop=0
|
|
||||||
while [ $_loop -lt 90 ] && ! is_mounted /sysroot; do
|
|
||||||
sleep 1
|
|
||||||
_loop=$((_loop + 1))
|
|
||||||
done
|
|
||||||
|
|
||||||
if ! is_mounted /sysroot; then
|
|
||||||
derror "Failed to mount rootfs"
|
|
||||||
return
|
|
||||||
fi
|
|
||||||
|
|
||||||
ddebug "NEWROOT=$NEWROOT"
|
|
||||||
dump_fs $NEWROOT
|
|
||||||
}
|
|
||||||
|
|
||||||
kdump_emergency_shell()
|
|
||||||
{
|
|
||||||
ddebug "Switching to kdump emergency shell..."
|
|
||||||
|
|
||||||
[ -f /etc/profile ] && . /etc/profile
|
|
||||||
export PS1='kdump:${PWD}# '
|
|
||||||
|
|
||||||
. /lib/dracut-lib.sh
|
|
||||||
if [ -f /dracut-state.sh ]; then
|
|
||||||
. /dracut-state.sh 2> /dev/null
|
|
||||||
fi
|
|
||||||
|
|
||||||
source_conf /etc/conf.d
|
|
||||||
|
|
||||||
type plymouth > /dev/null 2>&1 && plymouth quit
|
|
||||||
|
|
||||||
source_hook "emergency"
|
|
||||||
while read -r _tty rest; do
|
|
||||||
(
|
|
||||||
echo
|
|
||||||
echo
|
|
||||||
echo 'Entering kdump emergency mode.'
|
|
||||||
echo 'Type "journalctl" to view system logs.'
|
|
||||||
echo 'Type "rdsosreport" to generate a sosreport, you can then'
|
|
||||||
echo 'save it elsewhere and attach it to a bug report.'
|
|
||||||
echo
|
|
||||||
echo
|
|
||||||
) > "/dev/$_tty"
|
|
||||||
done < /proc/consoles
|
|
||||||
sh -i -l
|
|
||||||
/bin/rm -f -- /.console_lock
|
|
||||||
}
|
|
||||||
|
|
||||||
do_failure_action()
|
|
||||||
{
|
|
||||||
dinfo "Executing failure action $FAILURE_ACTION"
|
|
||||||
eval $FAILURE_ACTION
|
|
||||||
}
|
|
||||||
|
|
||||||
do_final_action()
|
|
||||||
{
|
|
||||||
dinfo "Executing final action $FINAL_ACTION"
|
|
||||||
eval $FINAL_ACTION
|
|
||||||
}
|
|
||||||
|
|
||||||
do_dump()
|
|
||||||
{
|
|
||||||
eval $DUMP_INSTRUCTION
|
|
||||||
_ret=$?
|
|
||||||
|
|
||||||
if [ $_ret -ne 0 ]; then
|
|
||||||
derror "saving vmcore failed"
|
|
||||||
fi
|
|
||||||
|
|
||||||
return $_ret
|
|
||||||
}
|
|
||||||
|
|
||||||
do_kdump_pre()
|
|
||||||
{
|
|
||||||
if [ -n "$KDUMP_PRE" ]; then
|
|
||||||
"$KDUMP_PRE"
|
|
||||||
_ret=$?
|
|
||||||
if [ $_ret -ne 0 ]; then
|
|
||||||
derror "$KDUMP_PRE exited with $_ret status"
|
|
||||||
return $_ret
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# if any script fails, it just raises warning and continues
|
|
||||||
if [ -d /etc/kdump/pre.d ]; then
|
|
||||||
for file in /etc/kdump/pre.d/*; do
|
|
||||||
"$file"
|
|
||||||
_ret=$?
|
|
||||||
if [ $_ret -ne 0 ]; then
|
|
||||||
derror "$file exited with $_ret status"
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
fi
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
do_kdump_post()
|
|
||||||
{
|
|
||||||
if [ -d /etc/kdump/post.d ]; then
|
|
||||||
for file in /etc/kdump/post.d/*; do
|
|
||||||
"$file" "$1"
|
|
||||||
_ret=$?
|
|
||||||
if [ $_ret -ne 0 ]; then
|
|
||||||
derror "$file exited with $_ret status"
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ -n "$KDUMP_POST" ]; then
|
|
||||||
"$KDUMP_POST" "$1"
|
|
||||||
_ret=$?
|
|
||||||
if [ $_ret -ne 0 ]; then
|
|
||||||
derror "$KDUMP_POST exited with $_ret status"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: block target, eg. /dev/sda
|
|
||||||
dump_raw()
|
|
||||||
{
|
|
||||||
[ -b "$1" ] || return 1
|
|
||||||
|
|
||||||
dinfo "saving to raw disk $1"
|
|
||||||
|
|
||||||
if ! echo "$CORE_COLLECTOR" | grep -q makedumpfile; then
|
|
||||||
_src_size=$(stat --format %s /proc/vmcore)
|
|
||||||
_src_size_mb=$((_src_size / 1048576))
|
|
||||||
/kdumpscripts/monitor_dd_progress $_src_size_mb &
|
|
||||||
fi
|
|
||||||
|
|
||||||
dinfo "saving vmcore"
|
|
||||||
$CORE_COLLECTOR /proc/vmcore | dd of="$1" bs=$DD_BLKSIZE >> /tmp/dd_progress_file 2>&1 || return 1
|
|
||||||
sync
|
|
||||||
|
|
||||||
dinfo "saving vmcore complete"
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: ssh key file
|
|
||||||
# $2: ssh address in <user>@<host> format
|
|
||||||
dump_ssh()
|
|
||||||
{
|
|
||||||
_ret=0
|
|
||||||
_ssh_opt="-i $1 -o BatchMode=yes -o StrictHostKeyChecking=yes"
|
|
||||||
_ssh_dir="$KDUMP_PATH/$HOST_IP-$DATEDIR"
|
|
||||||
if is_ipv6_address "$2"; then
|
|
||||||
_scp_address=${2%@*}@"[${2#*@}]"
|
|
||||||
else
|
|
||||||
_scp_address=$2
|
|
||||||
fi
|
|
||||||
|
|
||||||
dinfo "saving to $2:$_ssh_dir"
|
|
||||||
|
|
||||||
cat /var/lib/random-seed > /dev/urandom
|
|
||||||
ssh -q $_ssh_opt "$2" mkdir -p "$_ssh_dir" || return 1
|
|
||||||
|
|
||||||
save_vmcore_dmesg_ssh "$DMESG_COLLECTOR" "$_ssh_dir" "$_ssh_opt" "$2"
|
|
||||||
dinfo "saving vmcore"
|
|
||||||
|
|
||||||
save_opalcore_ssh "$_ssh_dir" "$_ssh_opt" "$2" "$_scp_address"
|
|
||||||
|
|
||||||
if [ "${CORE_COLLECTOR%%[[:blank:]]*}" = "scp" ]; then
|
|
||||||
scp -q $_ssh_opt /proc/vmcore "$_scp_address:$_ssh_dir/vmcore-incomplete"
|
|
||||||
_ret=$?
|
|
||||||
_vmcore="vmcore"
|
|
||||||
else
|
|
||||||
$CORE_COLLECTOR /proc/vmcore | ssh $_ssh_opt "$2" "umask 0077 && dd bs=512 of='$_ssh_dir/vmcore-incomplete'"
|
|
||||||
_ret=$?
|
|
||||||
_vmcore="vmcore.flat"
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ $_ret -eq 0 ]; then
|
|
||||||
ssh $_ssh_opt "$2" "mv '$_ssh_dir/vmcore-incomplete' '$_ssh_dir/$_vmcore'"
|
|
||||||
_ret=$?
|
|
||||||
if [ $_ret -ne 0 ]; then
|
|
||||||
derror "moving vmcore failed, exitcode:$_ret"
|
|
||||||
else
|
|
||||||
dinfo "saving vmcore complete"
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
derror "saving vmcore failed, exitcode:$_ret"
|
|
||||||
fi
|
|
||||||
|
|
||||||
dinfo "saving the $KDUMP_LOG_FILE to $2:$_ssh_dir/"
|
|
||||||
save_log
|
|
||||||
if ! scp -q $_ssh_opt $KDUMP_LOG_FILE "$_scp_address:$_ssh_dir/"; then
|
|
||||||
derror "saving log file failed, _exitcode:$_ret"
|
|
||||||
fi
|
|
||||||
|
|
||||||
return $_ret
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: dump path
|
|
||||||
# $2: ssh opts
|
|
||||||
# $3: ssh address in <user>@<host> format
|
|
||||||
# $4: scp address, similar with ssh address but IPv6 addresses are quoted
|
|
||||||
save_opalcore_ssh()
|
|
||||||
{
|
|
||||||
if [ ! -f $OPALCORE ]; then
|
|
||||||
# Check if we are on an old kernel that uses a different path
|
|
||||||
if [ -f /sys/firmware/opal/core ]; then
|
|
||||||
OPALCORE="/sys/firmware/opal/core"
|
|
||||||
else
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
dinfo "saving opalcore:$OPALCORE to $3:$1"
|
|
||||||
|
|
||||||
if ! scp $2 $OPALCORE "$4:$1/opalcore-incomplete"; then
|
|
||||||
derror "saving opalcore failed"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
ssh $2 "$3" mv "$1/opalcore-incomplete" "$1/opalcore"
|
|
||||||
dinfo "saving opalcore complete"
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: dmesg collector
|
|
||||||
# $2: dump path
|
|
||||||
# $3: ssh opts
|
|
||||||
# $4: ssh address in <user>@<host> format
|
|
||||||
save_vmcore_dmesg_ssh()
|
|
||||||
{
|
|
||||||
dinfo "saving vmcore-dmesg.txt to $4:$2"
|
|
||||||
if $1 /proc/vmcore | ssh $3 "$4" "umask 0077 && dd of='$2/vmcore-dmesg-incomplete.txt'"; then
|
|
||||||
ssh -q $3 "$4" mv "$2/vmcore-dmesg-incomplete.txt" "$2/vmcore-dmesg.txt"
|
|
||||||
dinfo "saving vmcore-dmesg.txt complete"
|
|
||||||
else
|
|
||||||
derror "saving vmcore-dmesg.txt failed"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
wait_online_network()
|
|
||||||
{
|
|
||||||
# In some cases, network may still not be ready because nm-online is called
|
|
||||||
# with "-s" which means to wait for NetworkManager startup to complete, rather
|
|
||||||
# than waiting for network connectivity specifically. Wait 10mins more for the
|
|
||||||
# network to be truely ready in these cases.
|
|
||||||
_loop=0
|
|
||||||
while [ $_loop -lt 600 ]; do
|
|
||||||
sleep 1
|
|
||||||
_loop=$((_loop + 1))
|
|
||||||
if _route=$(kdump_get_ip_route "$1" 2> /dev/null); then
|
|
||||||
printf "%s" "$_route"
|
|
||||||
return
|
|
||||||
else
|
|
||||||
dwarn "Waiting for network to be ready (${_loop}s / 10min)"
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
derror "Oops. The network still isn't ready after waiting 10mins."
|
|
||||||
exit 1
|
|
||||||
}
|
|
||||||
|
|
||||||
get_host_ip()
|
|
||||||
{
|
|
||||||
|
|
||||||
if ! is_nfs_dump_target && ! is_ssh_dump_target; then
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
_kdump_remote_ip=$(getarg kdump_remote_ip=)
|
|
||||||
|
|
||||||
if [ -z "$_kdump_remote_ip" ]; then
|
|
||||||
derror "failed to get remote IP address!"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
if ! _route=$(wait_online_network "$_kdump_remote_ip"); then
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
_netdev=$(kdump_get_ip_route_field "$_route" "dev")
|
|
||||||
|
|
||||||
if ! _kdumpip=$(ip addr show dev "$_netdev" | grep '[ ]*inet'); then
|
|
||||||
derror "Failed to get IP of $_netdev"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
_kdumpip=$(echo "$_kdumpip" | head -n 1 | awk '{print $2}')
|
|
||||||
_kdumpip="${_kdumpip%%/*}"
|
|
||||||
HOST_IP=$_kdumpip
|
|
||||||
}
|
|
||||||
|
|
||||||
read_kdump_confs()
|
|
||||||
{
|
|
||||||
if [ ! -f "$KDUMP_CONFIG_FILE" ]; then
|
|
||||||
derror "$KDUMP_CONFIG_FILE not found"
|
|
||||||
return
|
|
||||||
fi
|
|
||||||
|
|
||||||
get_kdump_confs
|
|
||||||
|
|
||||||
# rescan for add code for dump target
|
|
||||||
while read -r config_opt config_val; do
|
|
||||||
# remove inline comments after the end of a directive.
|
|
||||||
case "$config_opt" in
|
|
||||||
dracut_args)
|
|
||||||
config_val=$(get_dracut_args_target "$config_val")
|
|
||||||
if [ -n "$config_val" ]; then
|
|
||||||
config_val=$(get_mntpoint_from_target "$config_val")
|
|
||||||
DUMP_INSTRUCTION="dump_fs $config_val"
|
|
||||||
fi
|
|
||||||
;;
|
|
||||||
ext[234] | xfs | btrfs | minix | nfs | virtiofs)
|
|
||||||
config_val=$(get_mntpoint_from_target "$config_val")
|
|
||||||
DUMP_INSTRUCTION="dump_fs $config_val"
|
|
||||||
;;
|
|
||||||
raw)
|
|
||||||
DUMP_INSTRUCTION="dump_raw $config_val"
|
|
||||||
;;
|
|
||||||
ssh)
|
|
||||||
DUMP_INSTRUCTION="dump_ssh $SSH_KEY_LOCATION $config_val"
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
done < "$KDUMP_CONF_PARSED"
|
|
||||||
}
|
|
||||||
|
|
||||||
fence_kdump_notify()
|
|
||||||
{
|
|
||||||
if [ -n "$FENCE_KDUMP_NODES" ]; then
|
|
||||||
# shellcheck disable=SC2086
|
|
||||||
$FENCE_KDUMP_SEND $FENCE_KDUMP_ARGS $FENCE_KDUMP_NODES &
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
if [ "$1" = "--error-handler" ]; then
|
|
||||||
get_kdump_confs
|
|
||||||
do_failure_action
|
|
||||||
do_final_action
|
|
||||||
|
|
||||||
exit $?
|
|
||||||
fi
|
|
||||||
|
|
||||||
# continue here only if we have to save dump.
|
|
||||||
if [ -f /etc/fadump.initramfs ] && [ ! -f /proc/device-tree/rtas/ibm,kernel-dump ] && [ ! -f /proc/device-tree/ibm,opal/dump/mpipl-boot ]; then
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
read_kdump_confs
|
|
||||||
fence_kdump_notify
|
|
||||||
|
|
||||||
if ! get_host_ip; then
|
|
||||||
derror "get_host_ip exited with non-zero status!"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ -z "$DUMP_INSTRUCTION" ]; then
|
|
||||||
DUMP_INSTRUCTION="dump_fs $NEWROOT"
|
|
||||||
fi
|
|
||||||
|
|
||||||
if ! do_kdump_pre; then
|
|
||||||
derror "kdump_pre script exited with non-zero status!"
|
|
||||||
do_final_action
|
|
||||||
# During systemd service to reboot the machine, stop this shell script running
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
make_trace_mem "kdump saving vmcore" '1:shortmem' '2+:mem' '3+:slab'
|
|
||||||
do_dump
|
|
||||||
DUMP_RETVAL=$?
|
|
||||||
|
|
||||||
if ! do_kdump_post $DUMP_RETVAL; then
|
|
||||||
derror "kdump_post script exited with non-zero status!"
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ $DUMP_RETVAL -ne 0 ]; then
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
do_final_action
|
|
||||||
File diff suppressed because it is too large
Load Diff
@ -1,28 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
|
|
||||||
SRC_FILE_MB=$1
|
|
||||||
|
|
||||||
while true
|
|
||||||
do
|
|
||||||
DD_PID=`pidof dd`
|
|
||||||
if [ -n "$DD_PID" ]; then
|
|
||||||
break
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
while true
|
|
||||||
do
|
|
||||||
sleep 5
|
|
||||||
if [ ! -d /proc/$DD_PID ]; then
|
|
||||||
break
|
|
||||||
fi
|
|
||||||
|
|
||||||
kill -s USR1 $DD_PID
|
|
||||||
CURRENT_SIZE=`tail -n 1 /tmp/dd_progress_file | sed "s/[^0-9].*//g"`
|
|
||||||
[ -n "$CURRENT_SIZE" ] && {
|
|
||||||
CURRENT_MB=$(($CURRENT_SIZE / 1048576))
|
|
||||||
echo -e "Copied $CURRENT_MB MB / $SRC_FILE_MB MB\r"
|
|
||||||
}
|
|
||||||
done
|
|
||||||
|
|
||||||
rm -f /tmp/dd_progress_file
|
|
||||||
@ -1,95 +0,0 @@
|
|||||||
Early Kdump HOWTO
|
|
||||||
|
|
||||||
Introduction
|
|
||||||
------------
|
|
||||||
|
|
||||||
Early kdump is a mechanism to make kdump operational earlier than normal kdump
|
|
||||||
service. The kdump service starts early enough for general crash cases, but
|
|
||||||
there are some cases where it has no chance to make kdump operational in boot
|
|
||||||
sequence, such as detecting devices and starting early services. If you hit
|
|
||||||
such a case, early kdump may allow you to get more information of it.
|
|
||||||
|
|
||||||
Early kdump is implemented as a dracut module. It adds a kernel (vmlinuz) and
|
|
||||||
initramfs for kdump to your system's initramfs in order to load them as early
|
|
||||||
as possible. After that, if you provide "rd.earlykdump" in kernel command line,
|
|
||||||
then in the initramfs, early kdump will load those files like the normal kdump
|
|
||||||
service. This is disabled by default.
|
|
||||||
|
|
||||||
For the normal kdump service, it can check whether the early kdump has loaded
|
|
||||||
the crash kernel and initramfs. It has no conflict with the early kdump.
|
|
||||||
|
|
||||||
How to configure early kdump
|
|
||||||
----------------------------
|
|
||||||
|
|
||||||
We assume if you're reading this document, you should already have kexec-tools
|
|
||||||
installed.
|
|
||||||
|
|
||||||
You can rebuild the initramfs with earlykdump support with below steps:
|
|
||||||
|
|
||||||
1. start kdump service to make sure kdump initramfs is created.
|
|
||||||
|
|
||||||
# systemctl start kdump
|
|
||||||
|
|
||||||
NOTE: If a crash occurs during boot process, early kdump captures a vmcore
|
|
||||||
and reboot the system by default, so the system might go into crash loop.
|
|
||||||
You can avoid such a crash loop by adding the following settings, which
|
|
||||||
power off the system after dump capturing, to kdump.conf in advance:
|
|
||||||
|
|
||||||
final_action poweroff
|
|
||||||
failure_action poweroff
|
|
||||||
|
|
||||||
For the failure_action, you can choose anything other than "reboot".
|
|
||||||
|
|
||||||
2. rebuild system initramfs with earlykdump support.
|
|
||||||
|
|
||||||
# dracut --force --add earlykdump
|
|
||||||
|
|
||||||
NOTE: Recommend to backup the original system initramfs before performing
|
|
||||||
this step to put it back if something happens during boot-up.
|
|
||||||
|
|
||||||
3. add rd.earlykdump in grub kernel command line.
|
|
||||||
|
|
||||||
After making said changes, reboot your system to take effect. Of course, if you
|
|
||||||
want to disable early kdump, you can simply remove "rd.earlykdump" from kernel
|
|
||||||
boot parameters in grub, and reboot system like above.
|
|
||||||
|
|
||||||
Once the boot is completed, you can check the status of the early kdump support
|
|
||||||
on the command prompt:
|
|
||||||
|
|
||||||
# journalctl -b | grep early-kdump
|
|
||||||
|
|
||||||
Then, you will see some useful logs, for example:
|
|
||||||
|
|
||||||
- if early kdump is successful.
|
|
||||||
|
|
||||||
Mar 09 09:57:56 localhost dracut-cmdline[190]: early-kdump is enabled.
|
|
||||||
Mar 09 09:57:56 localhost dracut-cmdline[190]: kexec: loaded early-kdump kernel
|
|
||||||
|
|
||||||
- if early kdump is disabled.
|
|
||||||
|
|
||||||
Mar 09 10:02:47 localhost dracut-cmdline[189]: early-kdump is disabled.
|
|
||||||
|
|
||||||
Notes
|
|
||||||
-----
|
|
||||||
|
|
||||||
- The size of early kdump initramfs will be large because it includes vmlinuz
|
|
||||||
and kdump initramfs.
|
|
||||||
|
|
||||||
- Early kdump inherits the settings of normal kdump, so any changes that
|
|
||||||
caused normal kdump rebuilding also require rebuilding the system initramfs
|
|
||||||
to make sure that the changes take effect for early kdump. Therefore, after
|
|
||||||
the rebuilding of kdump initramfs is completed, provide a prompt message to
|
|
||||||
tell the fact.
|
|
||||||
|
|
||||||
- If you install an updated kernel and reboot the system with it, the early
|
|
||||||
kdump will be disabled by default. To enable it with the new kernel, you
|
|
||||||
need to take the above steps again.
|
|
||||||
|
|
||||||
Limitation
|
|
||||||
----------
|
|
||||||
|
|
||||||
- At present, early kdump doesn't support fadump.
|
|
||||||
|
|
||||||
- Early kdump loads a crash kernel and initramfs at the beginning of the
|
|
||||||
process in system's initramfs, so a crash at earlier than that (e.g. in
|
|
||||||
kernel initialization) cannot be captured even with the early kdump.
|
|
||||||
@ -1,359 +0,0 @@
|
|||||||
Firmware assisted dump (fadump) HOWTO
|
|
||||||
|
|
||||||
Introduction
|
|
||||||
|
|
||||||
Firmware assisted dump is a new feature in the 3.4 mainline kernel supported
|
|
||||||
only on powerpc architecture. The goal of firmware-assisted dump is to enable
|
|
||||||
the dump of a crashed system, and to do so from a fully-reset system, and to
|
|
||||||
minimize the total elapsed time until the system is back in production use. A
|
|
||||||
complete documentation on implementation can be found at
|
|
||||||
Documentation/powerpc/firmware-assisted-dump.txt in upstream linux kernel tree
|
|
||||||
from 3.4 version and above.
|
|
||||||
|
|
||||||
Please note that the firmware-assisted dump feature is only available on Power6
|
|
||||||
and above systems with recent firmware versions.
|
|
||||||
|
|
||||||
Overview
|
|
||||||
|
|
||||||
Fadump
|
|
||||||
|
|
||||||
Fadump is a robust kernel crash dumping mechanism to get reliable kernel crash
|
|
||||||
dump with assistance from firmware. This approach does not use kexec, instead
|
|
||||||
firmware assists in booting the kdump kernel while preserving memory contents.
|
|
||||||
Unlike kdump, the system is fully reset, and loaded with a fresh copy of the
|
|
||||||
kernel. In particular, PCI and I/O devices are reinitialized and are in a
|
|
||||||
clean, consistent state. This second kernel, often called a capture kernel,
|
|
||||||
boots with very little memory and captures the dump image.
|
|
||||||
|
|
||||||
The first kernel registers the sections of memory with the Power firmware for
|
|
||||||
dump preservation during OS initialization. These registered sections of memory
|
|
||||||
are reserved by the first kernel during early boot. When a system crashes, the
|
|
||||||
Power firmware fully resets the system, preserves all the system memory
|
|
||||||
contents, save the low memory (boot memory of size larger of 5% of system
|
|
||||||
RAM or 256MB) of RAM to the previous registered region. It will also save
|
|
||||||
system registers, and hardware PTE's.
|
|
||||||
|
|
||||||
Fadump is supported only on ppc64 platform. The standard kernel and capture
|
|
||||||
kernel are one and the same on ppc64.
|
|
||||||
|
|
||||||
If you're reading this document, you should already have kexec-tools
|
|
||||||
installed. If not, you install it via the following command:
|
|
||||||
|
|
||||||
# dnf install kexec-tools
|
|
||||||
|
|
||||||
Fadump Operational Flow:
|
|
||||||
|
|
||||||
Like kdump, fadump also exports the ELF formatted kernel crash dump through
|
|
||||||
/proc/vmcore. Hence existing kdump infrastructure can be used to capture fadump
|
|
||||||
vmcore. The idea is to keep the functionality transparent to end user. From
|
|
||||||
user perspective there is no change in the way kdump init script works.
|
|
||||||
|
|
||||||
However, unlike kdump, fadump does not pre-load kdump kernel and initrd into
|
|
||||||
reserved memory, instead it always uses default OS initrd during second boot
|
|
||||||
after crash. Hence, for fadump, we rebuild the new kdump initrd and replace it
|
|
||||||
with default initrd. Before replacing existing default initrd we take a backup
|
|
||||||
of original default initrd for user's reference. The dracut package has been
|
|
||||||
enhanced to rebuild the default initrd with vmcore capture steps. The initrd
|
|
||||||
image is rebuilt as per the configuration in /etc/kdump.conf file.
|
|
||||||
|
|
||||||
The control flow of fadump works as follows:
|
|
||||||
01. System panics.
|
|
||||||
02. At the crash, kernel informs power firmware that kernel has crashed.
|
|
||||||
03. Firmware takes the control and reboots the entire system preserving
|
|
||||||
only the memory (resets all other devices).
|
|
||||||
04. The reboot follows the normal booting process (non-kexec).
|
|
||||||
05. The boot loader loads the default kernel and initrd from /boot
|
|
||||||
06. The default initrd loads and runs /init
|
|
||||||
07. dracut-kdump.sh script present in fadump aware default initrd checks if
|
|
||||||
'/proc/device-tree/rtas/ibm,kernel-dump' file exists before executing
|
|
||||||
steps to capture vmcore.
|
|
||||||
(This check will help to bypass the vmcore capture steps during normal boot
|
|
||||||
process.)
|
|
||||||
09. Captures dump according to /etc/kdump.conf
|
|
||||||
10. Is dump capture successful (yes goto 12, no goto 11)
|
|
||||||
11. Perform the failure action specified in /etc/kdump.conf
|
|
||||||
(The default failure action is reboot, if unspecified)
|
|
||||||
12. Perform the final action specified in /etc/kdump.conf
|
|
||||||
(The default final action is reboot, if unspecified)
|
|
||||||
|
|
||||||
|
|
||||||
How to configure fadump:
|
|
||||||
|
|
||||||
Again, we assume if you're reading this document, you should already have
|
|
||||||
kexec-tools installed. If not, you install it via the following command:
|
|
||||||
|
|
||||||
# dnf install kexec-tools
|
|
||||||
|
|
||||||
Make the kernel to be configured with FADump as the default boot entry, if
|
|
||||||
it isn't already:
|
|
||||||
|
|
||||||
# grubby --set-default=/boot/vmlinuz-<kver>
|
|
||||||
|
|
||||||
Boot into the kernel to be configured for FADump. To be able to do much of
|
|
||||||
anything interesting in the way of debug analysis, you'll also need to install
|
|
||||||
the kernel-debuginfo package, of the same arch as your running kernel, and the
|
|
||||||
crash utility:
|
|
||||||
|
|
||||||
# dnf --enablerepo=\*debuginfo install kernel-debuginfo.$(uname -m) crash
|
|
||||||
|
|
||||||
Next up, we can enable firmware assisted dump and reserve the memory for boot
|
|
||||||
memory preservation as specified in in the table of 'FADump Memory Requirements'
|
|
||||||
section:
|
|
||||||
|
|
||||||
# kdumpctl reset-crashkernel --fadump=on
|
|
||||||
|
|
||||||
Alternatively, you can use grubby to reserve custom amount of memory:
|
|
||||||
|
|
||||||
# grubby --args="fadump=on crashkernel=6G" --update-kernel=/boot/vmlinuz-`uname -r`
|
|
||||||
|
|
||||||
By default, FADump reserved memory will be initialized as CMA area to make the
|
|
||||||
memory available through CMA allocator on the production kernel. We can opt out
|
|
||||||
of this, making reserved memory unavailable to production kernel, by booting the
|
|
||||||
linux kernel with 'fadump=nocma' instead of 'fadump=on':
|
|
||||||
|
|
||||||
# kdumpctl reset-crashkernel --fadump=nocma
|
|
||||||
|
|
||||||
The term 'boot memory' means size of the low memory chunk that is required for
|
|
||||||
a kernel to boot successfully when booted with restricted memory. By default,
|
|
||||||
the boot memory size will be the larger of 5% of system RAM or 256MB.
|
|
||||||
Alternatively, user can also specify boot memory size through boot parameter
|
|
||||||
'fadump_reserve_mem=' which will override the default calculated size. Use this
|
|
||||||
option if default boot memory size is not sufficient for second kernel to boot
|
|
||||||
successfully.
|
|
||||||
|
|
||||||
After making said changes, reboot your system, so that the specified memory is
|
|
||||||
reserved and left untouched by the normal system. Take note that the output of
|
|
||||||
'free -m' will show X MB less memory than without this parameter, which is
|
|
||||||
expected. If you see OOM (Out Of Memory) error messages while loading capture
|
|
||||||
kernel, then you should bump up the memory reservation size.
|
|
||||||
|
|
||||||
Now that you've got that reserved memory region set up, you want to turn on
|
|
||||||
the kdump init script:
|
|
||||||
|
|
||||||
# systemctl enable kdump.service
|
|
||||||
|
|
||||||
Then, start up kdump as well:
|
|
||||||
|
|
||||||
# systemctl start kdump.service
|
|
||||||
|
|
||||||
This should turn on the firmware assisted functionality in kernel by
|
|
||||||
echo'ing 1 to /sys/kernel/fadump/registered, leaving the system ready
|
|
||||||
to capture a vmcore upon crashing. For journaling filesystems like XFS an
|
|
||||||
additional step is required to ensure bootloader does not pick the
|
|
||||||
older initrd (without vmcore capture scripts):
|
|
||||||
|
|
||||||
* If /boot is a separate partition, run the below commands as the root user,
|
|
||||||
or as a user with CAP_SYS_ADMIN rights:
|
|
||||||
|
|
||||||
# fsfreeze -f
|
|
||||||
# fsfreeze -u
|
|
||||||
|
|
||||||
* If /boot is not a separate partition, reboot the system.
|
|
||||||
|
|
||||||
After reboot check if the kdump service is up and running with:
|
|
||||||
|
|
||||||
# systemctl status kdump.service
|
|
||||||
|
|
||||||
To test out whether FADump is configured properly, you can force-crash your
|
|
||||||
system by echo'ing a 'c' into /proc/sysrq-trigger:
|
|
||||||
|
|
||||||
# echo c > /proc/sysrq-trigger
|
|
||||||
|
|
||||||
You should see some panic output, followed by the system reset and booting into
|
|
||||||
fresh copy of kernel. When default initrd loads and runs /init, vmcore should
|
|
||||||
be copied out to disk (by default, in /var/crash/<YYYY.MM.DD-HH:MM:SS>/vmcore),
|
|
||||||
then the system rebooted back into your normal kernel.
|
|
||||||
|
|
||||||
Once back to your normal kernel, you can use the previously installed crash
|
|
||||||
kernel in conjunction with the previously installed kernel-debuginfo to
|
|
||||||
perform postmortem analysis:
|
|
||||||
|
|
||||||
# crash /usr/lib/debug/lib/modules/2.6.17-1.2621.el5/vmlinux
|
|
||||||
/var/crash/2006-08-23-15:34/vmcore
|
|
||||||
|
|
||||||
crash> bt
|
|
||||||
|
|
||||||
and so on...
|
|
||||||
|
|
||||||
Saving vmcore-dmesg.txt
|
|
||||||
-----------------------
|
|
||||||
Kernel log bufferes are one of the most important information available
|
|
||||||
in vmcore. Now before saving vmcore, kernel log bufferes are extracted
|
|
||||||
from /proc/vmcore and saved into a file vmcore-dmesg.txt. After
|
|
||||||
vmcore-dmesg.txt, vmcore is saved. Destination disk and directory for
|
|
||||||
vmcore-dmesg.txt is same as vmcore. Note that kernel log buffers will
|
|
||||||
not be available if dump target is raw device.
|
|
||||||
|
|
||||||
FADump Memory Requirements:
|
|
||||||
|
|
||||||
System Memory Recommended memory
|
|
||||||
--------------------- ----------------------
|
|
||||||
4 GB - 16 GB : 768 MB
|
|
||||||
16 GB - 64 GB : 1024 MB
|
|
||||||
64 GB - 128 GB : 2 GB
|
|
||||||
128 GB - 1 TB : 4 GB
|
|
||||||
1 TB - 2 TB : 6 GB
|
|
||||||
2 TB - 4 TB : 12 GB
|
|
||||||
4 TB - 8 TB : 20 GB
|
|
||||||
8 TB - 16 TB : 36 GB
|
|
||||||
16 TB - 32 TB : 64 GB
|
|
||||||
32 TB - 64 TB : 128 GB
|
|
||||||
64 TB & above : 180 GB
|
|
||||||
|
|
||||||
Things to remember:
|
|
||||||
|
|
||||||
1) The memory required to boot capture Kernel is a moving target that depends
|
|
||||||
on many factors like hardware attached to the system, kernel and modules in
|
|
||||||
use, packages installed and services enabled, there is no one-size-fits-all.
|
|
||||||
But the above recommendations are based on system memory. So, the above
|
|
||||||
recommendations for FADump come with a few assumptions, based on available
|
|
||||||
system memory, about the resources the system could have. So, please take
|
|
||||||
the recommendations with a pinch of salt and remember to try capturing dump
|
|
||||||
a few times to confirm that the system is configured successfully with dump
|
|
||||||
capturing support.
|
|
||||||
|
|
||||||
2) Though the memory requirements for FADump seem high, this memory is not
|
|
||||||
completely set aside but made available for userspace applications to use,
|
|
||||||
through the CMA allocator.
|
|
||||||
|
|
||||||
3) As the same initrd is used for booting production kernel as well as capture
|
|
||||||
kernel and with dump being captured in a restricted memory environment, few
|
|
||||||
optimizations (like not inclding network dracut module, disabling multipath
|
|
||||||
and such) are applied while building the initrd. In case, the production
|
|
||||||
environment needs these optimizations to be avoided, dracut_args option in
|
|
||||||
/etc/kdump.conf file could be leveraged. For example, if a user wishes for
|
|
||||||
network module to be included in the initrd, adding the below entry in
|
|
||||||
/etc/kdump.conf file and restarting kdump service would take care of it.
|
|
||||||
|
|
||||||
dracut_args --add "network"
|
|
||||||
|
|
||||||
4) If FADump is configured to capture vmcore to a remote dump target using SSH
|
|
||||||
or NFS protocol, the corresponding network interface '<interface-name>' is
|
|
||||||
renamed to 'kdump-<interface-name>', if it is generic (like *eth# or net#).
|
|
||||||
It happens because vmcore capture scripts in the initial RAM disk (initrd)
|
|
||||||
add the 'kdump-' prefix to the network interface name to secure persistent
|
|
||||||
naming. And as capture kernel and production kernel use the same initrd in
|
|
||||||
case of FADump, the interface name is changed for the production kernel too.
|
|
||||||
This is likely to impact network configuration setup for production kernel.
|
|
||||||
So, it is recommended to use a non-generic name for a network interface,
|
|
||||||
before setting up FADump to capture vmcore to a remote dump target based on
|
|
||||||
that network interface, to avoid running into network configuration issues.
|
|
||||||
|
|
||||||
Dump Triggering methods:
|
|
||||||
|
|
||||||
This section talks about the various ways, other than a Kernel Panic, in which
|
|
||||||
fadump can be triggered. The following methods assume that fadump is configured
|
|
||||||
on your system, with the scripts enabled as described in the section above.
|
|
||||||
|
|
||||||
1) AltSysRq C
|
|
||||||
|
|
||||||
FAdump can be triggered with the combination of the 'Alt','SysRq' and 'C'
|
|
||||||
keyboard keys. Please refer to the following link for more details:
|
|
||||||
|
|
||||||
https://fedoraproject.org/wiki/QA/Sysrq
|
|
||||||
|
|
||||||
In addition, on PowerPC boxes, fadump can also be triggered via Hardware
|
|
||||||
Management Console(HMC) using 'Ctrl', 'O' and 'C' keyboard keys.
|
|
||||||
|
|
||||||
2) Kernel OOPs
|
|
||||||
|
|
||||||
If we want to generate a dump everytime the Kernel OOPses, we can achieve this
|
|
||||||
by setting the 'Panic On OOPs' option as follows:
|
|
||||||
|
|
||||||
# echo 1 > /proc/sys/kernel/panic_on_oops
|
|
||||||
|
|
||||||
3) PowerPC specific methods:
|
|
||||||
|
|
||||||
On IBM PowerPC machines, issuing a soft reset invokes the XMON debugger(if
|
|
||||||
XMON is configured). To configure XMON one needs to compile the kernel with
|
|
||||||
the CONFIG_XMON and CONFIG_XMON_DEFAULT options, or by compiling with
|
|
||||||
CONFIG_XMON and booting the kernel with xmon=on option.
|
|
||||||
|
|
||||||
Following are the ways to remotely issue a soft reset on PowerPC boxes, which
|
|
||||||
would drop you to XMON. Pressing a 'X' (capital alphabet X) followed by an
|
|
||||||
'Enter' here will trigger the dump.
|
|
||||||
|
|
||||||
3.1) HMC
|
|
||||||
|
|
||||||
Hardware Management Console(HMC) available on Power4 and Power5 machines allow
|
|
||||||
partitions to be reset remotely. This is specially useful in hang situations
|
|
||||||
where the system is not accepting any keyboard inputs.
|
|
||||||
|
|
||||||
Once you have HMC configured, the following steps will enable you to trigger
|
|
||||||
fadump via a soft reset:
|
|
||||||
|
|
||||||
On Power4
|
|
||||||
Using GUI
|
|
||||||
|
|
||||||
* In the right pane, right click on the partition you wish to dump.
|
|
||||||
* Select "Operating System->Reset".
|
|
||||||
* Select "Soft Reset".
|
|
||||||
* Select "Yes".
|
|
||||||
|
|
||||||
Using HMC Commandline
|
|
||||||
|
|
||||||
# reset_partition -m <machine> -p <partition> -t soft
|
|
||||||
|
|
||||||
On Power5
|
|
||||||
Using GUI
|
|
||||||
|
|
||||||
* In the right pane, right click on the partition you wish to dump.
|
|
||||||
* Select "Restart Partition".
|
|
||||||
* Select "Dump".
|
|
||||||
* Select "OK".
|
|
||||||
|
|
||||||
Using HMC Commandline
|
|
||||||
|
|
||||||
# chsysstate -m <managed system name> -n <lpar name> -o dumprestart -r lpar
|
|
||||||
|
|
||||||
3.2) Blade Management Console for Blade Center
|
|
||||||
|
|
||||||
To initiate a dump operation, go to Power/Restart option under "Blade Tasks" in
|
|
||||||
the Blade Management Console. Select the corresponding blade for which you want
|
|
||||||
to initate the dump and then click "Restart blade with NMI". This issues a
|
|
||||||
system reset and invokes xmon debugger.
|
|
||||||
|
|
||||||
|
|
||||||
Advanced Setups & Failure action:
|
|
||||||
|
|
||||||
Kdump and fadump exhibit similar behavior in terms of setup & failure action.
|
|
||||||
For fadump advanced setup related information see section "Advanced Setups" in
|
|
||||||
"kexec-kdump-howto.txt" document. Refer to "Failure action" section in "kexec-
|
|
||||||
kdump-howto.txt" document for fadump failure action related information.
|
|
||||||
|
|
||||||
Compression and filtering
|
|
||||||
|
|
||||||
Refer "Compression and filtering" section in "kexec-kdump-howto.txt" document.
|
|
||||||
Compression and filtering are same for kdump & fadump.
|
|
||||||
|
|
||||||
|
|
||||||
Notes on rootfs mount:
|
|
||||||
Dracut is designed to mount rootfs by default. If rootfs mounting fails it
|
|
||||||
will refuse to go on. So fadump leaves rootfs mounting to dracut currently.
|
|
||||||
We make the assumtion that proper root= cmdline is being passed to dracut
|
|
||||||
initramfs for the time being. If you need modify "KDUMP_COMMANDLINE=" in
|
|
||||||
/etc/sysconfig/kdump, you will need to make sure that appropriate root=
|
|
||||||
options are copied from /proc/cmdline. In general it is best to append
|
|
||||||
command line options using "KDUMP_COMMANDLINE_APPEND=" instead of replacing
|
|
||||||
the original command line completely.
|
|
||||||
|
|
||||||
How to disable FADump:
|
|
||||||
|
|
||||||
Remove "fadump=on"/"fadump=nocma" from kernel cmdline parameters OR replace
|
|
||||||
it with "fadump=off" kernel cmdline parameter:
|
|
||||||
|
|
||||||
# grubby --update-kernel=/boot/vmlinuz-`uname -r` --remove-args="fadump=on"
|
|
||||||
or
|
|
||||||
# grubby --update-kernel=/boot/vmlinuz-`uname -r` --remove-args="fadump=nocma"
|
|
||||||
OR
|
|
||||||
# grubby --update-kernel=/boot/vmlinuz-`uname -r` --args="fadump=off"
|
|
||||||
|
|
||||||
Remove "crashkernel=" from kernel cmdline parameters:
|
|
||||||
|
|
||||||
# grubby --update-kernel=/boot/vmlinuz-`uname -r` --remove-args="crashkernel"
|
|
||||||
|
|
||||||
If KDump is to be used as the dump capturing mechanism, reset the crashkernel parameter:
|
|
||||||
|
|
||||||
# kdumpctl reset-crashkernel --fadump=off
|
|
||||||
|
|
||||||
Reboot the system for the settings to take effect.
|
|
||||||
@ -1,231 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
# $1: target arch
|
|
||||||
|
|
||||||
SED_EXP=""
|
|
||||||
|
|
||||||
generate()
|
|
||||||
{
|
|
||||||
sed "$SED_EXP" << EOF
|
|
||||||
# This file contains a series of commands to perform (in order) in the kdump
|
|
||||||
# kernel after a kernel crash in the crash kernel(1st kernel) has happened.
|
|
||||||
#
|
|
||||||
# Directives in this file are only applicable to the kdump initramfs, and have
|
|
||||||
# no effect once the root filesystem is mounted and the normal init scripts are
|
|
||||||
# processed.
|
|
||||||
#
|
|
||||||
# Currently, only one dump target and path can be specified. If the dumping to
|
|
||||||
# the configured target fails, the failure action which can be configured via
|
|
||||||
# the "failure_action" directive will be performed.
|
|
||||||
#
|
|
||||||
# Supported options:
|
|
||||||
#
|
|
||||||
# auto_reset_crashkernel <yes|no>
|
|
||||||
# - whether to reset kernel crashkernel to new default value
|
|
||||||
# or not when kexec-tools updates the default crashkernel value and
|
|
||||||
# existing kernels using the old default kernel crashkernel value.
|
|
||||||
# The default value is yes.
|
|
||||||
#
|
|
||||||
# raw <partition>
|
|
||||||
# - Will dd /proc/vmcore into <partition>.
|
|
||||||
# Use persistent device names for partition devices,
|
|
||||||
# such as /dev/vg/<devname>.
|
|
||||||
#
|
|
||||||
# nfs <nfs mount>
|
|
||||||
# - Will mount nfs to <mnt>, and copy /proc/vmcore to
|
|
||||||
# <mnt>/<path>/%HOST-%DATE/, supports DNS.
|
|
||||||
#
|
|
||||||
# ssh <user@server>
|
|
||||||
# - Will save /proc/vmcore to <user@server>:<path>/%HOST-%DATE/,
|
|
||||||
# supports DNS.
|
|
||||||
# NOTE: make sure the user has write permissions on the server.
|
|
||||||
#
|
|
||||||
# sshkey <path>
|
|
||||||
# - Will use the sshkey to do ssh dump.
|
|
||||||
# Specify the path of the ssh key to use when dumping
|
|
||||||
# via ssh. The default value is /root/.ssh/kdump_id_rsa.
|
|
||||||
#
|
|
||||||
# <fs type> <partition>
|
|
||||||
# - Will mount -t <fs type> <partition> <mnt>, and copy
|
|
||||||
# /proc/vmcore to <mnt>/<path>/%HOST_IP-%DATE/.
|
|
||||||
# NOTE: <partition> can be a device node, label or uuid.
|
|
||||||
# It's recommended to use persistent device names
|
|
||||||
# such as /dev/vg/<devname>.
|
|
||||||
# Otherwise it's suggested to use label or uuid.
|
|
||||||
# Supported fs types: ext[234], xfs, btrfs, minix, virtiofs
|
|
||||||
#
|
|
||||||
# path <path>
|
|
||||||
# - "path" represents the file system path in which vmcore
|
|
||||||
# will be saved. If a dump target is specified in
|
|
||||||
# kdump.conf, then "path" is relative to the specified
|
|
||||||
# dump target.
|
|
||||||
#
|
|
||||||
# Interpretation of "path" changes a bit if the user didn't
|
|
||||||
# specify any dump target explicitly in kdump.conf. In this
|
|
||||||
# case, "path" represents the absolute path from root. The
|
|
||||||
# dump target and adjusted path are arrived at automatically
|
|
||||||
# depending on what's mounted in the current system.
|
|
||||||
#
|
|
||||||
# Ignored for raw device dumps. If unset, will use the default
|
|
||||||
# "/var/crash".
|
|
||||||
#
|
|
||||||
# core_collector <command> <options>
|
|
||||||
# - This allows you to specify the command to copy
|
|
||||||
# the vmcore. The default is makedumpfile, which on
|
|
||||||
# some architectures can drastically reduce vmcore size.
|
|
||||||
# See /sbin/makedumpfile --help for a list of options.
|
|
||||||
# Note that the -i and -g options are not needed here,
|
|
||||||
# as the initrd will automatically be populated with a
|
|
||||||
# config file appropriate for the running kernel.
|
|
||||||
# The default core_collector for raw/ssh dump is:
|
|
||||||
# "makedumpfile -F -l --message-level 7 -d 31".
|
|
||||||
# The default core_collector for other targets is:
|
|
||||||
# "makedumpfile -l --message-level 7 -d 31".
|
|
||||||
#
|
|
||||||
# "makedumpfile -F" will create a flattened vmcore.
|
|
||||||
# You need to use "makedumpfile -R" to rearrange the dump data to
|
|
||||||
# a normal dumpfile readable with analysis tools. For example:
|
|
||||||
# "makedumpfile -R vmcore < vmcore.flat".
|
|
||||||
#
|
|
||||||
# For core_collector format details, you can refer to
|
|
||||||
# kexec-kdump-howto.txt or kdump.conf manpage.
|
|
||||||
#
|
|
||||||
# kdump_post <binary | script>
|
|
||||||
# - This directive allows you to run a executable binary
|
|
||||||
# or script after the vmcore dump process terminates.
|
|
||||||
# The exit status of the current dump process is fed to
|
|
||||||
# the executable binary or script as its first argument.
|
|
||||||
# All files under /etc/kdump/post.d are collectively sorted
|
|
||||||
# and executed in lexical order, before binary or script
|
|
||||||
# specified kdump_post parameter is executed.
|
|
||||||
#
|
|
||||||
# kdump_pre <binary | script>
|
|
||||||
# - Works like the "kdump_post" directive, but instead of running
|
|
||||||
# after the dump process, runs immediately before it.
|
|
||||||
# Exit status of this binary is interpreted as follows:
|
|
||||||
# 0 - continue with dump process as usual
|
|
||||||
# non 0 - run the final action (reboot/poweroff/halt)
|
|
||||||
# All files under /etc/kdump/pre.d are collectively sorted and
|
|
||||||
# executed in lexical order, after binary or script specified
|
|
||||||
# kdump_pre parameter is executed.
|
|
||||||
# Even if the binary or script in /etc/kdump/pre.d directory
|
|
||||||
# returns non 0 exit status, the processing is continued.
|
|
||||||
#
|
|
||||||
# extra_bins <binaries | shell scripts>
|
|
||||||
# - This directive allows you to specify additional binaries or
|
|
||||||
# shell scripts to be included in the kdump initrd.
|
|
||||||
# Generally they are useful in conjunction with a kdump_post
|
|
||||||
# or kdump_pre binary or script which depends on these extra_bins.
|
|
||||||
#
|
|
||||||
# extra_modules <module(s)>
|
|
||||||
# - This directive allows you to specify extra kernel modules
|
|
||||||
# that you want to be loaded in the kdump initrd.
|
|
||||||
# Multiple modules can be listed, separated by spaces, and any
|
|
||||||
# dependent modules will automatically be included.
|
|
||||||
#
|
|
||||||
# failure_action <reboot | halt | poweroff | shell | dump_to_rootfs>
|
|
||||||
# - Action to perform in case dumping fails.
|
|
||||||
# reboot: Reboot the system.
|
|
||||||
# halt: Halt the system.
|
|
||||||
# poweroff: Power down the system.
|
|
||||||
# shell: Drop to a bash shell.
|
|
||||||
# Exiting the shell reboots the system by default,
|
|
||||||
# or perform "final_action".
|
|
||||||
# dump_to_rootfs: Dump vmcore to rootfs from initramfs context and
|
|
||||||
# reboot by default or perform "final_action".
|
|
||||||
# Useful when non-root dump target is specified.
|
|
||||||
# The default option is "reboot".
|
|
||||||
#
|
|
||||||
# default <reboot | halt | poweroff | shell | dump_to_rootfs>
|
|
||||||
# - Same as the "failure_action" directive above, but this directive
|
|
||||||
# is obsolete and will be removed in the future.
|
|
||||||
#
|
|
||||||
# final_action <reboot | halt | poweroff>
|
|
||||||
# - Action to perform in case dumping succeeds. Also performed
|
|
||||||
# when "shell" or "dump_to_rootfs" failure action finishes.
|
|
||||||
# Each action is same as the "failure_action" directive above.
|
|
||||||
# The default is "reboot".
|
|
||||||
#
|
|
||||||
# force_rebuild <0 | 1>
|
|
||||||
# - By default, kdump initrd will only be rebuilt when necessary.
|
|
||||||
# Specify 1 to force rebuilding kdump initrd every time when kdump
|
|
||||||
# service starts.
|
|
||||||
#
|
|
||||||
# force_no_rebuild <0 | 1>
|
|
||||||
# - By default, kdump initrd will be rebuilt when necessary.
|
|
||||||
# Specify 1 to bypass rebuilding of kdump initrd.
|
|
||||||
#
|
|
||||||
# force_no_rebuild and force_rebuild options are mutually
|
|
||||||
# exclusive and they should not be set to 1 simultaneously.
|
|
||||||
#
|
|
||||||
# override_resettable <0 | 1>
|
|
||||||
# - Usually an unresettable block device can't be a dump target.
|
|
||||||
# Specifying 1 when you want to dump even though the block
|
|
||||||
# target is unresettable
|
|
||||||
# By default, it is 0, which will not try dumping destined to fail.
|
|
||||||
#
|
|
||||||
# dracut_args <arg(s)>
|
|
||||||
# - Pass extra dracut options when rebuilding kdump initrd.
|
|
||||||
#
|
|
||||||
# fence_kdump_args <arg(s)>
|
|
||||||
# - Command line arguments for fence_kdump_send (it can contain
|
|
||||||
# all valid arguments except hosts to send notification to).
|
|
||||||
#
|
|
||||||
# fence_kdump_nodes <node(s)>
|
|
||||||
# - List of cluster node(s) except localhost, separated by spaces,
|
|
||||||
# to send fence_kdump notifications to.
|
|
||||||
# (this option is mandatory to enable fence_kdump).
|
|
||||||
#
|
|
||||||
|
|
||||||
#raw /dev/vg/lv_kdump
|
|
||||||
#ext4 /dev/vg/lv_kdump
|
|
||||||
#ext4 LABEL=/boot
|
|
||||||
#ext4 UUID=03138356-5e61-4ab3-b58e-27507ac41937
|
|
||||||
#virtiofs myfs
|
|
||||||
#nfs my.server.com:/export/tmp
|
|
||||||
#nfs [2001:db8::1:2:3:4]:/export/tmp
|
|
||||||
#ssh user@my.server.com
|
|
||||||
#ssh user@2001:db8::1:2:3:4
|
|
||||||
#sshkey /root/.ssh/kdump_id_rsa
|
|
||||||
auto_reset_crashkernel yes
|
|
||||||
path /var/crash
|
|
||||||
core_collector makedumpfile -l --message-level 7 -d 31
|
|
||||||
#core_collector scp
|
|
||||||
#kdump_post /var/crash/scripts/kdump-post.sh
|
|
||||||
#kdump_pre /var/crash/scripts/kdump-pre.sh
|
|
||||||
#extra_bins /usr/bin/lftp
|
|
||||||
#extra_modules gfs2
|
|
||||||
#failure_action shell
|
|
||||||
#force_rebuild 1
|
|
||||||
#force_no_rebuild 1
|
|
||||||
#dracut_args --omit-drivers "cfg80211 snd" --add-drivers "ext2 ext3"
|
|
||||||
#fence_kdump_args -p 7410 -f auto -c 0 -i 10
|
|
||||||
#fence_kdump_nodes node1 node2
|
|
||||||
EOF
|
|
||||||
}
|
|
||||||
|
|
||||||
update_param()
|
|
||||||
{
|
|
||||||
SED_EXP="${SED_EXP}s/^$1.*$/$1 $2/;"
|
|
||||||
}
|
|
||||||
|
|
||||||
case "$1" in
|
|
||||||
aarch64) ;;
|
|
||||||
|
|
||||||
i386) ;;
|
|
||||||
|
|
||||||
ppc64) ;;
|
|
||||||
|
|
||||||
ppc64le) ;;
|
|
||||||
|
|
||||||
s390x)
|
|
||||||
update_param core_collector \
|
|
||||||
"makedumpfile -c --message-level 7 -d 31"
|
|
||||||
;;
|
|
||||||
x86_64) ;;
|
|
||||||
|
|
||||||
*)
|
|
||||||
echo "Warning: Unknown architecture '$1', using default kdump.conf template."
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
generate
|
|
||||||
@ -1,23 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
|
|
||||||
# More details about systemd generator:
|
|
||||||
# http://www.freedesktop.org/wiki/Software/systemd/Generators/
|
|
||||||
|
|
||||||
. /usr/lib/kdump/kdump-lib.sh
|
|
||||||
. /usr/lib/kdump/kdump-logger.sh
|
|
||||||
|
|
||||||
# If invokded with no arguments for testing purpose, output to /tmp to
|
|
||||||
# avoid overriding the existing.
|
|
||||||
dest_dir="/tmp"
|
|
||||||
|
|
||||||
if [ -n "$1" ]; then
|
|
||||||
dest_dir=$1
|
|
||||||
fi
|
|
||||||
|
|
||||||
systemd_dir=/usr/lib/systemd/system
|
|
||||||
kdump_wants=$dest_dir/kdump.service.wants
|
|
||||||
|
|
||||||
if is_ssh_dump_target; then
|
|
||||||
mkdir -p $kdump_wants
|
|
||||||
ln -sf $systemd_dir/network-online.target $kdump_wants/
|
|
||||||
fi
|
|
||||||
@ -1,91 +0,0 @@
|
|||||||
Kdump-in-cluster-environment HOWTO
|
|
||||||
|
|
||||||
Introduction
|
|
||||||
|
|
||||||
Kdump is a kexec based crash dumping mechansim for Linux. This docuement
|
|
||||||
illustrate how to configure kdump in cluster environment to allow the kdump
|
|
||||||
crash recovery service complete without being preempted by traditional power
|
|
||||||
fencing methods.
|
|
||||||
|
|
||||||
Overview
|
|
||||||
|
|
||||||
Kexec/Kdump
|
|
||||||
|
|
||||||
Details about Kexec/Kdump are available in Kexec-Kdump-howto file and will not
|
|
||||||
be described here.
|
|
||||||
|
|
||||||
fence_kdump
|
|
||||||
|
|
||||||
fence_kdump is an I/O fencing agent to be used with the kdump crash recovery
|
|
||||||
service. When the fence_kdump agent is invoked, it will listen for a message
|
|
||||||
from the failed node that acknowledges that the failed node is executing the
|
|
||||||
kdump crash kernel. Note that fence_kdump is not a replacement for traditional
|
|
||||||
fencing methods. The fence_kdump agent can only detect that a node has entered
|
|
||||||
the kdump crash recovery service. This allows the kdump crash recovery service
|
|
||||||
complete without being preempted by traditional power fencing methods.
|
|
||||||
|
|
||||||
fence_kdump_send
|
|
||||||
|
|
||||||
fence_kdump_send is a utility used to send messages that acknowledge that the
|
|
||||||
node itself has entered the kdump crash recovery service. The fence_kdump_send
|
|
||||||
utility is typically run in the kdump kernel after a cluster node has
|
|
||||||
encountered a kernel panic. Once the cluster node has entered the kdump crash
|
|
||||||
recovery service, fence_kdump_send will periodically send messages to all
|
|
||||||
cluster nodes. When the fence_kdump agent receives a valid message from the
|
|
||||||
failed nodes, fencing is complete.
|
|
||||||
|
|
||||||
How to configure Pacemaker cluster environment:
|
|
||||||
|
|
||||||
If we want to use kdump in Pacemaker cluster environment, fence-agents-kdump
|
|
||||||
should be installed in every nodes in the cluster. You can achieve this via
|
|
||||||
the following command:
|
|
||||||
|
|
||||||
# yum install -y fence-agents-kdump
|
|
||||||
|
|
||||||
Next is to add kdump_fence to the cluster. Assuming that the cluster consists
|
|
||||||
of three nodes, they are node1, node2 and node3, and use Pacemaker to perform
|
|
||||||
resource management and pcs as cli configuration tool.
|
|
||||||
|
|
||||||
With pcs it is easy to add a stonith resource to the cluster. For example, add
|
|
||||||
a stonith resource named mykdumpfence with fence type of fence_kdump via the
|
|
||||||
following commands:
|
|
||||||
|
|
||||||
# pcs stonith create mykdumpfence fence_kdump \
|
|
||||||
pcmk_host_check=static-list pcmk_host_list="node1 node2 node3"
|
|
||||||
# pcs stonith update mykdumpfence pcmk_monitor_action=metadata --force
|
|
||||||
# pcs stonith update mykdumpfence pcmk_status_action=metadata --force
|
|
||||||
# pcs stonith update mykdumpfence pcmk_reboot_action=off --force
|
|
||||||
|
|
||||||
Then enable stonith
|
|
||||||
# pcs property set stonith-enabled=true
|
|
||||||
|
|
||||||
How to configure kdump:
|
|
||||||
|
|
||||||
Actually there are two ways how to configure fence_kdump support:
|
|
||||||
|
|
||||||
1) Pacemaker based clusters
|
|
||||||
If you have successfully configured fence_kdump in Pacemaker, there is
|
|
||||||
no need to add some special configuration in kdump. So please refer to
|
|
||||||
Kexec-Kdump-howto file for more information.
|
|
||||||
|
|
||||||
2) Generic clusters
|
|
||||||
For other types of clusters there are two configuration options in
|
|
||||||
kdump.conf which enables fence_kdump support:
|
|
||||||
|
|
||||||
fence_kdump_nodes <node(s)>
|
|
||||||
Contains list of cluster node(s) separated by space to send
|
|
||||||
fence_kdump notification to (this option is mandatory to enable
|
|
||||||
fence_kdump)
|
|
||||||
|
|
||||||
fence_kdump_args <arg(s)>
|
|
||||||
Command line arguments for fence_kdump_send (it can contain
|
|
||||||
all valid arguments except hosts to send notification to)
|
|
||||||
|
|
||||||
These options will most probably be configured by your cluster software,
|
|
||||||
so please refer to your cluster documentation how to enable fence_kdump
|
|
||||||
support.
|
|
||||||
|
|
||||||
Please be aware that these two ways cannot be combined and 2) has precedence
|
|
||||||
over 1). It means that if fence_kdump is configured using fence_kdump_nodes
|
|
||||||
and fence_kdump_args options in kdump.conf, Pacemaker configuration is not
|
|
||||||
used even if it exists.
|
|
||||||
@ -1,177 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
#
|
|
||||||
# The code in this file will be used in initramfs environment, bash may
|
|
||||||
# not be the default shell. Any code added must be POSIX compliant.
|
|
||||||
|
|
||||||
DEFAULT_PATH="/var/crash/"
|
|
||||||
KDUMP_CONFIG_FILE="/etc/kdump.conf"
|
|
||||||
FENCE_KDUMP_CONFIG_FILE="/etc/sysconfig/fence_kdump"
|
|
||||||
FENCE_KDUMP_SEND="/usr/libexec/fence_kdump_send"
|
|
||||||
LVM_CONF="/etc/lvm/lvm.conf"
|
|
||||||
|
|
||||||
# Read kdump config in well formated style
|
|
||||||
kdump_read_conf()
|
|
||||||
{
|
|
||||||
# Following steps are applied in order: strip trailing comment, strip trailing space,
|
|
||||||
# strip heading space, match non-empty line, remove duplicated spaces between conf name and value
|
|
||||||
[ -f "$KDUMP_CONFIG_FILE" ] && sed -n -e "s/#.*//;s/\s*$//;s/^\s*//;s/\(\S\+\)\s*\(.*\)/\1 \2/p" $KDUMP_CONFIG_FILE
|
|
||||||
}
|
|
||||||
|
|
||||||
# Retrieves config value defined in kdump.conf
|
|
||||||
# $1: config name, sed regexp compatible
|
|
||||||
kdump_get_conf_val()
|
|
||||||
{
|
|
||||||
# For lines matching "^\s*$1\s+", remove matched part (config name including space),
|
|
||||||
# remove tailing comment, space, then store in hold space. Print out the hold buffer on last line.
|
|
||||||
[ -f "$KDUMP_CONFIG_FILE" ] &&
|
|
||||||
sed -n -e "/^\s*\($1\)\s\+/{s/^\s*\($1\)\s\+//;s/#.*//;s/\s*$//;h};\${x;p}" $KDUMP_CONFIG_FILE
|
|
||||||
}
|
|
||||||
|
|
||||||
is_mounted()
|
|
||||||
{
|
|
||||||
findmnt -k -n "$1" > /dev/null 2>&1
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: info type
|
|
||||||
# $2: mount source type
|
|
||||||
# $3: mount source
|
|
||||||
# $4: extra args
|
|
||||||
get_mount_info()
|
|
||||||
{
|
|
||||||
__kdump_mnt=$(findmnt -k -n -r -o "$1" "--$2" "$3" $4)
|
|
||||||
|
|
||||||
[ -z "$__kdump_mnt" ] && [ -e "/etc/fstab" ] && __kdump_mnt=$(findmnt -s -n -r -o "$1" "--$2" "$3" $4)
|
|
||||||
|
|
||||||
echo "$__kdump_mnt"
|
|
||||||
}
|
|
||||||
|
|
||||||
is_ipv6_address()
|
|
||||||
{
|
|
||||||
echo "$1" | grep -q ":"
|
|
||||||
}
|
|
||||||
|
|
||||||
is_fs_type_nfs()
|
|
||||||
{
|
|
||||||
[ "$1" = "nfs" ] || [ "$1" = "nfs4" ]
|
|
||||||
}
|
|
||||||
|
|
||||||
is_fs_type_virtiofs()
|
|
||||||
{
|
|
||||||
[ "$1" = "virtiofs" ]
|
|
||||||
}
|
|
||||||
|
|
||||||
# If $1 contains dracut_args "--mount", return <filesystem type>
|
|
||||||
get_dracut_args_fstype()
|
|
||||||
{
|
|
||||||
echo $1 | grep "\-\-mount" | sed "s/.*--mount .\(.*\)/\1/" | cut -d' ' -f3
|
|
||||||
}
|
|
||||||
|
|
||||||
# If $1 contains dracut_args "--mount", return <device>
|
|
||||||
get_dracut_args_target()
|
|
||||||
{
|
|
||||||
echo $1 | grep "\-\-mount" | sed "s/.*--mount .\(.*\)/\1/" | cut -d' ' -f1
|
|
||||||
}
|
|
||||||
|
|
||||||
get_save_path()
|
|
||||||
{
|
|
||||||
__kdump_path=$(kdump_get_conf_val path)
|
|
||||||
[ -z "$__kdump_path" ] && __kdump_path=$DEFAULT_PATH
|
|
||||||
|
|
||||||
# strip the duplicated "/"
|
|
||||||
echo "$__kdump_path" | tr -s /
|
|
||||||
}
|
|
||||||
|
|
||||||
get_root_fs_device()
|
|
||||||
{
|
|
||||||
findmnt -k -f -n -o SOURCE /
|
|
||||||
}
|
|
||||||
|
|
||||||
# Return the current underlying device of a path, ignore bind mounts
|
|
||||||
get_target_from_path()
|
|
||||||
{
|
|
||||||
__kdump_target=$(df "$1" 2> /dev/null | tail -1 | awk '{print $1}')
|
|
||||||
[ "$__kdump_target" = "/dev/root" ] && [ ! -e /dev/root ] && __kdump_target=$(get_root_fs_device)
|
|
||||||
echo "$__kdump_target"
|
|
||||||
}
|
|
||||||
|
|
||||||
get_fs_type_from_target()
|
|
||||||
{
|
|
||||||
get_mount_info FSTYPE source "$1" -f
|
|
||||||
}
|
|
||||||
|
|
||||||
get_mntpoint_from_target()
|
|
||||||
{
|
|
||||||
# --source is applied to ensure non-bind mount is returned
|
|
||||||
get_mount_info TARGET source "$1" -f
|
|
||||||
}
|
|
||||||
|
|
||||||
is_ssh_dump_target()
|
|
||||||
{
|
|
||||||
kdump_get_conf_val ssh | grep -q @
|
|
||||||
}
|
|
||||||
|
|
||||||
is_raw_dump_target()
|
|
||||||
{
|
|
||||||
[ -n "$(kdump_get_conf_val raw)" ]
|
|
||||||
}
|
|
||||||
|
|
||||||
is_virtiofs_dump_target()
|
|
||||||
{
|
|
||||||
if [ -n "$(kdump_get_conf_val virtiofs)" ]; then
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
if is_fs_type_virtiofs "$(get_dracut_args_fstype "$(kdump_get_conf_val dracut_args)")"; then
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
if is_fs_type_virtiofs "$(get_fs_type_from_target "$(get_target_from_path "$(get_save_path)")")"; then
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
|
|
||||||
is_nfs_dump_target()
|
|
||||||
{
|
|
||||||
if [ -n "$(kdump_get_conf_val nfs)" ]; then
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
if is_fs_type_nfs "$(get_dracut_args_fstype "$(kdump_get_conf_val dracut_args)")"; then
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
if is_fs_type_nfs "$(get_fs_type_from_target "$(get_target_from_path "$(get_save_path)")")"; then
|
|
||||||
return 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
|
|
||||||
is_fs_dump_target()
|
|
||||||
{
|
|
||||||
[ -n "$(kdump_get_conf_val "ext[234]\|xfs\|btrfs\|minix\|virtiofs")" ]
|
|
||||||
}
|
|
||||||
|
|
||||||
is_lvm2_thinp_device()
|
|
||||||
{
|
|
||||||
_device_path=$1
|
|
||||||
_lvm2_thin_device=$(lvm lvs -S 'lv_layout=sparse && lv_layout=thin' \
|
|
||||||
--nosuffix --noheadings -o vg_name,lv_name "$_device_path" 2> /dev/null)
|
|
||||||
|
|
||||||
[ -n "$_lvm2_thin_device" ]
|
|
||||||
}
|
|
||||||
|
|
||||||
kdump_get_ip_route()
|
|
||||||
{
|
|
||||||
if ! _route=$(/sbin/ip -o route get to "$1" 2>&1); then
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
echo "$_route"
|
|
||||||
}
|
|
||||||
|
|
||||||
kdump_get_ip_route_field()
|
|
||||||
{
|
|
||||||
echo "$1" | sed -n -e "s/^.*\<$2\>\s\+\(\S\+\).*$/\1/p"
|
|
||||||
}
|
|
||||||
File diff suppressed because it is too large
Load Diff
@ -1,355 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
#
|
|
||||||
# This comes from the dracut-logger.sh
|
|
||||||
#
|
|
||||||
# The logger defined 4 logging levels:
|
|
||||||
# - ddebug (4)
|
|
||||||
# The DEBUG Level designates fine-grained informational events that are most
|
|
||||||
# useful to debug an application.
|
|
||||||
# - dinfo (3)
|
|
||||||
# The INFO level designates informational messages that highlight the
|
|
||||||
# progress of the application at coarse-grained level.
|
|
||||||
# - dwarn (2)
|
|
||||||
# The WARN level designates potentially harmful situations.
|
|
||||||
# - derror (1)
|
|
||||||
# The ERROR level designates error events that might still allow the
|
|
||||||
# application to continue running.
|
|
||||||
#
|
|
||||||
# Logging is controlled by following global variables:
|
|
||||||
# - @var kdump_stdloglvl - logging level to standard error (console output)
|
|
||||||
# - @var kdump_sysloglvl - logging level to syslog (by logger command)
|
|
||||||
# - @var kdump_kmsgloglvl - logging level to /dev/kmsg (only for boot-time)
|
|
||||||
#
|
|
||||||
# If any of the variables is not set, the function dlog_init() sets it to default:
|
|
||||||
# - In the first kernel:
|
|
||||||
# - @var kdump_stdloglvl = 3 (info)
|
|
||||||
# - @var kdump_sysloglvl = 0 (no logging)
|
|
||||||
# - @var kdump_kmsgloglvl = 0 (no logging)
|
|
||||||
#
|
|
||||||
# -In the second kernel:
|
|
||||||
# - @var kdump_stdloglvl = 0 (no logging)
|
|
||||||
# - @var kdump_sysloglvl = 3 (info)
|
|
||||||
# - @var kdump_kmsgloglvl = 0 (no logging)
|
|
||||||
#
|
|
||||||
# First of all you have to start with dlog_init() function which initializes
|
|
||||||
# required variables. Don't call any other logging function before that one!
|
|
||||||
#
|
|
||||||
# The code in this file might be run in an environment without bash.
|
|
||||||
# Any code added must be POSIX compliant.
|
|
||||||
|
|
||||||
# Define vairables for the log levels in this module.
|
|
||||||
kdump_stdloglvl=""
|
|
||||||
kdump_sysloglvl=""
|
|
||||||
kdump_kmsgloglvl=""
|
|
||||||
|
|
||||||
# The dracut-lib.sh is only available in the second kernel, and it won't
|
|
||||||
# be used in the first kernel because the dracut-lib.sh is invisible in
|
|
||||||
# the first kernel.
|
|
||||||
if [ -f /lib/dracut-lib.sh ]; then
|
|
||||||
. /lib/dracut-lib.sh
|
|
||||||
fi
|
|
||||||
|
|
||||||
# @brief Get the log level from kernel command line.
|
|
||||||
# @retval 1 if something has gone wrong
|
|
||||||
# @retval 0 on success.
|
|
||||||
#
|
|
||||||
get_kdump_loglvl()
|
|
||||||
{
|
|
||||||
[ -f /lib/dracut-lib.sh ] && kdump_sysloglvl=$(getarg rd.kdumploglvl)
|
|
||||||
[ -z "$kdump_sysloglvl" ] && return 1;
|
|
||||||
|
|
||||||
if [ -f /lib/dracut-lib.sh ] && ! isdigit "$kdump_sysloglvl"; then
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
# @brief Check the log level.
|
|
||||||
# @retval 1 if something has gone wrong
|
|
||||||
# @retval 0 on success.
|
|
||||||
#
|
|
||||||
check_loglvl()
|
|
||||||
{
|
|
||||||
case "$1" in
|
|
||||||
0|1|2|3|4)
|
|
||||||
return 0
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
return 1
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
}
|
|
||||||
|
|
||||||
# @brief Initializes Logger.
|
|
||||||
# @retval 1 if something has gone wrong
|
|
||||||
# @retval 0 on success.
|
|
||||||
#
|
|
||||||
dlog_init() {
|
|
||||||
ret=0
|
|
||||||
|
|
||||||
if [ -s /proc/vmcore ];then
|
|
||||||
if ! get_kdump_loglvl; then
|
|
||||||
logger -t "kdump[$$]" -p warn -- "Kdump is using the default log level(3)."
|
|
||||||
kdump_sysloglvl=3
|
|
||||||
fi
|
|
||||||
kdump_stdloglvl=0
|
|
||||||
kdump_kmsgloglvl=0
|
|
||||||
else
|
|
||||||
kdump_stdloglvl=$KDUMP_STDLOGLVL
|
|
||||||
kdump_sysloglvl=$KDUMP_SYSLOGLVL
|
|
||||||
kdump_kmsgloglvl=$KDUMP_KMSGLOGLVL
|
|
||||||
fi
|
|
||||||
|
|
||||||
[ -z "$kdump_stdloglvl" ] && kdump_stdloglvl=3
|
|
||||||
[ -z "$kdump_sysloglvl" ] && kdump_sysloglvl=0
|
|
||||||
[ -z "$kdump_kmsgloglvl" ] && kdump_kmsgloglvl=0
|
|
||||||
|
|
||||||
for loglvl in "$kdump_stdloglvl" "$kdump_kmsgloglvl" "$kdump_sysloglvl"; do
|
|
||||||
if ! check_loglvl "$loglvl"; then
|
|
||||||
echo "Illegal log level: $kdump_stdloglvl $kdump_kmsgloglvl $kdump_sysloglvl"
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
|
|
||||||
# Skip initialization if it's already done.
|
|
||||||
[ -n "$kdump_maxloglvl" ] && return 0
|
|
||||||
|
|
||||||
if [ "$UID" -ne 0 ]; then
|
|
||||||
kdump_kmsgloglvl=0
|
|
||||||
kdump_sysloglvl=0
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ "$kdump_sysloglvl" -gt 0 ]; then
|
|
||||||
if [ -d /run/systemd/journal ] \
|
|
||||||
&& systemd-cat --version 1>/dev/null 2>&1 \
|
|
||||||
&& systemctl --quiet is-active systemd-journald.socket 1>/dev/null 2>&1; then
|
|
||||||
readonly _systemdcatfile="/var/tmp/systemd-cat"
|
|
||||||
mkfifo "$_systemdcatfile" 1>/dev/null 2>&1
|
|
||||||
readonly _dlogfd=15
|
|
||||||
systemd-cat -t 'kdump' --level-prefix=true <"$_systemdcatfile" &
|
|
||||||
exec 15>"$_systemdcatfile"
|
|
||||||
elif ! [ -S /dev/log ] && [ -w /dev/log ] || ! command -v logger >/dev/null; then
|
|
||||||
# We cannot log to syslog, so turn this facility off.
|
|
||||||
kdump_kmsgloglvl=$kdump_sysloglvl
|
|
||||||
kdump_sysloglvl=0
|
|
||||||
ret=1
|
|
||||||
errmsg="No '/dev/log' or 'logger' included for syslog logging"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
kdump_maxloglvl=0
|
|
||||||
for _dlog_lvl in $kdump_stdloglvl $kdump_sysloglvl $kdump_kmsgloglvl; do
|
|
||||||
[ $_dlog_lvl -gt $kdump_maxloglvl ] && kdump_maxloglvl=$_dlog_lvl
|
|
||||||
done
|
|
||||||
readonly kdump_maxloglvl
|
|
||||||
export kdump_maxloglvl
|
|
||||||
|
|
||||||
if [ $kdump_stdloglvl -lt 4 ] && [ $kdump_kmsgloglvl -lt 4 ] && [ $kdump_sysloglvl -lt 4 ]; then
|
|
||||||
unset ddebug
|
|
||||||
ddebug() { :; };
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ $kdump_stdloglvl -lt 3 ] && [ $kdump_kmsgloglvl -lt 3 ] && [ $kdump_sysloglvl -lt 3 ]; then
|
|
||||||
unset dinfo
|
|
||||||
dinfo() { :; };
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ $kdump_stdloglvl -lt 2 ] && [ $kdump_kmsgloglvl -lt 2 ] && [ $kdump_sysloglvl -lt 2 ]; then
|
|
||||||
unset dwarn
|
|
||||||
dwarn() { :; };
|
|
||||||
unset dwarning
|
|
||||||
dwarning() { :; };
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [ $kdump_stdloglvl -lt 1 ] && [ $kdump_kmsgloglvl -lt 1 ] && [ $kdump_sysloglvl -lt 1 ]; then
|
|
||||||
unset derror
|
|
||||||
derror() { :; };
|
|
||||||
fi
|
|
||||||
|
|
||||||
[ -n "$errmsg" ] && derror "$errmsg"
|
|
||||||
|
|
||||||
return $ret
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief Converts numeric level to logger priority defined by POSIX.2.
|
|
||||||
#
|
|
||||||
# @param $1: Numeric logging level in range from 1 to 4.
|
|
||||||
# @retval 1 if @a lvl is out of range.
|
|
||||||
# @retval 0 if @a lvl is correct.
|
|
||||||
# @result Echoes logger priority.
|
|
||||||
_lvl2syspri() {
|
|
||||||
case "$1" in
|
|
||||||
1) echo error;;
|
|
||||||
2) echo warning;;
|
|
||||||
3) echo info;;
|
|
||||||
4) echo debug;;
|
|
||||||
*) return 1;;
|
|
||||||
esac
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief Converts logger numeric level to syslog log level
|
|
||||||
#
|
|
||||||
# @param $1: Numeric logging level in range from 1 to 4.
|
|
||||||
# @retval 1 if @a lvl is out of range.
|
|
||||||
# @retval 0 if @a lvl is correct.
|
|
||||||
# @result Echoes kernel console numeric log level
|
|
||||||
#
|
|
||||||
# Conversion is done as follows:
|
|
||||||
#
|
|
||||||
# <tt>
|
|
||||||
# none -> LOG_EMERG (0)
|
|
||||||
# none -> LOG_ALERT (1)
|
|
||||||
# none -> LOG_CRIT (2)
|
|
||||||
# ERROR(1) -> LOG_ERR (3)
|
|
||||||
# WARN(2) -> LOG_WARNING (4)
|
|
||||||
# none -> LOG_NOTICE (5)
|
|
||||||
# INFO(3) -> LOG_INFO (6)
|
|
||||||
# DEBUG(4) -> LOG_DEBUG (7)
|
|
||||||
# </tt>
|
|
||||||
#
|
|
||||||
# @see /usr/include/sys/syslog.h
|
|
||||||
_dlvl2syslvl() {
|
|
||||||
case "$1" in
|
|
||||||
1) set -- 3;;
|
|
||||||
2) set -- 4;;
|
|
||||||
3) set -- 6;;
|
|
||||||
4) set -- 7;;
|
|
||||||
*) return 1;;
|
|
||||||
esac
|
|
||||||
|
|
||||||
# The number is constructed by multiplying the facility by 8 and then
|
|
||||||
# adding the level.
|
|
||||||
# About The Syslog Protocol, please refer to the RFC5424 for more details.
|
|
||||||
echo $((24 + $1))
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief Prints to stderr, to syslog and/or /dev/kmsg given message with
|
|
||||||
# given level (priority).
|
|
||||||
#
|
|
||||||
# @param $1: Numeric logging level.
|
|
||||||
# @param $2: Message.
|
|
||||||
# @retval 0 It's always returned, even if logging failed.
|
|
||||||
#
|
|
||||||
# @note This function is not supposed to be called manually. Please use
|
|
||||||
# dinfo(), ddebug(), or others instead which wrap this one.
|
|
||||||
#
|
|
||||||
# This is core logging function which logs given message to standard error
|
|
||||||
# and/or syslog (with POSIX shell command <tt>logger</tt>) and/or to /dev/kmsg.
|
|
||||||
# The format is following:
|
|
||||||
#
|
|
||||||
# <tt>X: some message</tt>
|
|
||||||
#
|
|
||||||
# where @c X is the first letter of logging level. See module description for
|
|
||||||
# details on that.
|
|
||||||
#
|
|
||||||
# Message to syslog is sent with tag @c kdump. Priorities are mapped as
|
|
||||||
# following:
|
|
||||||
# - @c ERROR to @c error
|
|
||||||
# - @c WARN to @c warning
|
|
||||||
# - @c INFO to @c info
|
|
||||||
# - @c DEBUG to @c debug
|
|
||||||
_do_dlog() {
|
|
||||||
[ "$1" -le $kdump_stdloglvl ] && printf -- 'kdump: %s\n' "$2" >&2
|
|
||||||
|
|
||||||
if [ "$1" -le $kdump_sysloglvl ]; then
|
|
||||||
if [ "$_dlogfd" ]; then
|
|
||||||
printf -- "<%s>%s\n" "$(($(_dlvl2syslvl "$1") & 7))" "$2" 1>&$_dlogfd
|
|
||||||
else
|
|
||||||
logger -t "kdump[$$]" -p "$(_lvl2syspri "$1")" -- "$2"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
[ "$1" -le $kdump_kmsgloglvl ] && \
|
|
||||||
echo "<$(_dlvl2syslvl "$1")>kdump[$$] $2" >/dev/kmsg
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief Internal helper function for _do_dlog()
|
|
||||||
#
|
|
||||||
# @param $1: Numeric logging level.
|
|
||||||
# @param $2 [...]: Message.
|
|
||||||
# @retval 0 It's always returned, even if logging failed.
|
|
||||||
#
|
|
||||||
# @note This function is not supposed to be called manually. Please use
|
|
||||||
# dinfo(), ddebug(), or others instead which wrap this one.
|
|
||||||
#
|
|
||||||
# This function calls _do_dlog() either with parameter msg, or if
|
|
||||||
# none is given, it will read standard input and will use every line as
|
|
||||||
# a message.
|
|
||||||
#
|
|
||||||
# This enables:
|
|
||||||
# dwarn "This is a warning"
|
|
||||||
# echo "This is a warning" | dwarn
|
|
||||||
dlog() {
|
|
||||||
[ -z "$kdump_maxloglvl" ] && return 0
|
|
||||||
[ "$1" -le "$kdump_maxloglvl" ] || return 0
|
|
||||||
|
|
||||||
if [ $# -gt 1 ]; then
|
|
||||||
_dlog_lvl=$1; shift
|
|
||||||
_do_dlog "$_dlog_lvl" "$*"
|
|
||||||
else
|
|
||||||
while read -r line || [ -n "$line" ]; do
|
|
||||||
_do_dlog "$1" "$line"
|
|
||||||
done
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief Logs message at DEBUG level (4)
|
|
||||||
#
|
|
||||||
# @param msg Message.
|
|
||||||
# @retval 0 It's always returned, even if logging failed.
|
|
||||||
ddebug() {
|
|
||||||
set +x
|
|
||||||
dlog 4 "$@"
|
|
||||||
if [ -n "$debug" ]; then
|
|
||||||
set -x
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief Logs message at INFO level (3)
|
|
||||||
#
|
|
||||||
# @param msg Message.
|
|
||||||
# @retval 0 It's always returned, even if logging failed.
|
|
||||||
dinfo() {
|
|
||||||
set +x
|
|
||||||
dlog 3 "$@"
|
|
||||||
if [ -n "$debug" ]; then
|
|
||||||
set -x
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief Logs message at WARN level (2)
|
|
||||||
#
|
|
||||||
# @param msg Message.
|
|
||||||
# @retval 0 It's always returned, even if logging failed.
|
|
||||||
dwarn() {
|
|
||||||
set +x
|
|
||||||
dlog 2 "$@"
|
|
||||||
if [ -n "$debug" ]; then
|
|
||||||
set -x
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief It's an alias to dwarn() function.
|
|
||||||
#
|
|
||||||
# @param msg Message.
|
|
||||||
# @retval 0 It's always returned, even if logging failed.
|
|
||||||
dwarning() {
|
|
||||||
set +x
|
|
||||||
dwarn "$@"
|
|
||||||
if [ -n "$debug" ]; then
|
|
||||||
set -x
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
## @brief Logs message at ERROR level (1)
|
|
||||||
#
|
|
||||||
# @param msg Message.
|
|
||||||
# @retval 0 It's always returned, even if logging failed.
|
|
||||||
derror() {
|
|
||||||
set +x
|
|
||||||
dlog 1 "$@"
|
|
||||||
if [ -n "$debug" ]; then
|
|
||||||
set -x
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
@ -1,8 +0,0 @@
|
|||||||
#!/bin/sh
|
|
||||||
|
|
||||||
systemctl is-active kdump
|
|
||||||
if [ $? -ne 0 ]; then
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
/usr/lib/kdump/kdump-restart.sh
|
|
||||||
@ -1,8 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
export PATH="$PATH:/usr/bin:/usr/sbin"
|
|
||||||
|
|
||||||
exec >>/var/log/kdump-migration.log 2>&1
|
|
||||||
|
|
||||||
echo "kdump: Partition Migration detected. Rebuilding initramfs image to reload."
|
|
||||||
/usr/bin/kdumpctl rebuild
|
|
||||||
/usr/bin/kdumpctl reload
|
|
||||||
@ -1,42 +0,0 @@
|
|||||||
#!/bin/bash
|
|
||||||
# This util helps to reduce the workload of kdump service restarting
|
|
||||||
# on udev event. When hotplugging memory / CPU, multiple udev
|
|
||||||
# events may be triggered concurrently, and obviously, we don't want
|
|
||||||
# to restart kdump service for each event.
|
|
||||||
|
|
||||||
# This script will be called by udev, and make sure kdump service is
|
|
||||||
# restart after all events we are watching are settled.
|
|
||||||
|
|
||||||
# On each call, this script will update try to aquire the $throttle_lock
|
|
||||||
# The first instance acquired the file lock will keep waiting for events
|
|
||||||
# to settle and then reload kdump. Other instances will just exit
|
|
||||||
# In this way, we can make sure kdump service is restarted immediately
|
|
||||||
# and for exactly once after udev events are settled.
|
|
||||||
|
|
||||||
throttle_lock="/var/lock/kdump-udev-throttle"
|
|
||||||
|
|
||||||
exec 9>$throttle_lock
|
|
||||||
if [ $? -ne 0 ]; then
|
|
||||||
echo "Failed to create the lock file! Fallback to non-throttled kdump service restart"
|
|
||||||
/bin/kdumpctl reload
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
flock -n 9
|
|
||||||
if [ $? -ne 0 ]; then
|
|
||||||
echo "Throttling kdump restart for concurrent udev event"
|
|
||||||
exit 0
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Wait for at least 1 second, at most 4 seconds for udev to settle
|
|
||||||
# Idealy we will have a less than 1 second lag between udev events settle
|
|
||||||
# and kdump reload
|
|
||||||
sleep 1 && udevadm settle --timeout 3
|
|
||||||
|
|
||||||
# Release the lock, /bin/kdumpctl will block and make the process
|
|
||||||
# holding two locks at the same time and we might miss some events
|
|
||||||
exec 9>&-
|
|
||||||
|
|
||||||
/bin/kdumpctl reload
|
|
||||||
|
|
||||||
exit 0
|
|
||||||
@ -1,399 +0,0 @@
|
|||||||
.TH KDUMP.CONF 5 "07/23/2008" "kexec-tools"
|
|
||||||
|
|
||||||
.SH NAME
|
|
||||||
kdump.conf \- configuration file for kdump kernel.
|
|
||||||
|
|
||||||
.SH DESCRIPTION
|
|
||||||
|
|
||||||
kdump.conf is a configuration file for the kdump kernel crash
|
|
||||||
collection service.
|
|
||||||
|
|
||||||
kdump.conf provides post-kexec instructions to the kdump kernel. It is
|
|
||||||
stored in the initrd file managed by the kdump service. If you change
|
|
||||||
this file and do not want to reboot in order for the changes to take
|
|
||||||
effect, restart the kdump service to rebuild the initrd.
|
|
||||||
|
|
||||||
For most configurations, you can simply review the examples provided
|
|
||||||
in the stock /etc/kdump.conf.
|
|
||||||
|
|
||||||
.B NOTE:
|
|
||||||
For filesystem dumps the dump target must be mounted before building
|
|
||||||
kdump initramfs.
|
|
||||||
|
|
||||||
kdump.conf only affects the behavior of the initramfs. Please read the
|
|
||||||
kdump operational flow section of kexec-kdump-howto.txt in the docs to better
|
|
||||||
understand how this configuration file affects the behavior of kdump.
|
|
||||||
|
|
||||||
.SH OPTIONS
|
|
||||||
|
|
||||||
.B auto_reset_crashkernel <yes|no>
|
|
||||||
.RS
|
|
||||||
determine whether to reset kernel crashkernel parameter to the default value
|
|
||||||
or not when kexec-tools is updated or a new kernel is installed. The default
|
|
||||||
crashkernel values are different for different architectures and also take the
|
|
||||||
following factors into consideration,
|
|
||||||
- AMD Secure Memory Encryption (SME) and Secure Encrypted Virtualization (SEV)
|
|
||||||
- Mellanox 5th generation network driver
|
|
||||||
- aarch64 64k kernel
|
|
||||||
- Firmware-assisted dump (FADump)
|
|
||||||
|
|
||||||
Since the kernel crasherkernel parameter will be only reset when kexec-tools is
|
|
||||||
updated or a new kernel is installed, you need to call "kdumpctl
|
|
||||||
reset-crashkernel [--kernel=path_to_kernel]" if you want to use the default
|
|
||||||
value set after having enabled features like SME/SEV for a specific kernel. And
|
|
||||||
you should also reboot the system for the new crashkernel value to take effect.
|
|
||||||
Also see kdumpctl(8).
|
|
||||||
|
|
||||||
.B raw <partition>
|
|
||||||
.RS
|
|
||||||
Will dd /proc/vmcore into <partition>. Use persistent device names for
|
|
||||||
partition devices, such as /dev/vg/<devname>.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B nfs <nfs mount>
|
|
||||||
.RS
|
|
||||||
Will mount nfs to <mnt>, and copy /proc/vmcore to <mnt>/<path>/%HOST-%DATE/,
|
|
||||||
supports DNS. Note that a fqdn should be used as the server name in the
|
|
||||||
mount point.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B ssh <user@server>
|
|
||||||
.RS
|
|
||||||
Will save /proc/vmcore through ssh pipe to <user@server>:<path>/%HOST-%DATE/,
|
|
||||||
supports DNS. NOTE: make sure user has necessary write permissions on
|
|
||||||
server and that a fqdn is used as the server name.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B sshkey <path>
|
|
||||||
.RS
|
|
||||||
Specify the path of the ssh key to use when dumping via ssh.
|
|
||||||
The default value is /root/.ssh/kdump_id_rsa.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B <fs type> <partition>
|
|
||||||
.RS
|
|
||||||
Will mount -t <fs type> <partition> <mnt>, and copy /proc/vmcore to
|
|
||||||
<mnt>/<path>/%HOST_IP-%DATE/. NOTE: <partition> can be a device node, label
|
|
||||||
or uuid. It's recommended to use persistent device names such as
|
|
||||||
/dev/vg/<devname>. Otherwise it's suggested to use label or uuid.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B path <path>
|
|
||||||
.RS
|
|
||||||
"path" represents the file system path in which vmcore will be saved.
|
|
||||||
If a dump target is specified in kdump.conf, then "path" is relative to the
|
|
||||||
specified dump target.
|
|
||||||
.PP
|
|
||||||
Interpretation of "path" changes a bit if the user didn't specify any dump
|
|
||||||
target explicitly in kdump.conf. In this case, "path" represents the
|
|
||||||
absolute path from root. The dump target and adjusted path are arrived
|
|
||||||
at automatically depending on what's mounted in the current system.
|
|
||||||
.PP
|
|
||||||
Ignored for raw device dumps. If unset, will use the default "/var/crash".
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B core_collector <command> <options>
|
|
||||||
.RS
|
|
||||||
This allows you to specify the command to copy the vmcore.
|
|
||||||
The default is makedumpfile, which on some architectures can drastically reduce
|
|
||||||
core file size. See /sbin/makedumpfile --help for a list of options.
|
|
||||||
Note that the -i and -g options are not needed here, as the initrd
|
|
||||||
will automatically be populated with a config file appropriate
|
|
||||||
for the running kernel.
|
|
||||||
.PP
|
|
||||||
Note 1: About default core collector:
|
|
||||||
The default core_collector for raw/ssh dump is:
|
|
||||||
"makedumpfile -F -l --message-level 7 -d 31".
|
|
||||||
The default core_collector for other targets is:
|
|
||||||
"makedumpfile -l --message-level 7 -d 31".
|
|
||||||
Even if core_collector option is commented out in kdump.conf, makedumpfile
|
|
||||||
is the default core collector and kdump uses it internally.
|
|
||||||
If one does not want makedumpfile as default core_collector, then they
|
|
||||||
need to specify one using core_collector option to change the behavior.
|
|
||||||
.PP
|
|
||||||
Note 2: If "makedumpfile -F" is used then you will get a flattened format
|
|
||||||
vmcore.flat, you will need to use "makedumpfile -R" to rearrange the
|
|
||||||
dump data from standard input to a normal dumpfile (readable with analysis
|
|
||||||
tools).
|
|
||||||
ie. "makedumpfile -R vmcore < vmcore.flat"
|
|
||||||
.PP
|
|
||||||
Note 3: If specified core_collector simply copy the vmcore file to the
|
|
||||||
dump target (eg: cp, scp), the vmcore could be significantly large.
|
|
||||||
Please make sure the dump target has enough space, at leaset larger
|
|
||||||
than the system's RAM.
|
|
||||||
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B kdump_post <binary | script>
|
|
||||||
.RS
|
|
||||||
This directive allows you to run a specified executable
|
|
||||||
just after the vmcore dump process terminates. The exit
|
|
||||||
status of the current dump process is fed to the kdump_post
|
|
||||||
executable as its first argument($1). Executable can modify
|
|
||||||
it to indicate the new exit status of succeeding dump process,
|
|
||||||
.PP
|
|
||||||
All files under /etc/kdump/post.d are collectively sorted
|
|
||||||
and executed in lexical order, before binary or script
|
|
||||||
specified kdump_post parameter is executed.
|
|
||||||
.PP
|
|
||||||
Note that scripts written for use with this directive must use the /bin/bash
|
|
||||||
interpreter. And since these scripts run in kdump enviroment, the reference to
|
|
||||||
the storage or network device in the scripts should adhere to the section
|
|
||||||
'Supported dump target types and requirements' in kexec-kdump-howto.txt.
|
|
||||||
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B kdump_pre <binary | script>
|
|
||||||
.RS
|
|
||||||
Works just like the "kdump_post" directive, but instead
|
|
||||||
of running after the dump process, runs immediately
|
|
||||||
before. Exit status of this binary is interpreted
|
|
||||||
as follows:
|
|
||||||
.PP
|
|
||||||
0 - continue with dump process as usual
|
|
||||||
.PP
|
|
||||||
non 0 - run the final action (reboot/poweroff/halt)
|
|
||||||
.PP
|
|
||||||
All files under /etc/kdump/pre.d are collectively sorted and
|
|
||||||
executed in lexical order, after binary or script specified
|
|
||||||
kdump_pre parameter is executed.
|
|
||||||
Even if the binary or script in /etc/kdump/pre.d directory
|
|
||||||
returns non 0 exit status, the processing is continued.
|
|
||||||
.PP
|
|
||||||
Note that scripts written for use with this directive must use the /bin/bash
|
|
||||||
interpreter. And since these scripts run in kdump enviroment, the reference to
|
|
||||||
the storage or network device in the scripts should adhere to the section
|
|
||||||
'Supported dump target types and requirements' in kexec-kdump-howto.txt.
|
|
||||||
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B extra_bins <binaries | shell scripts>
|
|
||||||
.RS
|
|
||||||
This directive allows you to specify additional
|
|
||||||
binaries or shell scripts you'd like to include in
|
|
||||||
your kdump initrd. Generally only useful in
|
|
||||||
conjunction with a kdump_post binary or script that
|
|
||||||
relies on other binaries or scripts.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B extra_modules <module(s)>
|
|
||||||
.RS
|
|
||||||
This directive allows you to specify extra kernel
|
|
||||||
modules that you want to be loaded in the kdump
|
|
||||||
initrd, typically used to set up access to
|
|
||||||
non-boot-path dump targets that might otherwise
|
|
||||||
not be accessible in the kdump environment. Multiple
|
|
||||||
modules can be listed, separated by spaces, and any
|
|
||||||
dependent modules will automatically be included.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B failure_action <reboot | halt | poweroff | shell | dump_to_rootfs>
|
|
||||||
.RS
|
|
||||||
Action to perform in case dumping to the intended target fails. The default is "reboot".
|
|
||||||
reboot: Reboot the system (this is what most people will want, as it returns the system
|
|
||||||
to a normal state). halt: Halt the system and lose the vmcore. poweroff: The system
|
|
||||||
will be powered down. shell: Drop to a shell session inside the initramfs, from which
|
|
||||||
you can manually perform additional recovery actions. Exiting this shell reboots the
|
|
||||||
system by default or performs "final_action".
|
|
||||||
Note: kdump uses bash as the default shell. dump_to_rootfs: If non-root dump
|
|
||||||
target is specified, the failure action can be set as dump_to_rootfs. That means when
|
|
||||||
dumping to target fails, dump vmcore to rootfs from initramfs context and reboot
|
|
||||||
by default or perform "final_action".
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B default <reboot | halt | poweroff | shell | dump_to_rootfs>
|
|
||||||
.RS
|
|
||||||
Same as the "failure_action" directive above, but this directive is obsolete
|
|
||||||
and will be removed in the future.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B final_action <reboot | halt | poweroff>
|
|
||||||
.RS
|
|
||||||
Action to perform in case dumping to the intended target succeeds.
|
|
||||||
Also performed when "shell" or "dump_to_rootfs" failure action finishes.
|
|
||||||
Each action is same as the "failure_action" directive above.
|
|
||||||
The default is "reboot".
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B force_rebuild <0 | 1>
|
|
||||||
.RS
|
|
||||||
By default, kdump initrd will only be rebuilt when necessary.
|
|
||||||
Specify 1 to force rebuilding kdump initrd every time when kdump service starts.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B force_no_rebuild <0 | 1>
|
|
||||||
.RS
|
|
||||||
By default, kdump initrd will be rebuilt when necessary.
|
|
||||||
Specify 1 to bypass rebuilding of kdump initrd.
|
|
||||||
|
|
||||||
.PP
|
|
||||||
force_no_rebuild and force_rebuild options are mutually exclusive and
|
|
||||||
they should not be set to 1 simultaneously.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B override_resettable <0 | 1>
|
|
||||||
.RS
|
|
||||||
Usually an unresettable block device can't be a dump target. Specifying 1 means
|
|
||||||
that even though the block target is unresettable, the user wants to try dumping anyway.
|
|
||||||
By default, it's set to 0, which will not try something destined to fail.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
|
|
||||||
.B dracut_args <arg(s)>
|
|
||||||
.RS
|
|
||||||
Kdump uses dracut to generate initramfs for second kernel. This option
|
|
||||||
allows a user to pass arguments to dracut directly.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
|
|
||||||
.B fence_kdump_args <arg(s)>
|
|
||||||
.RS
|
|
||||||
Command line arguments for fence_kdump_send (it can contain all valid
|
|
||||||
arguments except hosts to send notification to).
|
|
||||||
.RE
|
|
||||||
|
|
||||||
|
|
||||||
.B fence_kdump_nodes <node(s)>
|
|
||||||
.RS
|
|
||||||
List of cluster node(s) except localhost, separated by spaces, to send fence_kdump notification
|
|
||||||
to (this option is mandatory to enable fence_kdump).
|
|
||||||
.RE
|
|
||||||
|
|
||||||
|
|
||||||
.SH DEPRECATED OPTIONS
|
|
||||||
|
|
||||||
.B net <nfs mount>|<user@server>
|
|
||||||
.RS
|
|
||||||
net option is replaced by nfs and ssh options. Use nfs or ssh options
|
|
||||||
directly.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B options <module> <option list>
|
|
||||||
.RS
|
|
||||||
Use KDUMP_COMMANDLINE_APPEND in /etc/sysconfig/kdump to add module options as
|
|
||||||
kernel command line parameters. For example, specify 'loop.max_loop=1' to limit
|
|
||||||
maximum loop devices to 1.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B link_delay <seconds>
|
|
||||||
.RS
|
|
||||||
link_delay was used to wait for a network device to initialize before using it.
|
|
||||||
Now dracut network module takes care of this issue automatically.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B disk_timeout <seconds>
|
|
||||||
.RS
|
|
||||||
Similar to link_delay, dracut ensures disks are ready before kdump uses them.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B debug_mem_level <0-3>
|
|
||||||
.RS
|
|
||||||
Turn on verbose debug output of kdump scripts regarding free/used memory at
|
|
||||||
various points of execution. This feature has been
|
|
||||||
moved to dracut now.
|
|
||||||
Use KDUMP_COMMANDLINE_APPEND in /etc/sysconfig/kdump and
|
|
||||||
append dracut cmdline param rd.memdebug=[0-3] to enable the debug output.
|
|
||||||
|
|
||||||
Higher level means more debugging output.
|
|
||||||
.PP
|
|
||||||
0 - no output
|
|
||||||
.PP
|
|
||||||
1 - partial /proc/meminfo
|
|
||||||
.PP
|
|
||||||
2 - /proc/meminfo
|
|
||||||
.PP
|
|
||||||
3 - /proc/meminfo + /proc/slabinfo
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.B blacklist <list of kernel modules>
|
|
||||||
.RS
|
|
||||||
blacklist option was recently being used to prevent loading modules in
|
|
||||||
initramfs. General terminology for blacklist has been that module is
|
|
||||||
present in initramfs but it is not actually loaded in kernel. Hence
|
|
||||||
retaining blacklist option creates more confusing behavior. It has been
|
|
||||||
deprecated.
|
|
||||||
.PP
|
|
||||||
Instead, use rd.driver.blacklist option on second kernel to blacklist
|
|
||||||
a certain module. One can edit /etc/sysconfig/kdump.conf and edit
|
|
||||||
KDUMP_COMMANDLINE_APPEND to pass kernel command line options. Refer
|
|
||||||
to dracut.cmdline man page for more details on module blacklist option.
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.RE
|
|
||||||
|
|
||||||
.SH EXAMPLES
|
|
||||||
Here are some examples for core_collector option:
|
|
||||||
.PP
|
|
||||||
Core collector command format depends on dump target type. Typically for
|
|
||||||
filesystem (local/remote), core_collector should accept two arguments.
|
|
||||||
First one is source file and second one is target file. For ex.
|
|
||||||
.TP
|
|
||||||
ex1.
|
|
||||||
core_collector "cp --sparse=always"
|
|
||||||
|
|
||||||
Above will effectively be translated to:
|
|
||||||
|
|
||||||
cp --sparse=always /proc/vmcore <dest-path>/vmcore
|
|
||||||
.TP
|
|
||||||
ex2.
|
|
||||||
core_collector "makedumpfile -l --message-level 7 -d 31"
|
|
||||||
|
|
||||||
Above will effectively be translated to:
|
|
||||||
|
|
||||||
makedumpfile -l --message-level 7 -d 31 /proc/vmcore <dest-path>/vmcore
|
|
||||||
.PP
|
|
||||||
For dump targets like raw and ssh, in general, core collector should expect
|
|
||||||
one argument (source file) and should output the processed core on standard
|
|
||||||
output (There is one exception of "scp", discussed later). This standard
|
|
||||||
output will be saved to destination using appropriate commands.
|
|
||||||
|
|
||||||
raw dumps examples:
|
|
||||||
.TP
|
|
||||||
ex3.
|
|
||||||
core_collector "cat"
|
|
||||||
|
|
||||||
Above will effectively be translated to.
|
|
||||||
|
|
||||||
cat /proc/vmcore | dd of=<target-device>
|
|
||||||
.TP
|
|
||||||
ex4.
|
|
||||||
core_collector "makedumpfile -F -l --message-level 7 -d 31"
|
|
||||||
|
|
||||||
Above will effectively be translated to.
|
|
||||||
|
|
||||||
makedumpfile -F -l --message-level 7 -d 31 | dd of=<target-device>
|
|
||||||
.PP
|
|
||||||
ssh dumps examples
|
|
||||||
.TP
|
|
||||||
ex5.
|
|
||||||
core_collector "cat"
|
|
||||||
|
|
||||||
Above will effectively be translated to.
|
|
||||||
|
|
||||||
cat /proc/vmcore | ssh <options> <remote-location> "dd of=path/vmcore"
|
|
||||||
.TP
|
|
||||||
ex6.
|
|
||||||
core_collector "makedumpfile -F -l --message-level 7 -d 31"
|
|
||||||
|
|
||||||
Above will effectively be translated to.
|
|
||||||
|
|
||||||
makedumpfile -F -l --message-level 7 -d 31 | ssh <options> <remote-location> "dd of=path/vmcore"
|
|
||||||
|
|
||||||
There is one exception to standard output rule for ssh dumps. And that is
|
|
||||||
scp. As scp can handle ssh destinations for file transfers, one can
|
|
||||||
specify "scp" as core collector for ssh targets (no output on stdout).
|
|
||||||
.TP
|
|
||||||
ex7.
|
|
||||||
core_collector "scp"
|
|
||||||
|
|
||||||
Above will effectively be translated to.
|
|
||||||
|
|
||||||
scp /proc/vmcore <user@host>:path/vmcore
|
|
||||||
|
|
||||||
.PP
|
|
||||||
examples for other options please see
|
|
||||||
.I /etc/kdump.conf
|
|
||||||
|
|
||||||
.SH SEE ALSO
|
|
||||||
|
|
||||||
kexec(8) mkdumprd(8) dracut.cmdline(7)
|
|
||||||
@ -1,17 +0,0 @@
|
|||||||
[Unit]
|
|
||||||
Description=Crash recovery kernel arming
|
|
||||||
After=network.target network-online.target remote-fs.target basic.target
|
|
||||||
DefaultDependencies=no
|
|
||||||
ConditionKernelCommandLine=crashkernel
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=oneshot
|
|
||||||
ExecStart=/usr/bin/kdumpctl start
|
|
||||||
ExecStop=/usr/bin/kdumpctl stop
|
|
||||||
ExecReload=/usr/bin/kdumpctl reload
|
|
||||||
RemainAfterExit=yes
|
|
||||||
StartLimitInterval=0
|
|
||||||
PrivateTmp=yes
|
|
||||||
|
|
||||||
[Install]
|
|
||||||
WantedBy=multi-user.target
|
|
||||||
@ -1,53 +0,0 @@
|
|||||||
# Kernel Version string for the -kdump kernel, such as 2.6.13-1544.FC5kdump
|
|
||||||
# If no version is specified, then the init script will try to find a
|
|
||||||
# kdump kernel with the same version number as the running kernel.
|
|
||||||
KDUMP_KERNELVER=""
|
|
||||||
|
|
||||||
# The kdump commandline is the command line that needs to be passed off to
|
|
||||||
# the kdump kernel. This will likely match the contents of the grub kernel
|
|
||||||
# line. For example:
|
|
||||||
# KDUMP_COMMANDLINE="ro root=LABEL=/"
|
|
||||||
# Dracut depends on proper root= options, so please make sure that appropriate
|
|
||||||
# root= options are copied from /proc/cmdline. In general it is best to append
|
|
||||||
# command line options using "KDUMP_COMMANDLINE_APPEND=".
|
|
||||||
# If a command line is not specified, the default will be taken from
|
|
||||||
# /proc/cmdline
|
|
||||||
KDUMP_COMMANDLINE=""
|
|
||||||
|
|
||||||
# This variable lets us remove arguments from the current kdump commandline
|
|
||||||
# as taken from either KDUMP_COMMANDLINE above, or from /proc/cmdline
|
|
||||||
# NOTE: some arguments such as crashkernel will always be removed
|
|
||||||
KDUMP_COMMANDLINE_REMOVE="hugepages hugepagesz slub_debug quiet log_buf_len swiotlb cma hugetlb_cma ignition.firstboot"
|
|
||||||
|
|
||||||
# This variable lets us append arguments to the current kdump commandline
|
|
||||||
# after processed by KDUMP_COMMANDLINE_REMOVE
|
|
||||||
KDUMP_COMMANDLINE_APPEND="irqpoll nr_cpus=1 reset_devices novmcoredd cma=0 hugetlb_cma=0"
|
|
||||||
|
|
||||||
# Any additional kexec arguments required. In most situations, this should
|
|
||||||
# be left empty
|
|
||||||
#
|
|
||||||
# Example:
|
|
||||||
# KEXEC_ARGS="--elf32-core-headers"
|
|
||||||
KEXEC_ARGS=""
|
|
||||||
|
|
||||||
#Where to find the boot image
|
|
||||||
#KDUMP_BOOTDIR="/boot"
|
|
||||||
|
|
||||||
#What is the image type used for kdump
|
|
||||||
KDUMP_IMG="vmlinuz"
|
|
||||||
|
|
||||||
# Logging is controlled by following variables in the first kernel:
|
|
||||||
# - @var KDUMP_STDLOGLVL - logging level to standard error (console output)
|
|
||||||
# - @var KDUMP_SYSLOGLVL - logging level to syslog (by logger command)
|
|
||||||
# - @var KDUMP_KMSGLOGLVL - logging level to /dev/kmsg (only for boot-time)
|
|
||||||
#
|
|
||||||
# In the second kernel, kdump will use the rd.kdumploglvl option to set the
|
|
||||||
# log level in the above KDUMP_COMMANDLINE_APPEND.
|
|
||||||
# - @var rd.kdumploglvl - logging level to syslog (by logger command)
|
|
||||||
# - for example: add the rd.kdumploglvl=3 option to KDUMP_COMMANDLINE_APPEND
|
|
||||||
#
|
|
||||||
# Logging levels: no logging(0), error(1),warn(2),info(3),debug(4)
|
|
||||||
#
|
|
||||||
# KDUMP_STDLOGLVL=3
|
|
||||||
# KDUMP_SYSLOGLVL=0
|
|
||||||
# KDUMP_KMSGLOGLVL=0
|
|
||||||
@ -1,53 +0,0 @@
|
|||||||
# Kernel Version string for the -kdump kernel, such as 2.6.13-1544.FC5kdump
|
|
||||||
# If no version is specified, then the init script will try to find a
|
|
||||||
# kdump kernel with the same version number as the running kernel.
|
|
||||||
KDUMP_KERNELVER=""
|
|
||||||
|
|
||||||
# The kdump commandline is the command line that needs to be passed off to
|
|
||||||
# the kdump kernel. This will likely match the contents of the grub kernel
|
|
||||||
# line. For example:
|
|
||||||
# KDUMP_COMMANDLINE="ro root=LABEL=/"
|
|
||||||
# Dracut depends on proper root= options, so please make sure that appropriate
|
|
||||||
# root= options are copied from /proc/cmdline. In general it is best to append
|
|
||||||
# command line options using "KDUMP_COMMANDLINE_APPEND=".
|
|
||||||
# If a command line is not specified, the default will be taken from
|
|
||||||
# /proc/cmdline
|
|
||||||
KDUMP_COMMANDLINE=""
|
|
||||||
|
|
||||||
# This variable lets us remove arguments from the current kdump commandline
|
|
||||||
# as taken from either KDUMP_COMMANDLINE above, or from /proc/cmdline
|
|
||||||
# NOTE: some arguments such as crashkernel will always be removed
|
|
||||||
KDUMP_COMMANDLINE_REMOVE="hugepages hugepagesz slub_debug quiet log_buf_len swiotlb cma hugetlb_cma ignition.firstboot"
|
|
||||||
|
|
||||||
# This variable lets us append arguments to the current kdump commandline
|
|
||||||
# after processed by KDUMP_COMMANDLINE_REMOVE
|
|
||||||
KDUMP_COMMANDLINE_APPEND="irqpoll nr_cpus=1 reset_devices cgroup_disable=memory udev.children-max=2 panic=10 swiotlb=noforce novmcoredd cma=0 hugetlb_cma=0"
|
|
||||||
|
|
||||||
# Any additional kexec arguments required. In most situations, this should
|
|
||||||
# be left empty
|
|
||||||
#
|
|
||||||
# Example:
|
|
||||||
# KEXEC_ARGS="--elf32-core-headers"
|
|
||||||
KEXEC_ARGS="-s"
|
|
||||||
|
|
||||||
#Where to find the boot image
|
|
||||||
#KDUMP_BOOTDIR="/boot"
|
|
||||||
|
|
||||||
#What is the image type used for kdump
|
|
||||||
KDUMP_IMG="vmlinuz"
|
|
||||||
|
|
||||||
# Logging is controlled by following variables in the first kernel:
|
|
||||||
# - @var KDUMP_STDLOGLVL - logging level to standard error (console output)
|
|
||||||
# - @var KDUMP_SYSLOGLVL - logging level to syslog (by logger command)
|
|
||||||
# - @var KDUMP_KMSGLOGLVL - logging level to /dev/kmsg (only for boot-time)
|
|
||||||
#
|
|
||||||
# In the second kernel, kdump will use the rd.kdumploglvl option to set the
|
|
||||||
# log level in the above KDUMP_COMMANDLINE_APPEND.
|
|
||||||
# - @var rd.kdumploglvl - logging level to syslog (by logger command)
|
|
||||||
# - for example: add the rd.kdumploglvl=3 option to KDUMP_COMMANDLINE_APPEND
|
|
||||||
#
|
|
||||||
# Logging levels: no logging(0), error(1),warn(2),info(3),debug(4)
|
|
||||||
#
|
|
||||||
# KDUMP_STDLOGLVL=3
|
|
||||||
# KDUMP_SYSLOGLVL=0
|
|
||||||
# KDUMP_KMSGLOGLVL=0
|
|
||||||
@ -1,56 +0,0 @@
|
|||||||
# Kernel Version string for the -kdump kernel, such as 2.6.13-1544.FC5kdump
|
|
||||||
# If no version is specified, then the init script will try to find a
|
|
||||||
# kdump kernel with the same version number as the running kernel.
|
|
||||||
KDUMP_KERNELVER=""
|
|
||||||
|
|
||||||
# The kdump commandline is the command line that needs to be passed off to
|
|
||||||
# the kdump kernel. This will likely match the contents of the grub kernel
|
|
||||||
# line. For example:
|
|
||||||
# KDUMP_COMMANDLINE="ro root=LABEL=/"
|
|
||||||
# Dracut depends on proper root= options, so please make sure that appropriate
|
|
||||||
# root= options are copied from /proc/cmdline. In general it is best to append
|
|
||||||
# command line options using "KDUMP_COMMANDLINE_APPEND=".
|
|
||||||
# If a command line is not specified, the default will be taken from
|
|
||||||
# /proc/cmdline
|
|
||||||
KDUMP_COMMANDLINE=""
|
|
||||||
|
|
||||||
# This variable lets us remove arguments from the current kdump commandline
|
|
||||||
# as taken from either KDUMP_COMMANDLINE above, or from /proc/cmdline
|
|
||||||
# NOTE: some arguments such as crashkernel will always be removed
|
|
||||||
KDUMP_COMMANDLINE_REMOVE="hugepages hugepagesz slub_debug quiet log_buf_len swiotlb cma hugetlb_cma ignition.firstboot"
|
|
||||||
|
|
||||||
# This variable lets us append arguments to the current kdump commandline
|
|
||||||
# after processed by KDUMP_COMMANDLINE_REMOVE
|
|
||||||
KDUMP_COMMANDLINE_APPEND="irqpoll nr_cpus=1 reset_devices numa=off udev.children-max=2 panic=10 transparent_hugepage=never novmcoredd cma=0 hugetlb_cma=0"
|
|
||||||
|
|
||||||
# Any additional kexec arguments required. In most situations, this should
|
|
||||||
# be left empty
|
|
||||||
#
|
|
||||||
# Example:
|
|
||||||
# KEXEC_ARGS="--elf32-core-headers"
|
|
||||||
KEXEC_ARGS=""
|
|
||||||
|
|
||||||
#Where to find the boot image
|
|
||||||
#KDUMP_BOOTDIR="/boot"
|
|
||||||
|
|
||||||
#What is the image type used for kdump
|
|
||||||
KDUMP_IMG="vmlinuz"
|
|
||||||
|
|
||||||
#What is the images extension. Relocatable kernels don't have one
|
|
||||||
KDUMP_IMG_EXT=""
|
|
||||||
|
|
||||||
# Logging is controlled by following variables in the first kernel:
|
|
||||||
# - @var KDUMP_STDLOGLVL - logging level to standard error (console output)
|
|
||||||
# - @var KDUMP_SYSLOGLVL - logging level to syslog (by logger command)
|
|
||||||
# - @var KDUMP_KMSGLOGLVL - logging level to /dev/kmsg (only for boot-time)
|
|
||||||
#
|
|
||||||
# In the second kernel, kdump will use the rd.kdumploglvl option to set the
|
|
||||||
# log level in the above KDUMP_COMMANDLINE_APPEND.
|
|
||||||
# - @var rd.kdumploglvl - logging level to syslog (by logger command)
|
|
||||||
# - for example: add the rd.kdumploglvl=3 option to KDUMP_COMMANDLINE_APPEND
|
|
||||||
#
|
|
||||||
# Logging levels: no logging(0), error(1),warn(2),info(3),debug(4)
|
|
||||||
#
|
|
||||||
# KDUMP_STDLOGLVL=3
|
|
||||||
# KDUMP_SYSLOGLVL=0
|
|
||||||
# KDUMP_KMSGLOGLVL=0
|
|
||||||
@ -1,58 +0,0 @@
|
|||||||
# Kernel Version string for the -kdump kernel, such as 2.6.13-1544.FC5kdump
|
|
||||||
# If no version is specified, then the init script will try to find a
|
|
||||||
# kdump kernel with the same version number as the running kernel.
|
|
||||||
KDUMP_KERNELVER=""
|
|
||||||
|
|
||||||
# The kdump commandline is the command line that needs to be passed off to
|
|
||||||
# the kdump kernel. This will likely match the contents of the grub kernel
|
|
||||||
# line. For example:
|
|
||||||
# KDUMP_COMMANDLINE="ro root=LABEL=/"
|
|
||||||
# Dracut depends on proper root= options, so please make sure that appropriate
|
|
||||||
# root= options are copied from /proc/cmdline. In general it is best to append
|
|
||||||
# command line options using "KDUMP_COMMANDLINE_APPEND=".
|
|
||||||
# If a command line is not specified, the default will be taken from
|
|
||||||
# /proc/cmdline
|
|
||||||
KDUMP_COMMANDLINE=""
|
|
||||||
|
|
||||||
# This variable lets us remove arguments from the current kdump commandline
|
|
||||||
# as taken from either KDUMP_COMMANDLINE above, or from /proc/cmdline
|
|
||||||
# NOTE: some arguments such as crashkernel will always be removed
|
|
||||||
KDUMP_COMMANDLINE_REMOVE="hugepages hugepagesz slub_debug quiet log_buf_len swiotlb hugetlb_cma ignition.firstboot"
|
|
||||||
|
|
||||||
# This variable lets us append arguments to the current kdump commandline
|
|
||||||
# after processed by KDUMP_COMMANDLINE_REMOVE
|
|
||||||
KDUMP_COMMANDLINE_APPEND="irqpoll nr_cpus=1 noirqdistrib reset_devices cgroup_disable=memory numa=off udev.children-max=2 ehea.use_mcs=0 panic=10 kvm_cma_resv_ratio=0 transparent_hugepage=never novmcoredd hugetlb_cma=0"
|
|
||||||
|
|
||||||
# Any additional kexec arguments required. In most situations, this should
|
|
||||||
# be left empty
|
|
||||||
#
|
|
||||||
# Example:
|
|
||||||
# KEXEC_ARGS="--elf32-core-headers"
|
|
||||||
KEXEC_ARGS="--dt-no-old-root"
|
|
||||||
|
|
||||||
#Where to find the boot image
|
|
||||||
#KDUMP_BOOTDIR="/boot"
|
|
||||||
|
|
||||||
#What is the image type used for kdump
|
|
||||||
KDUMP_IMG="vmlinuz"
|
|
||||||
|
|
||||||
#What is the images extension. Relocatable kernels don't have one
|
|
||||||
KDUMP_IMG_EXT=""
|
|
||||||
|
|
||||||
#Specify the action after failure
|
|
||||||
|
|
||||||
# Logging is controlled by following variables in the first kernel:
|
|
||||||
# - @var KDUMP_STDLOGLVL - logging level to standard error (console output)
|
|
||||||
# - @var KDUMP_SYSLOGLVL - logging level to syslog (by logger command)
|
|
||||||
# - @var KDUMP_KMSGLOGLVL - logging level to /dev/kmsg (only for boot-time)
|
|
||||||
#
|
|
||||||
# In the second kernel, kdump will use the rd.kdumploglvl option to set the
|
|
||||||
# log level in the above KDUMP_COMMANDLINE_APPEND.
|
|
||||||
# - @var rd.kdumploglvl - logging level to syslog (by logger command)
|
|
||||||
# - for example: add the rd.kdumploglvl=3 option to KDUMP_COMMANDLINE_APPEND
|
|
||||||
#
|
|
||||||
# Logging levels: no logging(0), error(1),warn(2),info(3),debug(4)
|
|
||||||
#
|
|
||||||
# KDUMP_STDLOGLVL=3
|
|
||||||
# KDUMP_SYSLOGLVL=0
|
|
||||||
# KDUMP_KMSGLOGLVL=0
|
|
||||||
@ -1,58 +0,0 @@
|
|||||||
# Kernel Version string for the -kdump kernel, such as 2.6.13-1544.FC5kdump
|
|
||||||
# If no version is specified, then the init script will try to find a
|
|
||||||
# kdump kernel with the same version number as the running kernel.
|
|
||||||
KDUMP_KERNELVER=""
|
|
||||||
|
|
||||||
# The kdump commandline is the command line that needs to be passed off to
|
|
||||||
# the kdump kernel. This will likely match the contents of the grub kernel
|
|
||||||
# line. For example:
|
|
||||||
# KDUMP_COMMANDLINE="ro root=LABEL=/"
|
|
||||||
# Dracut depends on proper root= options, so please make sure that appropriate
|
|
||||||
# root= options are copied from /proc/cmdline. In general it is best to append
|
|
||||||
# command line options using "KDUMP_COMMANDLINE_APPEND=".
|
|
||||||
# If a command line is not specified, the default will be taken from
|
|
||||||
# /proc/cmdline
|
|
||||||
KDUMP_COMMANDLINE=""
|
|
||||||
|
|
||||||
# This variable lets us remove arguments from the current kdump commandline
|
|
||||||
# as taken from either KDUMP_COMMANDLINE above, or from /proc/cmdline
|
|
||||||
# NOTE: some arguments such as crashkernel will always be removed
|
|
||||||
KDUMP_COMMANDLINE_REMOVE="hugepages hugepagesz slub_debug quiet log_buf_len swiotlb hugetlb_cma ignition.firstboot"
|
|
||||||
|
|
||||||
# This variable lets us append arguments to the current kdump commandline
|
|
||||||
# after processed by KDUMP_COMMANDLINE_REMOVE
|
|
||||||
KDUMP_COMMANDLINE_APPEND="irqpoll nr_cpus=1 noirqdistrib reset_devices cgroup_disable=memory numa=off udev.children-max=2 ehea.use_mcs=0 panic=10 kvm_cma_resv_ratio=0 transparent_hugepage=never novmcoredd hugetlb_cma=0"
|
|
||||||
|
|
||||||
# Any additional kexec arguments required. In most situations, this should
|
|
||||||
# be left empty
|
|
||||||
#
|
|
||||||
# Example:
|
|
||||||
# KEXEC_ARGS="--elf32-core-headers"
|
|
||||||
KEXEC_ARGS="--dt-no-old-root -s"
|
|
||||||
|
|
||||||
#Where to find the boot image
|
|
||||||
#KDUMP_BOOTDIR="/boot"
|
|
||||||
|
|
||||||
#What is the image type used for kdump
|
|
||||||
KDUMP_IMG="vmlinuz"
|
|
||||||
|
|
||||||
#What is the images extension. Relocatable kernels don't have one
|
|
||||||
KDUMP_IMG_EXT=""
|
|
||||||
|
|
||||||
#Specify the action after failure
|
|
||||||
|
|
||||||
# Logging is controlled by following variables in the first kernel:
|
|
||||||
# - @var KDUMP_STDLOGLVL - logging level to standard error (console output)
|
|
||||||
# - @var KDUMP_SYSLOGLVL - logging level to syslog (by logger command)
|
|
||||||
# - @var KDUMP_KMSGLOGLVL - logging level to /dev/kmsg (only for boot-time)
|
|
||||||
#
|
|
||||||
# In the second kernel, kdump will use the rd.kdumploglvl option to set the
|
|
||||||
# log level in the above KDUMP_COMMANDLINE_APPEND.
|
|
||||||
# - @var rd.kdumploglvl - logging level to syslog (by logger command)
|
|
||||||
# - for example: add the rd.kdumploglvl=3 option to KDUMP_COMMANDLINE_APPEND
|
|
||||||
#
|
|
||||||
# Logging levels: no logging(0), error(1),warn(2),info(3),debug(4)
|
|
||||||
#
|
|
||||||
# KDUMP_STDLOGLVL=3
|
|
||||||
# KDUMP_SYSLOGLVL=0
|
|
||||||
# KDUMP_KMSGLOGLVL=0
|
|
||||||
@ -1,59 +0,0 @@
|
|||||||
# Kernel Version string for the -kdump kernel, such as 2.6.13-1544.FC5kdump
|
|
||||||
# If no version is specified, then the init script will try to find a
|
|
||||||
# kdump kernel with the same version number as the running kernel.
|
|
||||||
KDUMP_KERNELVER=""
|
|
||||||
|
|
||||||
# The kdump commandline is the command line that needs to be passed off to
|
|
||||||
# the kdump kernel. This will likely match the contents of the grub kernel
|
|
||||||
# line. For example:
|
|
||||||
# KDUMP_COMMANDLINE="ro root=LABEL=/"
|
|
||||||
# Dracut depends on proper root= options, so please make sure that appropriate
|
|
||||||
# root= options are copied from /proc/cmdline. In general it is best to append
|
|
||||||
# command line options using "KDUMP_COMMANDLINE_APPEND=".
|
|
||||||
# If a command line is not specified, the default will be taken from
|
|
||||||
# /proc/cmdline
|
|
||||||
KDUMP_COMMANDLINE=""
|
|
||||||
|
|
||||||
# This variable lets us remove arguments from the current kdump commandline
|
|
||||||
# as taken from either KDUMP_COMMANDLINE above, or from /proc/cmdline
|
|
||||||
# NOTE: some arguments such as crashkernel will always be removed
|
|
||||||
KDUMP_COMMANDLINE_REMOVE="hugepages hugepagesz slub_debug quiet log_buf_len swiotlb vmcp_cma cma hugetlb_cma prot_virt ignition.firstboot zfcp.allow_lun_scan"
|
|
||||||
|
|
||||||
# This variable lets us append arguments to the current kdump commandline
|
|
||||||
# after processed by KDUMP_COMMANDLINE_REMOVE
|
|
||||||
KDUMP_COMMANDLINE_APPEND="nr_cpus=1 cgroup_disable=memory numa=off udev.children-max=2 panic=10 transparent_hugepage=never novmcoredd vmcp_cma=0 cma=0 hugetlb_cma=0"
|
|
||||||
|
|
||||||
# Any additional /sbin/mkdumprd arguments required.
|
|
||||||
MKDUMPRD_ARGS=""
|
|
||||||
|
|
||||||
# Any additional kexec arguments required. In most situations, this should
|
|
||||||
# be left empty
|
|
||||||
#
|
|
||||||
# Example:
|
|
||||||
# KEXEC_ARGS="--elf32-core-headers"
|
|
||||||
KEXEC_ARGS="-s"
|
|
||||||
|
|
||||||
#Where to find the boot image
|
|
||||||
#KDUMP_BOOTDIR="/boot"
|
|
||||||
|
|
||||||
#What is the image type used for kdump
|
|
||||||
KDUMP_IMG="vmlinuz"
|
|
||||||
|
|
||||||
#What is the images extension. Relocatable kernels don't have one
|
|
||||||
KDUMP_IMG_EXT=""
|
|
||||||
|
|
||||||
# Logging is controlled by following variables in the first kernel:
|
|
||||||
# - @var KDUMP_STDLOGLVL - logging level to standard error (console output)
|
|
||||||
# - @var KDUMP_SYSLOGLVL - logging level to syslog (by logger command)
|
|
||||||
# - @var KDUMP_KMSGLOGLVL - logging level to /dev/kmsg (only for boot-time)
|
|
||||||
#
|
|
||||||
# In the second kernel, kdump will use the rd.kdumploglvl option to set the
|
|
||||||
# log level in the above KDUMP_COMMANDLINE_APPEND.
|
|
||||||
# - @var rd.kdumploglvl - logging level to syslog (by logger command)
|
|
||||||
# - for example: add the rd.kdumploglvl=3 option to KDUMP_COMMANDLINE_APPEND
|
|
||||||
#
|
|
||||||
# Logging levels: no logging(0), error(1),warn(2),info(3),debug(4)
|
|
||||||
#
|
|
||||||
# KDUMP_STDLOGLVL=3
|
|
||||||
# KDUMP_SYSLOGLVL=0
|
|
||||||
# KDUMP_KMSGLOGLVL=0
|
|
||||||
@ -1,56 +0,0 @@
|
|||||||
# Kernel Version string for the -kdump kernel, such as 2.6.13-1544.FC5kdump
|
|
||||||
# If no version is specified, then the init script will try to find a
|
|
||||||
# kdump kernel with the same version number as the running kernel.
|
|
||||||
KDUMP_KERNELVER=""
|
|
||||||
|
|
||||||
# The kdump commandline is the command line that needs to be passed off to
|
|
||||||
# the kdump kernel. This will likely match the contents of the grub kernel
|
|
||||||
# line. For example:
|
|
||||||
# KDUMP_COMMANDLINE="ro root=LABEL=/"
|
|
||||||
# Dracut depends on proper root= options, so please make sure that appropriate
|
|
||||||
# root= options are copied from /proc/cmdline. In general it is best to append
|
|
||||||
# command line options using "KDUMP_COMMANDLINE_APPEND=".
|
|
||||||
# If a command line is not specified, the default will be taken from
|
|
||||||
# /proc/cmdline
|
|
||||||
KDUMP_COMMANDLINE=""
|
|
||||||
|
|
||||||
# This variable lets us remove arguments from the current kdump commandline
|
|
||||||
# as taken from either KDUMP_COMMANDLINE above, or from /proc/cmdline
|
|
||||||
# NOTE: some arguments such as crashkernel will always be removed
|
|
||||||
KDUMP_COMMANDLINE_REMOVE="hugepages hugepagesz slub_debug quiet log_buf_len swiotlb cma hugetlb_cma ignition.firstboot"
|
|
||||||
|
|
||||||
# This variable lets us append arguments to the current kdump commandline
|
|
||||||
# after processed by KDUMP_COMMANDLINE_REMOVE
|
|
||||||
KDUMP_COMMANDLINE_APPEND="irqpoll nr_cpus=1 reset_devices cgroup_disable=memory mce=off numa=off udev.children-max=2 panic=10 acpi_no_memhotplug transparent_hugepage=never nokaslr hest_disable novmcoredd cma=0 hugetlb_cma=0 pcie_ports=compat"
|
|
||||||
|
|
||||||
# Any additional kexec arguments required. In most situations, this should
|
|
||||||
# be left empty
|
|
||||||
#
|
|
||||||
# Example:
|
|
||||||
# KEXEC_ARGS="--elf32-core-headers"
|
|
||||||
KEXEC_ARGS="-s"
|
|
||||||
|
|
||||||
#Where to find the boot image
|
|
||||||
#KDUMP_BOOTDIR="/boot"
|
|
||||||
|
|
||||||
#What is the image type used for kdump
|
|
||||||
KDUMP_IMG="vmlinuz"
|
|
||||||
|
|
||||||
#What is the images extension. Relocatable kernels don't have one
|
|
||||||
KDUMP_IMG_EXT=""
|
|
||||||
|
|
||||||
# Logging is controlled by following variables in the first kernel:
|
|
||||||
# - @var KDUMP_STDLOGLVL - logging level to standard error (console output)
|
|
||||||
# - @var KDUMP_SYSLOGLVL - logging level to syslog (by logger command)
|
|
||||||
# - @var KDUMP_KMSGLOGLVL - logging level to /dev/kmsg (only for boot-time)
|
|
||||||
#
|
|
||||||
# In the second kernel, kdump will use the rd.kdumploglvl option to set the
|
|
||||||
# log level in the above KDUMP_COMMANDLINE_APPEND.
|
|
||||||
# - @var rd.kdumploglvl - logging level to syslog (by logger command)
|
|
||||||
# - for example: add the rd.kdumploglvl=3 option to KDUMP_COMMANDLINE_APPEND
|
|
||||||
#
|
|
||||||
# Logging levels: no logging(0), error(1),warn(2),info(3),debug(4)
|
|
||||||
#
|
|
||||||
# KDUMP_STDLOGLVL=3
|
|
||||||
# KDUMP_SYSLOGLVL=0
|
|
||||||
# KDUMP_KMSGLOGLVL=0
|
|
||||||
File diff suppressed because it is too large
Load Diff
@ -1,76 +0,0 @@
|
|||||||
.TH KDUMPCTL 8 2015-07-13 kexec-tools
|
|
||||||
|
|
||||||
.SH NAME
|
|
||||||
kdumpctl \- control interface for kdump
|
|
||||||
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.B kdumpctl
|
|
||||||
.I COMMAND
|
|
||||||
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.B kdumpctl
|
|
||||||
is used to check or control the kdump service.
|
|
||||||
In most cases, you should use
|
|
||||||
.B systemctl
|
|
||||||
to start / stop / enable kdump service instead. However,
|
|
||||||
.B kdumpctl
|
|
||||||
provides more details for debugging and a helper to set up ssh key authentication.
|
|
||||||
|
|
||||||
.SH COMMANDS
|
|
||||||
.TP
|
|
||||||
.I start
|
|
||||||
Start the service.
|
|
||||||
.TP
|
|
||||||
.I stop
|
|
||||||
Stop the service.
|
|
||||||
.TP
|
|
||||||
.I status
|
|
||||||
Prints the current status of kdump service.
|
|
||||||
It returns a non-zero value if kdump is not operational.
|
|
||||||
.TP
|
|
||||||
.I restart
|
|
||||||
Is equal to
|
|
||||||
.I start; stop
|
|
||||||
.TP
|
|
||||||
.I reload
|
|
||||||
reload the crash kernel image and initramfs without triggering a rebuild.
|
|
||||||
.TP
|
|
||||||
.I rebuild
|
|
||||||
rebuild the crash kernel initramfs.
|
|
||||||
.TP
|
|
||||||
.I propagate
|
|
||||||
Helps to setup key authentication for ssh storage since it's
|
|
||||||
impossible to use password authentication during kdump.
|
|
||||||
.TP
|
|
||||||
.I showmem
|
|
||||||
Prints the size of reserved memory for the crash kernel in megabytes.
|
|
||||||
.TP
|
|
||||||
.I estimate
|
|
||||||
Estimate a suitable crashkernel value for the current machine. This is a
|
|
||||||
best-effort estimate. It will print a recommended crashkernel value
|
|
||||||
based on the current kdump setup, and list some details of memory usage.
|
|
||||||
.TP
|
|
||||||
.I get-default-crashkernel
|
|
||||||
Return the default crashkernel value provided by kexec-tools.
|
|
||||||
.TP
|
|
||||||
.I reset-crashkernel [--kernel=path_to_kernel] [--reboot]
|
|
||||||
Reset crashkernel to default value recommended by kexec-tools. If no kernel
|
|
||||||
is specified, will reset KDUMP_KERNELVER if it's defined in /etc/sysconfig/kdump
|
|
||||||
or the current running kernel's crashkernel value if KDUMP_KERNELVER is empty. You can
|
|
||||||
also specify --kernel=ALL and --kernel=DEFAULT which have the same meaning as
|
|
||||||
grubby's kernel-path=ALL and kernel-path=DEFAULT. ppc64le supports FADump and
|
|
||||||
supports an additional [--fadump=[on|off|nocma]] parameter to toggle FADump
|
|
||||||
on/off.
|
|
||||||
|
|
||||||
If the optional parameter [--reboot] is provided the system will automatically
|
|
||||||
reboot for changes to take effect. If no changes were made to the kernel
|
|
||||||
command line the reboot is omitted.
|
|
||||||
|
|
||||||
Note: The memory requirements for kdump varies heavily depending on the
|
|
||||||
used hardware and system configuration. Thus the recommended
|
|
||||||
crashkernel might not work for your specific setup. Please test if
|
|
||||||
kdump works after resetting the crashkernel value.
|
|
||||||
|
|
||||||
.SH "SEE ALSO"
|
|
||||||
.BR kdump.conf (5),
|
|
||||||
.BR mkdumprd (8)
|
|
||||||
File diff suppressed because it is too large
Load Diff
@ -1,39 +0,0 @@
|
|||||||
From bd0200c47c45dd420244b39ddabcecdab1fb9a8e Mon Sep 17 00:00:00 2001
|
|
||||||
From: Hari Bathini <hbathini@linux.ibm.com>
|
|
||||||
Date: Wed, 20 Sep 2023 17:29:27 +0530
|
|
||||||
Subject: [PATCH] kexec: update manpage with explicit mention of clean kexec
|
|
||||||
|
|
||||||
While the manpage does mention about kexec boot with a clean shutdown,
|
|
||||||
it is not explicit about it. Make it explicit.
|
|
||||||
|
|
||||||
Signed-off-by: Hari Bathini <hbathini@linux.ibm.com>
|
|
||||||
Signed-off-by: Simon Horman <horms@kernel.org>
|
|
||||||
---
|
|
||||||
kexec/kexec.8 | 11 +++++++++--
|
|
||||||
1 file changed, 9 insertions(+), 2 deletions(-)
|
|
||||||
|
|
||||||
diff --git a/kexec/kexec.8 b/kexec/kexec.8
|
|
||||||
index 3a344c5..179dcf2 100644
|
|
||||||
--- a/kexec/kexec.8
|
|
||||||
+++ b/kexec/kexec.8
|
|
||||||
@@ -95,8 +95,15 @@ then you would use the following command to load the kernel:
|
|
||||||
.RB "\-\-append=" "root=/dev/hda1" "\ \-\-initrd=" /boot/initrd
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
-After this kernel is loaded, it can be booted to at any time using the
|
|
||||||
-command:
|
|
||||||
+After this kernel is loaded, assuming the user-space supports kexec-based
|
|
||||||
+rebooting, it can be booted to, with a clean shutdown, using the command:
|
|
||||||
+
|
|
||||||
+.RS
|
|
||||||
+.BR reboot
|
|
||||||
+.RE
|
|
||||||
+.PP
|
|
||||||
+Alternatively, it can also be booted to, without calling shutdown(8), with
|
|
||||||
+the command:
|
|
||||||
|
|
||||||
.RS
|
|
||||||
.BR kexec \ \-e
|
|
||||||
--
|
|
||||||
2.41.0
|
|
||||||
|
|
||||||
@ -1,44 +0,0 @@
|
|||||||
From 9d9cf8de8b2ad8273861a30476a46f34cd34871a Mon Sep 17 00:00:00 2001
|
|
||||||
From: Baoquan He <bhe@redhat.com>
|
|
||||||
Date: Tue, 14 Nov 2023 23:20:30 +0800
|
|
||||||
Subject: [PATCH] kexec_file: add kexec_file flag to support debug printing
|
|
||||||
Content-type: text/plain
|
|
||||||
|
|
||||||
This add KEXEC_FILE_DEBUG to kexec_file_flags so that it can be passed
|
|
||||||
to kernel when '-d' is added with kexec_file_load interface. With that
|
|
||||||
flag enabled, kernel can enable the debugging message printing.
|
|
||||||
|
|
||||||
Signed-off-by: Baoquan He <bhe@redhat.com>
|
|
||||||
Signed-off-by: Simon Horman <horms@kernel.org>
|
|
||||||
---
|
|
||||||
kexec/kexec-syscall.h | 1 +
|
|
||||||
kexec/kexec.c | 1 +
|
|
||||||
2 files changed, 2 insertions(+)
|
|
||||||
|
|
||||||
diff --git a/kexec/kexec-syscall.h b/kexec/kexec-syscall.h
|
|
||||||
index 2559bffb93da..73e52543e1b0 100644
|
|
||||||
--- a/kexec/kexec-syscall.h
|
|
||||||
+++ b/kexec/kexec-syscall.h
|
|
||||||
@@ -119,6 +119,7 @@ static inline long kexec_file_load(int kernel_fd, int initrd_fd,
|
|
||||||
#define KEXEC_FILE_UNLOAD 0x00000001
|
|
||||||
#define KEXEC_FILE_ON_CRASH 0x00000002
|
|
||||||
#define KEXEC_FILE_NO_INITRAMFS 0x00000004
|
|
||||||
+#define KEXEC_FILE_DEBUG 0x00000008
|
|
||||||
|
|
||||||
/* These values match the ELF architecture values.
|
|
||||||
* Unless there is a good reason that should continue to be the case.
|
|
||||||
diff --git a/kexec/kexec.c b/kexec/kexec.c
|
|
||||||
index 9d0ec46e5657..222f79e3112e 100644
|
|
||||||
--- a/kexec/kexec.c
|
|
||||||
+++ b/kexec/kexec.c
|
|
||||||
@@ -1477,6 +1477,7 @@ int main(int argc, char *argv[])
|
|
||||||
return 0;
|
|
||||||
case OPT_DEBUG:
|
|
||||||
kexec_debug = 1;
|
|
||||||
+ kexec_file_flags |= KEXEC_FILE_DEBUG;
|
|
||||||
break;
|
|
||||||
case OPT_NOIFDOWN:
|
|
||||||
skip_ifdown = 1;
|
|
||||||
--
|
|
||||||
2.41.0
|
|
||||||
|
|
||||||
@ -1,25 +0,0 @@
|
|||||||
Kdump now works on live images with some manual configurations. Here is the step
|
|
||||||
by step guide.
|
|
||||||
|
|
||||||
1. Enable crashkernel reservation
|
|
||||||
|
|
||||||
Since there isn't any config file that can be used to configure kernel
|
|
||||||
parameters for live images before booting them, we have to append 'crashkernel'
|
|
||||||
argument in boot menu every time we boot a live image.
|
|
||||||
|
|
||||||
2. Change dump target in /etc/kdump.conf
|
|
||||||
|
|
||||||
When kdump kernel boots in a live environment, the default target /var/crash is
|
|
||||||
in RAM so you need to change the dump target to an external disk or a network
|
|
||||||
dump target.
|
|
||||||
|
|
||||||
Besides, make sure that "default dump_to_rootfs" is not specified.
|
|
||||||
|
|
||||||
3. Start kdump service
|
|
||||||
|
|
||||||
$ kdumpctl start
|
|
||||||
|
|
||||||
4. Trigger a kdump test
|
|
||||||
|
|
||||||
$ echo 1 > /proc/sys/kernel/sysrq
|
|
||||||
$ echo c > /proc/sysrq-trigger
|
|
||||||
@ -1,481 +0,0 @@
|
|||||||
#!/bin/bash --norc
|
|
||||||
# New mkdumprd
|
|
||||||
#
|
|
||||||
# Copyright 2011 Red Hat, Inc.
|
|
||||||
#
|
|
||||||
# Written by Cong Wang <amwang@redhat.com>
|
|
||||||
#
|
|
||||||
|
|
||||||
if [[ -f /etc/sysconfig/kdump ]]; then
|
|
||||||
. /etc/sysconfig/kdump
|
|
||||||
fi
|
|
||||||
|
|
||||||
[[ $dracutbasedir ]] || dracutbasedir=/usr/lib/dracut
|
|
||||||
. $dracutbasedir/dracut-functions.sh
|
|
||||||
. /lib/kdump/kdump-lib.sh
|
|
||||||
. /lib/kdump/kdump-logger.sh
|
|
||||||
export IN_KDUMP=1
|
|
||||||
|
|
||||||
#initiate the kdump logger
|
|
||||||
if ! dlog_init; then
|
|
||||||
echo "failed to initiate the kdump logger."
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
SSH_KEY_LOCATION="/root/.ssh/kdump_id_rsa"
|
|
||||||
SAVE_PATH=$(get_save_path)
|
|
||||||
OVERRIDE_RESETTABLE=0
|
|
||||||
|
|
||||||
extra_modules=""
|
|
||||||
dracut_args=(--add kdumpbase --quiet --hostonly --hostonly-cmdline --hostonly-i18n --hostonly-mode strict --hostonly-nics '' -o "plymouth resume ifcfg earlykdump")
|
|
||||||
|
|
||||||
MKDUMPRD_TMPDIR="$(mktemp -d -t mkdumprd.XXXXXX)"
|
|
||||||
[ -d "$MKDUMPRD_TMPDIR" ] || perror_exit "dracut: mktemp -p -d -t dracut.XXXXXX failed."
|
|
||||||
MKDUMPRD_TMPMNT="$MKDUMPRD_TMPDIR/target"
|
|
||||||
|
|
||||||
trap '
|
|
||||||
ret=$?;
|
|
||||||
is_mounted $MKDUMPRD_TMPMNT && umount -f $MKDUMPRD_TMPMNT;
|
|
||||||
[[ -d $MKDUMPRD_TMPDIR ]] && rm --one-file-system -rf -- "$MKDUMPRD_TMPDIR";
|
|
||||||
exit $ret;
|
|
||||||
' EXIT
|
|
||||||
|
|
||||||
# clean up after ourselves no matter how we die.
|
|
||||||
trap 'exit 1;' SIGINT
|
|
||||||
|
|
||||||
add_dracut_arg()
|
|
||||||
{
|
|
||||||
dracut_args+=("$@")
|
|
||||||
}
|
|
||||||
|
|
||||||
add_dracut_mount()
|
|
||||||
{
|
|
||||||
add_dracut_arg "--mount" "$1"
|
|
||||||
}
|
|
||||||
|
|
||||||
add_dracut_sshkey()
|
|
||||||
{
|
|
||||||
add_dracut_arg "--sshkey" "$1"
|
|
||||||
}
|
|
||||||
|
|
||||||
# caller should ensure $1 is valid and mounted in 1st kernel
|
|
||||||
to_mount()
|
|
||||||
{
|
|
||||||
local _target=$1 _fstype=$2 _options=$3 _sed_cmd _new_mntpoint _pdev
|
|
||||||
|
|
||||||
_new_mntpoint=$(get_kdump_mntpoint_from_target "$_target")
|
|
||||||
_fstype="${_fstype:-$(get_fs_type_from_target "$_target")}"
|
|
||||||
_options="${_options:-$(get_mntopt_from_target "$_target")}"
|
|
||||||
_options="${_options:-defaults}"
|
|
||||||
|
|
||||||
if [[ $_fstype == "nfs"* ]]; then
|
|
||||||
_pdev=$_target
|
|
||||||
_sed_cmd+='s/,\(mount\)\?addr=[^,]*//g;'
|
|
||||||
_sed_cmd+='s/,\(mount\)\?proto=[^,]*//g;'
|
|
||||||
_sed_cmd+='s/,clientaddr=[^,]*//;'
|
|
||||||
else
|
|
||||||
# for non-nfs _target converting to use udev persistent name
|
|
||||||
_pdev="$(kdump_get_persistent_dev "$_target")"
|
|
||||||
if [[ -z $_pdev ]]; then
|
|
||||||
return 1
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# mount fs target as rw in 2nd kernel
|
|
||||||
_sed_cmd+='s/\(^\|,\)ro\($\|,\)/\1rw\2/g;'
|
|
||||||
# with 'noauto' in fstab nfs and non-root disk mount will fail in 2nd
|
|
||||||
# kernel, filter it out here.
|
|
||||||
_sed_cmd+='s/\(^\|,\)noauto\($\|,\)/\1/g;'
|
|
||||||
# drop nofail or nobootwait
|
|
||||||
_sed_cmd+='s/\(^\|,\)nofail\($\|,\)/\1/g;'
|
|
||||||
_sed_cmd+='s/\(^\|,\)nobootwait\($\|,\)/\1/g;'
|
|
||||||
|
|
||||||
_options=$(echo "$_options" | sed "$_sed_cmd")
|
|
||||||
|
|
||||||
echo "$_pdev $_new_mntpoint $_fstype $_options"
|
|
||||||
}
|
|
||||||
|
|
||||||
#Function: get_ssh_size
|
|
||||||
#$1=dump target
|
|
||||||
#called from while loop and shouldn't read from stdin, so we're using "ssh -n"
|
|
||||||
get_ssh_size()
|
|
||||||
{
|
|
||||||
local _out
|
|
||||||
local _opt=("-i" "$SSH_KEY_LOCATION" "-o" "BatchMode=yes" "-o" "StrictHostKeyChecking=yes")
|
|
||||||
|
|
||||||
if ! _out=$(ssh -q -n "${_opt[@]}" "$1" "df" "--output=avail" "$SAVE_PATH"); then
|
|
||||||
perror_exit "checking remote ssh server available size failed."
|
|
||||||
fi
|
|
||||||
|
|
||||||
echo -n "$_out" | tail -1
|
|
||||||
}
|
|
||||||
|
|
||||||
#mkdir if save path does not exist on ssh dump target
|
|
||||||
#$1=ssh dump target
|
|
||||||
#caller should ensure write permission on $1:$SAVE_PATH
|
|
||||||
#called from while loop and shouldn't read from stdin, so we're using "ssh -n"
|
|
||||||
mkdir_save_path_ssh()
|
|
||||||
{
|
|
||||||
local _opt _dir
|
|
||||||
_opt=(-i "$SSH_KEY_LOCATION" -o BatchMode=yes -o StrictHostKeyChecking=yes)
|
|
||||||
ssh -qn "${_opt[@]}" "$1" mkdir -p "$SAVE_PATH" &> /dev/null ||
|
|
||||||
perror_exit "mkdir failed on $1:$SAVE_PATH"
|
|
||||||
|
|
||||||
# check whether user has write permission on $1:$SAVE_PATH
|
|
||||||
_dir=$(ssh -qn "${_opt[@]}" "$1" mktemp -dqp "$SAVE_PATH" 2> /dev/null) ||
|
|
||||||
perror_exit "Could not create temporary directory on $1:$SAVE_PATH. Make sure user has write permission on destination"
|
|
||||||
ssh -qn "${_opt[@]}" "$1" rmdir "$_dir"
|
|
||||||
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
#Function: get_fs_size
|
|
||||||
#$1=dump target
|
|
||||||
get_fs_size()
|
|
||||||
{
|
|
||||||
df --output=avail "$(get_mntpoint_from_target "$1")/$SAVE_PATH" | tail -1
|
|
||||||
}
|
|
||||||
|
|
||||||
#Function: get_raw_size
|
|
||||||
#$1=dump target
|
|
||||||
get_raw_size()
|
|
||||||
{
|
|
||||||
fdisk -s "$1"
|
|
||||||
}
|
|
||||||
|
|
||||||
#Function: check_size
|
|
||||||
#$1: dump type string ('raw', 'fs', 'ssh')
|
|
||||||
#$2: dump target
|
|
||||||
check_size()
|
|
||||||
{
|
|
||||||
local avail memtotal
|
|
||||||
|
|
||||||
memtotal=$(awk '/MemTotal/{print $2}' /proc/meminfo)
|
|
||||||
case "$1" in
|
|
||||||
raw)
|
|
||||||
avail=$(get_raw_size "$2")
|
|
||||||
;;
|
|
||||||
ssh)
|
|
||||||
avail=$(get_ssh_size "$2")
|
|
||||||
;;
|
|
||||||
fs)
|
|
||||||
avail=$(get_fs_size "$2")
|
|
||||||
;;
|
|
||||||
*)
|
|
||||||
return
|
|
||||||
;;
|
|
||||||
esac || perror_exit "Check dump target size failed"
|
|
||||||
|
|
||||||
if [[ $avail -lt $memtotal ]]; then
|
|
||||||
dwarn "Warning: There might not be enough space to save a vmcore."
|
|
||||||
dwarn " The size of $2 should be greater than $memtotal kilo bytes."
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
check_save_path_fs()
|
|
||||||
{
|
|
||||||
local _path=$1
|
|
||||||
|
|
||||||
if [[ ! -d $_path ]]; then
|
|
||||||
perror_exit "Dump path $_path does not exist."
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
mount_failure()
|
|
||||||
{
|
|
||||||
local _target=$1
|
|
||||||
local _mnt=$2
|
|
||||||
local _fstype=$3
|
|
||||||
local msg="Failed to mount $_target"
|
|
||||||
|
|
||||||
if [[ -n $_mnt ]]; then
|
|
||||||
msg="$msg on $_mnt"
|
|
||||||
fi
|
|
||||||
|
|
||||||
msg="$msg for kdump preflight check."
|
|
||||||
|
|
||||||
if [[ $_fstype == "nfs" ]]; then
|
|
||||||
msg="$msg Please make sure nfs-utils has been installed."
|
|
||||||
fi
|
|
||||||
|
|
||||||
perror_exit "$msg"
|
|
||||||
}
|
|
||||||
|
|
||||||
check_user_configured_target()
|
|
||||||
{
|
|
||||||
local _target=$1 _cfg_fs_type=$2 _mounted
|
|
||||||
local _mnt _opt _fstype
|
|
||||||
|
|
||||||
_mnt=$(get_mntpoint_from_target "$_target")
|
|
||||||
_opt=$(get_mntopt_from_target "$_target")
|
|
||||||
_fstype=$(get_fs_type_from_target "$_target")
|
|
||||||
|
|
||||||
if [[ -n $_fstype ]]; then
|
|
||||||
# In case of nfs4, nfs should be used instead, nfs* options is deprecated in kdump.conf
|
|
||||||
[[ $_fstype == "nfs"* ]] && _fstype=nfs
|
|
||||||
|
|
||||||
if [[ -n $_cfg_fs_type ]] && [[ $_fstype != "$_cfg_fs_type" ]]; then
|
|
||||||
perror_exit "\"$_target\" have a wrong type config \"$_cfg_fs_type\", expected \"$_fstype\""
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
_fstype="$_cfg_fs_type"
|
|
||||||
_fstype="$_cfg_fs_type"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# For noauto mount, mount it inplace with default value.
|
|
||||||
# Else use the temporary target directory
|
|
||||||
if [[ -n $_mnt ]]; then
|
|
||||||
if ! is_mounted "$_mnt"; then
|
|
||||||
if [[ $_opt == *",noauto"* ]]; then
|
|
||||||
mount "$_mnt" || mount_failure "$_target" "$_mnt" "$_fstype"
|
|
||||||
_mounted=$_mnt
|
|
||||||
else
|
|
||||||
perror_exit "Dump target \"$_target\" is neither mounted nor configured as \"noauto\""
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
else
|
|
||||||
_mnt=$MKDUMPRD_TMPMNT
|
|
||||||
mkdir -p "$_mnt"
|
|
||||||
mount "$_target" "$_mnt" -t "$_fstype" -o defaults || mount_failure "$_target" "" "$_fstype"
|
|
||||||
_mounted=$_mnt
|
|
||||||
fi
|
|
||||||
|
|
||||||
# For user configured target, use $SAVE_PATH as the dump path within the target
|
|
||||||
if [[ ! -d "$_mnt/$SAVE_PATH" ]]; then
|
|
||||||
perror_exit "Dump path \"$SAVE_PATH\" does not exist in dump target \"$_target\""
|
|
||||||
fi
|
|
||||||
|
|
||||||
check_size fs "$_target"
|
|
||||||
|
|
||||||
# Unmount it early, if function is interrupted and didn't reach here, the shell trap will clear it up anyway
|
|
||||||
if [[ -n $_mounted ]]; then
|
|
||||||
umount -f -- "$_mounted"
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: core_collector config value
|
|
||||||
verify_core_collector()
|
|
||||||
{
|
|
||||||
local _cmd="${1%% *}"
|
|
||||||
local _params="${1#${_cmd}}"
|
|
||||||
|
|
||||||
if [[ $_cmd != "makedumpfile" ]]; then
|
|
||||||
if is_raw_dump_target; then
|
|
||||||
dwarn "Warning: specifying a non-makedumpfile core collector, you will have to recover the vmcore manually."
|
|
||||||
fi
|
|
||||||
return
|
|
||||||
fi
|
|
||||||
|
|
||||||
if is_ssh_dump_target || is_raw_dump_target; then
|
|
||||||
if ! strstr "$_params" "-F"; then
|
|
||||||
perror_exit 'The specified dump target needs makedumpfile "-F" option.'
|
|
||||||
fi
|
|
||||||
_params="$_params vmcore"
|
|
||||||
else
|
|
||||||
_params="$_params vmcore dumpfile"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# shellcheck disable=SC2086
|
|
||||||
if ! $_cmd --check-params $_params; then
|
|
||||||
perror_exit "makedumpfile parameter check failed."
|
|
||||||
fi
|
|
||||||
}
|
|
||||||
|
|
||||||
add_mount()
|
|
||||||
{
|
|
||||||
local _mnt
|
|
||||||
|
|
||||||
_mnt=$(to_mount "$@") || exit 1
|
|
||||||
|
|
||||||
add_dracut_mount "$_mnt"
|
|
||||||
}
|
|
||||||
|
|
||||||
#handle the case user does not specify the dump target explicitly
|
|
||||||
handle_default_dump_target()
|
|
||||||
{
|
|
||||||
local _target
|
|
||||||
local _mntpoint
|
|
||||||
|
|
||||||
is_user_configured_dump_target && return
|
|
||||||
|
|
||||||
check_save_path_fs "$SAVE_PATH"
|
|
||||||
|
|
||||||
_save_path=$(get_bind_mount_source "$SAVE_PATH")
|
|
||||||
_target=$(get_target_from_path "$_save_path")
|
|
||||||
_mntpoint=$(get_mntpoint_from_target "$_target")
|
|
||||||
|
|
||||||
SAVE_PATH=${_save_path##"$_mntpoint"}
|
|
||||||
add_mount "$_target"
|
|
||||||
check_size fs "$_target"
|
|
||||||
}
|
|
||||||
|
|
||||||
# $1: function name
|
|
||||||
for_each_block_target()
|
|
||||||
{
|
|
||||||
local dev majmin
|
|
||||||
|
|
||||||
for dev in $(get_kdump_targets); do
|
|
||||||
[[ -b $dev ]] || continue
|
|
||||||
majmin=$(get_maj_min "$dev")
|
|
||||||
check_block_and_slaves "$1" "$majmin" && return 1
|
|
||||||
done
|
|
||||||
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
#judge if a specific device with $1 is unresettable
|
|
||||||
#return false if unresettable.
|
|
||||||
is_unresettable()
|
|
||||||
{
|
|
||||||
local path device resettable=1
|
|
||||||
|
|
||||||
path="/sys/$(udevadm info --query=all --path="/sys/dev/block/$1" | awk '/^P:/ {print $2}' | sed -e 's/\(cciss[0-9]\+\/\).*/\1/g' -e 's/\/block\/.*$//')/resettable"
|
|
||||||
if [[ -f $path ]]; then
|
|
||||||
resettable="$(< "$path")"
|
|
||||||
[[ $resettable -eq 0 ]] && [[ $OVERRIDE_RESETTABLE -eq 0 ]] && {
|
|
||||||
device=$(udevadm info --query=all --path="/sys/dev/block/$1" | awk -F= '/DEVNAME/{print $2}')
|
|
||||||
derror "Error: Can not save vmcore because device $device is unresettable"
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
fi
|
|
||||||
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
|
|
||||||
#check if machine is resettable.
|
|
||||||
#return true if resettable
|
|
||||||
check_resettable()
|
|
||||||
{
|
|
||||||
local _target _override_resettable
|
|
||||||
|
|
||||||
_override_resettable=$(kdump_get_conf_val override_resettable)
|
|
||||||
OVERRIDE_RESETTABLE=${_override_resettable:-$OVERRIDE_RESETTABLE}
|
|
||||||
if [ "$OVERRIDE_RESETTABLE" != "0" ] && [ "$OVERRIDE_RESETTABLE" != "1" ]; then
|
|
||||||
perror_exit "override_resettable value '$OVERRIDE_RESETTABLE' is invalid"
|
|
||||||
fi
|
|
||||||
|
|
||||||
for_each_block_target is_unresettable && return
|
|
||||||
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
|
|
||||||
check_crypt()
|
|
||||||
{
|
|
||||||
local _dev
|
|
||||||
|
|
||||||
for _dev in $(get_kdump_targets); do
|
|
||||||
if [[ -n $(get_luks_crypt_dev "$(get_maj_min "$_dev")") ]]; then
|
|
||||||
derror "Device $_dev is encrypted." && return 1
|
|
||||||
fi
|
|
||||||
done
|
|
||||||
}
|
|
||||||
|
|
||||||
if ! check_resettable; then
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
if ! check_crypt; then
|
|
||||||
dwarn "Warning: Encrypted device is in dump path, which is not recommended, see kexec-kdump-howto.txt for more details."
|
|
||||||
fi
|
|
||||||
|
|
||||||
# firstly get right SSH_KEY_LOCATION
|
|
||||||
keyfile=$(kdump_get_conf_val sshkey)
|
|
||||||
if [[ -f $keyfile ]]; then
|
|
||||||
# canonicalize the path
|
|
||||||
SSH_KEY_LOCATION=$(/usr/bin/readlink -m "$keyfile")
|
|
||||||
fi
|
|
||||||
|
|
||||||
while read -r config_opt config_val; do
|
|
||||||
# remove inline comments after the end of a directive.
|
|
||||||
case "$config_opt" in
|
|
||||||
extra_modules)
|
|
||||||
extra_modules="$extra_modules $config_val"
|
|
||||||
;;
|
|
||||||
ext[234] | xfs | btrfs | minix | nfs | virtiofs)
|
|
||||||
check_user_configured_target "$config_val" "$config_opt"
|
|
||||||
add_mount "$config_val" "$config_opt"
|
|
||||||
;;
|
|
||||||
raw)
|
|
||||||
# checking raw disk writable
|
|
||||||
dd if="$config_val" count=1 of=/dev/null > /dev/null 2>&1 || {
|
|
||||||
perror_exit "Bad raw disk $config_val"
|
|
||||||
}
|
|
||||||
_praw=$(persistent_policy="by-id" kdump_get_persistent_dev "$config_val")
|
|
||||||
if [[ -z $_praw ]]; then
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
add_dracut_arg "--device" "$_praw"
|
|
||||||
check_size raw "$config_val"
|
|
||||||
;;
|
|
||||||
ssh)
|
|
||||||
if strstr "$config_val" "@"; then
|
|
||||||
mkdir_save_path_ssh "$config_val"
|
|
||||||
check_size ssh "$config_val"
|
|
||||||
add_dracut_sshkey "$SSH_KEY_LOCATION"
|
|
||||||
else
|
|
||||||
perror_exit "Bad ssh dump target $config_val"
|
|
||||||
fi
|
|
||||||
;;
|
|
||||||
core_collector)
|
|
||||||
verify_core_collector "$config_val"
|
|
||||||
;;
|
|
||||||
dracut_args)
|
|
||||||
|
|
||||||
# When users specify nfs dumping via dracut_args, kexec-tools won't
|
|
||||||
# mount nfs fs beforehand thus nfsv4-related drivers won't be installed
|
|
||||||
# because we call dracut with --hostonly-mode strict. So manually install
|
|
||||||
# nfsv4-related drivers.
|
|
||||||
if [[ $(get_dracut_args_fstype "$config_val") == nfs* ]]; then
|
|
||||||
add_dracut_arg "--add-drivers" nfs_layout_nfsv41_files
|
|
||||||
fi
|
|
||||||
|
|
||||||
while read -r dracut_arg; do
|
|
||||||
add_dracut_arg "$dracut_arg"
|
|
||||||
done <<< "$(echo "$config_val" | xargs -n 1 echo)"
|
|
||||||
;;
|
|
||||||
*) ;;
|
|
||||||
|
|
||||||
esac
|
|
||||||
done <<< "$(kdump_read_conf)"
|
|
||||||
|
|
||||||
handle_default_dump_target
|
|
||||||
|
|
||||||
if ! have_compression_in_dracut_args; then
|
|
||||||
if is_squash_available && dracut_have_option "--squash-compressor"; then
|
|
||||||
add_dracut_arg "--squash-compressor" "zstd"
|
|
||||||
elif is_zstd_command_available; then
|
|
||||||
add_dracut_arg "--compress" "zstd"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
if [[ -n $extra_modules ]]; then
|
|
||||||
add_dracut_arg "--add-drivers" "$extra_modules"
|
|
||||||
fi
|
|
||||||
|
|
||||||
# TODO: The below check is not needed anymore with the introduction of
|
|
||||||
# 'zz-fadumpinit' module, that isolates fadump's capture kernel initrd,
|
|
||||||
# but still sysroot.mount unit gets generated based on 'root=' kernel
|
|
||||||
# parameter available in fadump case. So, find a way to fix that first
|
|
||||||
# before removing this check.
|
|
||||||
if ! is_fadump_capable; then
|
|
||||||
# The 2nd rootfs mount stays behind the normal dump target mount,
|
|
||||||
# so it doesn't affect the logic of check_dump_fs_modified().
|
|
||||||
is_dump_to_rootfs && add_mount "$(to_dev_name "$(get_root_fs_device)")"
|
|
||||||
|
|
||||||
add_dracut_arg "--no-hostonly-default-device"
|
|
||||||
|
|
||||||
if fips-mode-setup --is-enabled 2> /dev/null; then
|
|
||||||
add_dracut_arg --add-device "$(findmnt -n -o SOURCE --target /boot)"
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
# This is RHEL-only to work around nvme problem, then real fix should go to dracut
|
|
||||||
if [[ -d /sys/module/nvme ]]; then
|
|
||||||
add_dracut_arg "--add-drivers" "nvme"
|
|
||||||
fi
|
|
||||||
|
|
||||||
dracut "${dracut_args[@]}" "$@"
|
|
||||||
|
|
||||||
_rc=$?
|
|
||||||
sync
|
|
||||||
exit $_rc
|
|
||||||
@ -1,39 +0,0 @@
|
|||||||
.TH MKDUMRD 8 "Fri Feb 9 2007"
|
|
||||||
.SH NAME
|
|
||||||
mkdumprd \- creates initial ramdisk images for kdump crash recovery
|
|
||||||
.SH SYNOPSIS
|
|
||||||
\fBmkdumprd\fR [OPTION]
|
|
||||||
|
|
||||||
.SH DESCRIPTION
|
|
||||||
\fBmkdumprd\fR creates an initial ram file system for use in conjunction with
|
|
||||||
the booting of a kernel within the kdump framework for crash recovery.
|
|
||||||
\fBmkdumprds\fR purpose is to create an initial ram filesystem capable of copying
|
|
||||||
the crashed systems vmcore image to a location specified in \fI/etc/kdump.conf
|
|
||||||
|
|
||||||
\fBmkdumprd\fR interrogates the running system to understand what modules need to
|
|
||||||
be loaded in the initramfs (based on configuration retrieved from
|
|
||||||
\fI/etc/kdump.conf)\fR
|
|
||||||
|
|
||||||
\fBmkdumprd\fR add a new \fBdracut\fR module 99kdumpbase and use \fBdracut\fR
|
|
||||||
utility to generate the initramfs. When generating a kdump initramfs, \fBmkdumprd\fR
|
|
||||||
will determine how much disk space is available, if the dump target's available
|
|
||||||
space is not greater than the total system memory, \fBmkdumprd\fR will print a
|
|
||||||
warning to remind that there might not be enough space to save a vmcore. The
|
|
||||||
warning covers extreme scenarios such as the slab explodes with non-zero data or
|
|
||||||
a full vmcore, etc. Therefore, need to prevent users from having minimum disk
|
|
||||||
space for crash dump.
|
|
||||||
|
|
||||||
\fBmkdumprd\fR was not intended for casual use outside of the service
|
|
||||||
initialization script for the kdump utility, and should not be run manually. If
|
|
||||||
you require a custom kdump initramfs image, it is suggested that you use the
|
|
||||||
kdump service infrastructure to create one, and then manually unpack, modify and
|
|
||||||
repack the image.
|
|
||||||
|
|
||||||
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
All options here are passed to dracut directly, please refer \fBdracut\fR docs
|
|
||||||
for the info.
|
|
||||||
|
|
||||||
.SH "SEE ALSO"
|
|
||||||
.BR dracut (8)
|
|
||||||
@ -1,74 +0,0 @@
|
|||||||
#!/bin/bash --norc
|
|
||||||
# Generate an initramfs image that isolates dump capture capability within
|
|
||||||
# the default initramfs using zz-fadumpinit dracut module.
|
|
||||||
|
|
||||||
if [[ -f /etc/sysconfig/kdump ]]; then
|
|
||||||
. /etc/sysconfig/kdump
|
|
||||||
fi
|
|
||||||
|
|
||||||
[[ $dracutbasedir ]] || dracutbasedir=/usr/lib/dracut
|
|
||||||
. $dracutbasedir/dracut-functions.sh
|
|
||||||
. /lib/kdump/kdump-lib.sh
|
|
||||||
. /lib/kdump/kdump-logger.sh
|
|
||||||
|
|
||||||
#initiate the kdump logger
|
|
||||||
if ! dlog_init; then
|
|
||||||
echo "mkfadumprd: failed to initiate the kdump logger."
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
MKFADUMPRD_TMPDIR="$(mktemp -d -t mkfadumprd.XXXXXX)"
|
|
||||||
[ -d "$MKFADUMPRD_TMPDIR" ] || perror_exit "mkfadumprd: mktemp -d -t mkfadumprd.XXXXXX failed."
|
|
||||||
trap '
|
|
||||||
ret=$?;
|
|
||||||
[[ -d $MKFADUMPRD_TMPDIR ]] && rm --one-file-system -rf -- "$MKFADUMPRD_TMPDIR";
|
|
||||||
exit $ret;
|
|
||||||
' EXIT
|
|
||||||
|
|
||||||
# clean up after ourselves no matter how we die.
|
|
||||||
trap 'exit 1;' SIGINT
|
|
||||||
|
|
||||||
MKDUMPRD="/sbin/mkdumprd -f"
|
|
||||||
# Default boot initramfs to be rebuilt
|
|
||||||
REBUILD_INITRD="$1" && shift
|
|
||||||
TARGET_INITRD="$1" && shift
|
|
||||||
FADUMP_INITRD="$MKFADUMPRD_TMPDIR/fadump.img"
|
|
||||||
|
|
||||||
### First build an initramfs with dump capture capability
|
|
||||||
# this file tells the initrd is fadump enabled
|
|
||||||
touch "$MKFADUMPRD_TMPDIR/fadump.initramfs"
|
|
||||||
ddebug "rebuild fadump initrd: $FADUMP_INITRD $DEFAULT_INITRD $KDUMP_KERNELVER"
|
|
||||||
# Don't use squash for capture image or default image as it negatively impacts
|
|
||||||
# compression ratio and increases the size of the initramfs image.
|
|
||||||
# Don't compress the capture image as uncompressed image is needed immediately.
|
|
||||||
# Also, early microcode would not be needed here.
|
|
||||||
if ! $MKDUMPRD "$FADUMP_INITRD" -i "$MKFADUMPRD_TMPDIR/fadump.initramfs" /etc/fadump.initramfs --omit squash --no-compress --no-early-microcode; then
|
|
||||||
perror_exit "mkfadumprd: failed to build image with dump capture support"
|
|
||||||
fi
|
|
||||||
|
|
||||||
### Unpack the initramfs having dump capture capability retaining previous file modification time.
|
|
||||||
# This helps in saving space by hardlinking identical files.
|
|
||||||
mkdir -p "$MKFADUMPRD_TMPDIR/fadumproot"
|
|
||||||
if ! cpio -id --preserve-modification-time --quiet -D "$MKFADUMPRD_TMPDIR/fadumproot" < "$FADUMP_INITRD"; then
|
|
||||||
derror "mkfadumprd: failed to unpack '$MKFADUMPRD_TMPDIR'"
|
|
||||||
exit 1
|
|
||||||
fi
|
|
||||||
|
|
||||||
### Pack it into the normal boot initramfs with zz-fadumpinit module
|
|
||||||
_dracut_isolate_args=(
|
|
||||||
--rebuild "$REBUILD_INITRD" --add zz-fadumpinit
|
|
||||||
-i "$MKFADUMPRD_TMPDIR/fadumproot" /fadumproot
|
|
||||||
-i "$MKFADUMPRD_TMPDIR/fadumproot/usr/lib/dracut/hostonly-kernel-modules.txt"
|
|
||||||
/usr/lib/dracut/fadump-kernel-modules.txt
|
|
||||||
)
|
|
||||||
|
|
||||||
# Use zstd compression method, if available
|
|
||||||
if ! have_compression_in_dracut_args; then
|
|
||||||
if is_zstd_command_available; then
|
|
||||||
_dracut_isolate_args+=(--compress zstd)
|
|
||||||
fi
|
|
||||||
fi
|
|
||||||
|
|
||||||
if ! dracut --force --quiet "${_dracut_isolate_args[@]}" "$@" "$TARGET_INITRD"; then
|
|
||||||
perror_exit "mkfadumprd: failed to setup '$TARGET_INITRD' with dump capture capability"
|
|
||||||
fi
|
|
||||||
@ -1,121 +0,0 @@
|
|||||||
Supported Kdump Targets
|
|
||||||
|
|
||||||
This document try to list all supported kdump targets, and those supported
|
|
||||||
or unknown/tech-preview targets, this can help users to decide whether a dump
|
|
||||||
solution is available.
|
|
||||||
|
|
||||||
Dump Target support status
|
|
||||||
==========================
|
|
||||||
This section tries to come up with some kind of guidelines in terms of
|
|
||||||
what dump targets are supported/not supported. Whatever is listed here
|
|
||||||
is not binding in any manner. It is just sharing of current understanding
|
|
||||||
and if something is not right, this section needs to be edited.
|
|
||||||
|
|
||||||
Following are 3 lists. First one contains supported targets. These are
|
|
||||||
generic configurations which should work and some configuration most
|
|
||||||
likely has worked in testing. Second list is known unsupported targets.
|
|
||||||
These targets we know either don't work or we don't support. And third
|
|
||||||
list is unknown/tech-preview. We either don't yet know the status of kdump
|
|
||||||
on these targets or these are under tech-preview.
|
|
||||||
|
|
||||||
Note, these lists are not set in stone and can be changed at any point of
|
|
||||||
time. Also these lists might not be complete. We will add/remove items to
|
|
||||||
it as we get more testing information. Also, there are many corner cases
|
|
||||||
which can't possibly be listed. For example in general we might be
|
|
||||||
supporting software iscsi but there might be some configurations of it
|
|
||||||
which don't work.
|
|
||||||
|
|
||||||
So if any target is listed in supported section, it does not mean it works
|
|
||||||
in all possible configurations. It just means that in common configurations
|
|
||||||
it should work but there can be issues with particular configurations which
|
|
||||||
are not supported. As we come to know of particular issues, we will keep on
|
|
||||||
updating lists accordingly.
|
|
||||||
|
|
||||||
|
|
||||||
Supported Dump targets
|
|
||||||
----------------------
|
|
||||||
storage:
|
|
||||||
LVM volume
|
|
||||||
Thin provisioning volume
|
|
||||||
FC disks (qla2xxx, lpfc, bnx2fc, bfa)
|
|
||||||
software initiator based iSCSI
|
|
||||||
software RAID (mdraid)
|
|
||||||
hardware RAID (smartpqi, hpsa, megaraid, mpt3sas, aacraid, mpi3mr)
|
|
||||||
SCSI/SATA disks
|
|
||||||
iSCSI HBA (all offload)
|
|
||||||
hardware FCoE (qla2xxx, lpfc)
|
|
||||||
software FCoE (bnx2fc) (Extra configuration required,
|
|
||||||
please read "Note on FCoE" section below)
|
|
||||||
NVMe-FC (qla2xxx, lpfc)
|
|
||||||
|
|
||||||
network:
|
|
||||||
Hardware using kernel modules: (igb, ixgbe, ice, i40e, e1000e, igc,
|
|
||||||
tg3, bnx2x, bnxt_en, qede, cxgb4, be2net, enic, sfc, mlx4_en,
|
|
||||||
mlx5_core, r8169, atlantic, nfp, ionic; nicvf (aarch64 only))
|
|
||||||
protocol: ipv4
|
|
||||||
bonding
|
|
||||||
vlan
|
|
||||||
bridge
|
|
||||||
vlan tagged bonding
|
|
||||||
bridge over bond/vlan
|
|
||||||
|
|
||||||
hypervisor:
|
|
||||||
kvm
|
|
||||||
xen (Supported in select configurations only)
|
|
||||||
|
|
||||||
filesystem:
|
|
||||||
ext[234]
|
|
||||||
xfs
|
|
||||||
nfs
|
|
||||||
virtiofs
|
|
||||||
|
|
||||||
firmware:
|
|
||||||
BIOS
|
|
||||||
UEFI
|
|
||||||
|
|
||||||
hypervisor:
|
|
||||||
VMWare ESXi 4.x 5.x would not be tested/supported any more.
|
|
||||||
only support ESXi 6.6, 6.7, 7.0
|
|
||||||
Hyper-V 2012 R2 (RHEL Gen1 UP Guest only), later version will
|
|
||||||
also be tested/supported
|
|
||||||
|
|
||||||
Unsupported Dump targets
|
|
||||||
------------------------
|
|
||||||
storage:
|
|
||||||
BIOS RAID
|
|
||||||
Software iSCSI with iBFT (bnx2i, cxgb3i, cxgb4i)
|
|
||||||
Software iSCSI with hybrid (be2iscsi)
|
|
||||||
FCoE
|
|
||||||
legacy IDE
|
|
||||||
glusterfs
|
|
||||||
gfs2/clvm/halvm
|
|
||||||
|
|
||||||
network:
|
|
||||||
hardware using kernel modules: (sfc SRIOV, cxgb4vf, pch_gbe)
|
|
||||||
protocol: ipv6
|
|
||||||
wireless
|
|
||||||
Infiniband (IB)
|
|
||||||
vlan over bridge/team
|
|
||||||
|
|
||||||
filesystem:
|
|
||||||
btrfs
|
|
||||||
|
|
||||||
Unknown/tech-preview
|
|
||||||
--------------------
|
|
||||||
storage:
|
|
||||||
PCI Express based SSDs
|
|
||||||
|
|
||||||
hypervisor:
|
|
||||||
Hyper-V 2008
|
|
||||||
Hyper-V 2012
|
|
||||||
|
|
||||||
|
|
||||||
Note on FCoE
|
|
||||||
=====================
|
|
||||||
If you are trying to dump to a software FCoE target, you may encounter OOM
|
|
||||||
issue, because some software FCoE requires more memory to work. In such case,
|
|
||||||
you may need to increase the kdump reserved memory size in "crashkernel="
|
|
||||||
kernel parameter.
|
|
||||||
|
|
||||||
For hardware FCoE, kdump should work naturally as firmware will do the
|
|
||||||
initialization job. The capture kernel and kdump tools will run just fine.
|
|
||||||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in new issue