/[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.33 - (hide annotations) (download) (as text)
Mon May 7 18:11:41 2007 UTC (7 years, 4 months ago) by nightmorph
Branch: MAIN
Changes since 1.32: +70 -24 lines
File MIME type: application/xml
2007.0 release is here; final changes and new docs

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.33 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-medium.xml,v 1.25 2007/04/21 03:53:22 nightmorph Exp $ -->
8 swift 1.1
9     <sections>
10 swift 1.10
11 nightmorph 1.33 <version>8.0</version>
12     <date>2007-05-07</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     <uri>http://www.linuxppc64.org/hardware.shtml</uri>.
59 swift 1.1 </p>
60    
61     </body>
62     </subsection>
63     </section>
64 swift 1.14 <!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
65     <!-- 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 swift 1.17 two Installation CDs which are equaly 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 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.33 link="2007.0/index.xml">Gentoo 2007.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.33 <c>install-ppc64-minimal-2007.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.33 <c>install-ppc64-universal-2007.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     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 neysx 1.27 </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 swift 1.25 <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 nightmorph 1.33 <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 swift 1.1 </section>
243 swift 1.14 <!-- STOP -->
244 swift 1.1 <section>
245 swift 1.17 <title>Download, Burn and Boot a Gentoo Installation CD</title>
246 swift 1.1 <subsection>
247 swift 1.17 <title>Downloading and Burning the Installation CDs</title>
248 swift 1.1 <body>
249    
250     <p>
251 swift 1.17 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 swift 1.14 </p>
255    
256     <p>
257 nightmorph 1.33 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 swift 1.1 </p>
262    
263     <p>
264 neysx 1.26 Inside that directory you'll find ISO-files. Those are full CD images
265 swift 1.1 which you can write on a CD-R.
266     </p>
267    
268     <p>
269 swift 1.14 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 nightmorph 1.33 <path>install-ppc64-minimal-2007.0.iso.DIGESTS</path>). You can check the MD5
272 swift 1.1 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 swift 1.14 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 swift 1.1 </p>
281    
282 swift 1.14 <pre caption="Obtaining the public key">
283 jkt 1.28 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
284 swift 1.1 </pre>
285    
286     <p>
287 swift 1.14 Now verify the signature:
288 swift 1.1 </p>
289    
290 swift 1.14 <pre caption="Verify the cryptographic signature">
291     $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
292     </pre>
293 swift 1.1
294     <p>
295     To burn the downloaded ISO(s), you have to select raw-burning. How you
296 swift 1.14 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 swift 1.1 </p>
300    
301     <ul>
302     <li>
303 swift 1.14 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 swift 1.16 device path).
306 swift 1.1 </li>
307     <li>
308 swift 1.14 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
309 swift 1.1 you can locate your ISO file within the 'Image to Burn' area. Finally click
310     <c>Start</c>.
311     </li>
312 swift 1.7 <li>
313     With Mac OS X Panther, launch <c>Disk Utility</c> from
314     <path>Applications/Utilities</path>, select <c>Open</c> from the
315     <c>Images</c> menu, select the mounted disk image in the main window and
316     select <c>Burn</c> in the <c>Images</c> menu.
317     </li>
318     <li>
319     With Mac OS X Jaguar, launch <c>Disk Copy</c> from
320     <path>Applications/Utilities</path>, select <c>Burn Image</c> from the
321     <c>File</c> menu, select the ISO and click the <c>Burn</c> button.
322     </li>
323 swift 1.1 </ul>
324    
325     </body>
326     </subsection>
327     <subsection>
328 swift 1.17 <title>Default: Booting the Installation CD on an Apple/IBM</title>
329 swift 1.1 <body>
330    
331     <p>
332 swift 1.17 Place the Installation CD in the CD-ROM and reboot the system. Hold down the
333     'C' key at bootup. You will be greeted by a friendly welcome message and a
334     <e>boot:</e> prompt at the bottom of the screen.
335 swift 1.1 </p>
336    
337     <p>
338     You are also able to tweak some kernel options at this prompt. The following
339     table lists the available boot options you can add:
340     </p>
341    
342     <table>
343     <tr>
344     <th>Boot Option</th>
345     <th>Description</th>
346     </tr>
347     <tr>
348     <ti><c>video</c></ti>
349     <ti>
350     This option takes one of the following vendor-specific tags:
351 nightmorph 1.32 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
352     or <c>ofonly</c>. You can follow this tag with the resolution and
353 nightmorph 1.33 refreshrate you want to use. For instance
354     <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
355     <c>ofonly</c> will most certainly work.
356 swift 1.1 </ti>
357     </tr>
358     <tr>
359     <ti><c>nol3</c></ti>
360     <ti>
361 nightmorph 1.33 Disables level 3 cache on some powerbooks (needed for at least the 17")
362 swift 1.1 </ti>
363     </tr>
364     <tr>
365     <ti><c>debug</c></ti>
366     <ti>
367     Enables verbose booting, spawns an initrd shell that can be used to debug
368 swift 1.17 the Installation CD
369 swift 1.1 </ti>
370     </tr>
371     <tr>
372     <ti><c>sleep=X</c></ti>
373     <ti>
374     Wait X seconds before continuing; this can be needed by some very old SCSI
375     CD-ROMs which don't speed up the CD quick enough
376     </ti>
377     </tr>
378     <tr>
379     <ti><c>bootfrom=X</c></ti>
380     <ti>
381     Boot from a different device
382     </ti>
383     </tr>
384     </table>
385    
386     <p>
387     At this prompt, hit enter, and a complete Gentoo Linux environment will be
388     loaded from the CD. Continue with <uri link="#booted">And When You're
389     Booted...</uri>.
390     </p>
391    
392     </body>
393     </subsection>
394     <subsection>
395     <title>IBM pSeries</title>
396     <body>
397    
398     <p>
399 neysx 1.30 The CD should autoboot on your pSeries box, but sometimes it does not. In that
400     case, you have to set up your cdrom as a bootable device in the multi-boot
401     menu. If you start your machine with a monitor and a keyboard attached, you can
402     reach the multi-boot menu pressing the F1 key on startup. But if you start your
403     machine using the serial console, then you have to press <c>1</c>. Press the
404     key when you see the beginning of the following line on the serial console:
405 swift 1.1 </p>
406    
407 neysx 1.30 <pre caption="Hit the '1' key when this line appears">
408     memory keyboard network scsi speaker
409     </pre>
410    
411 swift 1.1 <p>
412 neysx 1.30 The other option is to jump into OpenFirmware and do it from there:
413 swift 1.1 </p>
414 neysx 1.30
415     <ol>
416     <li>
417     Boot into OpenFirmware: same procedure as getting into multi-boot
418     (described a few lines above), but use F8 and 8 instead of F1 and 1.
419     </li>
420     <li>Run the command 0> boot cdrom:1,yaboot</li>
421     <li>Stand back and enjoy!</li>
422     </ol>
423    
424     <note>
425     If you get something like the following output, then OpenFirmware isn't set up
426     correctly. Please use the multi-boot option described above.
427     </note>
428    
429 fox2mike 1.31 <pre caption="Output if OpenFirmware is not set up correctly">
430 neysx 1.30 0 > boot cdrom:1,yaboot
431     ok
432     0 >
433     </pre>
434 swift 1.1
435     </body>
436     </subsection>
437     <subsection id="booted">
438     <title>And When You're Booted...</title>
439     <body>
440    
441     <p>
442     You will be greeted by a root ("#") prompt on the current console. You can also
443     switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
444     back to the one you started on by pressing Alt-fn-F1.
445     </p>
446    
447     <p>
448     If you are installing Gentoo on a system with a non-US keyboard, use
449     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
450     keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
451     </p>
452    
453     <pre caption="Listing available keymaps">
454     <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
455 swift 1.17 on the Installation CD are ADB keymaps and unusable with the
456     Installation CD kernel)</comment>
457 swift 1.1 # <i>ls /usr/share/keymaps/i386</i>
458     </pre>
459    
460     <p>
461     Now load the keymap of your choice:
462     </p>
463    
464     <pre caption="Loading a keymap">
465     # <i>loadkeys be-latin1</i>
466     </pre>
467    
468     <p>
469     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
470     </p>
471    
472     </body>
473     </subsection>
474     <subsection id="hardware">
475     <title>Extra Hardware Configuration</title>
476     <body>
477    
478     <p>
479 swift 1.17 When the Installation CD boots, it tries to detect all your hardware devices and
480 nightmorph 1.33 loads the appropriate kernel modules to support your hardware. In the vast
481     majority of cases, it does a very good job. However, in some cases it may not
482     auto-load the kernel modules you need. If the PCI auto-detection missed some of
483     your system's hardware, you will have to load the appropriate kernel modules
484     manually.
485 swift 1.1 </p>
486    
487     <p>
488     In the next example we try to load the <c>8139too</c> module (support for
489     certain kinds of network interfaces):
490     </p>
491    
492     <pre caption="Loading kernel modules">
493     # <i>modprobe 8139too</i>
494     </pre>
495    
496     </body>
497     </subsection>
498     <subsection>
499     <title>Optional: Tweaking Hard Disk Performance</title>
500     <body>
501    
502     <p>
503     If you are an advanced user, you might want to tweak the IDE hard disk
504     performance using <c>hdparm</c>. With the <c>-tT</c> options you can
505     test the performance of your disk (execute it several times to get a
506     more precise impression):
507     </p>
508    
509     <pre caption="Testing disk performance">
510     # <i>hdparm -tT /dev/hda</i>
511     </pre>
512    
513     <p>
514     To tweak, you can use any of the following examples (or experiment
515     yourself) which use <path>/dev/hda</path> as disk (substitute with your
516     disk):
517     </p>
518    
519     <pre caption="Tweaking hard disk performance">
520 nightmorph 1.33 <comment>Activate DMA:</comment>
521     # <i>hdparm -d 1 /dev/hda</i>
522     <comment>Activate DMA + Safe Performance-enhancing Options:</comment>
523     # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
524 swift 1.1 </pre>
525    
526     </body>
527     </subsection>
528 swift 1.2 <subsection id="useraccounts">
529 swift 1.1 <title>Optional: User Accounts</title>
530     <body>
531    
532     <p>
533     If you plan on giving other people access to your installation
534     environment or you want to chat using <c>irssi</c> without root privileges (for
535     security reasons), you need to create the necessary user accounts and change
536     the root password.
537     </p>
538    
539     <p>
540     To change the root password, use the <c>passwd</c> utility:
541     </p>
542    
543     <pre caption="Changing the root password">
544     # <i>passwd</i>
545     New password: <comment>(Enter your new password)</comment>
546     Re-enter password: <comment>(Re-enter your password)</comment>
547     </pre>
548    
549     <p>
550     To create a user account, we first enter their credentials, followed by
551     its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
552     In the next example, we create a user called &quot;john&quot;.
553     </p>
554    
555     <pre caption="Creating a user account">
556 swift 1.8 # <i>useradd -m -G users john</i>
557 swift 1.1 # <i>passwd john</i>
558     New password: <comment>(Enter john's password)</comment>
559     Re-enter password: <comment>(Re-enter john's password)</comment>
560     </pre>
561    
562     <p>
563     You can change your user id from root to the newly created user by using
564     <c>su</c>:
565     </p>
566    
567     <pre caption="Changing user id">
568 swift 1.4 # <i>su - john</i>
569 swift 1.1 </pre>
570    
571     </body>
572     </subsection>
573     <subsection>
574 swift 1.2 <title>Optional: Viewing Documentation while Installing</title>
575     <body>
576    
577     <p>
578 neysx 1.20 If you want to view the Gentoo Handbook during the installation, make sure you
579     have created a user account (see <uri link="#useraccounts">Optional: User
580     Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
581 swift 1.2 </p>
582    
583     <p>
584     If you want to view the documentation on the CD you can immediately run
585 fox2mike 1.29 <c>links</c> to read it:
586 swift 1.2 </p>
587    
588     <pre caption="Viewing the on-CD documentation">
589 fox2mike 1.29 # <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
590 swift 1.2 </pre>
591    
592     <p>
593     However, it is preferred that you use the online Gentoo Handbook as it will be
594 neysx 1.20 more recent than the one provided on the CD.
595 swift 1.2 </p>
596    
597     <pre caption="Viewing the Online Documentation">
598 nightmorph 1.33 # <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
599 swift 1.2 </pre>
600    
601     <p>
602     You can go back to your original terminal by pressing <c>Alt-F1</c>.
603     </p>
604    
605     </body>
606     </subsection>
607     <subsection>
608 swift 1.1 <title>Optional: Starting the SSH Daemon</title>
609     <body>
610    
611     <p>
612     If you want to allow other users to access your computer during the
613     Gentoo installation (perhaps because those users are going to help you
614     install Gentoo, or even do it for you), you need to create a user
615     account for them and perhaps even provide them with your root password
616     (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
617     </p>
618    
619     <p>
620     To fire up the SSH daemon, execute the following command:
621     </p>
622    
623     <pre caption="Starting the SSH daemon">
624     # <i>/etc/init.d/sshd start</i>
625     </pre>
626    
627     <p>
628 swift 1.6 To be able to use sshd, you first need to set up your networking. Continue with
629 swift 1.1 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
630     </p>
631    
632     </body>
633     </subsection>
634     </section>
635     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20