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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.40 - (hide annotations) (download) (as text)
Mon May 25 04:05:30 2009 UTC (5 years, 1 month ago) by nightmorph
Branch: MAIN
Changes since 1.39: +4 -4 lines
File MIME type: application/xml
update supported ppc64 systems, bug 271029

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 jkt 1.28 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 swift 1.1
7 nightmorph 1.40 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.39 2009/01/26 07:51:05 nightmorph Exp $ -->
8 swift 1.1
9     <sections>
10 swift 1.10
11 nightmorph 1.40 <version>9.3</version>
12     <date>2009-05-24</date>
13 swift 1.10
14 swift 1.1 <section>
15     <title>Hardware Requirements</title>
16     <subsection>
17     <title>Introduction</title>
18     <body>
19    
20     <p>
21     Before we start, we first list what hardware requirements you need to
22 swift 1.14 successfully install Gentoo on your box.
23 swift 1.1 </p>
24    
25     </body>
26     </subsection>
27     <subsection>
28 swift 1.14 <title>Hardware Requirements</title>
29 swift 1.1 <body>
30    
31 swift 1.14 <table>
32     <tr>
33     <th>CPU</th>
34     <ti>Any PowerPC64 CPU</ti>
35     </tr>
36     <tr>
37     <th>Systems</th>
38     <ti>
39 rane 1.23 IBM RS/6000s, Power Macintosh G5, IBM pSeries and IBM iSeries
40 swift 1.14 </ti>
41     </tr>
42     <tr>
43     <th>Memory</th>
44     <ti>64 MB</ti>
45     </tr>
46     <tr>
47     <th>Diskspace</th>
48     <ti>1.5 GB (excluding swap space)</ti>
49     </tr>
50     <tr>
51     <th>Swap space</th>
52     <ti>At least 256 MB</ti>
53     </tr>
54     </table>
55    
56 swift 1.1 <p>
57 swift 1.14 For a full list of supported systems, please go to
58 nightmorph 1.40 <uri>http://penguinppc.org/about/intro.php#hardware</uri>.
59 swift 1.1 </p>
60    
61     </body>
62     </subsection>
63     </section>
64 nightmorph 1.37
65 swift 1.14 <!-- START -->
66 swift 1.1 <section>
67 swift 1.17 <title>The Gentoo Installation CDs</title>
68 swift 1.1 <subsection>
69 swift 1.14 <title>Introduction</title>
70 swift 1.1 <body>
71    
72     <p>
73 swift 1.17 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
74 swift 1.1 self-sustained Gentoo environment. They allow you to boot Linux from the CD.
75     During the boot process your hardware is detected and the appropriate drivers
76     are loaded. They are maintained by Gentoo developers.
77     </p>
78    
79     <p>
80 swift 1.17 All Installation CDs allow you to boot, set up networking, initialize your
81 swift 1.14 partitions and start installing Gentoo from the Internet. We currently provide
82 neysx 1.34 two Installation CDs which are equally suitable to install Gentoo from, as long
83 swift 1.17 as you're planning on performing an Internet-based installation using the
84     latest version of the available packages.
85 swift 1.14 </p>
86    
87     <p>
88 swift 1.15 If you wish to install Gentoo without a working Internet connection, please use
89 swift 1.14 the installation instructions described in the <uri
90 nightmorph 1.37 link="2008.0/index.xml">Gentoo 2008.0 Handbooks</uri>.
91 swift 1.1 </p>
92    
93     <p>
94 neysx 1.27 The two Installation CDs that we currently provide are:
95     </p>
96    
97     <ul>
98     <li>
99     The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
100     CD which sole purpose is to boot the system, prepare the networking and
101     continue with the Gentoo installation.
102     </li>
103     <li>
104     The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
105     abilities as the Minimal Installation CD. Additionally, it contains
106     several stage3 tarballs (optimized for the individual subarchitectures).
107     </li>
108     </ul>
109    
110     <p>
111     To help you decide which Installation CD you need, we have written down the
112     major advantages and disadvantages of each Installation CD.
113 swift 1.1 </p>
114    
115     </body>
116     </subsection>
117     <subsection>
118 swift 1.17 <title>Gentoo's Minimal Installation CD</title>
119 swift 1.1 <body>
120    
121     <p>
122 swift 1.17 The Minimal Installation CD is called
123 nightmorph 1.37 <c>install-ppc64-minimal-2008.0.iso</c> and takes up only 124 MB of
124 swift 1.17 diskspace. You can use this Installation CD to install Gentoo, but always with a
125 swift 1.14 working Internet connection only.
126 swift 1.1 </p>
127    
128     <table>
129     <tr>
130 swift 1.17 <th>Minimal Installation CD</th>
131 swift 1.1 <th>Pros and Cons</th>
132     </tr>
133     <tr>
134     <th>+</th>
135     <ti>Smallest download</ti>
136     </tr>
137     <tr>
138     <th>-</th>
139     <ti>
140 swift 1.25 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
141 swift 1.14 therefore not suitable for networkless installation
142 swift 1.1 </ti>
143     </tr>
144     </table>
145    
146     </body>
147     </subsection>
148 swift 1.25 <subsection>
149 neysx 1.27 <title>Gentoo's Universal Installation CD</title>
150     <body>
151    
152     <p>
153     The Universal Installation CD is called
154 nightmorph 1.37 <c>install-ppc64-universal-2008.0.iso</c> and uses 460 MB. You can use
155 fox2mike 1.29 this Installation CD to install Gentoo, and you can even use it to install
156 nightmorph 1.39 Gentoo without a working internet connection.
157 neysx 1.27 </p>
158    
159     <table>
160     <tr>
161     <th>Universal Installation CD</th>
162     <th>Pros and Cons</th>
163     </tr>
164     <tr>
165     <th>+</th>
166     <ti>
167     Contains everything you need. You can even install without a network
168     connection.
169     </ti>
170     </tr>
171     <tr>
172     <th>-</th>
173     <ti>Huge download</ti>
174     </tr>
175     </table>
176    
177     </body>
178     </subsection>
179     <subsection>
180 swift 1.25 <title>The Stage3 Tarball</title>
181     <body>
182    
183     <p>
184     A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
185     to continue the Gentoo installation using the instructions in this manual.
186     Previously, the Gentoo Handbook described the installation using one of three
187     stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
188     official installation method uses the stage3 tarball. If you are interested in
189     performing a Gentoo installation using a stage1 or stage2 tarball, please read
190     the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
191     Using a Stage1 or Stage2 Tarball?</uri>
192     </p>
193    
194     </body>
195     </subsection>
196 nightmorph 1.33 <subsection>
197     <title>Choosing a userland</title>
198     <body>
199    
200     <p>
201     On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit. The
202     userland is basically the applications you are running, such as
203     <c>bash</c> or <c>mozilla-firefox</c>. They can be compiled and run in either
204     64-bit or 32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit
205     userlands, so which one should you use?
206     </p>
207    
208     <p>
209     You may have heard that 64-bit applications are better, but in fact, 32-bit
210     applications take up slightly less memory and often run a little bit faster than
211     64-bit applications.
212     </p>
213    
214     <p>
215     You really only need 64-bit applications when you need more memory than a 32-bit
216     userland allows, or if you do a lot of 64-bit number crunching. If you run
217     applications that require more than 4GB of memory or you run scientific
218     applications, you should choose the 64-bit userland. Otherwise, choose the
219     32-bit userland, as it is recommended by the Gentoo/PPC64 developers.
220     </p>
221    
222     <p>
223     Additionally, the 32-bit userland has been available in Portage longer than the
224     64-bit userland has. This means that there are more applications tested in the
225     32-bit userland that just work "out of the box." Many applications compiled for
226     the 64-bit userland may be just as stable as the 32-bit version, but they
227     haven't been tested yet. Though testing isn't difficult to do, it can be
228     annoying and time consuming if you want to use many untested 64-bit
229     applications. Also, some programs just won't run in the 64-bit userland until
230     their code is fixed, such as OpenOffice.
231     </p>
232    
233     <p>
234     The Gentoo/PPC64 team provides stages and Package CDs for both 32-bit and 64-bit
235     userlands, so no matter which one you choose, you'll be able to successfully
236     install Gentoo and get a full system up and running with minimal fuss.
237     </p>
238    
239     </body>
240     </subsection>
241 swift 1.1 </section>
242 swift 1.14 <!-- STOP -->
243 swift 1.1 <section>
244 swift 1.17 <title>Download, Burn and Boot a Gentoo Installation CD</title>
245 swift 1.1 <subsection>
246 swift 1.17 <title>Downloading and Burning the Installation CDs</title>
247 swift 1.1 <body>
248    
249     <p>
250 swift 1.17 You have chosen to use a Gentoo Installation CD. We'll first start by
251     downloading and burning the chosen Installation CD. We previously discussed the
252     several available Installation CDs, but where can you find them?
253 swift 1.14 </p>
254    
255     <p>
256 nightmorph 1.33 You can download any of the Installation CDs (and, if you want to, a Packages CD
257     as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
258     Installation CDs are located in the <path><keyval
259     id="release-dir"/>installcd</path> directory.
260 swift 1.1 </p>
261    
262     <p>
263 nightmorph 1.37 Inside that directory you'll find ISO files. Those are full CD images
264 swift 1.1 which you can write on a CD-R.
265     </p>
266    
267     <p>
268 swift 1.14 In case you wonder if your downloaded file is corrupted or not, you can
269     check its MD5 checksum and compare it with the MD5 checksum we provide (such as
270 nightmorph 1.37 <path>install-ppc64-minimal-2008.0.iso.DIGESTS</path>). You can check the MD5
271 swift 1.1 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
272     link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
273     </p>
274    
275     <p>
276 swift 1.14 Another way to check the validity of the downloaded file is to use GnuPG to
277     verify the cryptographic signature that we provide (the file ending with
278     <path>.asc</path>). Download the signature file and obtain the public key:
279 swift 1.1 </p>
280    
281 swift 1.14 <pre caption="Obtaining the public key">
282 jkt 1.28 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
283 swift 1.1 </pre>
284    
285     <p>
286 swift 1.14 Now verify the signature:
287 swift 1.1 </p>
288    
289 swift 1.14 <pre caption="Verify the cryptographic signature">
290     $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
291     </pre>
292 swift 1.1
293     <p>
294     To burn the downloaded ISO(s), you have to select raw-burning. How you
295 swift 1.14 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
296     <c>K3B</c> here; more information can be found in our <uri
297     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
298 swift 1.1 </p>
299    
300     <ul>
301     <li>
302 swift 1.14 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
303     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
304 swift 1.16 device path).
305 swift 1.1 </li>
306     <li>
307 nightmorph 1.35 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
308     your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
309 swift 1.1 </li>
310 swift 1.7 <li>
311     With Mac OS X Panther, launch <c>Disk Utility</c> from
312     <path>Applications/Utilities</path>, select <c>Open</c> from the
313     <c>Images</c> menu, select the mounted disk image in the main window and
314     select <c>Burn</c> in the <c>Images</c> menu.
315     </li>
316     <li>
317     With Mac OS X Jaguar, launch <c>Disk Copy</c> from
318     <path>Applications/Utilities</path>, select <c>Burn Image</c> from the
319     <c>File</c> menu, select the ISO and click the <c>Burn</c> button.
320     </li>
321 swift 1.1 </ul>
322    
323     </body>
324     </subsection>
325     <subsection>
326 swift 1.17 <title>Default: Booting the Installation CD on an Apple/IBM</title>
327 swift 1.1 <body>
328    
329     <p>
330 swift 1.17 Place the Installation CD in the CD-ROM and reboot the system. Hold down the
331     'C' key at bootup. You will be greeted by a friendly welcome message and a
332     <e>boot:</e> prompt at the bottom of the screen.
333 swift 1.1 </p>
334    
335     <p>
336     You are also able to tweak some kernel options at this prompt. The following
337     table lists the available boot options you can add:
338     </p>
339    
340     <table>
341     <tr>
342     <th>Boot Option</th>
343     <th>Description</th>
344     </tr>
345     <tr>
346     <ti><c>video</c></ti>
347     <ti>
348     This option takes one of the following vendor-specific tags:
349 nightmorph 1.32 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
350     or <c>ofonly</c>. You can follow this tag with the resolution and
351 nightmorph 1.33 refreshrate you want to use. For instance
352     <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
353     <c>ofonly</c> will most certainly work.
354 swift 1.1 </ti>
355     </tr>
356     <tr>
357     <ti><c>nol3</c></ti>
358     <ti>
359 nightmorph 1.33 Disables level 3 cache on some powerbooks (needed for at least the 17")
360 swift 1.1 </ti>
361     </tr>
362     <tr>
363     <ti><c>debug</c></ti>
364     <ti>
365     Enables verbose booting, spawns an initrd shell that can be used to debug
366 swift 1.17 the Installation CD
367 swift 1.1 </ti>
368     </tr>
369     <tr>
370     <ti><c>sleep=X</c></ti>
371     <ti>
372     Wait X seconds before continuing; this can be needed by some very old SCSI
373     CD-ROMs which don't speed up the CD quick enough
374     </ti>
375     </tr>
376     <tr>
377     <ti><c>bootfrom=X</c></ti>
378     <ti>
379     Boot from a different device
380     </ti>
381     </tr>
382 nightmorph 1.37 <tr>
383     <ti><c>dosshd</c></ti>
384     <ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
385     </tr>
386     <tr>
387     <ti><c>passwd=foo</c></ti>
388     <ti>
389     Sets whatever is after the = as the root password. Use with <c>dosshd</c>
390     for remote installs.
391     </ti>
392     </tr>
393 swift 1.1 </table>
394    
395     <p>
396     At this prompt, hit enter, and a complete Gentoo Linux environment will be
397     loaded from the CD. Continue with <uri link="#booted">And When You're
398     Booted...</uri>.
399     </p>
400    
401     </body>
402     </subsection>
403     <subsection>
404     <title>IBM pSeries</title>
405     <body>
406    
407     <p>
408 neysx 1.30 The CD should autoboot on your pSeries box, but sometimes it does not. In that
409     case, you have to set up your cdrom as a bootable device in the multi-boot
410     menu. If you start your machine with a monitor and a keyboard attached, you can
411     reach the multi-boot menu pressing the F1 key on startup. But if you start your
412     machine using the serial console, then you have to press <c>1</c>. Press the
413     key when you see the beginning of the following line on the serial console:
414 swift 1.1 </p>
415    
416 neysx 1.30 <pre caption="Hit the '1' key when this line appears">
417     memory keyboard network scsi speaker
418     </pre>
419    
420 swift 1.1 <p>
421 nightmorph 1.36 The other option is to jump into Open Firmware and do it from there:
422 swift 1.1 </p>
423 neysx 1.30
424     <ol>
425     <li>
426 nightmorph 1.36 Boot into Open Firmware: same procedure as getting into multi-boot
427 neysx 1.30 (described a few lines above), but use F8 and 8 instead of F1 and 1.
428     </li>
429     <li>Run the command 0> boot cdrom:1,yaboot</li>
430     <li>Stand back and enjoy!</li>
431     </ol>
432    
433     <note>
434 nightmorph 1.36 If you get something like the following output, then Open Firmware isn't set up
435 neysx 1.30 correctly. Please use the multi-boot option described above.
436     </note>
437    
438 nightmorph 1.36 <pre caption="Output if Open Firmware is not set up correctly">
439 neysx 1.30 0 > boot cdrom:1,yaboot
440     ok
441     0 >
442     </pre>
443 swift 1.1
444     </body>
445     </subsection>
446     <subsection id="booted">
447     <title>And When You're Booted...</title>
448     <body>
449    
450     <p>
451     You will be greeted by a root ("#") prompt on the current console. You can also
452     switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
453     back to the one you started on by pressing Alt-fn-F1.
454     </p>
455    
456     <p>
457     If you are installing Gentoo on a system with a non-US keyboard, use
458     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
459     keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
460     </p>
461    
462     <pre caption="Listing available keymaps">
463     <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
464 swift 1.17 on the Installation CD are ADB keymaps and unusable with the
465     Installation CD kernel)</comment>
466 swift 1.1 # <i>ls /usr/share/keymaps/i386</i>
467     </pre>
468    
469     <p>
470     Now load the keymap of your choice:
471     </p>
472    
473     <pre caption="Loading a keymap">
474     # <i>loadkeys be-latin1</i>
475     </pre>
476    
477     <p>
478     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
479     </p>
480    
481     </body>
482     </subsection>
483    
484     <subsection>
485 nightmorph 1.38 <include href="hb-install-bootconfig.xml"/>
486 swift 1.2 </subsection>
487 swift 1.1
488     </section>
489     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20