/[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.18 - (show annotations) (download) (as text)
Mon Apr 4 20:11:01 2005 UTC (9 years, 8 months ago) by neysx
Branch: MAIN
Changes since 1.17: +4 -4 lines
File MIME type: application/xml
s/livecd/installcd/

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/1.0 -->
6
7 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.17 2005/03/28 11:30:53 swift Exp $ -->
8
9 <sections>
10
11 <version>2.1</version>
12 <date>2005-04-04</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, IBP 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 Approaches</title>
68 <subsection>
69 <title>Introduction</title>
70 <body>
71
72 <p>
73 Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
74 A stage file is a tarball (compressed archive) that contains a minimal
75 environment.
76 </p>
77
78 <ul>
79 <li>
80 A stage1 file contains nothing more than a compiler, Portage (Gentoo's
81 software management system) and a couple of packages on which the compiler
82 or Portage depends.
83 </li>
84 <li>
85 A stage2 file contains a so-called bootstrapped system, a minimal
86 environment from which one can start building all other necessary
87 applications that make a Gentoo environment complete.
88 </li>
89 <li>
90 A stage3 file contains a prebuilt minimal system which is almost fully
91 deployable. It only lacks a few applications where you, the Gentoo user,
92 needs to choose which one you want to install.
93 </li>
94 </ul>
95
96 <p>
97 To help you decide what stage file you want to use, we have written down the
98 major advantages and disadvantages of each stage file.
99 </p>
100
101 </body>
102 </subsection>
103 <subsection>
104 <title>A Stage1 Approach</title>
105 <body>
106
107 <p>
108 A <e>stage1</e> is used when you want to bootstrap and build the entire system
109 from scratch.
110 </p>
111
112 <p>
113 Starting from a stage1 allows you to have total control over the
114 optimization settings and optional build-time functionality that is
115 initially enabled on your system. This makes <e>stage1</e> installs good for
116 power users who know what they are doing. It is also a great
117 installation method for those who would like to know more about the
118 inner workings of Gentoo Linux.
119 </p>
120
121 <table>
122 <tr>
123 <th>Stage1</th>
124 <th>Pros and Cons</th>
125 </tr>
126 <tr>
127 <th>+</th>
128 <ti>
129 Allows you to have total control over the optimization settings and optional
130 build-time functionality that is initially enabled on your system
131 </ti>
132 </tr>
133 <tr>
134 <th>+</th>
135 <ti>Suitable for powerusers that know what they are doing</ti>
136 </tr>
137 <tr>
138 <th>+</th>
139 <ti>Allows you to learn more about the inner workings of Gentoo</ti>
140 </tr>
141 <tr>
142 <th>-</th>
143 <ti>Takes a long time to finish the installation</ti>
144 </tr>
145 <tr>
146 <th>-</th>
147 <ti>
148 If you don't intend to tweak the settings, it is a waste of time
149 </ti>
150 </tr>
151 </table>
152
153 </body>
154 </subsection>
155 <subsection>
156 <title>A Stage2 Approach</title>
157 <body>
158
159 <p>
160 A <e>stage2</e> is used for building the entire system from a bootstrapped
161 "semi-compiled" state.
162 </p>
163
164 <p>
165 Stage2 installs allow you to skip the bootstrap process; doing this
166 is fine if you are happy with the optimization settings that we chose
167 for your particular stage2 tarball.
168 </p>
169
170 <table>
171 <tr>
172 <th>Stage2</th>
173 <th>Pros and Cons</th>
174 </tr>
175 <tr>
176 <th>+</th>
177 <ti>You don't need to bootstrap</ti>
178 </tr>
179 <tr>
180 <th>+</th>
181 <ti>Faster than starting with stage1</ti>
182 </tr>
183 <tr>
184 <th>+</th>
185 <ti>You can still tweak your settings</ti>
186 </tr>
187 <tr>
188 <th>-</th>
189 <ti>You cannot tweak as much as with a stage1</ti>
190 </tr>
191 <tr>
192 <th>-</th>
193 <ti>It's still not the fastest way to install Gentoo</ti>
194 </tr>
195 <tr>
196 <th>-</th>
197 <ti>You have to accept the optimizations we chose for the bootstrap</ti>
198 </tr>
199 </table>
200
201 </body>
202 </subsection>
203 <subsection>
204 <title>A Stage3 Approach</title>
205 <body>
206
207 <p>
208 A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
209 built for you. You will only need to build a few packages of which we can't
210 decide for you which one to choose.
211 </p>
212
213 <p>
214 Choosing to go with a stage3 allows for the fastest install of Gentoo
215 Linux, but also means that your base system will have the optimization
216 settings that we chose for you (which to be honest, are good settings
217 and were carefully chosen to enhance performance while maintaining
218 stability). Stage3 is also required if you want to install Gentoo using
219 prebuilt packages or without a network connection.
220 </p>
221
222 <table>
223 <tr>
224 <th>Stage3</th>
225 <th>Pros and Cons</th>
226 </tr>
227 <tr>
228 <th>+</th>
229 <ti>Fastest way to get a Gentoo base system</ti>
230 </tr>
231 <tr>
232 <th>-</th>
233 <ti>You cannot tweak the base system - it's built already</ti>
234 </tr>
235 </table>
236
237 <p>
238 You might be interested to know that, if you decide to use different
239 optimization settings after having installed Gentoo, you will be able to
240 recompile your entire system with the new optimization settings.
241 </p>
242
243 </body>
244 </subsection>
245 </section>
246 <section>
247 <title>The Gentoo Installation CDs</title>
248 <subsection>
249 <title>Introduction</title>
250 <body>
251
252 <p>
253 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
254 self-sustained Gentoo environment. They allow you to boot Linux from the CD.
255 During the boot process your hardware is detected and the appropriate drivers
256 are loaded. They are maintained by Gentoo developers.
257 </p>
258
259 <p>
260 All Installation CDs allow you to boot, set up networking, initialize your
261 partitions and start installing Gentoo from the Internet. We currently provide
262 two Installation CDs which are equaly suitable to install Gentoo from, as long
263 as you're planning on performing an Internet-based installation using the
264 latest version of the available packages.
265 </p>
266
267 <p>
268 If you wish to install Gentoo without a working Internet connection, please use
269 the installation instructions described in the <uri
270 link="2005.0/index.xml">Gentoo 2005.0 Handbooks</uri>. This is currently not
271 supported for the PPC64 architecture though.
272 </p>
273
274 <p>
275 For the PowerPC64 architecture, we only supply a <e>Minimal</e> Installation CD,
276 a small, no-nonsense, bootable CD which sole purpose is to boot the system,
277 prepare the networking and continue with the Gentoo installation.
278 </p>
279
280 </body>
281 </subsection>
282 <subsection>
283 <title>Gentoo's Minimal Installation CD</title>
284 <body>
285
286 <p>
287 The Minimal Installation CD is called
288 <c>install-ppc64-g5-minimal-2005.0.iso</c> or
289 <c>install-ppc64-ibm-minimal-2005.0.iso</c> and takes up only 350 MB of
290 diskspace. You can use this Installation CD to install Gentoo, but always with a
291 working Internet connection only.
292 </p>
293
294 <table>
295 <tr>
296 <th>Minimal Installation CD</th>
297 <th>Pros and Cons</th>
298 </tr>
299 <tr>
300 <th>+</th>
301 <ti>Smallest download</ti>
302 </tr>
303 <tr>
304 <th>+</th>
305 <ti>
306 You can do a stage1, stage2 or stage3 by getting the stage tarball off the
307 net
308 </ti>
309 </tr>
310 <tr>
311 <th>-</th>
312 <ti>
313 Contains no stages, no Portage snapshot, no prebuilt packages and is
314 therefore not suitable for networkless installation
315 </ti>
316 </tr>
317 </table>
318
319 </body>
320 </subsection>
321 </section>
322 <!-- STOP -->
323 <section>
324 <title>Download, Burn and Boot a Gentoo Installation CD</title>
325 <subsection>
326 <title>Downloading and Burning the Installation CDs</title>
327 <body>
328
329 <p>
330 You have chosen to use a Gentoo Installation CD. We'll first start by
331 downloading and burning the chosen Installation CD. We previously discussed the
332 several available Installation CDs, but where can you find them?
333 </p>
334
335 <p>
336 You can download any of the Installation CDs (and, if you want to, a Packages
337 CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
338 Installation CDs are located in the <path>releases/ppc64/2005.0/installcd</path>
339 directory.
340 </p>
341
342 <p>
343 Inside that directory you'll find so-called ISO-files. Those are full CD images
344 which you can write on a CD-R.
345 </p>
346
347 <p>
348 In case you wonder if your downloaded file is corrupted or not, you can
349 check its MD5 checksum and compare it with the MD5 checksum we provide (such as
350 <path>install-ppc64-g5-minimal-2005.0.iso.md5</path>). You can check the MD5
351 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
352 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
353 </p>
354
355 <p>
356 Another way to check the validity of the downloaded file is to use GnuPG to
357 verify the cryptographic signature that we provide (the file ending with
358 <path>.asc</path>). Download the signature file and obtain the public key:
359 </p>
360
361 <pre caption="Obtaining the public key">
362 $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
363 </pre>
364
365 <p>
366 Now verify the signature:
367 </p>
368
369 <pre caption="Verify the cryptographic signature">
370 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
371 </pre>
372
373 <p>
374 To burn the downloaded ISO(s), you have to select raw-burning. How you
375 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
376 <c>K3B</c> here; more information can be found in our <uri
377 link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
378 </p>
379
380 <ul>
381 <li>
382 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
383 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
384 device path).
385 </li>
386 <li>
387 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
388 you can locate your ISO file within the 'Image to Burn' area. Finally click
389 <c>Start</c>.
390 </li>
391 <li>
392 With Mac OS X Panther, launch <c>Disk Utility</c> from
393 <path>Applications/Utilities</path>, select <c>Open</c> from the
394 <c>Images</c> menu, select the mounted disk image in the main window and
395 select <c>Burn</c> in the <c>Images</c> menu.
396 </li>
397 <li>
398 With Mac OS X Jaguar, launch <c>Disk Copy</c> from
399 <path>Applications/Utilities</path>, select <c>Burn Image</c> from the
400 <c>File</c> menu, select the ISO and click the <c>Burn</c> button.
401 </li>
402 </ul>
403
404 </body>
405 </subsection>
406 <subsection>
407 <title>Default: Booting the Installation CD on an Apple/IBM</title>
408 <body>
409
410 <p>
411 Place the Installation CD in the CD-ROM and reboot the system. Hold down the
412 'C' key at bootup. You will be greeted by a friendly welcome message and a
413 <e>boot:</e> prompt at the bottom of the screen.
414 </p>
415
416 <p>
417 You are also able to tweak some kernel options at this prompt. The following
418 table lists the available boot options you can add:
419 </p>
420
421 <table>
422 <tr>
423 <th>Boot Option</th>
424 <th>Description</th>
425 </tr>
426 <tr>
427 <ti><c>video</c></ti>
428 <ti>
429 This option takes one of the following vendor-specific tags:
430 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
431 <c>ofonly</c>. You can follow this tag with the resolution and refreshrate
432 you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
433 uncertain what to choose, <c>ofonly</c> will most certainly work.
434 </ti>
435 </tr>
436 <tr>
437 <ti><c>nol3</c></ti>
438 <ti>
439 Disables level 3 cache on some powerbooks (needed for at least the 17'')
440 </ti>
441 </tr>
442 <tr>
443 <ti><c>debug</c></ti>
444 <ti>
445 Enables verbose booting, spawns an initrd shell that can be used to debug
446 the Installation CD
447 </ti>
448 </tr>
449 <tr>
450 <ti><c>sleep=X</c></ti>
451 <ti>
452 Wait X seconds before continuing; this can be needed by some very old SCSI
453 CD-ROMs which don't speed up the CD quick enough
454 </ti>
455 </tr>
456 <tr>
457 <ti><c>bootfrom=X</c></ti>
458 <ti>
459 Boot from a different device
460 </ti>
461 </tr>
462 </table>
463
464 <p>
465 At this prompt, hit enter, and a complete Gentoo Linux environment will be
466 loaded from the CD. Continue with <uri link="#booted">And When You're
467 Booted...</uri>.
468 </p>
469
470 </body>
471 </subsection>
472 <subsection>
473 <title>IBM pSeries</title>
474 <body>
475
476 <p>
477 For pSeries boxes, sometimes the cds might not autoboot. You might have
478 to set up your cdrom as a bootable device in the multi-boot menu. (F1 at
479 startup) The other option is to jump into OF and do it from there:
480 </p>
481
482 <p>
483 1) Boot into OF (this is 8 from the serial cons or F8 from a graphics
484 cons, start hitting the key when you see the keyboard mouse etc etc
485 messages
486 </p>
487 <p>
488 2) run the command 0> boot cdrom:1,yaboot
489 </p>
490 <p>
491 3) stand back and enjoy!
492 </p>
493
494 </body>
495 </subsection>
496 <subsection id="booted">
497 <title>And When You're Booted...</title>
498 <body>
499
500 <p>
501 You will be greeted by a root ("#") prompt on the current console. You can also
502 switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
503 back to the one you started on by pressing Alt-fn-F1.
504 </p>
505
506 <p>
507 If you are installing Gentoo on a system with a non-US keyboard, use
508 <c>loadkeys</c> to load the keymap for your keyboard. To list the available
509 keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
510 </p>
511
512 <pre caption="Listing available keymaps">
513 <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
514 on the Installation CD are ADB keymaps and unusable with the
515 Installation CD kernel)</comment>
516 # <i>ls /usr/share/keymaps/i386</i>
517 </pre>
518
519 <p>
520 Now load the keymap of your choice:
521 </p>
522
523 <pre caption="Loading a keymap">
524 # <i>loadkeys be-latin1</i>
525 </pre>
526
527 <p>
528 Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
529 </p>
530
531 </body>
532 </subsection>
533 <subsection id="hardware">
534 <title>Extra Hardware Configuration</title>
535 <body>
536
537 <p>
538 When the Installation CD boots, it tries to detect all your hardware devices and
539 loads the appropriate kernel modules to support your hardware. In the
540 vast majority of cases, it does a very good job. However, in some cases it may
541 not auto-load the kernel
542 modules you need. If the PCI auto-detection missed some of your system's
543 hardware, you will have to load the appropriate kernel modules manually.
544 </p>
545
546 <p>
547 In the next example we try to load the <c>8139too</c> module (support for
548 certain kinds of network interfaces):
549 </p>
550
551 <pre caption="Loading kernel modules">
552 # <i>modprobe 8139too</i>
553 </pre>
554
555 </body>
556 </subsection>
557 <subsection>
558 <title>Optional: Tweaking Hard Disk Performance</title>
559 <body>
560
561 <p>
562 If you are an advanced user, you might want to tweak the IDE hard disk
563 performance using <c>hdparm</c>. With the <c>-tT</c> options you can
564 test the performance of your disk (execute it several times to get a
565 more precise impression):
566 </p>
567
568 <pre caption="Testing disk performance">
569 # <i>hdparm -tT /dev/hda</i>
570 </pre>
571
572 <p>
573 To tweak, you can use any of the following examples (or experiment
574 yourself) which use <path>/dev/hda</path> as disk (substitute with your
575 disk):
576 </p>
577
578 <pre caption="Tweaking hard disk performance">
579 <comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
580 <comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
581 </pre>
582
583 </body>
584 </subsection>
585 <subsection id="useraccounts">
586 <title>Optional: User Accounts</title>
587 <body>
588
589 <p>
590 If you plan on giving other people access to your installation
591 environment or you want to chat using <c>irssi</c> without root privileges (for
592 security reasons), you need to create the necessary user accounts and change
593 the root password.
594 </p>
595
596 <p>
597 To change the root password, use the <c>passwd</c> utility:
598 </p>
599
600 <pre caption="Changing the root password">
601 # <i>passwd</i>
602 New password: <comment>(Enter your new password)</comment>
603 Re-enter password: <comment>(Re-enter your password)</comment>
604 </pre>
605
606 <p>
607 To create a user account, we first enter their credentials, followed by
608 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
609 In the next example, we create a user called &quot;john&quot;.
610 </p>
611
612 <pre caption="Creating a user account">
613 # <i>useradd -m -G users john</i>
614 # <i>passwd john</i>
615 New password: <comment>(Enter john's password)</comment>
616 Re-enter password: <comment>(Re-enter john's password)</comment>
617 </pre>
618
619 <p>
620 You can change your user id from root to the newly created user by using
621 <c>su</c>:
622 </p>
623
624 <pre caption="Changing user id">
625 # <i>su - john</i>
626 </pre>
627
628 </body>
629 </subsection>
630 <subsection>
631 <title>Optional: Viewing Documentation while Installing</title>
632 <body>
633
634 <p>
635 If you want to view the Gentoo Handbook (either from-CD or online) during the
636 installation, make sure you have created a user account (see <uri
637 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
638 go to a new terminal and log in.
639 </p>
640
641 <p>
642 If you want to view the documentation on the CD you can immediately run
643 <c>links2</c> to read it:
644 </p>
645
646 <pre caption="Viewing the on-CD documentation">
647 # <i>links2 /mnt/cdrom/docs/html/index.html</i>
648 </pre>
649
650 <p>
651 However, it is preferred that you use the online Gentoo Handbook as it will be
652 more recent than the one provided on the CD. You can view it using <c>links2</c>
653 as well, but only after having completed the <e>Configuring your Network</e>
654 chapter (otherwise you won't be able to go on the Internet to view the
655 document):
656 </p>
657
658 <pre caption="Viewing the Online Documentation">
659 # <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
660 </pre>
661
662 <p>
663 You can go back to your original terminal by pressing <c>Alt-F1</c>.
664 </p>
665
666 </body>
667 </subsection>
668 <subsection>
669 <title>Optional: Starting the SSH Daemon</title>
670 <body>
671
672 <p>
673 If you want to allow other users to access your computer during the
674 Gentoo installation (perhaps because those users are going to help you
675 install Gentoo, or even do it for you), you need to create a user
676 account for them and perhaps even provide them with your root password
677 (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
678 </p>
679
680 <p>
681 To fire up the SSH daemon, execute the following command:
682 </p>
683
684 <pre caption="Starting the SSH daemon">
685 # <i>/etc/init.d/sshd start</i>
686 </pre>
687
688 <p>
689 To be able to use sshd, you first need to set up your networking. Continue with
690 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
691 </p>
692
693 </body>
694 </subsection>
695 </section>
696 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20