/[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.48 Revision 1.70
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/2.5 --> 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.48 2005/10/09 16:33: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.6</version> 16<version>13</version>
12<date>2005-10-09</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>
130This approach builds core system packages that are vital to your system and is
131used by Gentoo developers to prepare the Gentoo release media. It is a great
132installation method for those who would like to learn more about the inner
133workings of bootstrapping, toolchains and the like.
134</p>
135
136<p>
137However, if you do not plan to tweak the bootstrapping instructions in the
138<path>bootstrap.sh</path> script written by the Gentoo developers, then a
139stage1 approach has no benefits for you.
140</p>
141
142<table>
143<tr>
144 <th>Stage1</th>
145 <th>Pros and Cons</th>
146</tr>
147<tr>
148 <th>+</th>
149 <ti>
150 Allows you to have total control over the installation routine, bootstrap
151 sequence, etc.
152 </ti>
153</tr>
154<tr>
155 <th>+</th>
156 <ti>Suitable for powerusers and developers who know what they are doing</ti>
157</tr>
158<tr>
159 <th>-</th>
160 <ti>
161 Takes a long time to finish the installation (it is the lengthiest approach)
162 </ti>
163</tr>
164<tr>
165 <th>-</th>
166 <ti>
167 If you don't intend to tweak the settings, it is a waste of time
168 </ti>
169</tr>
170<tr>
171 <th>-</th>
172 <ti>
173 Requires a working Internet connection during the installation
174 </ti>
175</tr>
176</table>
177
178</body>
179</subsection>
180<subsection>
181<title>A Stage2 Approach</title>
182<body>
183
184<p>
185A <e>stage2</e> is used for building the entire system from a bootstrapped
186"semi-compiled" state.
187</p>
188
189<p>
190When you perform a stage2 installation approach, you will build all system
191packages (core packages, including toolchain) using your specific <c>USE</c>,
192<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
193optimized to your preference.
194</p>
195
196<p>
197However, this installation takes some time and if you do not intend to change
198the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
199default", using this approach only makes sense if your <c>USE</c> variable is
200sufficiently different from the default <c>USE</c> we provide.
201</p>
202
203<table>
204<tr>
205 <th>Stage2</th>
206 <th>Pros and Cons</th>
207</tr>
208<tr>
209 <th>+</th>
210 <ti>You don't need to bootstrap</ti>
211</tr>
212<tr>
213 <th>+</th>
214 <ti>Faster than starting with stage1</ti>
215</tr>
216<tr>
217 <th>+</th>
218 <ti>You can still tweak your settings</ti>
219</tr>
220<tr>
221 <th>-</th>
222 <ti>It's still not the fastest way to install Gentoo</ti>
223</tr>
224<tr>
225 <th>-</th>
226 <ti>
227 Requires a working Internet connection during the installation
228 </ti>
229</tr>
230</table>
231
232</body>
233</subsection>
234<subsection>
235<title>A Stage3 Approach</title>
236<body>
237
238<p>
239A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
240built for you. You will only need to build a few packages (such as system
241logger, networking tools, ...) before you can boot into a base Gentoo
242installation.
243</p>
244
245<p>
246Choosing to go with a stage3 allows for the fastest install of Gentoo
247Linux, but also means that your base system will have the optimization
248settings that we chose for you (which to be honest, are good settings
249and were carefully chosen to enhance performance while maintaining
250stability). Stage3 is also required if you want to install Gentoo using
251prebuilt packages or without a network connection.
252</p>
253
254<table>
255<tr>
256 <th>Stage3</th>
257 <th>Pros and Cons</th>
258</tr>
259<tr>
260 <th>+</th>
261 <ti>Fastest way to get a Gentoo base system</ti>
262</tr>
263<tr>
264 <th>+</th>
265 <ti>
266 You can still tweak your system
267 </ti>
268</tr>
269</table>
270
271<p>
272You might be interested to know that, if you decide to use different
273optimization settings after having installed Gentoo, you will be able to
274recompile your entire system with the new optimization settings. The same goes
275for any <c>USE</c> flag changes: Portage is intelligent enough to know what
276packages need to be rebuild.
277</p>
278
279</body>
280</subsection>
281</section>
282
283<section> 89<section>
284<title>The Gentoo Installation CDs</title> 90<title>The Gentoo Installation CDs</title>
285<subsection> 91<subsection>
286<title>Introduction</title> 92<title>Introduction</title>
287<body> 93<body>
293are loaded. They are maintained by Gentoo developers. 99are loaded. They are maintained by Gentoo developers.
294</p> 100</p>
295 101
296<p> 102<p>
297All Installation CDs allow you to boot, set up networking, initialize your 103All Installation CDs allow you to boot, set up networking, initialize your
298partitions and start installing Gentoo from the Internet. We currently provide 104partitions and start installing Gentoo from the Internet.
299two Installation CDs which are equaly suitable to install Gentoo from, as long
300as you're planning on performing an Internet-based installation using the
301latest version of the available packages.
302</p>
303
304<p> 105</p>
106
107<!--
108<impo>
305If 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
306the installation instructions described in the <uri 110like to use one of the provided installers, please use the installation
307link="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<!--
308</p> 116<p>
309
310<p>
311The two Installation CDs that we currently provide are: 117The Installation CDs that we currently provide are:
312</p> 118</p>
313 119
314<ul> 120<ul>
315 <li> 121 <li>
316 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
317 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
318 continue with the Gentoo installation. 124 continue with the Gentoo installation.
319 </li> 125 </li>
320 <li> 126 <li>
321 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 127 The Universal Installation CD contains everything you need to install
322 abilities as the Minimal Installation CD. Additionally, it contains a 128 Gentoo. It provides stage3 files for common architectures, source code
323 stage1 and several stage3 tarballs (optimized for the individual 129 for the extra applications you need to choose from and, of course, the
324 subarchitectures). 130 installation instructions for your architecture.
325 </li> 131 </li>
326</ul> 132</ul>
327 133
328<p> 134<p>
329To 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
330major 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
331</p> 143<p>
332 144The use of the Package CD is covered later in this document.
145</p>
146-->
333</body> 147</body>
334</subsection>
335<subsection> 148</subsection>
149<subsection>
336<title>Gentoo's Minimal Installation CD</title> 150<title>Gentoo Minimal Installation CD</title>
337<body> 151<body>
338 152
339<p>
340The Minimal Installation CD is called <c>install-ppc-minimal-2005.1.iso</c> and
341takes up only 52 MB of diskspace. You can use this Installation CD to install
342Gentoo, but always with a working Internet connection only.
343</p> 153<p>
344 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<!--
345<table> 160<table>
346<tr> 161<tr>
347 <th>Minimal Installation CD</th> 162 <th>Minimal Installation CD</th>
348 <th>Pros and Cons</th> 163 <th>Pros and Cons</th>
349</tr> 164</tr>
350<tr> 165<tr>
351 <th>+</th> 166 <th>+</th>
352 <ti>Smallest download</ti> 167 <ti>Smallest download</ti>
353</tr> 168</tr>
354<tr> 169<tr>
355 <th>+</th>
356 <ti>
357 You can do a stage1, stage2 or stage3 by getting the stage tarball off the
358 net
359 </ti>
360</tr>
361<tr>
362 <th>-</th> 170 <th>-</th>
363 <ti> 171 <ti>
364 Contains no stages, no Portage snapshot, no prebuilt packages and is 172 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
365 therefore not suitable for networkless installation 173 is therefore not suitable for networkless installation
366 </ti> 174 </ti>
367</tr> 175</tr>
368</table> 176</table>
369 177-->
370</body> 178</body>
371</subsection>
372<subsection> 179</subsection>
373<title>Gentoo's Universal Installation CD</title>
374<body>
375
376<p>
377The Universal Installation CD is called <c>install-ppc-universal-2005.1.iso</c>
378and consumes the entire surface of a 650 MB CD. You can use this Installation
379CD to install Gentoo, and you can even use it to install Gentoo without a
380working internet connection, just in case you want to bring Gentoo to another
381PC than the one you are currently installing Gentoo on :)
382</p>
383
384<table>
385<tr>
386 <th>Universal Installation CD</th>
387 <th>Pros and Cons</th>
388</tr>
389<tr>
390 <th>+</th>
391 <ti>
392 Contains everything you need. You can even install without a network
393 connection.
394 </ti>
395</tr>
396<tr>
397 <th>-</th>
398 <ti>Huge download</ti>
399</tr>
400</table>
401
402</body>
403</subsection> 180<subsection>
404<subsection> 181<title>The Stage3 Tarball</title>
405<title>Other CDs</title>
406<body> 182<body>
407 183
408<p>
409You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is
410no Installation CD but an additional resource that can be exploited during a
411networkless installation. It contains prebuilt packages (the so-called GRP
412set) that allows you to easily and quickly install additional applications
413(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless
414Gentoo installation.
415</p> 184<p>
416 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>
417<p> 193</p>
418If you intend to use the Packages CD to quickly install additional software, 194
419make sure that you use the same subarchitecture as the stage-3 tarball you use. 195<p>
196Stage3 tarballs can be downloaded from <path><keyval
197id="release-dir"/>current-stage3/</path> on any of the <uri
198link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
199on the LiveCD.
420</p> 200</p>
421 201
422</body> 202</body>
423</subsection> 203</subsection>
424</section> 204</section>
205
206
425<!-- STOP --> 207<!-- STOP -->
426<section> 208<section>
427<title>Download, Burn and Boot a Gentoo Installation CD</title> 209<title>Download, Burn and Boot a Gentoo Installation CD</title>
428<subsection> 210<subsection>
429<title>Downloading and Burning the Installation CDs</title> 211<title>Downloading and Burning the Installation CDs</title>
430<body> 212<body>
431 213
432<p> 214<p>
433You 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
434downloading and burning the chosen Installation CD. We previously discussed 216downloading and burning the chosen Installation CD. We previously discussed
435the several available Installation CDs, but where can you find them? 217the several available Installation CDs, but where can you find them?
436</p>
437
438<p> 218</p>
439You can download any of the Installation CDs (and, if you want to, a Packages 219
440CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
441Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path>
442directory.
443</p> 220<p>
444 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.
445<p> 224</p>
225
226<p>
446Inside 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
447which you can write on a CD-R. 228can write on a CD-R.
448</p>
449
450<p> 229</p>
230
231<p>
451In 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
452check 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
453<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
454with the <c>md5sum</c> tool under Linux/Unix or 235checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
455<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If 236link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
456<c>md5sum</c> is not available on Mac OS X, see the
457<uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help.
458</p> 237</p>
459 238
460<p> 239<p>
461Another 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
462verify the cryptographic signature that we provide (the file ending with 241verify the cryptographic signature that we provide (the file ending with
463<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>.
464</p> 245</p>
465 246
466<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>
467$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> 249$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
468</pre> 250</pre>
469 251
470<p> 252<p>
471Now verify the signature: 253Now verify the signature:
472</p> 254</p>
473 255
474<pre caption="Verify the cryptographic signature"> 256<pre caption="Verify the files">
475$ <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>
476</pre> 261</pre>
477 262
478<p> 263<p>
479To 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
480do 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
482link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. 267link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
483</p> 268</p>
484 269
485<ul> 270<ul>
486 <li> 271 <li>
487 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
488 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
489 device path). 274 path).
490 </li> 275 </li>
491 <li> 276 <li>
492 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
493 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>.
494 <c>Start</c>.
495 </li> 279 </li>
496</ul> 280</ul>
497 281
498</body> 282</body>
499</subsection> 283</subsection>
501<title>Default: Booting the Installation CD with Yaboot</title> 285<title>Default: Booting the Installation CD with Yaboot</title>
502<body> 286<body>
503 287
504<p> 288<p>
505On 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
506system. 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
507CD loads. 291CD loads.
508</p> 292</p>
509 293
510<p> 294<p>
511After 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
512message 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.
513</p> 297</p>
514 298
515<p> 299<p>
516At 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
517We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
518support 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.
519well.
520</p>
521
522<p> 302</p>
303
304<p>
523You 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
524table lists some of the available boot options you can add: 306some of the available boot options you can add:
525</p> 307</p>
526 308
527<table> 309<table>
528<tr> 310<tr>
529 <th>Boot Option</th> 311 <th>Boot Option</th>
531</tr> 313</tr>
532<tr> 314<tr>
533 <ti><c>video</c></ti> 315 <ti><c>video</c></ti>
534 <ti> 316 <ti>
535 This option takes one of the following vendor-specific tags: 317 This option takes one of the following vendor-specific tags:
536 <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>,
537 <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
538 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,
539 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.
540 </ti> 325 </ti>
541</tr> 326</tr>
542<tr> 327<tr>
543 <ti><c>nol3</c></ti> 328 <ti><c>nol3</c></ti>
544 <ti> 329 <ti>
552 </ti> 337 </ti>
553</tr> 338</tr>
554<tr> 339<tr>
555 <ti><c>dopcmcia</c></ti> 340 <ti><c>dopcmcia</c></ti>
556 <ti> 341 <ti>
557 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
558 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.
559 </ti> 355 </ti>
560</tr> 356</tr>
561</table> 357</table>
562 358
563<p> 359<p>
564At 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
565loaded 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
566Booted...</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>.
567</p> 373</p>
568 374
569</body> 375</body>
570</subsection> 376</subsection>
571<subsection> 377<subsection>
574 380
575<p> 381<p>
576On 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
577<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
578between several preconfigured video configs. If you need any special boot 384between several preconfigured video configs. If you need any special boot
579options 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.
580/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>.
581kernel 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
582in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc 388preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
583looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>. 389looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
584</p> 390</p>
585 391
586</body> 392</body>
587</subsection> 393</subsection>
588 394
590<title>Alternative: Booting the Installation CD with BootX</title> 396<title>Alternative: Booting the Installation CD with BootX</title>
591<body> 397<body>
592 398
593<p> 399<p>
594If 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.
595The 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
596with a tool called BootX. Boot floppies are being prepared for Macs without 402environment with a tool called BootX.
597MacOS, but they are not available at this time.
598</p>
599
600<p> 403</p>
404
405<p>
601First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri> 406First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
602and 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
603archive 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
604<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.
605Next, 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
606<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>
607from the Installation CD <path>boot</path> folder into the MacOS 412from the Installation CD <path>boot</path> folder into the MacOS
608<c>System Folder</c>. 413<c>System Folder</c>.
609</p> 414</p>
610 415
611<p> 416<p>
612To 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
613dialog 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
614your 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
615ramdisk 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
616shown below: 421shown below:
617</p> 422</p>
618 423
619<pre caption="BootX kernel arguments"> 424<pre caption="BootX kernel arguments">
620cdroot 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
621</pre> 426</pre>
622 427
623<note> 428<note>
624The 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.
625</note> 431</note>
626 432
627<p> 433<p>
628Check 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
629configuration. 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
630missing. 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
631Installation CD and continue with <uri link="#booted">And When 437correctly, it should boot into the Installation CD. Continue with
632You're Booted...</uri> 438<uri link="#booted">And When You're Booted...</uri>
633</p> 439</p>
634 440
635</body> 441</body>
636</subsection> 442</subsection>
637 443
640<body> 446<body>
641 447
642<p> 448<p>
643You 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
644switch 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
645back 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,
646Alt-fn-Fx on Apple machines. 452you may need to press Alt-fn-Fx on Apple machines.
647</p> 453</p>
648 454
649<p> 455<p>
650If 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
651<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
652keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the 458keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
653Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
654are for ADB-based OldWorld machines.
655</p> 459</p>
656 460
657<pre caption="Listing available keymaps"> 461<pre caption="Listing available keymaps">
658<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided 462<comment>(PPC uses x86 keymaps on most systems.)</comment>
659 on the Installation CD are ADB keymaps and unusable with the Installation CD
660 kernel)</comment>
661# <i>ls /usr/share/keymaps/i386</i> 463# <i>ls /usr/share/keymaps/i386</i>
662</pre> 464</pre>
663 465
664<p> 466<p>
665Now load the keymap of your choice: 467Now load the keymap of your choice:
673Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. 475Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
674</p> 476</p>
675 477
676</body> 478</body>
677</subsection> 479</subsection>
678<subsection id="hardware">
679<title>Extra Hardware Configuration</title>
680<body>
681 480
682<p>
683When the Installation CD boots, it tries to detect all your hardware devices and
684loads the appropriate kernel modules to support your hardware. In the
685vast majority of cases, it does a very good job. However, in some cases, it may
686not auto-load the kernel modules you need. If the PCI auto-detection missed some
687of your system's hardware, you will have to load the appropriate kernel modules
688manually.
689</p>
690
691<p>
692In the next example we try to load the <c>airport</c> module. This module
693supports only the old Airport cards (b-net). AirportExtreme is currently not
694supported under Linux:
695</p>
696
697<pre caption="Loading kernel modules">
698# <i>modprobe airport</i>
699</pre>
700
701</body>
702</subsection> 481<subsection>
482<include href="hb-install-bootconfig.xml"/>
703<subsection> 483</subsection>
704<title>Optional: Tweaking Hard Disk Performance</title>
705<body>
706 484
707<p>
708If you are an advanced user, you might want to tweak the IDE hard disk
709performance using <c>hdparm</c>. With the <c>-tT</c> options you can
710test the performance of your disk (execute it several times to get a
711more precise impression):
712</p>
713
714<pre caption="Testing disk performance">
715# <i>hdparm -tT /dev/hda</i>
716</pre>
717
718<p>
719To tweak, you can use any of the following examples (or experiment
720yourself) which use <path>/dev/hda</path> as disk (substitute with your
721disk):
722</p>
723
724<pre caption="Tweaking hard disk performance">
725<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
726<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
727</pre>
728
729</body>
730</subsection>
731<subsection id="useraccounts">
732<title>Optional: User Accounts</title>
733<body>
734
735<p>
736If you plan on giving other people access to your installation
737environment or you want to chat using <c>irssi</c> without root privileges (for
738security reasons), you need to create the necessary user accounts and change
739the root password.
740</p>
741
742<p>
743To change the root password, use the <c>passwd</c> utility:
744</p>
745
746<pre caption="Changing the root password">
747# <i>passwd</i>
748New password: <comment>(Enter your new password)</comment>
749Re-enter password: <comment>(Re-enter your password)</comment>
750</pre>
751
752<p>
753To create a user account, we first enter their credentials, followed by
754its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
755In the next example, we create a user called &quot;john&quot;.
756</p>
757
758<pre caption="Creating a user account">
759# <i>useradd -m -G users john</i>
760# <i>passwd john</i>
761New password: <comment>(Enter john's password)</comment>
762Re-enter password: <comment>(Re-enter john's password)</comment>
763</pre>
764
765<p>
766You can change your user id from root to the newly created user by using
767<c>su</c>:
768</p>
769
770<pre caption="Changing user id">
771# <i>su - john</i>
772</pre>
773
774</body>
775</subsection>
776<subsection>
777<title>Optional: Viewing Documentation while Installing</title>
778<body>
779
780<p>
781If you want to view the Gentoo Handbook (either from-CD or online) during the
782installation, make sure you have created a user account (see <uri
783link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
784go to a new terminal and log in.
785</p>
786
787<p>
788If you want to view the documentation on the CD you can immediately run
789<c>links2</c> to read it:
790</p>
791
792<pre caption="Viewing the on-CD documentation">
793# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
794</pre>
795
796<p>
797However, it is preferred that you use the online Gentoo Handbook as it will be
798more recent than the one provided on the CD. You can view it using <c>links2</c>
799as well, but only after having completed the <e>Configuring your Network</e>
800chapter (otherwise you won't be able to go on the Internet to view the
801document):
802</p>
803
804<pre caption="Viewing the Online Documentation">
805# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
806</pre>
807
808<p>
809You can go back to your original terminal by pressing <c>Alt-F1</c>.
810</p>
811
812</body>
813</subsection>
814<subsection>
815<title>Optional: Starting the SSH Daemon</title>
816<body>
817
818<p>
819If you want to allow other users to access your computer during the
820Gentoo installation (perhaps because those users are going to help you
821install Gentoo, or even do it for you), you need to create a user
822account for them and perhaps even provide them with your root password
823(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
824</p>
825
826<p>
827To fire up the SSH daemon, execute the following command:
828</p>
829
830<pre caption="Starting the SSH daemon">
831# <i>/etc/init.d/sshd start</i>
832</pre>
833
834<p>
835To be able to use sshd, you first need to set up your networking. Continue with
836the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
837</p>
838
839</body>
840</subsection>
841</section> 485</section>
842</sections> 486</sections>

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

  ViewVC Help
Powered by ViewVC 1.1.20