Skip to content

Commit

Permalink
troubleshooting: Add instructions for enabling kdump
Browse files Browse the repository at this point in the history
  • Loading branch information
kelvinfan001 committed Dec 7, 2020
1 parent 417cd8e commit d48385e
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 0 deletions.
1 change: 1 addition & 0 deletions modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@
*** xref:access-recovery.adoc[Access Recovery]
*** xref:emergency-shell.adoc[Emergency Shell Access]
*** xref:debugging-with-toolbox.adoc[Debugging with Toolbox]
*** xref:debugging-kernel-crashes.adoc[Debugging Kernel Crashes]
* Migration notes
** xref:migrate-ah.adoc[Migrating from Atomic Host]
** xref:migrate-cl.adoc[Migrating from Container Linux]
Expand Down
27 changes: 27 additions & 0 deletions modules/ROOT/pages/debugging-kernel-crashes.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
= Debugging kernel crashes using kdump

. Memory must be reserved for the crash kernel during booting of the first kernel. Kernel arguments can be provided like this:
+
[source, bash]
----
sudo rpm-ostree kargs --append='crashkernel=256M'
----
xref:kernel-args.adoc[More information] on how to modify kargs via `rpm-ostree`.

. By default, the path in which the vmcore will be saved is `/var/crash`. It is also possible to write the dump over the network or to some other location on the local system by editing `/etc/kdump.conf`. For additional information, see https://linux.die.net/man/8/mkdumprd[`mkdumprd(8)`] and the comments in `/etc/kdump.conf`.

. Enable the kdump systemd service.
+
[source, bash]
----
sudo systemctl enable kdump.service
----

. Reboot your system.
+
[source, bash]
----
sudo systemctl reboot
----

TIP: For additional information on how to test that kdump is properly armed and how to analyze the dump, refer to the https://fedoraproject.org/wiki/How_to_use_kdump_to_debug_kernel_crashes[kdump documentation for Fedora] and https://www.kernel.org/doc/html/latest/admin-guide/kdump/kdump.html[the Linux kernel documentation on kdump].

0 comments on commit d48385e

Please sign in to comment.