commit 47bc8d84b5fecbcd9639f2c40332db73652cbc9a Author: Stephen Wadeley swadeley@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"