/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.14 Revision 1.15
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 5<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml,v 1.14 2004/11/09 13:01:52 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml,v 1.15 2004/11/15 12:47:47 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.13</version> 11<version>1.13</version>
12<date>October 23, 2004</date> 12<date>October 23, 2004</date>
24program is called a <e>bootloader</e>. But before you start, consider 24program is called a <e>bootloader</e>. But before you start, consider
25your options... 25your options...
26</p> 26</p>
27 27
28<p> 28<p>
29Several bootloaders exist for Linux/PPC. We have <uri link="#yaboot">yaBoot</uri> 29Several bootloaders exist for Linux/PPC. We have <uri link="#yaboot">Yaboot</uri>
30(for NewWorld Apple and IBM machines) and <uri link="#bootx">BootX</uri> (for 30(for NewWorld Apple and IBM machines) and <uri link="#bootx">BootX</uri> (for
31OldWorld Apple and IBM machines). The Pegasos does not require a bootloader. 31OldWorld Apple and IBM machines). The Pegasos does not require a bootloader.
32You cannot use yaBoot or BootX on them at this time. Pegasos users should 32You cannot use Yaboot or BootX on them at this time. Pegasos users should
33therefore continue with <uri link="#reboot">Rebooting the System</uri>. 33therefore continue with <uri link="#reboot">Rebooting the System</uri>.
34</p> 34</p>
35 35
36</body> 36</body>
37</subsection> 37</subsection>
38</section> 38</section>
39<section id="yaboot"> 39<section id="yaboot">
40<title>Default: Using yaBoot</title> 40<title>Default: Using Yaboot</title>
41<subsection> 41<subsection>
42<title>Introduction</title> 42<title>Introduction</title>
43<body> 43<body>
44 44
45<impo> 45<impo>
46yaBoot can only be used on NewWorld Apple and IBM systems! 46Yaboot can only be used on NewWorld Apple and IBM systems!
47</impo> 47</impo>
48 48
49<p> 49<p>
50There are two ways to configure yaBoot for your system. You can use the 50There are two ways to configure Yaboot for your system. You can use the
51included <c>yabootconfig</c> to automatically set up yaboot. If 51included <c>yabootconfig</c> to automatically set up Yaboot. If
52for some reason you do not want to run <c>yabootconfig</c> to 52for some reason you do not want to run <c>yabootconfig</c> to
53automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo 53automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo
54on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit 54on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit
55the sample file already installed on your system. 55the sample file already installed on your system.
56</p> 56</p>
57 57
58<ul> 58<ul>
59 <li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li> 59 <li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li>
60 <li> 60 <li>
61 <uri link="#manual_yaboot">Alternative: Manual yaBoot Configuration</uri> 61 <uri link="#manual_yaboot">Alternative: Manual Yaboot Configuration</uri>
62 </li> 62 </li>
63</ul> 63</ul>
64 64
65</body> 65</body>
66</subsection> 66</subsection>
75 75
76<p> 76<p>
77To use <c>yabootconfig</c>, your drive must have a bootstrap partition, and 77To use <c>yabootconfig</c>, your drive must have a bootstrap partition, and
78<path>/etc/fstab</path> must be configured with your Linux partitions. Both of 78<path>/etc/fstab</path> must be configured with your Linux partitions. Both of
79these should have been done already in the steps above. To start, ensure that 79these should have been done already in the steps above. To start, ensure that
80you have the latest version of yaboot installed by running <c>emerge --update 80you have the latest <c>yaboot</c> installed.
81yaboot</c>. This is necessary as the latest version will be available via
82Portage, but it may not have made it into the stage files.
83</p> 81</p>
84 82
85<pre caption = "Installing yaboot"> 83<pre caption = "Installing yaboot with GRP">
86# <i>emerge --usepkg --update yaboot</i> 84# <i>emerge --usepkg --update yaboot</i>
87</pre> 85</pre>
88 86
89<p> 87<p>
90Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. The program will run and it will confirm 88Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. The
91the location of the bootstrap partition. Type <c>Y</c> if it is correct. If 89program will run and it will confirm the location of the bootstrap partition.
92not, double check <path>/etc/fstab</path>. yabootconfig will then scan your 90Type <c>Y</c> if it is correct. If not, double check <path>/etc/fstab</path>.
93system setup, create <path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for 91yabootconfig will then scan your system setup, create
94you. <c>mkofboot</c> is used to format the bootstrap partition, and install 92<path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. <c>mkofboot</c>
95the yaboot configuration file into it. 93is used to format the bootstrap partition, and install the Yaboot configuration
96After this enter the chroot again. 94file into it. After this enter the chroot again.
97</p> 95</p>
98<pre caption="enter chroot"> 96<pre caption="enter chroot">
99# <i>chroot /mnt/gentoo /bin/bash</i> 97# <i>chroot /mnt/gentoo /bin/bash</i>
100# <i>/usr/sbin/env-update &amp;&amp; source /etc/profile</i> 98# <i>/usr/sbin/env-update &amp;&amp; source /etc/profile</i>
101</pre> 99</pre>
102 100
103<p> 101<p>
104You might want to verify the contents of <path>/etc/yaboot.conf</path>. If 102You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you
105you make changes to <path>/etc/yaboot.conf</path> (like setting the 103make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot
106default/boot OS), make sure to rerun <c>ybin -v</c> to apply changes to the 104OS), make sure to rerun <c>ybin -v</c> to apply changes to the bootstrap
107bootstrap partition. 105partition.
108</p> 106</p>
109 107
110<p> 108<p>
111Now continue with <uri link="#reboot">Rebooting the System</uri>. 109Now continue with <uri link="#reboot">Rebooting the System</uri>.
112</p> 110</p>
113 111
114</body> 112</body>
115</subsection> 113</subsection>
116<subsection id="manual_yaboot"> 114<subsection id="manual_yaboot">
117<title>Alternative: Manual yaBoot Configuration</title> 115<title>Alternative: Manual Yaboot Configuration</title>
118<body> 116<body>
119 117
120<p> 118<p>
121First make sure you have the latest <c>yaboot</c> installed on your 119First make sure you have the latest <c>yaboot</c> installed on your
122system: 120system:
167 165
168<comment>################# 166<comment>#################
169## This section can be duplicated if you have more than one kernel or set of 167## This section can be duplicated if you have more than one kernel or set of
170## boot options - replace 2.6.7 with your kernel-version 168## boot options - replace 2.6.7 with your kernel-version
171#################</comment> 169#################</comment>
172image=/boot/kernel-2.6.7 170image=/boot/kernel-2.6.9
173 label=Linux 171 label=Linux
174 root=/dev/hda3 172 root=/dev/hda3
175 sysmap=/boot/System.map-2.6.7 173 sysmap=/boot/System.map-2.6.9
176 read-only 174 read-only
177<comment>##################</comment> 175<comment>##################</comment>
178 176
179<comment>## G5 users should set 177<comment>## G5 users should set
180## macos=hd:13 178## macos=hd:13
185enablecdboot 183enablecdboot
186enableofboot 184enableofboot
187</pre> 185</pre>
188 186
189<p> 187<p>
190Once <path>yaboot.conf</path> is set up the way you want it, you run 188Once <path>yaboot.conf</path> is set up the way you want it, you run
191<c>mkofboot -v</c> to install the settings in the bootstrap partition. <e>Don't 189<c>mkofboot -v</c> to install the settings in the bootstrap partition. <e>Don't
192forget this!</e> If all goes well, and you have the same options as the sample 190forget this!</e> If all goes well, and you have the same options as the sample
193above, your next reboot will give you a simple, five-entry boot menu. If you 191above, your next reboot will give you a simple, five-entry boot menu. If you
194update your yaboot config later on, you'll just need to run <c>ybin -v</c> to 192update your yaboot config later on, you'll just need to run <c>ybin -v</c> to
195update the bootstrap partition - <c>mkofboot</c> is for initial setup only. 193update the bootstrap partition - <c>mkofboot</c> is for initial setup only.
196</p> 194</p>
197 195
198<p> 196<p>
199For more information on yaboot, take a look at the <uri 197For more information on Yaboot, take a look at the <uri
200link="http://penguinppc.org/projects/yaboot">yaboot project</uri>. For 198link="http://penguinppc.org/bootloaders/yaboot">yaboot project</uri>. For
201now, continue the installation with <uri link="#reboot">Rebooting the 199now, continue the installation with <uri link="#reboot">Rebooting the
202System</uri>. 200System</uri>.
203</p> 201</p>
204 202
205</body> 203</body>
229cdimage ~# <i>reboot</i> 227cdimage ~# <i>reboot</i>
230</pre> 228</pre>
231 229
232<p> 230<p>
233Of course, don't forget to remove the bootable CD, otherwise the CD will be 231Of course, don't forget to remove the bootable CD, otherwise the CD will be
234booted again instead of Mac OS X. 232booted again instead of MacOS.
235</p> 233</p>
236 234
237<p> 235<p>
238Now your machine is booted in MacOS, open the BootX control panel. Select 236Now your machine is booted in MacOS, open the BootX control panel. Select
239<c>Options</c> and uncheck <c>Used specified RAM disk</c>. When you return to 237<c>Options</c> and uncheck <c>Used specified RAM disk</c>. When you return to
240the BootX main screen, you will now find an option to specify your machine's 238the BootX main screen, you will now find an option to specify your machine's
241root disk and partition. Fill these in with the appropriate values. 239root disk and partition. Fill these in with the appropriate values.
242</p> 240</p>
243 241
244<p> 242<p>
245BootX can be configured to start Linux upon boot. If you do this, you will first 243BootX can be configured to start Linux upon boot. If you do this, you will first
246see your machine boot into MacOS then, during startup, BootX will load and start 244see your machine boot into MacOS then, during startup, BootX will load and start
247Linux. See the <uri link="http://penguinppc.org/projects/bootx/">BootX home 245Linux. See the <uri link="http://penguinppc.org/bootloaders/bootx/">BootX home
248page</uri> for more information. 246page</uri> for more information.
249</p> 247</p>
250 248
251<p> 249<p>
252Now reboot again and boot into Linux, then continue with <uri 250Now reboot again and boot into Linux, then continue with <uri
253link="?part=1&amp;chap=11">Finalizing your Gentoo Installation</uri>. 251link="?part=1&amp;chap=11">Finalizing your Gentoo Installation</uri>.
254</p> 252</p>
255 253
256</body> 254</body>
257</section> 255</section>
259<title>Rebooting the System</title> 257<title>Rebooting the System</title>
260<subsection> 258<subsection>
261<body> 259<body>
262 260
263<p> 261<p>
264Exit the chrooted environment and unmount all mounted partitions. Then type in 262Exit the chrooted environment and unmount all mounted partitions. Then type in
265that one magical command you have been waiting for: <c>reboot</c>. 263that one magical command you have been waiting for: <c>reboot</c>.
266</p> 264</p>
267 265
268<pre caption="Exiting the chroot, unmounting all partitions and rebooting"> 266<pre caption="Exiting the chroot, unmounting all partitions and rebooting">
269# <i>exit</i> 267# <i>exit</i>
270cdimage ~# <i>umount /mnt/gentoo/boot /mnt/gentoo/proc /mnt/gentoo</i> 268cdimage ~# <i>umount /mnt/gentoo/proc /mnt/gentoo</i>
271cdimage ~# <i>reboot</i> 269cdimage ~# <i>reboot</i>
272</pre> 270</pre>
273 271
274<p> 272<p>
275Of course, don't forget to remove the bootable CD, otherwise the CD will be 273Of course, don't forget to remove the bootable CD, otherwise the CD will be

Legend:
Removed from v.1.14  
changed lines
  Added in v.1.15

  ViewVC Help
Powered by ViewVC 1.1.20