Chapter 19. Configuring automatic crash dumps by using the kdump RHEL System Role
To manage kdump using Ansible, you can use the kdump
role, which is one of the RHEL System Roles available in RHEL 7.9.
Using the kdump
role enables you to specify where to save the contents of the system’s memory for later analysis.
19.1. The kdump
RHEL System Role
The kdump
System Role enables you to set basic kernel dump parameters on multiple systems.
19.2. kdump
role parameters
The parameters used for the kdump
RHEL System Roles are:
Role Variable | Description |
---|---|
kdump_path |
The path to which |
Additional resources
- The makedumpfile(8) man page.
-
For details about the parameters used in
kdump
and additional information about thekdump
System Role, see the/usr/share/ansible/roles/rhel-system-roles.tlog/README.md
file.
19.3. Configuring kdump using RHEL System Roles
You can set basic kernel dump parameters on multiple systems using the kdump
System Role by running an Ansible playbook.
The kdump
role replaces the kdump configuration of the managed hosts entirely by replacing the /etc/kdump.conf
file. Additionally, if the kdump
role is applied, all previous kdump
settings are also replaced, even if they are not specified by the role variables, by replacing the /etc/sysconfig/kdump
file.
Prerequisites
- The Ansible Core package is installed on the control machine.
-
You have the
rhel-system-roles
package installed on the system from which you want to run the playbook. -
You have an inventory file which lists the systems on which you want to deploy
kdump
.
Procedure
Create a new
playbook.yml
file with the following content:--- - hosts: kdump-test vars: kdump_path: /var/crash roles: - rhel-system-roles.kdump
Optional: Verify playbook syntax.
# ansible-playbook --syntax-check playbook.yml
Run the playbook on your inventory file:
# ansible-playbook -i inventory_file /path/to/file/playbook.yml
Additional resources
-
For a detailed reference on
kdump
role variables, see the README.md or README.html files in the /usr/share/doc/rhel-system-roles/kdump directory. - See Preparing the control node and managed nodes to use RHEL System Roles
-
Documentation installed with the
rhel-system-roles
package/usr/share/ansible/roles/rhel-system-roles.kdump/README.html