pages: emergency-shell (coreos#74)

* Create emergency-shell.adoc Adds documentation to describe how to access the emergency shell with tty0. Resolves (by documentating) coreos/fedora-coreos-tracker#453 Co-authored-by: Xander <xander@web-refinery.com>
jbtrystram · May 21, 2020 · 448738b · 448738b
1 parent 52fb83b
commit 448738b
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 0 deletions.
diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
@@ -22,5 +22,6 @@
 ** Troubleshooting
 *** xref:manual-rollbacks.adoc[Manual Rollbacks]
 *** xref:access-recovery.adoc[Access Recovery]
+*** xref:emergency-shell.adoc[Emergency Shell Access]
 * Reference pages
  ** xref:platforms.adoc[Platforms]
diff --git a/modules/ROOT/pages/emergency-shell.adoc b/modules/ROOT/pages/emergency-shell.adoc
@@ -0,0 +1,14 @@
+= Access the emergency shell
+
+
+Sometimes you may want to access the emergency shell. For instance, to debug first boot provisioning errors.
+
+To access the emergency shell intercept the GRUB menu, edit the entry and drop all `console` parameters from the kernel line except for the one you need and press Ctrl+X to resume booting.
+
+[NOTE]
+====
+By default these console parameters are provided:
+
+ - `console=ttyS0,115200n8` for serial consoles.
+ - `console=tty0` for VGA.
+====