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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.71 - (hide annotations) (download) (as text)
Mon Nov 12 21:04:16 2012 UTC (23 months, 1 week ago) by swift
Branch: MAIN
Changes since 1.70: +7 -7 lines
File MIME type: application/xml
Fix bug #442686 - Book still referred to md5sum but only SHA-2 and Whirlpool is used

1 swift 1.1 <?xml version='1.0' encoding='UTF-8'?>
2     <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3    
4     <!-- The content of this document is licensed under the CC-BY-SA license -->
5 neysx 1.47 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 swift 1.1
7 swift 1.71 <!-- $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 swift 1.1
9     <sections>
10 swift 1.32
11 nightmorph 1.64 <abstract>
12     You can install Gentoo in many ways. This chapter explains how to install
13     Gentoo using the minimal Installation CD.
14     </abstract>
15    
16 swift 1.71 <version>14</version>
17     <date>2012-11-12</date>
18 swift 1.32
19 swift 1.1 <section>
20     <title>Hardware Requirements</title>
21     <subsection>
22     <title>Introduction</title>
23     <body>
24    
25     <p>
26     Before we start, we first list what hardware requirements you need to
27 swift 1.35 successfully install Gentoo on your box.
28 swift 1.1 </p>
29    
30     </body>
31     </subsection>
32     <subsection>
33 swift 1.35 <title>Hardware Requirements</title>
34 swift 1.1 <body>
35    
36 swift 1.35 <table>
37     <tr>
38 swift 1.45 <th>Apple NewWorld Machines</th>
39 swift 1.35 <ti>
40     Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
41 swift 1.45 PowerBook, Xserver, PowerMac
42 swift 1.35 </ti>
43     </tr>
44     <tr>
45 swift 1.45 <th>Apple OldWorld machines</th>
46 swift 1.35 <ti>
47 nightmorph 1.57 Apple Machines with an Open Firmware revision less than 3, such as the Beige
48 nightmorph 1.63 G3s, PCI PowerMacs and PCI PowerBooks. PCI-based Apple Clones should also
49 swift 1.45 be supported.
50     </ti>
51     </tr>
52     <tr>
53 nightmorph 1.55 <th>Genesi</th>
54 swift 1.45 <ti>
55 nightmorph 1.55 Pegasos I/II, Open Desktop Workstation, Efika
56 swift 1.45 </ti>
57     </tr>
58     <tr>
59     <th>IBM</th>
60     <ti>
61     RS/6000, iSeries, pSeries
62 swift 1.35 </ti>
63     </tr>
64     <tr>
65     <th>Memory</th>
66 swift 1.39 <ti>At least 64 MB</ti>
67 swift 1.35 </tr>
68     <tr>
69     <th>Diskspace</th>
70     <ti>1.5 GB (excluding swap space)</ti>
71     </tr>
72     <tr>
73     <th>Swap space</th>
74     <ti>At least 256 MB</ti>
75     </tr>
76     </table>
77    
78 swift 1.1 <p>
79 fox2mike 1.52 Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
80     for help with some common installation related issues or if you're unsure as to
81     just what's in that PowerPC machine you've got sitting on your desk right now.
82 swift 1.1 </p>
83    
84     </body>
85     </subsection>
86     </section>
87 nightmorph 1.60
88 swift 1.35 <!-- START -->
89 swift 1.1 <section>
90 nightmorph 1.63 <title>The Gentoo Installation CDs</title>
91 swift 1.1 <subsection>
92 swift 1.35 <title>Introduction</title>
93 swift 1.1 <body>
94    
95     <p>
96 nightmorph 1.63 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
97     self-sustained Gentoo environment. They allow you to boot Linux from the CD.
98     During the boot process your hardware is detected and the appropriate drivers
99     are loaded. They are maintained by Gentoo developers.
100 swift 1.1 </p>
101    
102     <p>
103 nightmorph 1.63 All Installation CDs allow you to boot, set up networking, initialize your
104     partitions and start installing Gentoo from the Internet.
105 swift 1.35 </p>
106    
107 nightmorph 1.63 <!--
108     <impo>
109     If you wish to install Gentoo without a working Internet connection, or would
110     like to use one of the provided installers, please use the installation
111     instructions described in the <uri link="2008.0/">Gentoo 2008.0
112     Handbooks</uri>.
113     </impo>
114     -->
115     <!--
116 swift 1.35 <p>
117 nightmorph 1.63 The Installation CDs that we currently provide are:
118 swift 1.35 </p>
119    
120     <ul>
121     <li>
122 nightmorph 1.63 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
123     CD which sole purpose is to boot the system, prepare the networking and
124     continue with the Gentoo installation.
125     </li>
126     <li>
127 nightmorph 1.54 The Universal Installation CD contains everything you need to install
128     Gentoo. It provides stage3 files for common architectures, source code
129     for the extra applications you need to choose from and, of course, the
130     installation instructions for your architecture.
131 swift 1.35 </li>
132     </ul>
133    
134     <p>
135 nightmorph 1.54 Gentoo also provides a Package CD. This is not an Installation CD but an
136     additional resource that you can exploit during the installation of your Gentoo
137     system. It contains prebuilt packages (also known as the GRP set) that allow
138     you to easily and quickly install additional applications (such as
139     OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
140     right before you update your Portage tree.
141 swift 1.35 </p>
142    
143 swift 1.48 <p>
144 nightmorph 1.54 The use of the Package CD is covered later in this document.
145 swift 1.48 </p>
146 nightmorph 1.63 -->
147     </body>
148     </subsection>
149     <subsection>
150     <title>Gentoo Minimal Installation CD</title>
151     <body>
152    
153     <p>
154     The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
155 swift 1.69 takes up around <keyval id="min-cd-size"/> MB of diskspace. You can use this
156 nightmorph 1.63 Installation CD to install Gentoo, but <e>only</e> with a working Internet
157     connection.
158     </p>
159     <!--
160     <table>
161     <tr>
162     <th>Minimal Installation CD</th>
163     <th>Pros and Cons</th>
164     </tr>
165     <tr>
166     <th>+</th>
167     <ti>Smallest download</ti>
168     </tr>
169     <tr>
170     <th>-</th>
171     <ti>
172     Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
173     is therefore not suitable for networkless installation
174     </ti>
175     </tr>
176     </table>
177     -->
178     </body>
179     </subsection>
180     <subsection>
181     <title>The Stage3 Tarball</title>
182     <body>
183    
184     <p>
185     A stage3 tarball is an archive containing a minimal Gentoo environment,
186     suitable to continue the Gentoo installation using the instructions in this
187     manual. Previously, the Gentoo Handbook described the installation using one of
188     three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
189     official installation method uses the stage3 tarball. If you are interested in
190     performing a Gentoo installation using a stage1 or stage2 tarball, please read
191     the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
192     Using a Stage1 or Stage2 Tarball?</uri>
193     </p>
194    
195     <p>
196     Stage3 tarballs can be downloaded from <path><keyval
197     id="release-dir"/>current-stage3/</path> on any of the <uri
198     link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
199     on the LiveCD.
200     </p>
201 swift 1.48
202 swift 1.35 </body>
203     </subsection>
204 swift 1.1 </section>
205 nightmorph 1.63
206    
207 swift 1.35 <!-- STOP -->
208 swift 1.1 <section>
209 nightmorph 1.63 <title>Download, Burn and Boot a Gentoo Installation CD</title>
210 swift 1.1 <subsection>
211 nightmorph 1.63 <title>Downloading and Burning the Installation CDs</title>
212 swift 1.1 <body>
213    
214     <p>
215 nightmorph 1.63 You have chosen to use a Gentoo Installation CD. We'll first start by
216     downloading and burning the chosen Installation CD. We previously discussed
217     the several available Installation CDs, but where can you find them?
218     </p>
219    
220     <p>
221     You can download any of the Installation CDs from one of our <uri
222 nightmorph 1.55 link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
223 nightmorph 1.63 the <path><keyval id="release-dir"/>current-iso/</path> directory.
224 swift 1.35 </p>
225    
226     <p>
227 nightmorph 1.63 Inside that directory you'll find ISO files. Those are full CD images which you
228     can write on a CD-R.
229 swift 1.1 </p>
230    
231     <p>
232 nightmorph 1.63 In case you wonder if your downloaded file is corrupted or not, you can check
233 swift 1.71 its SHA-2 checksum and compare it with the SHA-2 checksum we provide (such as
234     <path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the SHA-2
235     checksum with the <c>sha512sum</c> tool under Linux/Unix or <uri
236     link="http://www.krylack.com/file-checksum-tool/">File Checksum Tool</uri> for Windows.
237 swift 1.1 </p>
238    
239     <p>
240 nightmorph 1.63 Another way to check the validity of the downloaded file is to use GnuPG to
241     verify the cryptographic signature that we provide (the file ending with
242 swift 1.70 <path>.asc</path>). Download the signature file and obtain the public keys whose
243     key ids can be found on the <uri link="/proj/en/releng/index.xml">release
244     engineering project site</uri>.
245 swift 1.12 </p>
246    
247 swift 1.35 <pre caption="Obtaining the public key">
248 swift 1.70 <comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
249 swift 1.68 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
250 swift 1.12 </pre>
251    
252     <p>
253 swift 1.35 Now verify the signature:
254 swift 1.12 </p>
255    
256 nightmorph 1.63 <pre caption="Verify the files">
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>
261 swift 1.35 </pre>
262 swift 1.12
263     <p>
264 swift 1.1 To burn the downloaded ISO(s), you have to select raw-burning. How you
265 swift 1.35 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
266     <c>K3B</c> here; more information can be found in our <uri
267     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
268 swift 1.1 </p>
269    
270     <ul>
271     <li>
272 nightmorph 1.54 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
273     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
274     path).
275 swift 1.1 </li>
276     <li>
277 nightmorph 1.56 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
278     your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
279 swift 1.3 </li>
280 swift 1.1 </ul>
281    
282     </body>
283     </subsection>
284     <subsection>
285 josejx 1.41 <title>Default: Booting the Installation CD with Yaboot</title>
286 swift 1.1 <body>
287    
288     <p>
289 swift 1.39 On NewWorld machines place the Installation CD in the CD-ROM and reboot the
290 nightmorph 1.54 system. When the system-start-bell sounds, simply hold down the 'C' until the
291 swift 1.39 CD loads.
292 dertobi123 1.17 </p>
293    
294     <p>
295 swift 1.39 After the Installation CD loaded, you will be greeted by a friendly welcome
296     message and a <e>boot:</e> prompt at the bottom of the screen.
297 swift 1.1 </p>
298    
299     <p>
300 josejx 1.65 We provide one generic kernel, <e>ppc32</e>. This kernel is built with support
301 fox2mike 1.52 for multiple CPUs, but it will boot on single processor machines as well.
302 swift 1.1 </p>
303    
304     <p>
305 fox2mike 1.52 You can tweak some kernel options at this prompt. The following table lists
306     some of the available boot options you can add:
307 swift 1.1 </p>
308    
309     <table>
310     <tr>
311     <th>Boot Option</th>
312     <th>Description</th>
313     </tr>
314     <tr>
315     <ti><c>video</c></ti>
316     <ti>
317     This option takes one of the following vendor-specific tags:
318 fox2mike 1.52 <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
319     <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
320     refresh rate and color depth you want to use. For instance,
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.
325 swift 1.1 </ti>
326     </tr>
327     <tr>
328 pylon 1.2 <ti><c>nol3</c></ti>
329 swift 1.1 <ti>
330 dertobi123 1.17 Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
331 swift 1.1 </ti>
332     </tr>
333     <tr>
334 swift 1.39 <ti><c>dofirewire</c></ti>
335 swift 1.1 <ti>
336 swift 1.39 Enables support for IEEE1394 (FireWire) devices, like external harddisks.
337 swift 1.1 </ti>
338     </tr>
339 swift 1.7 <tr>
340 swift 1.39 <ti><c>dopcmcia</c></ti>
341 swift 1.7 <ti>
342 nightmorph 1.54 If you want to use PCMCIA devices during your installation (like PCMCIA
343     network cards) you have to enable this option.
344 swift 1.7 </ti>
345     </tr>
346 nightmorph 1.60 <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.
355     </ti>
356     </tr>
357 swift 1.1 </table>
358    
359     <p>
360 josejx 1.65 To use the above options, at the <e>boot:</e> prompt, type <e>ppc32</e> followed
361 josejx 1.53 by the desired option. In the example below, we'll force the kernel to use the
362 nightmorph 1.57 Open Firmware framebuffer instead of the device specific driver.
363 josejx 1.53 </p>
364    
365 nightmorph 1.57 <pre caption="Force the use of the Open Firmware framebuffer">
366 josejx 1.65 boot: <i>ppc32 video=ofonly</i>
367 josejx 1.53 </pre>
368    
369     <p>
370 josejx 1.65 If you don't need to add any options, just type ppc32 at this prompt, and a
371 josejx 1.53 complete Gentoo Linux environment will be loaded from the CD. Continue with
372     <uri link="#booted">And When You're Booted...</uri>.
373 swift 1.1 </p>
374    
375 swift 1.7 </body>
376     </subsection>
377     <subsection>
378 swift 1.39 <title>Alternative: Booting the Installation CD on a Pegasos</title>
379 swift 1.7 <body>
380    
381 swift 1.1 <p>
382 swift 1.7 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
383 swift 1.39 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
384     between several preconfigured video configs. If you need any special boot
385 fox2mike 1.52 options you can append them to the command-line just like with Yaboot above.
386     For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
387     The default kernel options (in case something goes wrong and you need it) are
388     preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
389 nightmorph 1.54 looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
390 swift 1.1 </p>
391    
392 swift 1.7 </body>
393     </subsection>
394 josejx 1.41
395     <subsection>
396     <title>Alternative: Booting the Installation CD with BootX</title>
397     <body>
398    
399     <p>
400     If you have an OldWorld Mac the bootable portion of the livecd can't be used.
401 josejx 1.53 The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
402     environment with a tool called BootX.
403 josejx 1.41 </p>
404 swift 1.45
405 josejx 1.41 <p>
406 grahl 1.58 First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
407 josejx 1.41 and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
408     archive into <c>Extensions Folder</c> and the BootX App Control Panel into
409     <c>Control Panels</c>, both of which are located in your MacOS System Folder.
410 josejx 1.42 Next, create a folder called "Linux Kernels" in your System folder and copy the
411 josejx 1.65 <c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c>
412 josejx 1.42 from the Installation CD <path>boot</path> folder into the MacOS
413     <c>System Folder</c>.
414 josejx 1.41 </p>
415 swift 1.45
416 josejx 1.41 <p>
417     To prepare BootX, start the BootX App Control Panel. First select the Options
418 josejx 1.65 dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from
419 josejx 1.41 your System Folder. Continue back to the initial screen and ensure that the
420     ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
421     shown below:
422     </p>
423    
424     <pre caption="BootX kernel arguments">
425 nightmorph 1.54 cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
426 josejx 1.41 </pre>
427 swift 1.45
428 josejx 1.41 <note>
429 fox2mike 1.52 The kernel parameters in the yaboot section above are also applicable here. You
430     can append any of those options to the kernel arguments above.
431 josejx 1.41 </note>
432 swift 1.45
433 josejx 1.41 <p>
434     Check once more to make sure the settings are correct and then save the
435     configuration. This saves typing just in case it doesn't boot or something is
436 fox2mike 1.52 missing. Press the Linux button at the top of the window. If everything goes
437     correctly, it should boot into the Installation CD. Continue with
438     <uri link="#booted">And When You're Booted...</uri>
439 josejx 1.41 </p>
440 swift 1.45
441 josejx 1.41 </body>
442     </subsection>
443    
444 swift 1.7 <subsection id="booted">
445     <title>And When You're Booted...</title>
446     <body>
447 swift 1.1
448     <p>
449 swift 1.7 You will be greeted by a root ("#") prompt on the current console. You can also
450 swift 1.39 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
451 fox2mike 1.52 back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
452     you may need to press Alt-fn-Fx on Apple machines.
453 swift 1.1 </p>
454    
455     <p>
456     If you are installing Gentoo on a system with a non-US keyboard, use
457     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
458 nightmorph 1.62 keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
459 swift 1.1 </p>
460    
461     <pre caption="Listing available keymaps">
462 nightmorph 1.62 <comment>(PPC uses x86 keymaps on most systems.)</comment>
463 swift 1.1 # <i>ls /usr/share/keymaps/i386</i>
464     </pre>
465    
466     <p>
467     Now load the keymap of your choice:
468     </p>
469    
470     <pre caption="Loading a keymap">
471 swift 1.7 # <i>loadkeys be-latin1</i>
472 swift 1.1 </pre>
473    
474     <p>
475     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
476     </p>
477    
478     </body>
479     </subsection>
480    
481     <subsection>
482 nightmorph 1.61 <include href="hb-install-bootconfig.xml"/>
483 swift 1.1 </subsection>
484    
485     </section>
486     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20