/[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.48 - (hide annotations) (download) (as text)
Thu Aug 1 19:02:27 2013 UTC (5 years, 4 months ago) by swift
Branch: MAIN
Changes since 1.47: +13 -6 lines
File MIME type: application/xml
Fix bug #479094 - Checksums are SHA-2 (512) now, so use sha512sum command

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

  ViewVC Help
Powered by ViewVC 1.1.20