[bf8c11f] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?> |
---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" |
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ |
---|
| 4 | <!ENTITY % general-entities SYSTEM "../../general.ent"> |
---|
| 5 | %general-entities; |
---|
| 6 | ]> |
---|
| 7 | |
---|
| 8 | <sect1 id="ch-bootable-yaboot" arch="ppc"> |
---|
| 9 | <?dbhtml filename="yaboot.html"?> |
---|
| 10 | |
---|
| 11 | <title>Making the LFS System Bootable</title> |
---|
| 12 | |
---|
| 13 | <indexterm zone="ch-bootable-yaboot"> |
---|
| 14 | <primary sortas="a-Yaboot">Yaboot</primary> |
---|
| 15 | <secondary>configuring</secondary></indexterm> |
---|
| 16 | |
---|
[a625f8b] | 17 | <para os="a">Your shiny new LFS system is almost complete. One of the last |
---|
| 18 | things to do is to ensure that the system can be properly booted. The |
---|
[3d23af3] | 19 | instructions below apply only to NewWorld Macintoshes.</para> |
---|
[a625f8b] | 20 | |
---|
| 21 | <para os="b">Boot loading can be a complex area, so a few cautionary words |
---|
| 22 | are in order. Be familiar with the current boot loader and any other |
---|
| 23 | operating systems present on the hard drive(s) that need to be bootable. |
---|
| 24 | Make sure that an emergency CD is ready to <quote>rescue</quote> the |
---|
[3d23af3] | 25 | computer if it becomes un-bootable. It is also a good idea to enable booting |
---|
| 26 | from Open Firmware in case things go really wrong.</para> |
---|
[a625f8b] | 27 | |
---|
| 28 | <para os="c">Earlier, we compiled and installed the yaboot boot loader software |
---|
| 29 | in preparation for this step. The procedure involves writing the bootloader |
---|
[3d23af3] | 30 | to a bootstrap partition and blessing it so that Open Firmware will boot from |
---|
| 31 | it. This is all handled by <command>ybin</command> the yaboot installer.</para> |
---|
[a625f8b] | 32 | |
---|
[983df6f] | 33 | <para os="d">Ybin writes an optional 'OS selector' menu into Open Firmware, |
---|
| 34 | then writes yaboot and yaboot.conf to the bootstrap partition, blesses this, |
---|
| 35 | and updates the boot device recorded in nvram. When booted, the OF provides |
---|
| 36 | the initial menu to choose between linux, boot from CD, and e.g. OSX |
---|
| 37 | (depending on what was in yaboot.conf). If you boot to 'linux', yaboot is |
---|
| 38 | executed and lets you select which kernel to use.</para> |
---|
[a625f8b] | 39 | |
---|
| 40 | <para os="e">Images (kernels) are specified, together with any necessary path, |
---|
| 41 | in yaboot.conf - the details are incorporated into the bootloader, but no attempt |
---|
| 42 | is made to access or validate the paths until they are selected. There are many |
---|
| 43 | possible options that can be specified in yaboot.conf, see the man page for the |
---|
| 44 | details. Most people will be able to specify device=hd: (for a single hard disk), |
---|
| 45 | but if you have multiple disks, or if you wish to be pedantic, you can specify the |
---|
[3d23af3] | 46 | full OF path to the device, obtained by running <command>ofpath /dev/hdX</command> |
---|
| 47 | .</para> |
---|
[a625f8b] | 48 | |
---|
| 49 | <para os="h">Using the above information, determine the appropriate designators |
---|
| 50 | for the bootstrap partition and the root partition. For the following example, |
---|
| 51 | it is assumed that the bootstrap partition is <filename class="partition">hda2 |
---|
| 52 | </filename> and the root partition is <filename class="partition">hda7</filename> |
---|
| 53 | . We will also assume that you wish to be able to boot an OSX installation on |
---|
| 54 | <filename class="partition">hda4</filename>. Change these items as necessary |
---|
| 55 | for your machine.</para> |
---|
| 56 | |
---|
[3d23af3] | 57 | <para os="i">If your machine has a SATA disk, specify the partitions using |
---|
| 58 | <filename class="devicefile">/dev/sda7</filename> and so forth in the usual |
---|
| 59 | way. At least some of the distros specify a full OF path to the 'device' and |
---|
| 60 | to the image(s), such as |
---|
| 61 | <filename class="devicefile">device=/ht@0,f2000000/pci@3/k2-sata-root@c/k2-sata@0/disk@0: |
---|
| 62 | </filename> for the disk, and |
---|
| 63 | <filename class="partition">image=/ht@0,f2000000/pci@3/k2-sata-root@c/k2-sata@0/disk@0:9,/boot/lfskernel-&linux-version; |
---|
| 64 | </filename> which definitely works.</para> |
---|
| 65 | |
---|
[a625f8b] | 66 | <para os="k">Create a <quote>yaboot.conf</quote> file defining yaboot's boot |
---|
| 67 | menu:</para> |
---|
| 68 | |
---|
| 69 | <screen os="l" role="nodump"><userinput>cat > /etc/yaboot.conf << "EOF" |
---|
| 70 | <literal># Begin /etc/yaboot.conf |
---|
| 71 | |
---|
| 72 | # By default, yaboot will boot the first menu entry. |
---|
| 73 | |
---|
| 74 | # Allow 10 seconds before booting the default. |
---|
| 75 | # this will also apply to the first-stage os selector |
---|
[9cc11c3] | 76 | timeout=100 |
---|
[a625f8b] | 77 | |
---|
| 78 | # These variables are global |
---|
| 79 | # first, where to put the bootstrap partition |
---|
| 80 | boot=/dev/hda2 |
---|
| 81 | |
---|
| 82 | # Which disk to use |
---|
| 83 | device=hd: |
---|
| 84 | |
---|
| 85 | # Default partition for the kernel images |
---|
| 86 | partition=7 |
---|
| 87 | |
---|
| 88 | # default root partition |
---|
| 89 | root=/dev/hda7 |
---|
| 90 | |
---|
| 91 | # where ybin is to find yaboot and ofboot |
---|
| 92 | install=/usr/lib/yaboot/yaboot |
---|
| 93 | magicboot=/usr/lib/yaboot/ofboot |
---|
| 94 | |
---|
| 95 | # allow the initial menu to offer CD as an option |
---|
| 96 | enablecdboot |
---|
| 97 | |
---|
[3d23af3] | 98 | # allow the initial menu to offer booting from Open Firmware |
---|
| 99 | enableofboot |
---|
| 100 | |
---|
[a625f8b] | 101 | # allow the initial menu to boot from mac osx |
---|
| 102 | macosx=/dev/hda4 |
---|
| 103 | |
---|
[3d23af3] | 104 | # white on black is boring! |
---|
| 105 | # note the spellings : 'fgcolor' but 'light' |
---|
| 106 | # in this context, light means 'without high intensity' |
---|
| 107 | fgcolor=light-green |
---|
| 108 | |
---|
[a625f8b] | 109 | # The first entry is for LFS. |
---|
| 110 | # For all images, the pathname is relative to the filesystem |
---|
[3d23af3] | 111 | # on which they are situated and can include at most one |
---|
| 112 | # directory |
---|
[930f404] | 113 | image=/boot/lfskernel-&linux-version; |
---|
[a625f8b] | 114 | label=&version; |
---|
| 115 | read-only</literal> |
---|
| 116 | EOF</userinput></screen> |
---|
| 117 | |
---|
| 118 | |
---|
| 119 | <para os="n">Add an entry for the host distribution, if you have one. It might |
---|
| 120 | look something like this if the kernel and initrd are in the host's '/' |
---|
| 121 | directory on <filename class="partition">hda6</filename>:</para> |
---|
| 122 | |
---|
| 123 | <screen os="o" role="nodump"><userinput>cat >> /etc/yaboot.conf << "EOF" |
---|
| 124 | <literal>title Debian |
---|
| 125 | image=/pci@f4000000/ata-6d/disk@0:6,/vmlinux |
---|
| 126 | label=Debian |
---|
| 127 | initrd=/pci@f4000000/ata-6d/disk@0:6,/initrd.gz |
---|
| 128 | initrd-size=10000 |
---|
| 129 | append="root=/dev/hda7" |
---|
| 130 | read-only</literal> |
---|
| 131 | EOF</userinput></screen> |
---|
| 132 | |
---|
| 133 | <warning os="r"> |
---|
[983df6f] | 134 | <para>The following command will update the bootstrap partition and the |
---|
| 135 | boot variable in Open Firmware. Do not run the command if this is not |
---|
| 136 | desired.</para> |
---|
[a625f8b] | 137 | </warning> |
---|
| 138 | |
---|
| 139 | <screen os="s" role="nodump"><userinput>ybin</userinput></screen> |
---|
[bf8c11f] | 140 | |
---|
[6d5bc698] | 141 | <para os="t">Alternatively, if the bootstrap partition has not already been |
---|
| 142 | initialized, perhaps because you are using a Live CD, you will need to use |
---|
| 143 | a different command to install the bootloader for the first time:</para> |
---|
| 144 | |
---|
| 145 | <screen os="u" role="nodump"><userinput>mkofboot</userinput></screen> |
---|
| 146 | |
---|
[bf8c11f] | 147 | </sect1> |
---|