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

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

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

Revision 1.42 Revision 1.56
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
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/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.42 2005/04/11 03:49:30 josejx Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.56 2007/06/30 00:50:26 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.1</version> 11<version>8.1</version>
12<date>2005-04-10</date> 12<date>2007-06-29</date>
13 13
14<section> 14<section>
15<title>Hardware Requirements</title> 15<title>Hardware Requirements</title>
16<subsection> 16<subsection>
17<title>Introduction</title> 17<title>Introduction</title>
… …
28<title>Hardware Requirements</title> 28<title>Hardware Requirements</title>
29<body> 29<body>
30 30
31<table> 31<table>
32<tr> 32<tr>
33 <th>NewWorld machines</th> 33 <th>Apple NewWorld Machines</th>
34 <ti> 34 <ti>
35 Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook 35 Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
36 PowerBook, Xserver, PowerMac, Genesi's Pegasos II 36 PowerBook, Xserver, PowerMac
37 </ti>
38</tr>
39<tr>
40 <th>OldWorld machines</th>
41 <ti> 37 </ti>
42 Limited support for IBM (RS/6000, iSeries, pSeries) and Amiga systems 38</tr>
39<tr>
40 <th>Apple OldWorld machines</th>
41 <ti>
42 Apple Machines with an OpenFirmware revision less than 3, such as the Beige
43 G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also
44 be supported.
45 </ti>
46</tr>
47<tr>
48 <th>Genesi</th>
49 <ti>
50 Pegasos I/II, Open Desktop Workstation, Efika
51 </ti>
52</tr>
53<tr>
54 <th>IBM</th>
55 <ti>
56 RS/6000, iSeries, pSeries
43 </ti> 57 </ti>
44</tr> 58</tr>
45<tr> 59<tr>
46 <th>Memory</th> 60 <th>Memory</th>
47 <ti>At least 64 MB</ti> 61 <ti>At least 64 MB</ti>
… …
55 <ti>At least 256 MB</ti> 69 <ti>At least 256 MB</ti>
56</tr> 70</tr>
57</table> 71</table>
58 72
59<p> 73<p>
60Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo 74Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
61PPC FAQ</uri> before you begin. 75for help with some common installation related issues or if you're unsure as to
76just what's in that PowerPC machine you've got sitting on your desk right now.
62</p> 77</p>
63 78
64</body> 79</body>
65</subsection> 80</subsection>
66</section> 81</section>
67<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) --> 82<!-- Copy/paste of hb-install-x86-medium.xml, with s/x86/ppc/ -->
68<!-- START --> 83<!-- START -->
69<section> 84<section>
70<title>The Gentoo Installation Approaches</title> 85<title>The Gentoo Universal Installation CD</title>
71<subsection> 86<subsection>
72<title>Introduction</title> 87<title>Introduction</title>
73<body> 88<body>
74 89
75<p> 90<p>
76Gentoo Linux can be installed using one of three <e>stage</e> tarball files. 91Gentoo Linux can be installed using a <e>stage3</e> tarball file.
77A stage file is a tarball (compressed archive) that contains a minimal 92Such a tarball is an archive that contains a minimal environment from
78environment. 93which you can succesfully install Gentoo Linux onto your system.
94</p>
95
96<p>
97Installations using a stage1 or stage2 tarball file are not documented in the
98Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
99FAQ</uri> on these matters.
100</p>
101
102</body>
103</subsection>
104<subsection>
105<title>Gentoo Universal Installation CD</title>
106<body>
107
108<p>
109An Installation CD is a bootable medium which contains a self-sustained Gentoo
110environment. It allows you to boot Linux from the CD. During the boot process
111your hardware is detected and the appropriate drivers are loaded. The Gentoo
112Installation CDs are maintained by Gentoo developers.
113</p>
114
115<p>
116There currently are two Installation CDs available:
79</p> 117</p>
80 118
81<ul> 119<ul>
82 <li> 120 <li>
83 A stage1 file contains nothing more than a compiler, Portage (Gentoo's 121 The Universal Installation CD contains everything you need to install
84 software management system) and a couple of packages on which the compiler 122 Gentoo. It provides stage3 files for common architectures, source code
85 or Portage depends. 123 for the extra applications you need to choose from and, of course, the
86 </li> 124 installation instructions for your architecture.
87 <li>
88 A stage2 file contains a so-called bootstrapped system, a minimal
89 environment from which one can start building all other necessary
90 applications that make a Gentoo environment complete.
91 </li>
92 <li>
93 A stage3 file contains a prebuilt minimal system which is almost fully
94 deployable. It only lacks a few applications where you, the Gentoo user,
95 needs to choose which one you want to install.
96 </li>
97</ul>
98
99<p>
100To help you decide what stage file you want to use, we have written down the
101major advantages and disadvantages of each stage file.
102</p>
103
104</body>
105</subsection>
106<subsection>
107<title>A Stage1 Approach</title>
108<body>
109
110<p>
111A <e>stage1</e> is used when you want to bootstrap and build the entire system
112from scratch.
113</p>
114
115<p>
116Starting from a stage1 allows you to have total control over the
117optimization settings and optional build-time functionality that is
118initially enabled on your system. This makes <e>stage1</e> installs good for
119power users who know what they are doing. It is also a great
120installation method for those who would like to know more about the
121inner workings of Gentoo Linux.
122</p>
123
124<table>
125<tr>
126 <th>Stage1</th>
127 <th>Pros and Cons</th>
128</tr>
129<tr>
130 <th>+</th>
131 <ti>
132 Allows you to have total control over the optimization settings and optional
133 build-time functionality that is initially enabled on your system
134 </ti>
135</tr>
136<tr>
137 <th>+</th>
138 <ti>Suitable for powerusers that know what they are doing</ti>
139</tr>
140<tr>
141 <th>+</th>
142 <ti>Allows you to learn more about the inner workings of Gentoo</ti>
143</tr>
144<tr>
145 <th>-</th>
146 <ti>Takes a long time to finish the installation</ti>
147</tr>
148<tr>
149 <th>-</th>
150 <ti>
151 If you don't intend to tweak the settings, it is a waste of time
152 </ti>
153</tr>
154<tr>
155 <th>-</th>
156 <ti>
157 Requires a working Internet connection during the installation
158 </ti>
159</tr>
160</table>
161
162</body>
163</subsection>
164<subsection>
165<title>A Stage2 Approach</title>
166<body>
167
168<p>
169A <e>stage2</e> is used for building the entire system from a bootstrapped
170"semi-compiled" state.
171</p>
172
173<p>
174Stage2 installs allow you to skip the bootstrap process; doing this
175is fine if you are happy with the optimization settings that we chose
176for your particular stage2 tarball.
177</p>
178
179<table>
180<tr>
181 <th>Stage2</th>
182 <th>Pros and Cons</th>
183</tr>
184<tr>
185 <th>+</th>
186 <ti>You don't need to bootstrap</ti>
187</tr>
188<tr>
189 <th>+</th>
190 <ti>Faster than starting with stage1</ti>
191</tr>
192<tr>
193 <th>+</th>
194 <ti>You can still tweak your settings</ti>
195</tr>
196<tr>
197 <th>-</th>
198 <ti>You cannot tweak as much as with a stage1</ti>
199</tr>
200<tr>
201 <th>-</th>
202 <ti>It's still not the fastest way to install Gentoo</ti>
203</tr>
204<tr>
205 <th>-</th>
206 <ti>You have to accept the optimizations we chose for the bootstrap</ti>
207</tr>
208<tr>
209 <th>-</th>
210 <ti>
211 Requires a working Internet connection during the installation
212 </ti>
213</tr>
214</table>
215
216</body>
217</subsection>
218<subsection>
219<title>A Stage3 Approach</title>
220<body>
221
222<p>
223A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
224built for you. You will only need to build a few packages of which we can't
225decide for you which one to choose.
226</p>
227
228<p>
229Choosing to go with a stage3 allows for the fastest install of Gentoo
230Linux, but also means that your base system will have the optimization
231settings that we chose for you (which to be honest, are good settings
232and were carefully chosen to enhance performance while maintaining
233stability). Stage3 is also required if you want to install Gentoo using
234prebuilt packages or without a network connection.
235</p>
236
237<table>
238<tr>
239 <th>Stage3</th>
240 <th>Pros and Cons</th>
241</tr>
242<tr>
243 <th>+</th>
244 <ti>Fastest way to get a Gentoo base system</ti>
245</tr>
246<tr>
247 <th>-</th>
248 <ti>You cannot tweak the base system - it's built already</ti>
249</tr>
250</table>
251
252<p>
253You might be interested to know that, if you decide to use different
254optimization settings after having installed Gentoo, you will be able to
255recompile your entire system with the new optimization settings.
256</p>
257
258</body>
259</subsection>
260</section>
261<section>
262<title>The Gentoo Installation CDs</title>
263<subsection>
264<title>Introduction</title>
265<body>
266
267<p>
268The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
269self-sustained Gentoo environment. They allow you to boot Linux from the CD.
270During the boot process your hardware is detected and the appropriate drivers
271are loaded. They are maintained by Gentoo developers.
272</p>
273
274<p>
275All Installation CDs allow you to boot, set up networking, initialize your
276partitions and start installing Gentoo from the Internet. We currently provide
277two Installation CDs which are equaly suitable to install Gentoo from, as long
278as you're planning on performing an Internet-based installation using the
279latest version of the available packages.
280</p>
281
282<p>
283If you wish to install Gentoo without a working Internet connection, please use
284the installation instructions described in the <uri
285link="2005.0/index.xml">Gentoo 2005.0 Handbooks</uri>.
286</p>
287
288<p>
289The two Installation CDs that we currently provide are:
290</p>
291
292<ul>
293 <li>
294 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
295 CD which sole purpose is to boot the system, prepare the networking and
296 continue with the Gentoo installation.
297 </li> 125 </li>
298 <li> 126 <li>
299 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 127 The Minimal Installation CD contains only a minimal environment that allows
300 abilities as the Minimal Installation CD. Additionally, it contains a 128 you to boot up and configure your network so you can connect to the
301 stage1 and several stage3 tarballs (optimized for the individual 129 Internet. It does not contain any additional files and cannot be used
302 subarchitectures). 130 during the current installation approach.
303 </li> 131 </li>
304</ul> 132</ul>
305 133
306<p> 134<p>
307To help you decide which Installation CD you need, we have written down the 135Gentoo also provides a Package CD. This is not an Installation CD but an
308major advantages and disadvantages of each Installation CD. 136additional resource that you can exploit during the installation of your Gentoo
309</p> 137system. It contains prebuilt packages (also known as the GRP set) that allow
310 138you to easily and quickly install additional applications (such as
311</body> 139OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
312</subsection> 140right before you update your Portage tree.
313<subsection>
314<title>Gentoo's Minimal Installation CD</title>
315<body>
316
317<p> 141</p>
318The Minimal Installation CD is called <c>install-ppc-minimal-2005.0.iso</c> and 142
319takes up only 52 MB of diskspace. You can use this Installation CD to install
320Gentoo, but always with a working Internet connection only.
321</p> 143<p>
322 144The use of the Package CD is covered later in this document.
323<table>
324<tr>
325 <th>Minimal Installation CD</th>
326 <th>Pros and Cons</th>
327</tr>
328<tr>
329 <th>+</th>
330 <ti>Smallest download</ti>
331</tr>
332<tr>
333 <th>+</th>
334 <ti>
335 You can do a stage1, stage2 or stage3 by getting the stage tarball off the
336 net
337 </ti>
338</tr>
339<tr>
340 <th>-</th>
341 <ti>
342 Contains no stages, no Portage snapshot, no prebuilt packages and is
343 therefore not suitable for networkless installation
344 </ti>
345</tr>
346</table>
347
348</body>
349</subsection>
350<subsection>
351<title>Gentoo's Universal Installation CD</title>
352<body>
353
354<p>
355The Universal Installation CD is called <c>install-ppc-universal-2005.0.iso</c>
356and consumes the entire surface of a 650 MB CD. You can use this Installation
357CD to install Gentoo, and you can even use it to install Gentoo without a
358working internet connection, just in case you want to bring Gentoo to another
359PC than the one you are currently installing Gentoo on :)
360</p>
361
362<table>
363<tr>
364 <th>Universal Installation CD</th>
365 <th>Pros and Cons</th>
366</tr>
367<tr>
368 <th>+</th>
369 <ti>
370 Contains everything you need. You can even install without a network
371 connection.
372 </ti>
373</tr>
374<tr>
375 <th>-</th>
376 <ti>Huge download</ti>
377</tr>
378</table>
379
380</body>
381</subsection>
382<subsection>
383<title>Other CDs</title>
384<body>
385
386<p>
387You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is
388no Installation CD but an additional resource that can be exploited during a
389networkless installation. It contains prebuilt packages (the so-called GRP
390set) that allows you to easily and quickly install additional applications
391(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless
392Gentoo installation.
393</p> 145</p>
394 146
395</body> 147</body>
396</subsection> 148</subsection>
397</section> 149</section>
398<!-- STOP --> 150<!-- STOP -->
399<section> 151<section>
400<title>Download, Burn and Boot a Gentoo Installation CD</title> 152<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
401<subsection> 153<subsection>
402<title>Downloading and Burning the Installation CDs</title> 154<title>Downloading and Burning the Installation CD</title>
403<body> 155<body>
404 156
405<p>
406You have chosen to use a Gentoo Installation CD. We'll first start by
407downloading and burning the chosen Installation CD. We previously discussed
408the several available Installation CDs, but where can you find them?
409</p> 157<p>
410 158You can download the Universal Installation CD (and, if you want to, the
159Packages CD as well) from one of our <uri
160link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
161the <path><keyval id="release-dir"/>installcd</path> directory; the Package CDs
162are located in the <path><keyval id="release-dir"/>packagecd</path> directory.
411<p> 163</p>
412You can download any of the Installation CDs (and, if you want to, a Packages 164
413CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
414Installation CDs are located in the <path>releases/ppc/2005.0/installcd</path>
415directory.
416</p> 165<p>
417
418<p>
419Inside that directory you'll find so-called ISO-files. Those are full CD images 166Inside those directories you'll find ISO-files. Those are full CD images which
420which you can write on a CD-R. 167you can write on a CD-R.
421</p>
422
423<p> 168</p>
424In case you wonder if your downloaded file is corrupted or not, you can 169
170<p>
171After downloading the file, you can verify its integrity to see if it is
172corrupted or not:
173</p>
174
175<ul>
176 <li>
425check its MD5 checksum and compare it with the MD5 checksum we provide (such as 177 You can check its MD5 checksum and compare it with the MD5 checksum we
426<path>install-ppc-minimal-2005.0.iso.md5</path>). You can check the MD5 checksum
427with the <c>md5sum</c> tool under Linux/Unix or <uri 178 provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
428link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. How 179 <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows).
429to verify MD5 checksums with Mac OS X is described in the <uri 180 Verifying MD5 checksums with Mac OS X is described in the <uri
430link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>. 181 link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
182 </li>
183 <li>
184 You can verify the cryptographic signature that we provide. You need to
185 obtain the public key we use (0x17072058) before you proceed though.
186 </li>
187</ul>
188
431</p> 189<p>
432 190To fetch our public key using the GnuPG application, run the following command:
433<p>
434Another way to check the validity of the downloaded file is to use GnuPG to
435verify the cryptographic signature that we provide (the file ending with
436<path>.asc</path>). Download the signature file and obtain the public key:
437</p> 191</p>
438 192
439<pre caption="Obtaining the public key"> 193<pre caption="Obtaining the public key">
440$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> 194$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
441</pre> 195</pre>
442 196
443<p> 197<p>
444Now verify the signature: 198Now verify the signature:
445</p> 199</p>
… …
455link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. 209link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
456</p> 210</p>
457 211
458<ul> 212<ul>
459 <li> 213 <li>
460 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso 214 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
461 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's 215 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
462 device path). 216 path).
463 </li> 217 </li>
464 <li> 218 <li>
465 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then 219 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
466 you can locate your ISO file within the 'Image to Burn' area. Finally click 220 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
467 <c>Start</c>.
468 </li> 221 </li>
469</ul> 222</ul>
470 223
471</body> 224</body>
472</subsection> 225</subsection>
… …
474<title>Default: Booting the Installation CD with Yaboot</title> 227<title>Default: Booting the Installation CD with Yaboot</title>
475<body> 228<body>
476 229
477<p> 230<p>
478On NewWorld machines place the Installation CD in the CD-ROM and reboot the 231On NewWorld machines place the Installation CD in the CD-ROM and reboot the
479system. When the system-start-bell sounds, simply hold down the 'C' until the 232system. When the system-start-bell sounds, simply hold down the 'C' until the
480CD loads. 233CD loads.
481</p> 234</p>
482 235
483<p> 236<p>
484After the Installation CD loaded, you will be greeted by a friendly welcome 237After the Installation CD loaded, you will be greeted by a friendly welcome
485message and a <e>boot:</e> prompt at the bottom of the screen. 238message and a <e>boot:</e> prompt at the bottom of the screen.
486</p> 239</p>
487 240
488<p> 241<p>
489At this prompt you are able to select a kernel for the subarchitecture you use. 242We provide one generic kernel, <e>apple</e>. This kernel is built with support
490We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
491support for multiple CPUs, but they will boot on single processor machines as 243for multiple CPUs, but it will boot on single processor machines as well.
492well.
493</p>
494
495<p> 244</p>
245
246<p>
496You are also able to tweak some kernel options at this prompt. The following 247You can tweak some kernel options at this prompt. The following table lists
497table lists some of the available boot options you can add: 248some of the available boot options you can add:
498</p> 249</p>
499 250
500<table> 251<table>
501<tr> 252<tr>
502 <th>Boot Option</th> 253 <th>Boot Option</th>
… …
504</tr> 255</tr>
505<tr> 256<tr>
506 <ti><c>video</c></ti> 257 <ti><c>video</c></ti>
507 <ti> 258 <ti>
508 This option takes one of the following vendor-specific tags: 259 This option takes one of the following vendor-specific tags:
509 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or 260 <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
510 <c>ofonly</c>. You can follow this tag with the resolution and refreshrate 261 <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
511 you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are 262 refresh rate and color depth you want to use. For instance,
512 uncertain what to choose, <c>ofonly</c> will most certainly work. 263 <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
264 at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
265 32 bits. If you are uncertain what to choose, and the default doesn't work,
266 <c>video=ofonly</c> will most certainly work.
513 </ti> 267 </ti>
514</tr> 268</tr>
515<tr> 269<tr>
516 <ti><c>nol3</c></ti> 270 <ti><c>nol3</c></ti>
517 <ti> 271 <ti>
… …
525 </ti> 279 </ti>
526</tr> 280</tr>
527<tr> 281<tr>
528 <ti><c>dopcmcia</c></ti> 282 <ti><c>dopcmcia</c></ti>
529 <ti> 283 <ti>
530 If you want to use PCMCIA devices during your installation (like PCMCIA 284 If you want to use PCMCIA devices during your installation (like PCMCIA
531 network cards) you have to enable this option. 285 network cards) you have to enable this option.
532 </ti> 286 </ti>
533</tr> 287</tr>
534</table> 288</table>
535 289
536<p> 290<p>
537At this prompt, hit enter, and a complete Gentoo Linux environment will be 291To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
538loaded from the CD. Continue with <uri link="#booted">And When You're 292by the desired option. In the example below, we'll force the kernel to use the
539Booted...</uri>. 293OpenFirmware framebuffer instead of the device specific driver.
294</p>
295
296<pre caption="Force the use of the OpenFirmware framebuffer">
297boot: <i>apple video=ofonly</i>
298</pre>
299
300<p>
301If you don't need to add any options, just hit enter at this prompt, and a
302complete Gentoo Linux environment will be loaded from the CD. Continue with
303<uri link="#booted">And When You're Booted...</uri>.
540</p> 304</p>
541 305
542</body> 306</body>
543</subsection> 307</subsection>
544<subsection> 308<subsection>
… …
547 311
548<p> 312<p>
549On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type 313On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
550<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose 314<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
551between several preconfigured video configs. If you need any special boot 315between several preconfigured video configs. If you need any special boot
552options you can append them to the command-line. For instance <c>boot cd 316options you can append them to the command-line just like with Yaboot above.
553/boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. The complete list of 317For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
554kernel appends (in case something goes wrong and you need it) is preconfigured 318The default kernel options (in case something goes wrong and you need it) are
555in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc 319preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
556looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>. 320looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
557</p> 321</p>
558 322
559</body> 323</body>
560</subsection> 324</subsection>
561 325
… …
563<title>Alternative: Booting the Installation CD with BootX</title> 327<title>Alternative: Booting the Installation CD with BootX</title>
564<body> 328<body>
565 329
566<p> 330<p>
567If you have an OldWorld Mac the bootable portion of the livecd can't be used. 331If you have an OldWorld Mac the bootable portion of the livecd can't be used.
568The most simple solution is to use MacOS to bootstrap into a Linux environment 332The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
569with a tool called BootX. Boot floppies are being prepared for Macs without 333environment with a tool called BootX.
570MacOS, but they are not available at this time.
571</p> 334</p>
335
572<p> 336<p>
573First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri> 337First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
574and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked 338and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
575archive into <c>Extensions Folder</c> and the BootX App Control Panel into 339archive into <c>Extensions Folder</c> and the BootX App Control Panel into
576<c>Control Panels</c>, both of which are located in your MacOS System Folder. 340<c>Control Panels</c>, both of which are located in your MacOS System Folder.
577Next, create a folder called "Linux Kernels" in your System folder and copy the 341Next, create a folder called "Linux Kernels" in your System folder and copy the
578<c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c> 342<c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c>
579from the Installation CD <path>boot</path> folder into the MacOS 343from the Installation CD <path>boot</path> folder into the MacOS
580<c>System Folder</c>. 344<c>System Folder</c>.
581</p> 345</p>
346
582<p> 347<p>
583To prepare BootX, start the BootX App Control Panel. First select the Options 348To prepare BootX, start the BootX App Control Panel. First select the Options
584dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from 349dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
585your System Folder. Continue back to the initial screen and ensure that the 350your System Folder. Continue back to the initial screen and ensure that the
586ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as 351ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
587shown below: 352shown below:
588</p> 353</p>
589 354
590<pre caption="BootX kernel arguments"> 355<pre caption="BootX kernel arguments">
591cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev 356cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
592</pre> 357</pre>
358
593<note> 359<note>
594The kernel parameters in the yaboot section above are also applicable here. 360The kernel parameters in the yaboot section above are also applicable here. You
361can append any of those options to the kernel arguments above.
595</note> 362</note>
363
596<p> 364<p>
597Check once more to make sure the settings are correct and then save the 365Check once more to make sure the settings are correct and then save the
598configuration. This saves typing just in case it doesn't boot or something is 366configuration. This saves typing just in case it doesn't boot or something is
599missing. Press the Linux button at the top of the window to boot into the 367missing. Press the Linux button at the top of the window. If everything goes
368correctly, it should boot into the Installation CD. Continue with
600LiveCD and continue with <uri link="#booted">And When You're Booted...</uri> 369<uri link="#booted">And When You're Booted...</uri>
601</p> 370</p>
371
602</body> 372</body>
603</subsection> 373</subsection>
604 374
605<subsection id="booted"> 375<subsection id="booted">
606<title>And When You're Booted...</title> 376<title>And When You're Booted...</title>
607<body> 377<body>
608 378
609<p> 379<p>
610You will be greeted by a root ("#") prompt on the current console. You can also 380You will be greeted by a root ("#") prompt on the current console. You can also
611switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get 381switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
612back to the one you started on by pressing Alt-F1. Probably you have to hit 382back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
613Alt-fn-Fx on Apple machines. 383you may need to press Alt-fn-Fx on Apple machines.
614</p> 384</p>
615 385
616<p> 386<p>
617If you are installing Gentoo on a system with a non-US keyboard, use 387If you are installing Gentoo on a system with a non-US keyboard, use
618<c>loadkeys</c> to load the keymap for your keyboard. To list the available 388<c>loadkeys</c> to load the keymap for your keyboard. To list the available
619keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the 389keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
620Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they 390Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
621are for ADB-based OldWorld machines. 391are for ADB-based OldWorld machines.
622</p> 392</p>
623 393
624<pre caption="Listing available keymaps"> 394<pre caption="Listing available keymaps">
… …
654of your system's hardware, you will have to load the appropriate kernel modules 424of your system's hardware, you will have to load the appropriate kernel modules
655manually. 425manually.
656</p> 426</p>
657 427
658<p> 428<p>
659In the next example we try to load the <c>airport</c> module. This module 429In the next example we try to load the <c>airport</c> module. This module
660supports only the old Airport cards (b-net). AirportExtreme is currently not 430supports only the old Airport cards (802.11b). Airport Extreme (802.11g) is not
661supported under Linux: 431supported on the InstallCD due to restrictions on firmware distribution.
662</p> 432</p>
663 433
664<pre caption="Loading kernel modules"> 434<pre caption="Loading the airport module">
665# <i>modprobe airport</i> 435# <i>modprobe airport</i>
436</pre>
437
438<p>
439On older iMacs, sometimes the network card is not detected properly. These use
440the BMAC driver:
441</p>
442
443<pre caption="Loading the bmac module">
444# <i>modprobe bmac</i>
666</pre> 445</pre>
667 446
668</body> 447</body>
669</subsection> 448</subsection>
670<subsection> 449<subsection>
… …
687yourself) which use <path>/dev/hda</path> as disk (substitute with your 466yourself) which use <path>/dev/hda</path> as disk (substitute with your
688disk): 467disk):
689</p> 468</p>
690 469
691<pre caption="Tweaking hard disk performance"> 470<pre caption="Tweaking hard disk performance">
692<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i> 471<comment>Activate DMA:</comment>
693<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i> 472# <i>hdparm -d 1 /dev/hda</i>
473<comment>Activate DMA + Safe Performance-enhancing Options:</comment>
474# <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
694</pre> 475</pre>
695 476
696</body> 477</body>
697</subsection> 478</subsection>
698<subsection id="useraccounts"> 479<subsection id="useraccounts">
… …
751go to a new terminal and log in. 532go to a new terminal and log in.
752</p> 533</p>
753 534
754<p> 535<p>
755If you want to view the documentation on the CD you can immediately run 536If you want to view the documentation on the CD you can immediately run
756<c>links2</c> to read it: 537<c>links</c> or even <c>links -g</c> for a graphical framebuffer browser to
538read it:
757</p> 539</p>
758 540
759<pre caption="Viewing the on-CD documentation"> 541<pre caption="Viewing the on-CD documentation">
760# <i>links2 /mnt/cdrom/docs/html/index.html</i> 542# <i>links /mnt/cdrom/docs/html/index.html</i>
761</pre> 543</pre>
762 544
763<p> 545<p>
764However, it is preferred that you use the online Gentoo Handbook as it will be 546However, it is preferred that you use the online Gentoo Handbook as it will be
765more recent than the one provided on the CD. You can view it using <c>links2</c> 547more recent than the one provided on the CD. You can view it using <c>links</c>
766as well, but only after having completed the <e>Configuring your Network</e> 548as well, but only after having completed the <e>Configuring your Network</e>
767chapter (otherwise you won't be able to go on the Internet to view the 549chapter (otherwise you won't be able to go on the Internet to view the
768document): 550document):
769</p> 551</p>
770 552
771<pre caption="Viewing the Online Documentation"> 553<pre caption="Viewing the Online Documentation">
772# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i> 554# <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
773</pre> 555</pre>
774 556
775<p> 557<p>
776You can go back to your original terminal by pressing <c>Alt-F1</c>. 558You can go back to your original terminal by pressing <c>Alt-F1</c>.
777</p> 559</p>
Legend:
Removed from v.1.42  
changed lines
  Added in v.1.56
  ViewVC Help
Powered by ViewVC 1.1.13