/[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.20 Revision 1.21
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.20 2005/01/04 18:11:20 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-bootloader.xml,v 1.21 2005/03/28 11:30:52 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.16</version> 11<version>2.00</version>
12<date>2004-12-22</date> 12<date>2005-03-28</date>
13 13
14<section> 14<section>
15<title>Making your Choice</title> 15<title>Making your Choice</title>
16<subsection> 16<subsection>
17<title>Introduction</title> 17<title>Introduction</title>
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, but
32You cannot use Yaboot or BootX on them at this time. Pegasos users should 32we included the <uri link="#bootcreator">BootCreator</uri> for creating a
33therefore continue with <uri link="#reboot">Rebooting the System</uri>. 33SmartFirmware bootmenu.
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
50<p> 49<p>
51First we have to create the <path>/dev</path> files in our new home, which is 50First we have to create the <path>/dev</path> files in our new home, which is
52needed during the bootloader installation. This could be done by "bind"-mapping 51needed during the bootloader installation. This could be done by "bind"-mapping
53the <path>/dev</path>-filesystem from the LiveCD: 52the <path>/dev</path>-filesystem from the Installation CD:
54</p> 53</p>
55 54
56<pre caption="Bind-mounting the /dev-filesystem"> 55<pre caption="Bind-mounting the /dev-filesystem">
57# <i>exit </i> # this will exit the chroot 56# <i>exit </i> # this will exit the chroot
58# <i>mount -o bind /dev /mnt/gentoo/dev</i> 57# <i>mount -o bind /dev /mnt/gentoo/dev</i>
59# <i>chroot /mnt/gentoo /bin/bash</i> 58# <i>chroot /mnt/gentoo /bin/bash</i>
60# <i>/usr/sbin/env-update &amp;&amp; source /etc/profile </i> 59# <i>/usr/sbin/env-update &amp;&amp; source /etc/profile </i>
61</pre> 60</pre>
62 61
63<p> 62<p>
64There are two ways to configure Yaboot for your system. You can use the 63There are two ways to configure yaboot for your system. You can use the
65included <c>yabootconfig</c> to automatically set up Yaboot. If 64included <c>yabootconfig</c> to automatically set up yaboot. If
66for some reason you do not want to run <c>yabootconfig</c> to 65for some reason you do not want to run <c>yabootconfig</c> to
67automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo 66automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo
68on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit 67on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit
69the sample file already installed on your system. 68the sample file already installed on your system.
70</p> 69</p>
71 70
72<ul> 71<ul>
73 <li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li> 72 <li><uri link="#yabootconfig">Default: Using yabootconfig</uri></li>
74 <li> 73 <li>
75 <uri link="#manual_yaboot">Alternative: Manual Yaboot Configuration</uri> 74 <uri link="#manual_yaboot">Alternative: Manual yaboot Configuration</uri>
76 </li> 75 </li>
77</ul> 76</ul>
78 77
79</body> 78</body>
80</subsection> 79</subsection>
86<c>yabootconfig</c> will auto-detect the partitions on your machine and will 85<c>yabootconfig</c> will auto-detect the partitions on your machine and will
87set up dual and triple boot combinations with Linux, Mac OS, and Mac OS X. 86set up dual and triple boot combinations with Linux, Mac OS, and Mac OS X.
88</p> 87</p>
89 88
90<p> 89<p>
91To use <c>yabootconfig</c>, your drive must have a bootstrap partition, and 90To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition,
92<path>/etc/fstab</path> must be configured with your Linux partitions. Both of 91and <path>/etc/fstab</path> must be configured with your Linux partitions. Both
93these should have been done already in the steps above. To start, ensure that 92of these should have been done already in the steps above. To start, ensure that
94you have the latest <c>yaboot</c> installed. 93you have the latest <c>yaboot</c> installed.
95</p> 94</p>
96 95
97<pre caption = "Installing yaboot with GRP"> 96<pre caption = "Installing yaboot with GRP">
98# <i>emerge --usepkg --update yaboot</i> 97# <i>emerge --usepkg --update yaboot</i>
102Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. The 101Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. The
103program will run and it will confirm the location of the bootstrap partition. 102program will run and it will confirm the location of the bootstrap partition.
104Type <c>Y</c> if it is correct. If not, double check <path>/etc/fstab</path>. 103Type <c>Y</c> if it is correct. If not, double check <path>/etc/fstab</path>.
105yabootconfig will then scan your system setup, create 104yabootconfig will then scan your system setup, create
106<path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. <c>mkofboot</c> 105<path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. <c>mkofboot</c>
107is used to format the bootstrap partition, and install the Yaboot configuration 106is used to format the Apple_Bootstrap partition, and install the yaboot
108file into it. After this enter the chroot again. 107configuration file into it. After this enter the chroot again.
109</p> 108</p>
110<pre caption="enter chroot"> 109<pre caption="enter chroot">
111# <i>chroot /mnt/gentoo /bin/bash</i> 110# <i>chroot /mnt/gentoo /bin/bash</i>
112# <i>/usr/sbin/env-update &amp;&amp; source /etc/profile</i> 111# <i>/usr/sbin/env-update &amp;&amp; source /etc/profile</i>
113</pre> 112</pre>
114 113
115<p> 114<p>
116You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you 115You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you
117make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot 116make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot
118OS), make sure to rerun <c>ybin -v</c> to apply changes to the bootstrap 117OS), make sure to rerun <c>ybin -v</c> to apply changes to the Apple_Bootstrap
119partition. 118partition.
120</p> 119</p>
121 120
122<p> 121<p>
123Now continue with <uri link="#reboot">Rebooting the System</uri>. 122Now continue with <uri link="#reboot">Rebooting the System</uri>.
124</p> 123</p>
125 124
126</body> 125</body>
127</subsection> 126</subsection>
128<subsection id="manual_yaboot"> 127<subsection id="manual_yaboot">
129<title>Alternative: Manual Yaboot Configuration</title> 128<title>Alternative: Manual yaboot Configuration</title>
130<body> 129<body>
131 130
132<p> 131<p>
133First make sure you have the latest <c>yaboot</c> installed on your 132First make sure you have the latest <c>yaboot</c> installed on your
134system: 133system:
211update your yaboot config later on, you'll just need to run <c>ybin -v</c> to 210update your yaboot config later on, you'll just need to run <c>ybin -v</c> to
212update the bootstrap partition - <c>mkofboot</c> is for initial setup only. 211update the bootstrap partition - <c>mkofboot</c> is for initial setup only.
213</p> 212</p>
214 213
215<p> 214<p>
216For more information on Yaboot, take a look at the <uri 215For more information on yaboot, take a look at the <uri
217link="http://penguinppc.org/bootloaders/yaboot">yaboot project</uri>. For 216link="http://penguinppc.org/bootloaders/yaboot">yaboot project</uri>. For
218now, continue the installation with <uri link="#reboot">Rebooting the 217now, continue the installation with <uri link="#reboot">Rebooting the
219System</uri>. 218System</uri>.
220</p> 219</p>
221 220
270link="?part=1&amp;chap=11">Finalizing your Gentoo Installation</uri>. 269link="?part=1&amp;chap=11">Finalizing your Gentoo Installation</uri>.
271</p> 270</p>
272 271
273</body> 272</body>
274</section> 273</section>
274<section id="bootcreator">
275<title>Alternative: BootCreator</title>
276<body>
277
278<impo>
279BootCreator will build a nice SmartFirmware bootmenu written in Forth for the
280Pegasos.
281</impo>
282
283<p>
284First make sure you have the latest <c>bootcreator</c> installed on your
285system:
286</p>
287
288<pre caption = "Installing bootcreator">
289# <i>emerge --usepkg --update bootcreator</i>
290</pre>
291
292<p>
293Now copy the file <path>/etc/bootmenu.example</path> into
294<path>/etc/bootmenu</path> and edit it to your needs:
295</p>
296
297<pre caption = "Edit the bootcreator config file">
298# <i>cp /etc/bootmenu.example /etc/bootmenu</i>
299# <i>nano -w /etc/bootmenu</i>
300</pre>
301
302<p>
303Below you find a completed <path>/etc/bootmenu</path> config file. Alter it at
304will.
305</p>
306
307<pre caption = "bootcreator config file">
308<comment>#
309# Example description file for bootcreator 1.1
310#</comment>
311
312[VERSION]
3131
314
315[TITLE]
316Boot Menu
317
318[SETTINGS]
319AbortOnKey = false
320Timeout = 9
321Default = 1
322
323[SECTION]
324Local HD -> Morphos (Normal)
325ide:0 boot2.img ramdebug edebugflags="logkprintf"
326
327[SECTION]
328Local HD -> Linux 2.6.10 (Normal)
329ide:0 linux-2.6.10 video=radeonfb:1024x768@70 root=/dev/hda3
330
331</pre>
332
333<p>
334Finally the <path>bootmenu</path> must be transfered into Forth and copied to
335your boot partition, so that the SmartFirmware can read it. Therefore you have
336to call <c>bootcreator</c>:
337</p>
338
339<pre caption = "Install the bootmenu">
340# <i>bootcreator /etc/bootmenu /boot/menu</i>
341</pre>
342
343<note>
344Be sure to have a look into the SmartFirmware's settings when you reboot, that
345<path>menu</path> is the file that will be loaded by default.
346</note>
347
348<p>
349For now, continue the installation with <uri link="#reboot">Rebooting the
350System</uri>.
351</p>
352
353
354</body>
355</section>
275<section id="reboot"> 356<section id="reboot">
276<title>Rebooting the System</title> 357<title>Rebooting the System</title>
277<subsection> 358<subsection>
278<body> 359<body>
279 360
287livecd ~# <i>umount /mnt/gentoo/proc /mnt/gentoo/dev /mnt/gentoo</i> 368livecd ~# <i>umount /mnt/gentoo/proc /mnt/gentoo/dev /mnt/gentoo</i>
288livecd ~# <i>reboot</i> 369livecd ~# <i>reboot</i>
289</pre> 370</pre>
290 371
291<p> 372<p>
292Of course, don't forget to remove the bootable CD, otherwise the CD will be
293booted again instead of your new Gentoo system.
294</p>
295
296<p>
297Once rebooted in your Gentoo installation, finish up with <uri 373Once rebooted in your Gentoo installation, finish up with <uri
298link="?part=1&amp;chap=11">Finalizing your Gentoo Installation</uri>. 374link="?part=1&amp;chap=11">Finalizing your Gentoo Installation</uri>.
299</p> 375</p>
300 376
301</body> 377</body>

Legend:
Removed from v.1.20  
changed lines
  Added in v.1.21

  ViewVC Help
Powered by ViewVC 1.1.20