grub.xml 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  3. "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  4. <!ENTITY % general-entities SYSTEM "../general.ent">
  5. %general-entities;
  6. ]>
  7. <sect1 id="ch-bootable-grub" role="wrap">
  8. <?dbhtml filename="grub.html"?>
  9. <sect1info condition="script">
  10. <productname>grub</productname>
  11. <productnumber>&grub-version;</productnumber>
  12. <address>&grub-url;</address>
  13. </sect1info>
  14. <title>Using GRUB to Set Up the Boot Process</title>
  15. <sect2>
  16. <title>Introduction</title>
  17. <para>Boot loading can be a complex area, so a few cautionary
  18. words are in order. Be familiar with the current boot loader and any other
  19. operating systems present on the hard drive(s) that need to be
  20. bootable. Make sure that an emergency boot disk is ready to
  21. <quote>rescue</quote> the computer if the computer becomes
  22. unusable (un-bootable).</para>
  23. <para>The procedure involves writing some special GRUB files to specific
  24. locations on the hard drive. We highly recommend creating a GRUB boot
  25. floppy diskette as a backup. Insert a blank floppy diskette and run the
  26. following commands:</para>
  27. <screen role="nodump"><userinput>cd /tmp
  28. grub-mkrescue --image-type=floppy floppy.img
  29. dd if=floppy.img of=/dev/fd0 bs=1440 count=1</userinput></screen>
  30. <para>GRUB uses its own naming structure for drives and partitions in
  31. the form of <emphasis>(hdn,m)</emphasis>, where <emphasis>n</emphasis>
  32. is the hard drive number and <emphasis>m</emphasis> is the partition
  33. number. The hard drive number starts from zero, but he partition number
  34. starts from one for normal partitions and five for extended partitions.
  35. Note that this is different form earlier versions where
  36. both numbers started from zero. For example, partition <filename
  37. class="partition">sda1</filename> is <emphasis>(hd0,1)</emphasis> to
  38. GRUB and <filename class="partition">sdb3</filename> is
  39. <emphasis>(hd1,3)</emphasis>. In contrast to Linux, GRUB does not
  40. consider CD-ROM drives to be hard drives. For example, if using a CD
  41. on <filename class="partition">hdb</filename> and a second hard drive
  42. on <filename class="partition">hdc</filename>, that second hard drive
  43. would still be <emphasis>(hd1)</emphasis>.</para>
  44. <para>You can determine what GRUB thinks your disk devices are by running:</para>
  45. <screen role="nodump"><userinput>grub-mkdevicemap --device-map=device.map
  46. cat device.map</userinput></screen>
  47. <para>The location of the boot partition is a choice of the user that
  48. affects the configuration. One recommendation is to have a separate small
  49. (suggested size is 100 MB) partition just for boot information. That way
  50. each build, whether LFS or some commercial distro, can access the same boot
  51. files and access can be made from any booted system. If you choose to do
  52. this, you will need to mount the separate partition, move all files in the
  53. current <filename class="directory">/boot</filename> directory (e.g. the
  54. linux kernel you just built in the previous section) to the new partition.
  55. You will then need to unmount the partition and remount it as <filename
  56. class="directory">/boot</filename>. If you do this, be sure to update
  57. <filename>/etc/fstab</filename>.</para>
  58. <para>Using the current lfs partition will also work, but configuration
  59. for multiple systems is more difficult.</para>
  60. </sect2>
  61. <sect2>
  62. <title>Setting Up the Configuration</title>
  63. <para>Using the above information, determine the appropriate
  64. designator for the root partition (or boot partition, if a separate
  65. one is used). For the following example, it is assumed that the root
  66. (or separate boot) partition is <filename
  67. class="partition">sda2</filename>.</para>
  68. <para>Install the GRUB files into <filename
  69. class="directory">/boot/grub</filename>:</para>
  70. <screen role="nodump"><userinput>grub-install --grub-setup=/bin/true /dev/sda</userinput></screen>
  71. <para>We use --grub-setup=/bin/true for now to prevent updating
  72. Master Boot Record (MBR). In this way, we can test our installation
  73. before committing to a change that is hard to revert.</para>
  74. <para>Generate <filename>/boot/grub/grub.cfg</filename>:</para>
  75. <screen role="nodump"><userinput>grub-mkconfig -o /boot/grub/grub.cfg</userinput></screen>
  76. <para>Here <command>grub-mkconfig</command> uses the files in <filename
  77. class="directory">/etc/grub.d/</filename> to determine the contents
  78. of this file. The configuration file will look something like:</para>
  79. <screen><computeroutput>#
  80. # DO NOT EDIT THIS FILE
  81. #
  82. # It is automatically generated by /usr/sbin/grub-mkconfig using templates
  83. # from /etc/grub.d and settings from /etc/default/grub
  84. #
  85. ### BEGIN /etc/grub.d/00_header ###
  86. set default=0
  87. set timeout=5
  88. ### END /etc/grub.d/00_header ###
  89. ### BEGIN /etc/grub.d/10_linux ###
  90. menuentry "GNU/Linux, Linux 2.6.30.2-lfs65" {
  91. insmod ext2
  92. set root=(hd0,2)
  93. search --no-floppy --fs-uuid --set 915852a7-859e-45a6-9ff0-d3ebfdb5cea2
  94. linux /boot/vmlinux-&linux-version;-lfs-&version; root=/dev/sda2 ro
  95. }
  96. menuentry "GNU/Linux, Linux 2.6.30.2-lfs65 (recovery mode)" {
  97. insmod ext2
  98. set root=(hd0,2)
  99. search --no-floppy --fs-uuid --set 915852a7-859e-45a6-9ff0-d3ebfdb5cea2
  100. linux /boot/vmlinux-&linux-version;-lfs-&version; root=/dev/sda2 ro single
  101. }
  102. menuentry "GNU/Linux, Linux 2.6.28-11-server" {
  103. insmod ext2
  104. set root=(hd0,2)
  105. search --no-floppy --fs-uuid --set 6b4c0339-5501-4a85-8351-e398e5252be8
  106. linux /boot/vmlinuz-2.6.28-11-server root=UUID=6b4c0339-5501-4a85-8351-e398e5252be8 ro
  107. initrd /boot/initrd.img-2.6.28-11-server
  108. }
  109. menuentry "GNU/Linux, Linux 2.6.28-11-server (recovery mode)" {
  110. insmod ext2
  111. set root=(hd0,2)
  112. search --no-floppy --fs-uuid --set 6b4c0339-5501-4a85-8351-e398e5252be8
  113. linux /boot/vmlinuz-2.6.28-11-server root=UUID=6b4c0339-5501-4a85-8351-e398e5252be8 ro single
  114. initrd /boot/initrd.img-2.6.28-11-server
  115. }
  116. ### END /etc/grub.d/10_linux ###
  117. ### BEGIN /etc/grub.d/30_os-prober ###
  118. ### END /etc/grub.d/30_os-prober ###
  119. ### BEGIN /etc/grub.d/40_custom ###
  120. # This file provides an easy way to add custom menu entries. Simply type the
  121. # menu entries you want to add after this comment. Be careful not to change
  122. # the 'exec tail' line above.
  123. ### END /etc/grub.d/40_custom ###
  124. </computeroutput></screen>
  125. <para>Note that even though there is a warning not to edit the file, you can
  126. do so as long as you do not re-run <command>grub-mkconfig</command>. The
  127. <emphasis>search</emphasis> lines are not meaningful for LFS systems as that
  128. command needs an initrd image for processing. If installing on a separate
  129. partition the linux and initrd lines will not have the /boot on the file
  130. names. In this example the kernel files for a Ubuntu installation are
  131. also found in <filename class="directory">/boot</filename>.</para>
  132. </sect2>
  133. <sect2>
  134. <title>Testing the Configuration</title>
  135. <para>The core image of GRUB is also a Multiboot kernel, so if you already
  136. have GRUB Legacy loaded you can load GRUB-&grub-version; through your old
  137. boot loader. To accomplish this, you will need to exit the
  138. <command>chroot</command> environment and re-enter it to finish the
  139. few remaining portions of the book.</para>
  140. <screen role="nodump"><userinput>/sbin/reboot
  141. ...
  142. grub> root (hd0,1)
  143. grub> kernel /boot/grub/core.img
  144. grub> boot</userinput></screen>
  145. <para>Note that the GRUB commands above are assumed to be GRUB Legacy.
  146. At this point the GRUB prompt will appear (very similar to GRUB Legacy) and
  147. you can explore the interface or boot to one of the systems in the grub.cfg
  148. file.</para>
  149. </sect2>
  150. <sect2>
  151. <title>Updating the Master Boot Record</title>
  152. <para>If you tested the GRUB configuration as specified above, re-enter
  153. the <command>chroot</command> environment.</para>
  154. <warning>
  155. <para>The following command will overwrite the current boot loader. Do not
  156. run the command if this is not desired, for example, if using a third party
  157. boot manager to manage the Master Boot Record (MBR).</para>
  158. </warning>
  159. <para>Update the MBR with:</para>
  160. <screen role="nodump"><userinput>grub-setup '&lt;DEVICE&gt;'</userinput></screen>
  161. <para>Change the DEVICE above to your boot disk, normally '(hd0)' or /dev/sda.
  162. If using (hd0) be sure to escape the parentheses with backslashes or single
  163. quotes to prevent the shell from interpreting them as a sub-shell.</para>
  164. <para>This program uses the following defaults and are correct if you did not
  165. deviate from the instructions above:</para>
  166. <itemizedlist>
  167. <listitem><para>boot image - boot.img </para></listitem>
  168. <listitem><para>core image - core.img </para></listitem>
  169. <listitem><para>directory - /boot/grub</para></listitem>
  170. <listitem><para>device map - device.map</para></listitem>
  171. <listitem><para>default root setting - guessed</para></listitem>
  172. </itemizedlist>
  173. <note><para>The root setting is the default value if a 'set root'
  174. instruction is not found in grub.cfg. This is the partition that is
  175. searched for the kernel and other supporting files. It is different from
  176. the 'root=' parameter on the 'linux' line in the configuration line. The
  177. latter is the partition the kernel mounts as '/'. In the example grub.cfg
  178. above, both values point to /dev/sda2, but if there is a separate boot
  179. partition, they will be different.</para></note>
  180. </sect2>
  181. </sect1>