/[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.53 Revision 1.54
… …
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.53 2006/07/25 18:01:45 josejx Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.54 2006/08/30 22:52:28 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.10</version> 11<version>7.0</version>
12<date>2006-07-25</date> 12<date>2006-08-30</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>
… …
77</p> 77</p>
78 78
79</body> 79</body>
80</subsection> 80</subsection>
81</section> 81</section>
82<!-- 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/ -->
83<!-- START --> 83<!-- START -->
84<section> 84<section>
85<title>The Gentoo Installation CDs</title> 85<title>The Gentoo Universal Installation CD</title>
86<subsection> 86<subsection>
87<title>Introduction</title> 87<title>Introduction</title>
88<body> 88<body>
89 89
90<p> 90<p>
91The <e>Gentoo Installation CDs</e> are bootable CDs which contain a 91Gentoo Linux can be installed using a <e>stage3</e> tarball file.
92self-sustained Gentoo environment. They allow you to boot Linux from the CD. 92Such a tarball is an archive that contains a minimal environment from
93During the boot process your hardware is detected and the appropriate drivers 93which you can succesfully install Gentoo Linux onto your system.
94are loaded. They are maintained by Gentoo developers.
95</p>
96
97<p> 94</p>
98All Installation CDs allow you to boot, set up networking, initialize your 95
99partitions and start installing Gentoo from the Internet. We currently provide
100two Installation CDs which are equaly suitable to install Gentoo from, as long
101as you're planning on performing an Internet-based installation using the
102latest version of the available packages.
103</p> 96<p>
104 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.
105<p> 100</p>
106If you wish to install Gentoo without a working Internet connection, please use 101
107the installation instructions described in the <uri 102</body>
108link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. 103</subsection>
104<subsection>
105<title>Gentoo Universal Installation CD</title>
106<body>
107
109</p> 108<p>
110 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.
111<p> 113</p>
112The two Installation CDs that we currently provide are: 114
115<p>
116There currently are two Installation CDs available:
113</p> 117</p>
114 118
115<ul> 119<ul>
116 <li> 120 <li>
117 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable 121 The Universal Installation CD contains everything you need to install
118 CD which sole purpose is to boot the system, prepare the networking and 122 Gentoo. It provides stage3 files for common architectures, source code
119 continue with the Gentoo installation. 123 for the extra applications you need to choose from and, of course, the
124 installation instructions for your architecture.
120 </li> 125 </li>
121 <li> 126 <li>
122 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
123 abilities as the Minimal Installation CD. Additionally, it contains 128 you to boot up and configure your network so you can connect to the
124 several stage3 tarballs (optimized for the individual subarchitectures). 129 Internet. It does not contain any additional files and cannot be used
130 during the current installation approach.
125 </li> 131 </li>
126</ul> 132</ul>
127 133
128<p> 134<p>
129To 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
130major advantages and disadvantages of each Installation CD. 136additional resource that you can exploit during the installation of your Gentoo
131</p> 137system. It contains prebuilt packages (also known as the GRP set) that allow
132
133</body>
134</subsection>
135<subsection>
136<title>Gentoo's Minimal Installation CD</title>
137<body>
138
139<p>
140The Minimal Installation CD is called <c>install-ppc-minimal-2006.0.iso</c> and
141takes up only 52 MB of diskspace. You can use this Installation CD to install
142Gentoo, but always with a working Internet connection only.
143</p>
144
145<table>
146<tr>
147 <th>Minimal Installation CD</th>
148 <th>Pros and Cons</th>
149</tr>
150<tr>
151 <th>+</th>
152 <ti>Smallest download</ti>
153</tr>
154<tr>
155 <th>-</th>
156 <ti>
157 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
158 therefore not suitable for networkless installation
159 </ti>
160</tr>
161</table>
162
163</body>
164</subsection>
165<subsection>
166<title>Gentoo's Universal Installation CD</title>
167<body>
168
169<p>
170The Universal Installation CD is called <c>install-ppc-universal-2006.0.iso</c>
171and consumes about 578 MB on a CD. You can use this Installation CD to install
172Gentoo, and you can even use it to install Gentoo without a working internet
173connection, just in case you want to bring Gentoo to another PC than the one
174you are currently installing Gentoo on :)
175</p>
176
177<table>
178<tr>
179 <th>Universal Installation CD</th>
180 <th>Pros and Cons</th>
181</tr>
182<tr>
183 <th>+</th>
184 <ti>
185 Contains everything you need. You can even install without a network
186 connection.
187 </ti>
188</tr>
189<tr>
190 <th>-</th>
191 <ti>Huge download</ti>
192</tr>
193</table>
194
195</body>
196</subsection>
197<subsection>
198<title>Other CDs</title>
199<body>
200
201<p>
202You might find a <e>Package CD</e> on one of our mirrors. This CD is not an
203Installation CD but an additional resource that can be exploited during a
204networkless installation. It contains prebuilt packages (also known as the GRP
205set) that allow you to easily and quickly install additional applications (such 138you to easily and quickly install additional applications (such as
206as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo 139OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
207installation. 140right before you update your Portage tree.
208</p>
209
210<p> 141</p>
211If you intend to use the Packages CD to quickly install additional software, 142
212make sure that you use the same subarchitecture as the stage3 tarball you use.
213</p> 143<p>
214 144The use of the Package CD is covered later in this document.
215</body>
216</subsection>
217<subsection>
218<title>The Stage3 Tarball</title>
219<body>
220
221<p>
222A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
223to continue the Gentoo installation using the instructions in this manual.
224Previously, the Gentoo Handbook described the installation using one of three
225stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
226official installation method uses the stage3 tarball. If you are interested in
227performing a Gentoo installation using a stage1 or stage2 tarball, please read
228the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
229Using a Stage1 or Stage2 Tarball?</uri>
230</p> 145</p>
231 146
232</body> 147</body>
233</subsection> 148</subsection>
234</section> 149</section>
235<!-- STOP --> 150<!-- STOP -->
236<section> 151<section>
237<title>Download, Burn and Boot a Gentoo Installation CD</title> 152<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
238<subsection> 153<subsection>
239<title>Downloading and Burning the Installation CDs</title> 154<title>Downloading and Burning the Installation CD</title>
240<body> 155<body>
241 156
242<p>
243You have chosen to use a Gentoo Installation CD. We'll first start by
244downloading and burning the chosen Installation CD. We previously discussed
245the several available Installation CDs, but where can you find them?
246</p> 157<p>
247 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
161in the <path>releases/ppc/2006.1/ppc32/installcd</path> directory;
162the Package CDs are located in the
163<path>releases/ppc/2006.1/ppc32/packagecd</path> directory.
248<p> 164</p>
249You can download any of the Installation CDs (and, if you want to, a Packages 165
250CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
251Installation CDs are located in the <path>releases/ppc/2006.0/ppc32/installcd</path>
252directory.
253</p> 166<p>
254
255<p>
256Inside that directory you'll find ISO-files. Those are full CD images which you 167Inside those directories you'll find ISO-files. Those are full CD images which
257can write on a CD-R. 168you can write on a CD-R.
258</p>
259
260<p> 169</p>
261In case you wonder if your downloaded file is corrupted or not, you can 170
171<p>
172After downloading the file, you can verify its integrity to see if it is
173corrupted or not:
174</p>
175
176<ul>
177 <li>
262check its MD5 checksum and compare it with the MD5 checksum we provide (such as 178 You can check its MD5 checksum and compare it with the MD5 checksum we
263<path>install-ppc-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 checksum
264with the <c>md5sum</c> tool under Linux/Unix or 179 provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
265<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If 180 <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows).
266<c>md5sum</c> is not available on Mac OS X, see the 181 Verifying MD5 checksums with Mac OS X is described in the <uri
267<uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help. 182 link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
183 </li>
184 <li>
185 You can verify the cryptographic signature that we provide. You need to
186 obtain the public key we use (0x17072058) before you proceed though.
187 </li>
188</ul>
189
268</p> 190<p>
269 191To fetch our public key using the GnuPG application, run the following command:
270<p>
271Another way to check the validity of the downloaded file is to use GnuPG to
272verify the cryptographic signature that we provide (the file ending with
273<path>.asc</path>). Download the signature file and obtain the public key:
274</p> 192</p>
275 193
276<pre caption="Obtaining the public key"> 194<pre caption="Obtaining the public key">
277$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i> 195$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
278</pre> 196</pre>
279 197
280<p> 198<p>
281Now verify the signature: 199Now verify the signature:
282</p> 200</p>
… …
292link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. 210link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
293</p> 211</p>
294 212
295<ul> 213<ul>
296 <li> 214 <li>
297 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso 215 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
298 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's 216 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
299 device path). 217 path).
300 </li> 218 </li>
301 <li> 219 <li>
302 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then 220 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
303 you can locate your ISO file within the 'Image to Burn' area. Finally click 221 you can locate your ISO file within the 'Image to Burn' area. Finally click
304 <c>Start</c>. 222 <c>Start</c>.
… …
311<title>Default: Booting the Installation CD with Yaboot</title> 229<title>Default: Booting the Installation CD with Yaboot</title>
312<body> 230<body>
313 231
314<p> 232<p>
315On NewWorld machines place the Installation CD in the CD-ROM and reboot the 233On NewWorld machines place the Installation CD in the CD-ROM and reboot the
316system. When the system-start-bell sounds, simply hold down the 'C' until the 234system. When the system-start-bell sounds, simply hold down the 'C' until the
317CD loads. 235CD loads.
318</p> 236</p>
319 237
320<p> 238<p>
321After the Installation CD loaded, you will be greeted by a friendly welcome 239After the Installation CD loaded, you will be greeted by a friendly welcome
322message and a <e>boot:</e> prompt at the bottom of the screen. 240message and a <e>boot:</e> prompt at the bottom of the screen.
323</p> 241</p>
324 242
325<p> 243<p>
326We provide one generic kernel, <e>ppc32</e>. This kernel is built with support 244We provide one generic kernel, <e>apple</e>. This kernel is built with support
327for multiple CPUs, but it will boot on single processor machines as well. 245for multiple CPUs, but it will boot on single processor machines as well.
328</p> 246</p>
329 247
330<p> 248<p>
331You can tweak some kernel options at this prompt. The following table lists 249You can tweak some kernel options at this prompt. The following table lists
… …
363 </ti> 281 </ti>
364</tr> 282</tr>
365<tr> 283<tr>
366 <ti><c>dopcmcia</c></ti> 284 <ti><c>dopcmcia</c></ti>
367 <ti> 285 <ti>
368 If you want to use PCMCIA devices during your installation (like PCMCIA 286 If you want to use PCMCIA devices during your installation (like PCMCIA
369 network cards) you have to enable this option. 287 network cards) you have to enable this option.
370 </ti> 288 </ti>
371</tr> 289</tr>
372</table> 290</table>
373 291
374<p> 292<p>
375To use the above options, at the <e>boot:</e> prompt, type <e>ppc32</e> followed 293To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
376by the desired option. In the example below, we'll force the kernel to use the 294by the desired option. In the example below, we'll force the kernel to use the
377OpenFirmware framebuffer instead of the device specific driver. 295OpenFirmware framebuffer instead of the device specific driver.
378</p> 296</p>
379 297
380<pre caption="Force the use of the OpenFirmware framebuffer"> 298<pre caption="Force the use of the OpenFirmware framebuffer">
381boot: <i>ppc32 video=ofonly</i> 299boot: <i>apple video=ofonly</i>
382</pre> 300</pre>
383 301
384<p> 302<p>
385If you don't need to add any options, just hit enter at this prompt, and a 303If you don't need to add any options, just hit enter at this prompt, and a
386complete Gentoo Linux environment will be loaded from the CD. Continue with 304complete Gentoo Linux environment will be loaded from the CD. Continue with
… …
399between several preconfigured video configs. If you need any special boot 317between several preconfigured video configs. If you need any special boot
400options you can append them to the command-line just like with Yaboot above. 318options you can append them to the command-line just like with Yaboot above.
401For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. 319For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
402The default kernel options (in case something goes wrong and you need it) are 320The default kernel options (in case something goes wrong and you need it) are
403preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc 321preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
404looptype=squashfs loop=/image.squashfs udev nodevfs cdroot root=/dev/ram0</c>. 322looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
405</p> 323</p>
406 324
407</body> 325</body>
408</subsection> 326</subsection>
409 327
… …
421First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri> 339First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
422and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked 340and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
423archive into <c>Extensions Folder</c> and the BootX App Control Panel into 341archive into <c>Extensions Folder</c> and the BootX App Control Panel into
424<c>Control Panels</c>, both of which are located in your MacOS System Folder. 342<c>Control Panels</c>, both of which are located in your MacOS System Folder.
425Next, create a folder called "Linux Kernels" in your System folder and copy the 343Next, create a folder called "Linux Kernels" in your System folder and copy the
426<c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c> 344<c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c>
427from the Installation CD <path>boot</path> folder into the MacOS 345from the Installation CD <path>boot</path> folder into the MacOS
428<c>System Folder</c>. 346<c>System Folder</c>.
429</p> 347</p>
430 348
431<p> 349<p>
432To prepare BootX, start the BootX App Control Panel. First select the Options 350To prepare BootX, start the BootX App Control Panel. First select the Options
433dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from 351dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
434your System Folder. Continue back to the initial screen and ensure that the 352your System Folder. Continue back to the initial screen and ensure that the
435ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as 353ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
436shown below: 354shown below:
437</p> 355</p>
438 356
439<pre caption="BootX kernel arguments"> 357<pre caption="BootX kernel arguments">
440cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0 nodevfs udev 358cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
441</pre> 359</pre>
442 360
443<note> 361<note>
444The kernel parameters in the yaboot section above are also applicable here. You 362The kernel parameters in the yaboot section above are also applicable here. You
445can append any of those options to the kernel arguments above. 363can append any of those options to the kernel arguments above.
… …
468</p> 386</p>
469 387
470<p> 388<p>
471If you are installing Gentoo on a system with a non-US keyboard, use 389If you are installing Gentoo on a system with a non-US keyboard, use
472<c>loadkeys</c> to load the keymap for your keyboard. To list the available 390<c>loadkeys</c> to load the keymap for your keyboard. To list the available
473keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the 391keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
474Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they 392Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
475are for ADB-based OldWorld machines. 393are for ADB-based OldWorld machines.
476</p> 394</p>
477 395
478<pre caption="Listing available keymaps"> 396<pre caption="Listing available keymaps">
… …
506vast majority of cases, it does a very good job. However, in some cases, it may 424vast majority of cases, it does a very good job. However, in some cases, it may
507not auto-load the kernel modules you need. If the PCI auto-detection missed some 425not auto-load the kernel modules you need. If the PCI auto-detection missed some
508of your system's hardware, you will have to load the appropriate kernel modules 426of your system's hardware, you will have to load the appropriate kernel modules
509manually. 427manually.
510</p> 428</p>
511 429
512<p> 430<p>
513In the next example we try to load the <c>airport</c> module. This module 431In the next example we try to load the <c>airport</c> module. This module
514supports only the old Airport cards (802.11b). Airport Extreme (802.11g) is not 432supports only the old Airport cards (802.11b). Airport Extreme (802.11g) is not
515supported on the InstallCD due to restrictions on firmware distribution. 433supported on the InstallCD due to restrictions on firmware distribution.
516</p> 434</p>
517 435
518<pre caption="Loading the airport module"> 436<pre caption="Loading the airport module">
519# <i>modprobe airport</i> 437# <i>modprobe airport</i>
520</pre> 438</pre>
521 439
522<p> 440<p>
523On older iMacs, sometimes the network card is not detected properly. These use 441On older iMacs, sometimes the network card is not detected properly. These use
524the BMAC driver: 442the BMAC driver:
525</p> 443</p>
526 444
… …
614go to a new terminal and log in. 532go to a new terminal and log in.
615</p> 533</p>
616 534
617<p> 535<p>
618If 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
619<c>links</c> to read it: 537<c>links</c> or even <c>links -g</c> for a graphical framebuffer browser to
538read it:
620</p> 539</p>
621 540
622<pre caption="Viewing the on-CD documentation"> 541<pre caption="Viewing the on-CD documentation">
623# <i>links /mnt/cdrom/docs/handbook/html/index.html</i> 542# <i>links /mnt/cdrom/docs/html/index.html</i>
624</pre> 543</pre>
625 544
626<p> 545<p>
627However, 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
628more recent than the one provided on the CD. You can view it using <c>links</c> 547more recent than the one provided on the CD. You can view it using <c>links</c>
Legend:
Removed from v.1.53  
changed lines
  Added in v.1.54
  ViewVC Help
Powered by ViewVC 1.1.13