commit 47bc8d84b5fecbcd9639f2c40332db73652cbc9a
Author: Stephen Wadeley <swadeley(a)redhat.com>
Date: Fri Aug 14 14:26:04 2015 +0200
Improve: GRUB 2 over a Serial Console
en-US/Working_with_the_GRUB_2_Boot_Loader.xml | 21 ++++++++++++++++-----
1 files changed, 16 insertions(+), 5 deletions(-)
---
diff --git a/en-US/Working_with_the_GRUB_2_Boot_Loader.xml
b/en-US/Working_with_the_GRUB_2_Boot_Loader.xml
index 81f951b..2665706 100644
--- a/en-US/Working_with_the_GRUB_2_Boot_Loader.xml
+++ b/en-US/Working_with_the_GRUB_2_Boot_Loader.xml
@@ -738,15 +738,26 @@ password_pbkdf2 john
grub.pbkdf2.sha512.10000.19074739ED80F115963D984BDCB35AA671
</section>
</section>
- <section id="sec-GRUB_2_over_Serial_Console">
- <title>GRUB 2 over Serial Console</title>
+ <section id="sec-GRUB_2_over_a_Serial_Console">
+ <title>GRUB 2 over a Serial Console</title>
<para>
If you use computers with no display or keyboard, it can be very useful to control the
machines through serial communications.
</para>
- <section id="sec-Configuring_GRUB_2">
- <title>Configuring GRUB 2</title>
+ <section id="sec-Configuring_the_GRUB_2_Menu">
+ <title>Configuring the GRUB 2 Menu</title>
+
+ <para>
+ To set the system to use a serial terminal only during a single boot process, when
the GRUB 2 boot menu appears, move the cursor to the kernel you want to start, and press
the <keycap>e</keycap> key to edit the kernel parameters. Remove the
<literal>rhgb</literal> and <literal>quit</literal> parameters and
add console parameters at the end of the <literal>linux16</literal> line as
follows:
+ </para>
+<screen>linux16 /vmlinuz-3.10.0-0.rc4.59.el7.x86_64 root=/dev/mapper/rhel-root
ro rd.md=0 rd.dm=0 rd.lvm.lv=rhel/swap crashkernel=auto rd.luks=0 vconsole.keymap=us
rd.lvm.lv=rhel/root <emphasis
role="bold">console=ttyS0,115200</emphasis></screen>
+ <para>
+ These settings are not persistent and apply only for a single boot.</para>
+ <para>
+ To make persistent changes to a menu entry on a system, use the
<command>grubby</command> tool. For example, to update the entry for the
default kernel, enter a command as follows:
+<screen>~]# <command>grubby --remove-args="rhgb quiet"
--args=console=ttyS0,115200 --update-kernel=DEFAULT</command></screen>
+The <option>--update-kernel</option> parameter also accepts the keyword
<literal>ALL</literal> or a comma separated list of kernel index numbers. See
<xref linkend="bh-Adding_and_Removing_Arguments_from_a_GRUB_Menu_Entry" />
for more information on using <command>grubby</command>.</para>
<para>
- In order to use GRUB 2 over a serial line, add the following two lines in the
<filename>/etc/default/grub</filename> file:
+ If required to build a new GRUB 2 configuration file, add the following two lines in
the <filename>/etc/default/grub</filename> file:
</para>
<programlisting>
GRUB_TERMINAL="serial"
Show replies by date