/[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.36 - (show annotations) (download) (as text)
Fri Jul 13 08:40:58 2007 UTC (7 years ago) by nightmorph
Branch: MAIN
Changes since 1.35: +5 -5 lines
File MIME type: application/xml
made Open Firmware usage consistent for all handbooks and translations, as suggested by grahl and rane on IRC, and approved by JoseJX. s/openfirmware/Open Firmware/g, so no revbump.

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.35 2007/06/30 00:50:26 nightmorph Exp $ -->
8
9 <sections>
10
11 <version>8.1</version>
12 <date>2007-06-29</date>
13
14 <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 successfully install Gentoo on your box.
23 </p>
24
25 </body>
26 </subsection>
27 <subsection>
28 <title>Hardware Requirements</title>
29 <body>
30
31 <table>
32 <tr>
33 <th>CPU</th>
34 <ti>Any PowerPC64 CPU</ti>
35 </tr>
36 <tr>
37 <th>Systems</th>
38 <ti>
39 IBM RS/6000s, Power Macintosh G5, IBM pSeries and IBM iSeries
40 </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 <p>
57 For a full list of supported systems, please go to
58 <uri>http://www.linuxppc64.org/hardware.shtml</uri>.
59 </p>
60
61 </body>
62 </subsection>
63 </section>
64 <!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
65 <!-- START -->
66 <section>
67 <title>The Gentoo Installation CDs</title>
68 <subsection>
69 <title>Introduction</title>
70 <body>
71
72 <p>
73 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
74 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 All Installation CDs allow you to boot, set up networking, initialize your
81 partitions and start installing Gentoo from the Internet. We currently provide
82 two Installation CDs which are equally suitable to install Gentoo from, as long
83 as you're planning on performing an Internet-based installation using the
84 latest version of the available packages.
85 </p>
86
87 <p>
88 If you wish to install Gentoo without a working Internet connection, please use
89 the installation instructions described in the <uri
90 link="2007.0/index.xml">Gentoo 2007.0 Handbooks</uri>.
91 </p>
92
93 <p>
94 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 </p>
114
115 </body>
116 </subsection>
117 <subsection>
118 <title>Gentoo's Minimal Installation CD</title>
119 <body>
120
121 <p>
122 The Minimal Installation CD is called
123 <c>install-ppc64-minimal-2007.0.iso</c> and takes up only 124 MB of
124 diskspace. You can use this Installation CD to install Gentoo, but always with a
125 working Internet connection only.
126 </p>
127
128 <table>
129 <tr>
130 <th>Minimal Installation CD</th>
131 <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 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
141 therefore not suitable for networkless installation
142 </ti>
143 </tr>
144 </table>
145
146 </body>
147 </subsection>
148 <subsection>
149 <title>Gentoo's Universal Installation CD</title>
150 <body>
151
152 <p>
153 The Universal Installation CD is called
154 <c>install-ppc64-universal-2007.0.iso</c> and uses 460 MB. You can use
155 this Installation CD to install Gentoo, and you can even use it to install
156 Gentoo without a working internet connection, just in case you want to bring
157 Gentoo to another PC than the one you are currently installing Gentoo on :)
158 </p>
159
160 <table>
161 <tr>
162 <th>Universal Installation CD</th>
163 <th>Pros and Cons</th>
164 </tr>
165 <tr>
166 <th>+</th>
167 <ti>
168 Contains everything you need. You can even install without a network
169 connection.
170 </ti>
171 </tr>
172 <tr>
173 <th>-</th>
174 <ti>Huge download</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, suitable
186 to continue the Gentoo installation using the instructions in this manual.
187 Previously, the Gentoo Handbook described the installation using one of three
188 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 </body>
196 </subsection>
197 <subsection>
198 <title>Choosing a userland</title>
199 <body>
200
201 <p>
202 On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit. The
203 userland is basically the applications you are running, such as
204 <c>bash</c> or <c>mozilla-firefox</c>. They can be compiled and run in either
205 64-bit or 32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit
206 userlands, so which one should you use?
207 </p>
208
209 <p>
210 You may have heard that 64-bit applications are better, but in fact, 32-bit
211 applications take up slightly less memory and often run a little bit faster than
212 64-bit applications.
213 </p>
214
215 <p>
216 You really only need 64-bit applications when you need more memory than a 32-bit
217 userland allows, or if you do a lot of 64-bit number crunching. If you run
218 applications that require more than 4GB of memory or you run scientific
219 applications, you should choose the 64-bit userland. Otherwise, choose the
220 32-bit userland, as it is recommended by the Gentoo/PPC64 developers.
221 </p>
222
223 <p>
224 Additionally, the 32-bit userland has been available in Portage longer than the
225 64-bit userland has. This means that there are more applications tested in the
226 32-bit userland that just work "out of the box." Many applications compiled for
227 the 64-bit userland may be just as stable as the 32-bit version, but they
228 haven't been tested yet. Though testing isn't difficult to do, it can be
229 annoying and time consuming if you want to use many untested 64-bit
230 applications. Also, some programs just won't run in the 64-bit userland until
231 their code is fixed, such as OpenOffice.
232 </p>
233
234 <p>
235 The Gentoo/PPC64 team provides stages and Package CDs for both 32-bit and 64-bit
236 userlands, so no matter which one you choose, you'll be able to successfully
237 install Gentoo and get a full system up and running with minimal fuss.
238 </p>
239
240 </body>
241 </subsection>
242 </section>
243 <!-- STOP -->
244 <section>
245 <title>Download, Burn and Boot a Gentoo Installation CD</title>
246 <subsection>
247 <title>Downloading and Burning the Installation CDs</title>
248 <body>
249
250 <p>
251 You have chosen to use a Gentoo Installation CD. We'll first start by
252 downloading and burning the chosen Installation CD. We previously discussed the
253 several available Installation CDs, but where can you find them?
254 </p>
255
256 <p>
257 You can download any of the Installation CDs (and, if you want to, a Packages CD
258 as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
259 Installation CDs are located in the <path><keyval
260 id="release-dir"/>installcd</path> directory.
261 </p>
262
263 <p>
264 Inside that directory you'll find ISO-files. Those are full CD images
265 which you can write on a CD-R.
266 </p>
267
268 <p>
269 In case you wonder if your downloaded file is corrupted or not, you can
270 check its MD5 checksum and compare it with the MD5 checksum we provide (such as
271 <path>install-ppc64-minimal-2007.0.iso.DIGESTS</path>). You can check the MD5
272 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
273 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
274 </p>
275
276 <p>
277 Another way to check the validity of the downloaded file is to use GnuPG to
278 verify the cryptographic signature that we provide (the file ending with
279 <path>.asc</path>). Download the signature file and obtain the public key:
280 </p>
281
282 <pre caption="Obtaining the public key">
283 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
284 </pre>
285
286 <p>
287 Now verify the signature:
288 </p>
289
290 <pre caption="Verify the cryptographic signature">
291 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
292 </pre>
293
294 <p>
295 To burn the downloaded ISO(s), you have to select raw-burning. How you
296 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
297 <c>K3B</c> here; more information can be found in our <uri
298 link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
299 </p>
300
301 <ul>
302 <li>
303 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
304 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
305 device path).
306 </li>
307 <li>
308 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
309 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
310 </li>
311 <li>
312 With Mac OS X Panther, launch <c>Disk Utility</c> from
313 <path>Applications/Utilities</path>, select <c>Open</c> from the
314 <c>Images</c> menu, select the mounted disk image in the main window and
315 select <c>Burn</c> in the <c>Images</c> menu.
316 </li>
317 <li>
318 With Mac OS X Jaguar, launch <c>Disk Copy</c> from
319 <path>Applications/Utilities</path>, select <c>Burn Image</c> from the
320 <c>File</c> menu, select the ISO and click the <c>Burn</c> button.
321 </li>
322 </ul>
323
324 </body>
325 </subsection>
326 <subsection>
327 <title>Default: Booting the Installation CD on an Apple/IBM</title>
328 <body>
329
330 <p>
331 Place the Installation CD in the CD-ROM and reboot the system. Hold down the
332 'C' key at bootup. You will be greeted by a friendly welcome message and a
333 <e>boot:</e> prompt at the bottom of the screen.
334 </p>
335
336 <p>
337 You are also able to tweak some kernel options at this prompt. The following
338 table lists the available boot options you can add:
339 </p>
340
341 <table>
342 <tr>
343 <th>Boot Option</th>
344 <th>Description</th>
345 </tr>
346 <tr>
347 <ti><c>video</c></ti>
348 <ti>
349 This option takes one of the following vendor-specific tags:
350 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
351 or <c>ofonly</c>. You can follow this tag with the resolution and
352 refreshrate you want to use. For instance
353 <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
354 <c>ofonly</c> will most certainly work.
355 </ti>
356 </tr>
357 <tr>
358 <ti><c>nol3</c></ti>
359 <ti>
360 Disables level 3 cache on some powerbooks (needed for at least the 17")
361 </ti>
362 </tr>
363 <tr>
364 <ti><c>debug</c></ti>
365 <ti>
366 Enables verbose booting, spawns an initrd shell that can be used to debug
367 the Installation CD
368 </ti>
369 </tr>
370 <tr>
371 <ti><c>sleep=X</c></ti>
372 <ti>
373 Wait X seconds before continuing; this can be needed by some very old SCSI
374 CD-ROMs which don't speed up the CD quick enough
375 </ti>
376 </tr>
377 <tr>
378 <ti><c>bootfrom=X</c></ti>
379 <ti>
380 Boot from a different device
381 </ti>
382 </tr>
383 </table>
384
385 <p>
386 At this prompt, hit enter, and a complete Gentoo Linux environment will be
387 loaded from the CD. Continue with <uri link="#booted">And When You're
388 Booted...</uri>.
389 </p>
390
391 </body>
392 </subsection>
393 <subsection>
394 <title>IBM pSeries</title>
395 <body>
396
397 <p>
398 The CD should autoboot on your pSeries box, but sometimes it does not. In that
399 case, you have to set up your cdrom as a bootable device in the multi-boot
400 menu. If you start your machine with a monitor and a keyboard attached, you can
401 reach the multi-boot menu pressing the F1 key on startup. But if you start your
402 machine using the serial console, then you have to press <c>1</c>. Press the
403 key when you see the beginning of the following line on the serial console:
404 </p>
405
406 <pre caption="Hit the '1' key when this line appears">
407 memory keyboard network scsi speaker
408 </pre>
409
410 <p>
411 The other option is to jump into Open Firmware and do it from there:
412 </p>
413
414 <ol>
415 <li>
416 Boot into Open Firmware: same procedure as getting into multi-boot
417 (described a few lines above), but use F8 and 8 instead of F1 and 1.
418 </li>
419 <li>Run the command 0> boot cdrom:1,yaboot</li>
420 <li>Stand back and enjoy!</li>
421 </ol>
422
423 <note>
424 If you get something like the following output, then Open Firmware isn't set up
425 correctly. Please use the multi-boot option described above.
426 </note>
427
428 <pre caption="Output if Open Firmware is not set up correctly">
429 0 > boot cdrom:1,yaboot
430 ok
431 0 >
432 </pre>
433
434 </body>
435 </subsection>
436 <subsection id="booted">
437 <title>And When You're Booted...</title>
438 <body>
439
440 <p>
441 You will be greeted by a root ("#") prompt on the current console. You can also
442 switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
443 back to the one you started on by pressing Alt-fn-F1.
444 </p>
445
446 <p>
447 If you are installing Gentoo on a system with a non-US keyboard, use
448 <c>loadkeys</c> to load the keymap for your keyboard. To list the available
449 keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
450 </p>
451
452 <pre caption="Listing available keymaps">
453 <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
454 on the Installation CD are ADB keymaps and unusable with the
455 Installation CD kernel)</comment>
456 # <i>ls /usr/share/keymaps/i386</i>
457 </pre>
458
459 <p>
460 Now load the keymap of your choice:
461 </p>
462
463 <pre caption="Loading a keymap">
464 # <i>loadkeys be-latin1</i>
465 </pre>
466
467 <p>
468 Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
469 </p>
470
471 </body>
472 </subsection>
473 <subsection id="hardware">
474 <title>Extra Hardware Configuration</title>
475 <body>
476
477 <p>
478 When the Installation CD boots, it tries to detect all your hardware devices and
479 loads the appropriate kernel modules to support your hardware. In the vast
480 majority of cases, it does a very good job. However, in some cases it may not
481 auto-load the kernel modules you need. If the PCI auto-detection missed some of
482 your system's hardware, you will have to load the appropriate kernel modules
483 manually.
484 </p>
485
486 <p>
487 In the next example we try to load the <c>8139too</c> module (support for
488 certain kinds of network interfaces):
489 </p>
490
491 <pre caption="Loading kernel modules">
492 # <i>modprobe 8139too</i>
493 </pre>
494
495 </body>
496 </subsection>
497 <subsection>
498 <title>Optional: Tweaking Hard Disk Performance</title>
499 <body>
500
501 <p>
502 If you are an advanced user, you might want to tweak the IDE hard disk
503 performance using <c>hdparm</c>. With the <c>-tT</c> options you can
504 test the performance of your disk (execute it several times to get a
505 more precise impression):
506 </p>
507
508 <pre caption="Testing disk performance">
509 # <i>hdparm -tT /dev/hda</i>
510 </pre>
511
512 <p>
513 To tweak, you can use any of the following examples (or experiment
514 yourself) which use <path>/dev/hda</path> as disk (substitute with your
515 disk):
516 </p>
517
518 <pre caption="Tweaking hard disk performance">
519 <comment>Activate DMA:</comment>
520 # <i>hdparm -d 1 /dev/hda</i>
521 <comment>Activate DMA + Safe Performance-enhancing Options:</comment>
522 # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
523 </pre>
524
525 </body>
526 </subsection>
527 <subsection id="useraccounts">
528 <title>Optional: User Accounts</title>
529 <body>
530
531 <p>
532 If you plan on giving other people access to your installation
533 environment or you want to chat using <c>irssi</c> without root privileges (for
534 security reasons), you need to create the necessary user accounts and change
535 the root password.
536 </p>
537
538 <p>
539 To change the root password, use the <c>passwd</c> utility:
540 </p>
541
542 <pre caption="Changing the root password">
543 # <i>passwd</i>
544 New password: <comment>(Enter your new password)</comment>
545 Re-enter password: <comment>(Re-enter your password)</comment>
546 </pre>
547
548 <p>
549 To create a user account, we first enter their credentials, followed by
550 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
551 In the next example, we create a user called &quot;john&quot;.
552 </p>
553
554 <pre caption="Creating a user account">
555 # <i>useradd -m -G users john</i>
556 # <i>passwd john</i>
557 New password: <comment>(Enter john's password)</comment>
558 Re-enter password: <comment>(Re-enter john's password)</comment>
559 </pre>
560
561 <p>
562 You can change your user id from root to the newly created user by using
563 <c>su</c>:
564 </p>
565
566 <pre caption="Changing user id">
567 # <i>su - john</i>
568 </pre>
569
570 </body>
571 </subsection>
572 <subsection>
573 <title>Optional: Viewing Documentation while Installing</title>
574 <body>
575
576 <p>
577 If you want to view the Gentoo Handbook during the installation, make sure you
578 have created a user account (see <uri link="#useraccounts">Optional: User
579 Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
580 </p>
581
582 <p>
583 If you want to view the documentation on the CD you can immediately run
584 <c>links</c> to read it:
585 </p>
586
587 <pre caption="Viewing the on-CD documentation">
588 # <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
589 </pre>
590
591 <p>
592 However, it is preferred that you use the online Gentoo Handbook as it will be
593 more recent than the one provided on the CD.
594 </p>
595
596 <pre caption="Viewing the Online Documentation">
597 # <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
598 </pre>
599
600 <p>
601 You can go back to your original terminal by pressing <c>Alt-F1</c>.
602 </p>
603
604 </body>
605 </subsection>
606 <subsection>
607 <title>Optional: Starting the SSH Daemon</title>
608 <body>
609
610 <p>
611 If you want to allow other users to access your computer during the
612 Gentoo installation (perhaps because those users are going to help you
613 install Gentoo, or even do it for you), you need to create a user
614 account for them and perhaps even provide them with your root password
615 (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
616 </p>
617
618 <p>
619 To fire up the SSH daemon, execute the following command:
620 </p>
621
622 <pre caption="Starting the SSH daemon">
623 # <i>/etc/init.d/sshd start</i>
624 </pre>
625
626 <p>
627 To be able to use sshd, you first need to set up your networking. Continue with
628 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
629 </p>
630
631 </body>
632 </subsection>
633 </section>
634 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20