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 Nov 2, 2020
1 parent 1a16de7 commit d6e71d7
Show file tree
Hide file tree
Showing 2 changed files with 33 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 @@ -34,6 +34,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
32 changes: 32 additions & 0 deletions modules/ROOT/pages/debugging-kernel-crashes.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
= Enabling kdump to debug kernel crashes

. 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`.

. Make sure the path in which the vmcore will be saved is somewhere in the `/var` directory of the FCOS stateroot. It is also possible to write the dump over the network; for additional information, consult the mkdumprd man page and the comments in /etc/kdump.conf.
+
[source, bash]
----
sed -i "s/^path.*/path \/sysroot\/ostree\/deploy\/fedora-coreos\/var\/crash/" /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].

0 comments on commit d6e71d7

Please sign in to comment.