Skip to content

Latest commit

 

History

History
86 lines (61 loc) · 2.44 KB

README.md

File metadata and controls

86 lines (61 loc) · 2.44 KB
Raw

Ansible Role: Kernel Crash Dump

CI Testing

An ansible role which configures kdump.

Warning

The role replaces the kdump configuration of the managed host. Previous settings will be lost, even if they are not specified in the role variables. Currently, this includes replacing at least the following configuration files:

  • /etc/sysconfig/kdump
  • /etc/kdump.conf

Role Variables

kdump_target: Can be specified to write vmcore to a location that is not in the root file system. If type is raw or a filesystem type, location points to a partition (by device node name, label, or uuid). For example:

kdump_target:
  type: raw
  location: /dev/sda1

or for an ext4 filesystem:

kdump_target:
  type: ext4
  location: "12e3e25f-534e-4007-a40c-e7e080a933ad"

If type is ssh, location points to a server: example:

  type: ssh
  location: [email protected]

Similarly for nfs, location points to an nfs server:

  type: nfs
  location: nfs.example.com

Only the ssh type is considered stable, support for the other types is experimental.

kdump_path: The path to which vmcore will be written. If kdump_target is not null, path is relative to that dump target. Otherwise, it must be an absolute path in the root file system.

kdump_core_collector: A command to copy the vmcore. If null, uses makedumpfile with options depending on the kdump_target.type.

kdump_system_action: The action that is performed when dumping the core file fails. Can be reboot, halt, poweroff, or shell.

kdump_reboot_ok: If you run the role on a managed node that does not have memory reserved for crash kernel, i.e. the file /sys/kernel/kexec_crash_size contains 0, it might be required to reboot the managed node to configure kdump.

By default, the role does not reboot the managed node. If a managed node requires reboot, the role sets the kdump_reboot_required fact and fails, so that the user can reboot the managed node when needed. If you want the role to reboot the system if required, set this variable to true. You do not need to re-execute the role after boot.

Default: false

Ansible Facts Returned by the Role

kdump_reboot_required: The role sets this fact if the managed node requires reboot to complete kdump configuration. Re-execute the role after boot to ensure that kdump is working.

License

MIT