pages: emergency-shell #74
Conversation
Adds documentation to describe how to access the emergency shell with tty0. Resolves (by documentating) coreos/fedora-coreos-tracker#453
|
|
||
| If there is an error while booting Fedora CoreOS and emergency.target is reached a shell prompt will open by default on ttyS0 (i.e. serial console). | ||
|
|
||
| To access the emergency shell when using VGA intercept the GRUB menu and edit the entry to append 'console=tty0' to the kernel argument list, then press Ctrl-X to resume booting. |
There was a problem hiding this comment.
I think that parameter is already on the command-line (both should be there).
If the machine does not have/use a serial console, it should be enough to drop the unwanted console= argument.
Can you confirm that works for you too?
|
@web-refinery thanks for the PR! I've left a comment with a minor doubt I had. In general, we should mention somewhere that this only affects the first-boot provisioning, i.e. when Ignition fails to setup a new machine. |
|
@lucab You were correct, thanks for the feedback! There are several console parameters by default. I had only noticed the serial console one. How's the PR looking now? It is unfortunate that we can only output to all console's but not mirror them so the emergency shell would be on all of them. Oh well. |
|
|
||
| To access the emergency shell when not using a serial console, you should intercept the GRUB menu and edit the entry to drop all 'console' parameters from the kernel line that you don't need, then press Ctrl+X to resume booting. | ||
|
|
||
| For VGA, you would keep 'console=tty0' |
There was a problem hiding this comment.
This is either missing the final dot, or a whole part of a sentence.
I'd probably move this as the second paragraph in the page, explaining that there are two console= parameters by default and what each is for (perhaps as a bullet list).
|
@lucab Thanks again for the feedback. I've made some more modifications, to (hopefully) improve readability. If I understood your feedback correctly, this should cover it. Can you let me know or edit my fork directly? |
|
@web-refinery yes, this looks good. I'll squash and merge. Thanks again! |
|
Woo! My first ever pull request (ever), merged! Thanks! (I was away so I hadn't noticed it yet!) |
Adds documentation to describe how to access the emergency shell with tty0.
Resolves (by documentating) coreos/fedora-coreos-tracker#453