/[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.46 Revision 1.70
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.46 2005/08/11 11:28:54 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.70 2012/06/29 15:57:32 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<abstract>
12You can install Gentoo in many ways. This chapter explains how to install
13Gentoo using the minimal Installation CD.
14</abstract>
15
11<version>2.4</version> 16<version>13</version>
12<date>2005-08-11</date> 17<date>2012-06-29</date>
13 18
14<section> 19<section>
15<title>Hardware Requirements</title> 20<title>Hardware Requirements</title>
16<subsection> 21<subsection>
17<title>Introduction</title> 22<title>Introduction</title>
37 </ti> 42 </ti>
38</tr> 43</tr>
39<tr> 44<tr>
40 <th>Apple OldWorld machines</th> 45 <th>Apple OldWorld machines</th>
41 <ti> 46 <ti>
42 Apple Machines with an OpenFirmware revision less than 3, such as the Beige 47 Apple Machines with an Open Firmware revision less than 3, such as the Beige
43 G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also 48 G3s, PCI PowerMacs and PCI PowerBooks. PCI-based Apple Clones should also
44 be supported. 49 be supported.
45 </ti> 50 </ti>
46</tr> 51</tr>
47<tr> 52<tr>
48 <th>Genesi's Pegasos</th> 53 <th>Genesi</th>
49 <ti> 54 <ti>
50 Pegasos I/II, Open Desktop Workstation 55 Pegasos I/II, Open Desktop Workstation, Efika
51 </ti> 56 </ti>
52</tr> 57</tr>
53<tr> 58<tr>
54 <th>IBM</th> 59 <th>IBM</th>
55 <ti> 60 <ti>
69 <ti>At least 256 MB</ti> 74 <ti>At least 256 MB</ti>
70</tr> 75</tr>
71</table> 76</table>
72 77
73<p> 78<p>
74Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo 79Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
75PPC FAQ</uri> before you begin. 80for help with some common installation related issues or if you're unsure as to
81just what's in that PowerPC machine you've got sitting on your desk right now.
76</p> 82</p>
77 83
78</body> 84</body>
79</subsection> 85</subsection>
80</section> 86</section>
81<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) --> 87
82<!-- START --> 88<!-- START -->
83<section>
84<title>The Gentoo Installation Approaches</title>
85<subsection>
86<title>Introduction</title>
87<body>
88
89<p>
90Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
91A stage file is a tarball (compressed archive) that contains a minimal
92environment.
93</p>
94
95<ul>
96 <li>
97 A stage1 file contains nothing more than a compiler, Portage (Gentoo's
98 software management system) and a couple of packages on which the compiler
99 or Portage depends.
100 </li>
101 <li>
102 A stage2 file contains a so-called bootstrapped system, a minimal
103 environment from which one can start building all other necessary
104 applications that make a Gentoo environment complete.
105 </li>
106 <li>
107 A stage3 file contains a prebuilt minimal system which is almost fully
108 deployable. It only lacks a few applications where you, the Gentoo user,
109 needs to choose which one you want to install.
110 </li>
111</ul>
112
113<p>
114To help you decide what stage file you want to use, we have written down the
115major advantages and disadvantages of each stage file.
116</p>
117
118</body>
119</subsection>
120<subsection>
121<title>A Stage1 Approach</title>
122<body>
123
124<p>
125A <e>stage1</e> is used when you want to bootstrap and build the entire system
126from scratch.
127</p>
128
129<p>
130Starting from a stage1 allows you to have total control over the
131optimization settings and optional build-time functionality that is
132initially enabled on your system. This makes <e>stage1</e> installs good for
133power users who know what they are doing. It is also a great
134installation method for those who would like to know more about the
135inner workings of Gentoo Linux.
136</p>
137
138<table>
139<tr>
140 <th>Stage1</th>
141 <th>Pros and Cons</th>
142</tr>
143<tr>
144 <th>+</th>
145 <ti>
146 Allows you to have total control over the optimization settings and optional
147 build-time functionality that is initially enabled on your system
148 </ti>
149</tr>
150<tr>
151 <th>+</th>
152 <ti>Suitable for powerusers that know what they are doing</ti>
153</tr>
154<tr>
155 <th>+</th>
156 <ti>Allows you to learn more about the inner workings of Gentoo</ti>
157</tr>
158<tr>
159 <th>-</th>
160 <ti>Takes a long time to finish the installation</ti>
161</tr>
162<tr>
163 <th>-</th>
164 <ti>
165 If you don't intend to tweak the settings, it is a waste of time
166 </ti>
167</tr>
168<tr>
169 <th>-</th>
170 <ti>
171 Requires a working Internet connection during the installation
172 </ti>
173</tr>
174</table>
175
176</body>
177</subsection>
178<subsection>
179<title>A Stage2 Approach</title>
180<body>
181
182<p>
183A <e>stage2</e> is used for building the entire system from a bootstrapped
184"semi-compiled" state.
185</p>
186
187<p>
188Stage2 installs allow you to skip the bootstrap process; doing this
189is fine if you are happy with the optimization settings that we chose
190for your particular stage2 tarball.
191</p>
192
193<table>
194<tr>
195 <th>Stage2</th>
196 <th>Pros and Cons</th>
197</tr>
198<tr>
199 <th>+</th>
200 <ti>You don't need to bootstrap</ti>
201</tr>
202<tr>
203 <th>+</th>
204 <ti>Faster than starting with stage1</ti>
205</tr>
206<tr>
207 <th>+</th>
208 <ti>You can still tweak your settings</ti>
209</tr>
210<tr>
211 <th>-</th>
212 <ti>You cannot tweak as much as with a stage1</ti>
213</tr>
214<tr>
215 <th>-</th>
216 <ti>It's still not the fastest way to install Gentoo</ti>
217</tr>
218<tr>
219 <th>-</th>
220 <ti>You have to accept the optimizations we chose for the bootstrap</ti>
221</tr>
222<tr>
223 <th>-</th>
224 <ti>
225 Requires a working Internet connection during the installation
226 </ti>
227</tr>
228</table>
229
230</body>
231</subsection>
232<subsection>
233<title>A Stage3 Approach</title>
234<body>
235
236<p>
237A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
238built for you. You will only need to build a few packages of which we can't
239decide for you which one to choose.
240</p>
241
242<p>
243Choosing to go with a stage3 allows for the fastest install of Gentoo
244Linux, but also means that your base system will have the optimization
245settings that we chose for you (which to be honest, are good settings
246and were carefully chosen to enhance performance while maintaining
247stability). Stage3 is also required if you want to install Gentoo using
248prebuilt packages or without a network connection.
249</p>
250
251<table>
252<tr>
253 <th>Stage3</th>
254 <th>Pros and Cons</th>
255</tr>
256<tr>
257 <th>+</th>
258 <ti>Fastest way to get a Gentoo base system</ti>
259</tr>
260<tr>
261 <th>-</th>
262 <ti>You cannot tweak the base system - it's built already</ti>
263</tr>
264</table>
265
266<p>
267You might be interested to know that, if you decide to use different
268optimization settings after having installed Gentoo, you will be able to
269recompile your entire system with the new optimization settings.
270</p>
271
272</body>
273</subsection>
274</section>
275<section> 89<section>
276<title>The Gentoo Installation CDs</title> 90<title>The Gentoo Installation CDs</title>
277<subsection> 91<subsection>
278<title>Introduction</title> 92<title>Introduction</title>
279<body> 93<body>
285are loaded. They are maintained by Gentoo developers. 99are loaded. They are maintained by Gentoo developers.
286</p> 100</p>
287 101
288<p> 102<p>
289All Installation CDs allow you to boot, set up networking, initialize your 103All Installation CDs allow you to boot, set up networking, initialize your
290partitions and start installing Gentoo from the Internet. We currently provide 104partitions and start installing Gentoo from the Internet.
291two Installation CDs which are equaly suitable to install Gentoo from, as long
292as you're planning on performing an Internet-based installation using the
293latest version of the available packages.
294</p>
295
296<p> 105</p>
106
107<!--
108<impo>
297If you wish to install Gentoo without a working Internet connection, please use 109If you wish to install Gentoo without a working Internet connection, or would
298the installation instructions described in the <uri 110like to use one of the provided installers, please use the installation
299link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. 111instructions described in the <uri link="2008.0/">Gentoo 2008.0
112Handbooks</uri>.
113</impo>
114-->
115<!--
300</p> 116<p>
301
302<p>
303The two Installation CDs that we currently provide are: 117The Installation CDs that we currently provide are:
304</p> 118</p>
305 119
306<ul> 120<ul>
307 <li> 121 <li>
308 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable 122 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
309 CD which sole purpose is to boot the system, prepare the networking and 123 CD which sole purpose is to boot the system, prepare the networking and
310 continue with the Gentoo installation. 124 continue with the Gentoo installation.
311 </li> 125 </li>
312 <li> 126 <li>
313 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 127 The Universal Installation CD contains everything you need to install
314 abilities as the Minimal Installation CD. Additionally, it contains a 128 Gentoo. It provides stage3 files for common architectures, source code
315 stage1 and several stage3 tarballs (optimized for the individual 129 for the extra applications you need to choose from and, of course, the
316 subarchitectures). 130 installation instructions for your architecture.
317 </li> 131 </li>
318</ul> 132</ul>
319 133
320<p> 134<p>
321To 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
322major advantages and disadvantages of each Installation CD. 136additional resource that you can exploit during the installation of your Gentoo
137system. It contains prebuilt packages (also known as the GRP set) that allow
138you to easily and quickly install additional applications (such as
139OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
140right before you update your Portage tree.
141</p>
142
323</p> 143<p>
324 144The use of the Package CD is covered later in this document.
145</p>
146-->
325</body> 147</body>
326</subsection>
327<subsection> 148</subsection>
149<subsection>
328<title>Gentoo's Minimal Installation CD</title> 150<title>Gentoo Minimal Installation CD</title>
329<body> 151<body>
330 152
331<p>
332The Minimal Installation CD is called <c>install-ppc-minimal-2005.1.iso</c> and
333takes up only 52 MB of diskspace. You can use this Installation CD to install
334Gentoo, but always with a working Internet connection only.
335</p> 153<p>
336 154The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
155takes up around <keyval id="min-cd-size"/> MB of diskspace. You can use this
156Installation CD to install Gentoo, but <e>only</e> with a working Internet
157connection.
158</p>
159<!--
337<table> 160<table>
338<tr> 161<tr>
339 <th>Minimal Installation CD</th> 162 <th>Minimal Installation CD</th>
340 <th>Pros and Cons</th> 163 <th>Pros and Cons</th>
341</tr> 164</tr>
342<tr> 165<tr>
343 <th>+</th> 166 <th>+</th>
344 <ti>Smallest download</ti> 167 <ti>Smallest download</ti>
345</tr> 168</tr>
346<tr> 169<tr>
347 <th>+</th>
348 <ti>
349 You can do a stage1, stage2 or stage3 by getting the stage tarball off the
350 net
351 </ti>
352</tr>
353<tr>
354 <th>-</th> 170 <th>-</th>
355 <ti> 171 <ti>
356 Contains no stages, no Portage snapshot, no prebuilt packages and is 172 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
357 therefore not suitable for networkless installation 173 is therefore not suitable for networkless installation
358 </ti> 174 </ti>
359</tr> 175</tr>
360</table> 176</table>
361 177-->
362</body> 178</body>
363</subsection>
364<subsection> 179</subsection>
365<title>Gentoo's Universal Installation CD</title>
366<body>
367
368<p>
369The Universal Installation CD is called <c>install-ppc-universal-2005.1.iso</c>
370and consumes the entire surface of a 650 MB CD. You can use this Installation
371CD to install Gentoo, and you can even use it to install Gentoo without a
372working internet connection, just in case you want to bring Gentoo to another
373PC than the one you are currently installing Gentoo on :)
374</p>
375
376<table>
377<tr>
378 <th>Universal Installation CD</th>
379 <th>Pros and Cons</th>
380</tr>
381<tr>
382 <th>+</th>
383 <ti>
384 Contains everything you need. You can even install without a network
385 connection.
386 </ti>
387</tr>
388<tr>
389 <th>-</th>
390 <ti>Huge download</ti>
391</tr>
392</table>
393
394</body>
395</subsection> 180<subsection>
396<subsection> 181<title>The Stage3 Tarball</title>
397<title>Other CDs</title>
398<body> 182<body>
399 183
184<p>
185A stage3 tarball is an archive containing a minimal Gentoo environment,
186suitable to continue the Gentoo installation using the instructions in this
187manual. Previously, the Gentoo Handbook described the installation using one of
188three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
189official installation method uses the stage3 tarball. If you are interested in
190performing a Gentoo installation using a stage1 or stage2 tarball, please read
191the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
192Using a Stage1 or Stage2 Tarball?</uri>
400<p> 193</p>
401You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is 194
402no Installation CD but an additional resource that can be exploited during a 195<p>
403networkless installation. It contains prebuilt packages (the so-called GRP 196Stage3 tarballs can be downloaded from <path><keyval
404set) that allows you to easily and quickly install additional applications 197id="release-dir"/>current-stage3/</path> on any of the <uri
405(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless 198link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
406Gentoo installation. 199on the LiveCD.
407</p> 200</p>
408 201
409</body> 202</body>
410</subsection> 203</subsection>
411</section> 204</section>
205
206
412<!-- STOP --> 207<!-- STOP -->
413<section> 208<section>
414<title>Download, Burn and Boot a Gentoo Installation CD</title> 209<title>Download, Burn and Boot a Gentoo Installation CD</title>
415<subsection> 210<subsection>
416<title>Downloading and Burning the Installation CDs</title> 211<title>Downloading and Burning the Installation CDs</title>
417<body> 212<body>
418 213
419<p> 214<p>
420You have chosen to use a Gentoo Installation CD. We'll first start by 215You have chosen to use a Gentoo Installation CD. We'll first start by
421downloading and burning the chosen Installation CD. We previously discussed 216downloading and burning the chosen Installation CD. We previously discussed
422the several available Installation CDs, but where can you find them? 217the several available Installation CDs, but where can you find them?
423</p>
424
425<p> 218</p>
426You can download any of the Installation CDs (and, if you want to, a Packages 219
427CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
428Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path>
429directory.
430</p> 220<p>
431 221You can download any of the Installation CDs from one of our <uri
222link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
223the <path><keyval id="release-dir"/>current-iso/</path> directory.
432<p> 224</p>
225
226<p>
433Inside that directory you'll find so-called ISO-files. Those are full CD images 227Inside that directory you'll find ISO files. Those are full CD images which you
434which you can write on a CD-R. 228can write on a CD-R.
435</p>
436
437<p> 229</p>
230
231<p>
438In case you wonder if your downloaded file is corrupted or not, you can 232In case you wonder if your downloaded file is corrupted or not, you can check
439check its MD5 checksum and compare it with the MD5 checksum we provide (such as 233its MD5 checksum and compare it with the MD5 checksum we provide (such as
440<path>install-ppc-minimal-2005.1.iso.md5</path>). You can check the MD5 checksum 234<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
441with the <c>md5sum</c> tool under Linux/Unix or 235checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
442<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If 236link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
443<c>md5sum</c> is not available on Mac OS X, see the
444<uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help.
445</p> 237</p>
446 238
447<p> 239<p>
448Another way to check the validity of the downloaded file is to use GnuPG to 240Another way to check the validity of the downloaded file is to use GnuPG to
449verify the cryptographic signature that we provide (the file ending with 241verify the cryptographic signature that we provide (the file ending with
450<path>.asc</path>). Download the signature file and obtain the public key: 242<path>.asc</path>). Download the signature file and obtain the public keys whose
243key ids can be found on the <uri link="/proj/en/releng/index.xml">release
244engineering project site</uri>.
451</p> 245</p>
452 246
453<pre caption="Obtaining the public key"> 247<pre caption="Obtaining the public key">
248<comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
454$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> 249$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
455</pre> 250</pre>
456 251
457<p> 252<p>
458Now verify the signature: 253Now verify the signature:
459</p> 254</p>
460 255
461<pre caption="Verify the cryptographic signature"> 256<pre caption="Verify the files">
462$ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i> 257<comment>(Verify the cryptographic signature)</comment>
258$ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
259<comment>(Verify the checksum)</comment>
260$ <i>sha1sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
463</pre> 261</pre>
464 262
465<p> 263<p>
466To burn the downloaded ISO(s), you have to select raw-burning. How you 264To burn the downloaded ISO(s), you have to select raw-burning. How you
467do this is highly program-dependent. We will discuss <c>cdrecord</c> and 265do this is highly program-dependent. We will discuss <c>cdrecord</c> and
469link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. 267link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
470</p> 268</p>
471 269
472<ul> 270<ul>
473 <li> 271 <li>
474 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso 272 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
475 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's 273 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
476 device path). 274 path).
477 </li> 275 </li>
478 <li> 276 <li>
479 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then 277 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
480 you can locate your ISO file within the 'Image to Burn' area. Finally click 278 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
481 <c>Start</c>.
482 </li> 279 </li>
483</ul> 280</ul>
484 281
485</body> 282</body>
486</subsection> 283</subsection>
488<title>Default: Booting the Installation CD with Yaboot</title> 285<title>Default: Booting the Installation CD with Yaboot</title>
489<body> 286<body>
490 287
491<p> 288<p>
492On NewWorld machines place the Installation CD in the CD-ROM and reboot the 289On NewWorld machines place the Installation CD in the CD-ROM and reboot the
493system. When the system-start-bell sounds, simply hold down the 'C' until the 290system. When the system-start-bell sounds, simply hold down the 'C' until the
494CD loads. 291CD loads.
495</p> 292</p>
496 293
497<p> 294<p>
498After the Installation CD loaded, you will be greeted by a friendly welcome 295After the Installation CD loaded, you will be greeted by a friendly welcome
499message and a <e>boot:</e> prompt at the bottom of the screen. 296message and a <e>boot:</e> prompt at the bottom of the screen.
500</p> 297</p>
501 298
502<p> 299<p>
503At this prompt you are able to select a kernel for the subarchitecture you use. 300We provide one generic kernel, <e>ppc32</e>. This kernel is built with support
504We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
505support for multiple CPUs, but they will boot on single processor machines as 301for multiple CPUs, but it will boot on single processor machines as well.
506well.
507</p>
508
509<p> 302</p>
303
304<p>
510You are also able to tweak some kernel options at this prompt. The following 305You can tweak some kernel options at this prompt. The following table lists
511table lists some of the available boot options you can add: 306some of the available boot options you can add:
512</p> 307</p>
513 308
514<table> 309<table>
515<tr> 310<tr>
516 <th>Boot Option</th> 311 <th>Boot Option</th>
518</tr> 313</tr>
519<tr> 314<tr>
520 <ti><c>video</c></ti> 315 <ti><c>video</c></ti>
521 <ti> 316 <ti>
522 This option takes one of the following vendor-specific tags: 317 This option takes one of the following vendor-specific tags:
523 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or 318 <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
524 <c>ofonly</c>. You can follow this tag with the resolution and refreshrate 319 <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
525 you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are 320 refresh rate and color depth you want to use. For instance,
526 uncertain what to choose, <c>ofonly</c> will most certainly work. 321 <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
322 at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
323 32 bits. If you are uncertain what to choose, and the default doesn't work,
324 <c>video=ofonly</c> will most certainly work.
527 </ti> 325 </ti>
528</tr> 326</tr>
529<tr> 327<tr>
530 <ti><c>nol3</c></ti> 328 <ti><c>nol3</c></ti>
531 <ti> 329 <ti>
539 </ti> 337 </ti>
540</tr> 338</tr>
541<tr> 339<tr>
542 <ti><c>dopcmcia</c></ti> 340 <ti><c>dopcmcia</c></ti>
543 <ti> 341 <ti>
544 If you want to use PCMCIA devices during your installation (like PCMCIA 342 If you want to use PCMCIA devices during your installation (like PCMCIA
545 network cards) you have to enable this option. 343 network cards) you have to enable this option.
344 </ti>
345</tr>
346<tr>
347 <ti><c>dosshd</c></ti>
348 <ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
349</tr>
350<tr>
351 <ti><c>passwd=foo</c></ti>
352 <ti>
353 Sets whatever is after the = as the root password. Use with <c>dosshd</c>
354 for remote installs.
546 </ti> 355 </ti>
547</tr> 356</tr>
548</table> 357</table>
549 358
550<p> 359<p>
551At this prompt, hit enter, and a complete Gentoo Linux environment will be 360To use the above options, at the <e>boot:</e> prompt, type <e>ppc32</e> followed
552loaded from the CD. Continue with <uri link="#booted">And When You're 361by the desired option. In the example below, we'll force the kernel to use the
553Booted...</uri>. 362Open Firmware framebuffer instead of the device specific driver.
363</p>
364
365<pre caption="Force the use of the Open Firmware framebuffer">
366boot: <i>ppc32 video=ofonly</i>
367</pre>
368
369<p>
370If you don't need to add any options, just type ppc32 at this prompt, and a
371complete Gentoo Linux environment will be loaded from the CD. Continue with
372<uri link="#booted">And When You're Booted...</uri>.
554</p> 373</p>
555 374
556</body> 375</body>
557</subsection> 376</subsection>
558<subsection> 377<subsection>
561 380
562<p> 381<p>
563On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type 382On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
564<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose 383<c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
565between several preconfigured video configs. If you need any special boot 384between several preconfigured video configs. If you need any special boot
566options you can append them to the command-line. For instance <c>boot cd 385options you can append them to the command-line just like with Yaboot above.
567/boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. The complete list of 386For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
568kernel appends (in case something goes wrong and you need it) is preconfigured 387The default kernel options (in case something goes wrong and you need it) are
569in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc 388preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
570looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>. 389looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
571</p> 390</p>
572 391
573</body> 392</body>
574</subsection> 393</subsection>
575 394
577<title>Alternative: Booting the Installation CD with BootX</title> 396<title>Alternative: Booting the Installation CD with BootX</title>
578<body> 397<body>
579 398
580<p> 399<p>
581If you have an OldWorld Mac the bootable portion of the livecd can't be used. 400If you have an OldWorld Mac the bootable portion of the livecd can't be used.
582The most simple solution is to use MacOS to bootstrap into a Linux environment 401The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
583with a tool called BootX. Boot floppies are being prepared for Macs without 402environment with a tool called BootX.
584MacOS, but they are not available at this time.
585</p>
586
587<p> 403</p>
404
405<p>
588First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri> 406First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
589and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked 407and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
590archive into <c>Extensions Folder</c> and the BootX App Control Panel into 408archive into <c>Extensions Folder</c> and the BootX App Control Panel into
591<c>Control Panels</c>, both of which are located in your MacOS System Folder. 409<c>Control Panels</c>, both of which are located in your MacOS System Folder.
592Next, create a folder called "Linux Kernels" in your System folder and copy the 410Next, create a folder called "Linux Kernels" in your System folder and copy the
593<c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c> 411<c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c>
594from the Installation CD <path>boot</path> folder into the MacOS 412from the Installation CD <path>boot</path> folder into the MacOS
595<c>System Folder</c>. 413<c>System Folder</c>.
596</p> 414</p>
597 415
598<p> 416<p>
599To prepare BootX, start the BootX App Control Panel. First select the Options 417To prepare BootX, start the BootX App Control Panel. First select the Options
600dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from 418dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from
601your System Folder. Continue back to the initial screen and ensure that the 419your System Folder. Continue back to the initial screen and ensure that the
602ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as 420ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
603shown below: 421shown below:
604</p> 422</p>
605 423
606<pre caption="BootX kernel arguments"> 424<pre caption="BootX kernel arguments">
607cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev 425cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
608</pre> 426</pre>
609 427
610<note> 428<note>
611The kernel parameters in the yaboot section above are also applicable here. 429The kernel parameters in the yaboot section above are also applicable here. You
430can append any of those options to the kernel arguments above.
612</note> 431</note>
613 432
614<p> 433<p>
615Check once more to make sure the settings are correct and then save the 434Check once more to make sure the settings are correct and then save the
616configuration. This saves typing just in case it doesn't boot or something is 435configuration. This saves typing just in case it doesn't boot or something is
617missing. Press the Linux button at the top of the window to boot into the 436missing. Press the Linux button at the top of the window. If everything goes
618Installation CD and continue with <uri link="#booted">And When 437correctly, it should boot into the Installation CD. Continue with
619You're Booted...</uri> 438<uri link="#booted">And When You're Booted...</uri>
620</p> 439</p>
621 440
622</body> 441</body>
623</subsection> 442</subsection>
624 443
627<body> 446<body>
628 447
629<p> 448<p>
630You will be greeted by a root ("#") prompt on the current console. You can also 449You will be greeted by a root ("#") prompt on the current console. You can also
631switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get 450switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
632back to the one you started on by pressing Alt-F1. Probably you have to hit 451back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
633Alt-fn-Fx on Apple machines. 452you may need to press Alt-fn-Fx on Apple machines.
634</p> 453</p>
635 454
636<p> 455<p>
637If you are installing Gentoo on a system with a non-US keyboard, use 456If you are installing Gentoo on a system with a non-US keyboard, use
638<c>loadkeys</c> to load the keymap for your keyboard. To list the available 457<c>loadkeys</c> to load the keymap for your keyboard. To list the available
639keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the 458keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
640Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
641are for ADB-based OldWorld machines.
642</p> 459</p>
643 460
644<pre caption="Listing available keymaps"> 461<pre caption="Listing available keymaps">
645<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided 462<comment>(PPC uses x86 keymaps on most systems.)</comment>
646 on the Installation CD are ADB keymaps and unusable with the Installation CD
647 kernel)</comment>
648# <i>ls /usr/share/keymaps/i386</i> 463# <i>ls /usr/share/keymaps/i386</i>
649</pre> 464</pre>
650 465
651<p> 466<p>
652Now load the keymap of your choice: 467Now load the keymap of your choice:
660Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. 475Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
661</p> 476</p>
662 477
663</body> 478</body>
664</subsection> 479</subsection>
665<subsection id="hardware">
666<title>Extra Hardware Configuration</title>
667<body>
668 480
669<p>
670When the Installation CD boots, it tries to detect all your hardware devices and
671loads the appropriate kernel modules to support your hardware. In the
672vast majority of cases, it does a very good job. However, in some cases, it may
673not auto-load the kernel modules you need. If the PCI auto-detection missed some
674of your system's hardware, you will have to load the appropriate kernel modules
675manually.
676</p>
677
678<p>
679In the next example we try to load the <c>airport</c> module. This module
680supports only the old Airport cards (b-net). AirportExtreme is currently not
681supported under Linux:
682</p>
683
684<pre caption="Loading kernel modules">
685# <i>modprobe airport</i>
686</pre>
687
688</body>
689</subsection> 481<subsection>
482<include href="hb-install-bootconfig.xml"/>
690<subsection> 483</subsection>
691<title>Optional: Tweaking Hard Disk Performance</title>
692<body>
693 484
694<p>
695If you are an advanced user, you might want to tweak the IDE hard disk
696performance using <c>hdparm</c>. With the <c>-tT</c> options you can
697test the performance of your disk (execute it several times to get a
698more precise impression):
699</p>
700
701<pre caption="Testing disk performance">
702# <i>hdparm -tT /dev/hda</i>
703</pre>
704
705<p>
706To tweak, you can use any of the following examples (or experiment
707yourself) which use <path>/dev/hda</path> as disk (substitute with your
708disk):
709</p>
710
711<pre caption="Tweaking hard disk performance">
712<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
713<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
714</pre>
715
716</body>
717</subsection>
718<subsection id="useraccounts">
719<title>Optional: User Accounts</title>
720<body>
721
722<p>
723If you plan on giving other people access to your installation
724environment or you want to chat using <c>irssi</c> without root privileges (for
725security reasons), you need to create the necessary user accounts and change
726the root password.
727</p>
728
729<p>
730To change the root password, use the <c>passwd</c> utility:
731</p>
732
733<pre caption="Changing the root password">
734# <i>passwd</i>
735New password: <comment>(Enter your new password)</comment>
736Re-enter password: <comment>(Re-enter your password)</comment>
737</pre>
738
739<p>
740To create a user account, we first enter their credentials, followed by
741its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
742In the next example, we create a user called &quot;john&quot;.
743</p>
744
745<pre caption="Creating a user account">
746# <i>useradd -m -G users john</i>
747# <i>passwd john</i>
748New password: <comment>(Enter john's password)</comment>
749Re-enter password: <comment>(Re-enter john's password)</comment>
750</pre>
751
752<p>
753You can change your user id from root to the newly created user by using
754<c>su</c>:
755</p>
756
757<pre caption="Changing user id">
758# <i>su - john</i>
759</pre>
760
761</body>
762</subsection>
763<subsection>
764<title>Optional: Viewing Documentation while Installing</title>
765<body>
766
767<p>
768If you want to view the Gentoo Handbook (either from-CD or online) during the
769installation, make sure you have created a user account (see <uri
770link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
771go to a new terminal and log in.
772</p>
773
774<p>
775If you want to view the documentation on the CD you can immediately run
776<c>links2</c> to read it:
777</p>
778
779<pre caption="Viewing the on-CD documentation">
780# <i>links2 /mnt/cdrom/docs/html/index.html</i>
781</pre>
782
783<p>
784However, it is preferred that you use the online Gentoo Handbook as it will be
785more recent than the one provided on the CD. You can view it using <c>links2</c>
786as well, but only after having completed the <e>Configuring your Network</e>
787chapter (otherwise you won't be able to go on the Internet to view the
788document):
789</p>
790
791<pre caption="Viewing the Online Documentation">
792# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
793</pre>
794
795<p>
796You can go back to your original terminal by pressing <c>Alt-F1</c>.
797</p>
798
799</body>
800</subsection>
801<subsection>
802<title>Optional: Starting the SSH Daemon</title>
803<body>
804
805<p>
806If you want to allow other users to access your computer during the
807Gentoo installation (perhaps because those users are going to help you
808install Gentoo, or even do it for you), you need to create a user
809account for them and perhaps even provide them with your root password
810(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
811</p>
812
813<p>
814To fire up the SSH daemon, execute the following command:
815</p>
816
817<pre caption="Starting the SSH daemon">
818# <i>/etc/init.d/sshd start</i>
819</pre>
820
821<p>
822To be able to use sshd, you first need to set up your networking. Continue with
823the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
824</p>
825
826</body>
827</subsection>
828</section> 485</section>
829</sections> 486</sections>

Legend:
Removed from v.1.46  
changed lines
  Added in v.1.70

  ViewVC Help
Powered by ViewVC 1.1.20