/[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.66 - (hide annotations) (download) (as text)
Mon May 16 19:11:46 2011 UTC (3 years, 2 months ago) by nightmorph
Branch: MAIN
Changes since 1.65: +2 -2 lines
File MIME type: application/xml
proper revision bump, no content change

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 nightmorph 1.66 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.65 2011/05/16 15:15:45 josejx 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 nightmorph 1.66 <version>11</version>
17 josejx 1.65 <date>2011-05-16</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     takes up only <keyval id="min-cd-size"/> MB of diskspace. You can use this
156     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     its MD5 checksum and compare it with the MD5 checksum we provide (such as
234     <path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
235     checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
236     link="http://www.etree.org/md5com.html">md5sum</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     <path>.asc</path>). Download the signature file and obtain the public key:
243 swift 1.12 </p>
244    
245 swift 1.35 <pre caption="Obtaining the public key">
246 nightmorph 1.63 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 2D182910</i>
247 swift 1.12 </pre>
248    
249     <p>
250 swift 1.35 Now verify the signature:
251 swift 1.12 </p>
252    
253 nightmorph 1.63 <pre caption="Verify the files">
254     <comment>(Verify the cryptographic signature)</comment>
255     $ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
256     <comment>(Verify the checksum)</comment>
257     $ <i>sha1sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
258 swift 1.35 </pre>
259 swift 1.12
260     <p>
261 swift 1.1 To burn the downloaded ISO(s), you have to select raw-burning. How you
262 swift 1.35 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
263     <c>K3B</c> here; more information can be found in our <uri
264     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
265 swift 1.1 </p>
266    
267     <ul>
268     <li>
269 nightmorph 1.54 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
270     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
271     path).
272 swift 1.1 </li>
273     <li>
274 nightmorph 1.56 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
275     your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
276 swift 1.3 </li>
277 swift 1.1 </ul>
278    
279     </body>
280     </subsection>
281     <subsection>
282 josejx 1.41 <title>Default: Booting the Installation CD with Yaboot</title>
283 swift 1.1 <body>
284    
285     <p>
286 swift 1.39 On NewWorld machines place the Installation CD in the CD-ROM and reboot the
287 nightmorph 1.54 system. When the system-start-bell sounds, simply hold down the 'C' until the
288 swift 1.39 CD loads.
289 dertobi123 1.17 </p>
290    
291     <p>
292 swift 1.39 After the Installation CD loaded, you will be greeted by a friendly welcome
293     message and a <e>boot:</e> prompt at the bottom of the screen.
294 swift 1.1 </p>
295    
296     <p>
297 josejx 1.65 We provide one generic kernel, <e>ppc32</e>. This kernel is built with support
298 fox2mike 1.52 for multiple CPUs, but it will boot on single processor machines as well.
299 swift 1.1 </p>
300    
301     <p>
302 fox2mike 1.52 You can tweak some kernel options at this prompt. The following table lists
303     some of the available boot options you can add:
304 swift 1.1 </p>
305    
306     <table>
307     <tr>
308     <th>Boot Option</th>
309     <th>Description</th>
310     </tr>
311     <tr>
312     <ti><c>video</c></ti>
313     <ti>
314     This option takes one of the following vendor-specific tags:
315 fox2mike 1.52 <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
316     <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
317     refresh rate and color depth you want to use. For instance,
318     <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
319     at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
320     32 bits. If you are uncertain what to choose, and the default doesn't work,
321     <c>video=ofonly</c> will most certainly work.
322 swift 1.1 </ti>
323     </tr>
324     <tr>
325 pylon 1.2 <ti><c>nol3</c></ti>
326 swift 1.1 <ti>
327 dertobi123 1.17 Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
328 swift 1.1 </ti>
329     </tr>
330     <tr>
331 swift 1.39 <ti><c>dofirewire</c></ti>
332 swift 1.1 <ti>
333 swift 1.39 Enables support for IEEE1394 (FireWire) devices, like external harddisks.
334 swift 1.1 </ti>
335     </tr>
336 swift 1.7 <tr>
337 swift 1.39 <ti><c>dopcmcia</c></ti>
338 swift 1.7 <ti>
339 nightmorph 1.54 If you want to use PCMCIA devices during your installation (like PCMCIA
340     network cards) you have to enable this option.
341 swift 1.7 </ti>
342     </tr>
343 nightmorph 1.60 <tr>
344     <ti><c>dosshd</c></ti>
345     <ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
346     </tr>
347     <tr>
348     <ti><c>passwd=foo</c></ti>
349     <ti>
350     Sets whatever is after the = as the root password. Use with <c>dosshd</c>
351     for remote installs.
352     </ti>
353     </tr>
354 swift 1.1 </table>
355    
356     <p>
357 josejx 1.65 To use the above options, at the <e>boot:</e> prompt, type <e>ppc32</e> followed
358 josejx 1.53 by the desired option. In the example below, we'll force the kernel to use the
359 nightmorph 1.57 Open Firmware framebuffer instead of the device specific driver.
360 josejx 1.53 </p>
361    
362 nightmorph 1.57 <pre caption="Force the use of the Open Firmware framebuffer">
363 josejx 1.65 boot: <i>ppc32 video=ofonly</i>
364 josejx 1.53 </pre>
365    
366     <p>
367 josejx 1.65 If you don't need to add any options, just type ppc32 at this prompt, and a
368 josejx 1.53 complete Gentoo Linux environment will be loaded from the CD. Continue with
369     <uri link="#booted">And When You're Booted...</uri>.
370 swift 1.1 </p>
371    
372 swift 1.7 </body>
373     </subsection>
374     <subsection>
375 swift 1.39 <title>Alternative: Booting the Installation CD on a Pegasos</title>
376 swift 1.7 <body>
377    
378 swift 1.1 <p>
379 swift 1.7 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
380 swift 1.39 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
381     between several preconfigured video configs. If you need any special boot
382 fox2mike 1.52 options you can append them to the command-line just like with Yaboot above.
383     For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
384     The default kernel options (in case something goes wrong and you need it) are
385     preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
386 nightmorph 1.54 looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
387 swift 1.1 </p>
388    
389 swift 1.7 </body>
390     </subsection>
391 josejx 1.41
392     <subsection>
393     <title>Alternative: Booting the Installation CD with BootX</title>
394     <body>
395    
396     <p>
397     If you have an OldWorld Mac the bootable portion of the livecd can't be used.
398 josejx 1.53 The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
399     environment with a tool called BootX.
400 josejx 1.41 </p>
401 swift 1.45
402 josejx 1.41 <p>
403 grahl 1.58 First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
404 josejx 1.41 and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
405     archive into <c>Extensions Folder</c> and the BootX App Control Panel into
406     <c>Control Panels</c>, both of which are located in your MacOS System Folder.
407 josejx 1.42 Next, create a folder called "Linux Kernels" in your System folder and copy the
408 josejx 1.65 <c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c>
409 josejx 1.42 from the Installation CD <path>boot</path> folder into the MacOS
410     <c>System Folder</c>.
411 josejx 1.41 </p>
412 swift 1.45
413 josejx 1.41 <p>
414     To prepare BootX, start the BootX App Control Panel. First select the Options
415 josejx 1.65 dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from
416 josejx 1.41 your System Folder. Continue back to the initial screen and ensure that the
417     ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
418     shown below:
419     </p>
420    
421     <pre caption="BootX kernel arguments">
422 nightmorph 1.54 cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
423 josejx 1.41 </pre>
424 swift 1.45
425 josejx 1.41 <note>
426 fox2mike 1.52 The kernel parameters in the yaboot section above are also applicable here. You
427     can append any of those options to the kernel arguments above.
428 josejx 1.41 </note>
429 swift 1.45
430 josejx 1.41 <p>
431     Check once more to make sure the settings are correct and then save the
432     configuration. This saves typing just in case it doesn't boot or something is
433 fox2mike 1.52 missing. Press the Linux button at the top of the window. If everything goes
434     correctly, it should boot into the Installation CD. Continue with
435     <uri link="#booted">And When You're Booted...</uri>
436 josejx 1.41 </p>
437 swift 1.45
438 josejx 1.41 </body>
439     </subsection>
440    
441 swift 1.7 <subsection id="booted">
442     <title>And When You're Booted...</title>
443     <body>
444 swift 1.1
445     <p>
446 swift 1.7 You will be greeted by a root ("#") prompt on the current console. You can also
447 swift 1.39 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
448 fox2mike 1.52 back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
449     you may need to press Alt-fn-Fx on Apple machines.
450 swift 1.1 </p>
451    
452     <p>
453     If you are installing Gentoo on a system with a non-US keyboard, use
454     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
455 nightmorph 1.62 keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
456 swift 1.1 </p>
457    
458     <pre caption="Listing available keymaps">
459 nightmorph 1.62 <comment>(PPC uses x86 keymaps on most systems.)</comment>
460 swift 1.1 # <i>ls /usr/share/keymaps/i386</i>
461     </pre>
462    
463     <p>
464     Now load the keymap of your choice:
465     </p>
466    
467     <pre caption="Loading a keymap">
468 swift 1.7 # <i>loadkeys be-latin1</i>
469 swift 1.1 </pre>
470    
471     <p>
472     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
473     </p>
474    
475     </body>
476     </subsection>
477    
478     <subsection>
479 nightmorph 1.61 <include href="hb-install-bootconfig.xml"/>
480 swift 1.1 </subsection>
481    
482     </section>
483     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20