/[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.46 - (show annotations) (download) (as text)
Fri Jun 29 15:57:32 2012 UTC (2 years, 1 month ago) by swift
Branch: MAIN
Changes since 1.45: +7 -4 lines
File MIME type: application/xml
Fix bug #398281 - Update docs to refer to release engineering site for gpg keys

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 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6
7 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.45 2012/02/26 09:49:46 swift Exp $ -->
8
9 <sections>
10
11 <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 <version>14</version>
17 <date>2012-06-29</date>
18
19 <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 successfully install Gentoo on your box.
28 </p>
29
30 </body>
31 </subsection>
32 <subsection>
33 <title>Hardware Requirements</title>
34 <body>
35
36 <table>
37 <tr>
38 <th>CPU</th>
39 <ti>Any PowerPC64 CPU</ti>
40 </tr>
41 <tr>
42 <th>Systems</th>
43 <ti>
44 IBM RS/6000s, Power Macintosh G5, IBM pSeries and IBM iSeries
45 </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 <p>
62 For a full list of supported systems, please go to
63 <uri>http://penguinppc.org/about/intro.php#hardware</uri>.
64 </p>
65
66 </body>
67 </subsection>
68 </section>
69
70 <!-- START -->
71 <section>
72 <title>The Gentoo Installation CDs</title>
73 <subsection>
74 <title>Introduction</title>
75 <body>
76
77 <p>
78 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
79 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 All Installation CDs allow you to boot, set up networking, initialize your
86 partitions and start installing Gentoo from the Internet.
87 </p>
88 <!--
89 <p>
90 If you wish to install Gentoo without a working Internet connection, please use
91 the installation instructions described in the <uri
92 link="2008.0/index.xml">Gentoo 2008.0 Handbooks</uri>.
93 </p>
94
95 <p>
96 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 </p>
116 -->
117 </body>
118 </subsection>
119 <subsection>
120 <title>Gentoo Minimal Installation CD</title>
121 <body>
122
123 <p>
124 The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
125 takes up around <keyval id="min-cd-size"/> MB of diskspace. You can use this
126 Installation CD to install Gentoo, but <e>only</e> with a working Internet
127 connection.
128 </p>
129 <!--
130 <table>
131 <tr>
132 <th>Minimal Installation CD</th>
133 <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 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
143 therefore not suitable for networkless installation
144 </ti>
145 </tr>
146 </table>
147
148 </body>
149 </subsection>
150 <subsection>
151 <title>Gentoo's Universal Installation CD</title>
152 <body>
153
154 <p>
155 The Universal Installation CD is called
156 <c>install-ppc64-universal-2008.0.iso</c> and uses 460 MB. You can use
157 this Installation CD to install Gentoo, and you can even use it to install
158 Gentoo without a working internet connection.
159 </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 -->
179 </body>
180 </subsection>
181 <subsection>
182 <title>The Stage3 Tarball</title>
183 <body>
184
185 <p>
186 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 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 <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 </body>
204 </subsection>
205 <subsection>
206 <title>Choosing a userland</title>
207 <body>
208
209 <p>
210 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 </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 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 </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 </section>
245 <!-- STOP -->
246 <section>
247 <title>Download, Burn and Boot a Gentoo Installation CD</title>
248 <subsection>
249 <title>Downloading and Burning the Installation CDs</title>
250 <body>
251
252 <p>
253 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 </p>
257
258 <p>
259 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 </p>
263
264 <p>
265 Inside that directory you'll find ISO files. Those are full CD images
266 which you can write on a CD-R.
267 </p>
268
269 <p>
270 In case you wonder if your downloaded file is corrupted or not, you can check
271 its MD5 checksum and compare it with the MD5 checksum we provide (such as
272 <path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
273 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
274 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
275 </p>
276
277 <p>
278 Another way to check the validity of the downloaded file is to use GnuPG to
279 verify the cryptographic signature that we provide (the file ending with
280 <path>.asc</path>). Download the signature file and obtain the public keys whose
281 key ids can be found on the <uri link="/proj/en/releng/index.xml">release
282 engineering project site</uri>.
283 </p>
284
285 <pre caption="Obtaining the public key">
286 <comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
287 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
288 </pre>
289
290 <p>
291 Now verify the signature:
292 </p>
293
294 <pre caption="Verify the files">
295 <comment>(Verify the cryptographic signature)</comment>
296 $ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
297 <comment>(Verify the checksum)</comment>
298 $ <i>sha1sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
299 </pre>
300
301 <p>
302 To burn the downloaded ISO(s), you have to select raw-burning. How you
303 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
304 <c>K3B</c> here; more information can be found in our <uri
305 link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
306 </p>
307
308 <ul>
309 <li>
310 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
311 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
312 device path).
313 </li>
314 <li>
315 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
316 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
317 </li>
318 <li>
319 With Mac OS X Panther, launch <c>Disk Utility</c> from
320 <path>Applications/Utilities</path>, select <c>Open</c> from the
321 <c>Images</c> menu, select the mounted disk image in the main window and
322 select <c>Burn</c> in the <c>Images</c> menu.
323 </li>
324 <li>
325 With Mac OS X Jaguar, launch <c>Disk Copy</c> from
326 <path>Applications/Utilities</path>, select <c>Burn Image</c> from the
327 <c>File</c> menu, select the ISO and click the <c>Burn</c> button.
328 </li>
329 </ul>
330
331 </body>
332 </subsection>
333 <subsection>
334 <title>Default: Booting the Installation CD on an Apple/IBM</title>
335 <body>
336
337 <p>
338 Place the Installation CD in the CD-ROM and reboot the system. Hold down the
339 'C' key at bootup. You will be greeted by a friendly welcome message and a
340 <e>boot:</e> prompt at the bottom of the screen.
341 </p>
342
343 <p>
344 You are also able to tweak some kernel options at this prompt. The following
345 table lists the available boot options you can add:
346 </p>
347
348 <table>
349 <tr>
350 <th>Boot Option</th>
351 <th>Description</th>
352 </tr>
353 <tr>
354 <ti><c>video</c></ti>
355 <ti>
356 This option takes one of the following vendor-specific tags:
357 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
358 or <c>ofonly</c>. You can follow this tag with the resolution and
359 refreshrate you want to use. For instance
360 <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
361 <c>ofonly</c> will most certainly work.
362 </ti>
363 </tr>
364 <tr>
365 <ti><c>nol3</c></ti>
366 <ti>
367 Disables level 3 cache on some powerbooks (needed for at least the 17")
368 </ti>
369 </tr>
370 <tr>
371 <ti><c>debug</c></ti>
372 <ti>
373 Enables verbose booting, spawns an initrd shell that can be used to debug
374 the Installation CD
375 </ti>
376 </tr>
377 <tr>
378 <ti><c>sleep=X</c></ti>
379 <ti>
380 Wait X seconds before continuing; this can be needed by some very old SCSI
381 CD-ROMs which don't speed up the CD quick enough
382 </ti>
383 </tr>
384 <tr>
385 <ti><c>bootfrom=X</c></ti>
386 <ti>
387 Boot from a different device
388 </ti>
389 </tr>
390 <tr>
391 <ti><c>dosshd</c></ti>
392 <ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
393 </tr>
394 <tr>
395 <ti><c>passwd=foo</c></ti>
396 <ti>
397 Sets whatever is after the = as the root password. Use with <c>dosshd</c>
398 for remote installs.
399 </ti>
400 </tr>
401 </table>
402
403 <p>
404 At this prompt, hit enter, and a complete Gentoo Linux environment will be
405 loaded from the CD. Continue with <uri link="#booted">And When You're
406 Booted...</uri>.
407 </p>
408
409 </body>
410 </subsection>
411 <subsection>
412 <title>IBM pSeries</title>
413 <body>
414
415 <p>
416 The CD should autoboot on your pSeries box, but sometimes it does not. In that
417 case, you have to set up your cdrom as a bootable device in the multi-boot
418 menu. If you start your machine with a monitor and a keyboard attached, you can
419 reach the multi-boot menu pressing the F1 key on startup. But if you start your
420 machine using the serial console, then you have to press <c>1</c>. Press the
421 key when you see the beginning of the following line on the serial console:
422 </p>
423
424 <pre caption="Hit the '1' key when this line appears">
425 memory keyboard network scsi speaker
426 </pre>
427
428 <p>
429 The other option is to jump into Open Firmware and do it from there:
430 </p>
431
432 <ol>
433 <li>
434 Boot into Open Firmware: same procedure as getting into multi-boot
435 (described a few lines above), but use F8 and 8 instead of F1 and 1.
436 </li>
437 <li>Run the command 0> boot cdrom:1,yaboot</li>
438 <li>Stand back and enjoy!</li>
439 </ol>
440
441 <note>
442 If you get something like the following output, then Open Firmware isn't set up
443 correctly. Please use the multi-boot option described above.
444 </note>
445
446 <pre caption="Output if Open Firmware is not set up correctly">
447 0 > boot cdrom:1,yaboot
448 ok
449 0 >
450 </pre>
451
452 </body>
453 </subsection>
454 <subsection id="booted">
455 <title>And When You're Booted...</title>
456 <body>
457
458 <p>
459 You will be greeted by a root ("#") prompt on the current console. You can also
460 switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
461 back to the one you started on by pressing Alt-fn-F1.
462 </p>
463
464 <p>
465 If you are installing Gentoo on a system with a non-US keyboard, use
466 <c>loadkeys</c> to load the keymap for your keyboard. To list the available
467 keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
468 </p>
469
470 <pre caption="Listing available keymaps">
471 <comment>(PPC uses x86 keymaps on most systems)</comment>
472 # <i>ls /usr/share/keymaps/i386</i>
473 </pre>
474
475 <p>
476 Now load the keymap of your choice:
477 </p>
478
479 <pre caption="Loading a keymap">
480 # <i>loadkeys be-latin1</i>
481 </pre>
482
483 <p>
484 Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
485 </p>
486
487 </body>
488 </subsection>
489
490 <subsection>
491 <include href="hb-install-bootconfig.xml"/>
492 </subsection>
493
494 </section>
495 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20