From 5ced61ae366b107a4361c418b7549d0d70d783dd Mon Sep 17 00:00:00 2001 From: Jesse Dohmann Date: Mon, 16 Jan 2023 17:14:59 -0600 Subject: [PATCH] add debugging ignition procedure --- .../troubleshooting-debugging-ignition.adoc | 25 +++++++++++++++++++ ...oubleshooting-operating-system-issues.adoc | 2 ++ 2 files changed, 27 insertions(+) create mode 100644 modules/troubleshooting-debugging-ignition.adoc diff --git a/modules/troubleshooting-debugging-ignition.adoc b/modules/troubleshooting-debugging-ignition.adoc new file mode 100644 index 0000000000..6c2e6b8195 --- /dev/null +++ b/modules/troubleshooting-debugging-ignition.adoc @@ -0,0 +1,25 @@ +// Module included in the following assemblies: +// +// * support/troubleshooting/troubleshooting-operating-system-issues.adoc + +:_content-type: PROCEDURE +[id="debugging-ignition_{context}"] += Debugging Ignition failures + +If a machine cannot be provisioned, Ignition fails and {op-system} will boot into the emergency shell. Use the following procedure to get debugging information. + +.Procedure + +. Run the following command to show which service units failed: ++ +[source,terminal] +---- +$ systemctl --failed +---- + +. Optional: Run the following command on an individual service unit to find out more information: ++ +[source,terminal] +---- +$ journalctl -u .service +---- diff --git a/support/troubleshooting/troubleshooting-operating-system-issues.adoc b/support/troubleshooting/troubleshooting-operating-system-issues.adoc index e2d4ce7bd5..14b3600c1b 100644 --- a/support/troubleshooting/troubleshooting-operating-system-issues.adoc +++ b/support/troubleshooting/troubleshooting-operating-system-issues.adoc @@ -57,3 +57,5 @@ endif::[] * kdump.conf(5) — a manual page for the `/etc/kdump.conf` configuration file containing the full documentation of available options * kexec(8) — a manual page for the `kexec` package * link:https://access.redhat.com/site/solutions/6038[Red Hat Knowledgebase article] regarding kexec and kdump + +include::modules/troubleshooting-debugging-ignition.adoc[leveloffset=+1]