/[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.32 - (hide annotations) (download) (as text)
Wed Aug 30 22:52:28 2006 UTC (7 years, 7 months ago) by nightmorph
Branch: MAIN
Changes since 1.31: +13 -12 lines
File MIME type: application/xml
2006.1 networked docs are in. portage handbook still untouched per separate bugs. thanks to all the hard work, guys. blame me if something is wrong (and please fix quickly) :)

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.32 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-medium.xml,v 1.18 2006/08/11 17:49:42 fox2mike Exp $ -->
8 swift 1.1
9     <sections>
10 swift 1.10
11 nightmorph 1.32 <version>7.0</version>
12     <date>2006-08-30</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.32 link="2006.1/index.xml">Gentoo 2006.1 Handbooks</uri>. This is currently not
91 swift 1.14 supported for the PPC64 architecture though.
92 swift 1.1 </p>
93    
94     <p>
95 neysx 1.27 The two Installation CDs that we currently provide are:
96     </p>
97    
98     <ul>
99     <li>
100     The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
101     CD which sole purpose is to boot the system, prepare the networking and
102     continue with the Gentoo installation.
103     </li>
104     <li>
105     The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
106     abilities as the Minimal Installation CD. Additionally, it contains
107     several stage3 tarballs (optimized for the individual subarchitectures).
108     </li>
109     </ul>
110    
111     <p>
112     To help you decide which Installation CD you need, we have written down the
113     major advantages and disadvantages of each Installation CD.
114 swift 1.1 </p>
115    
116     </body>
117     </subsection>
118     <subsection>
119 swift 1.17 <title>Gentoo's Minimal Installation CD</title>
120 swift 1.1 <body>
121    
122     <p>
123 swift 1.17 The Minimal Installation CD is called
124 nightmorph 1.32 <c>install-ppc64-minimal-2006.1.iso</c> and takes up only 124 MB of
125 swift 1.17 diskspace. You can use this Installation CD to install Gentoo, but always with a
126 swift 1.14 working Internet connection only.
127 swift 1.1 </p>
128    
129     <table>
130     <tr>
131 swift 1.17 <th>Minimal Installation CD</th>
132 swift 1.1 <th>Pros and Cons</th>
133     </tr>
134     <tr>
135     <th>+</th>
136     <ti>Smallest download</ti>
137     </tr>
138     <tr>
139     <th>-</th>
140     <ti>
141 swift 1.25 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
142 swift 1.14 therefore not suitable for networkless installation
143 swift 1.1 </ti>
144     </tr>
145     </table>
146    
147     </body>
148     </subsection>
149 swift 1.25 <subsection>
150 neysx 1.27 <title>Gentoo's Universal Installation CD</title>
151     <body>
152    
153     <p>
154     The Universal Installation CD is called
155 nightmorph 1.32 <c>install-ppc64-universal-2006.1.iso</c> and uses 460 MB. You can use
156 fox2mike 1.29 this Installation CD to install Gentoo, and you can even use it to install
157     Gentoo without a working internet connection, just in case you want to bring
158     Gentoo to another PC than the one you are currently installing Gentoo on :)
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    
179     </body>
180     </subsection>
181     <subsection>
182 swift 1.25 <title>The Stage3 Tarball</title>
183     <body>
184    
185     <p>
186     A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
187     to continue the Gentoo installation using the instructions in this manual.
188     Previously, the Gentoo Handbook described the installation using one of three
189     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     </body>
197     </subsection>
198 swift 1.1 </section>
199 swift 1.14 <!-- STOP -->
200 swift 1.1 <section>
201 swift 1.17 <title>Download, Burn and Boot a Gentoo Installation CD</title>
202 swift 1.1 <subsection>
203 swift 1.17 <title>Downloading and Burning the Installation CDs</title>
204 swift 1.1 <body>
205    
206     <p>
207 swift 1.17 You have chosen to use a Gentoo Installation CD. We'll first start by
208     downloading and burning the chosen Installation CD. We previously discussed the
209     several available Installation CDs, but where can you find them?
210 swift 1.14 </p>
211    
212     <p>
213 neysx 1.27 You can download any of the Installation CDs (and, if you want to, a Packages
214 swift 1.17 CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
215 neysx 1.27 Installation CDs are located in the
216 nightmorph 1.32 <path>releases/ppc/2006.1/ppc64/installcd</path> directory.
217 swift 1.1 </p>
218    
219     <p>
220 neysx 1.26 Inside that directory you'll find ISO-files. Those are full CD images
221 swift 1.1 which you can write on a CD-R.
222     </p>
223    
224     <p>
225 swift 1.14 In case you wonder if your downloaded file is corrupted or not, you can
226     check its MD5 checksum and compare it with the MD5 checksum we provide (such as
227 nightmorph 1.32 <path>install-ppc64-minimal-2006.1.iso.DIGESTS</path>). You can check the MD5
228 swift 1.1 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
229     link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
230     </p>
231    
232     <p>
233 swift 1.14 Another way to check the validity of the downloaded file is to use GnuPG to
234     verify the cryptographic signature that we provide (the file ending with
235     <path>.asc</path>). Download the signature file and obtain the public key:
236 swift 1.1 </p>
237    
238 swift 1.14 <pre caption="Obtaining the public key">
239 jkt 1.28 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
240 swift 1.1 </pre>
241    
242     <p>
243 swift 1.14 Now verify the signature:
244 swift 1.1 </p>
245    
246 swift 1.14 <pre caption="Verify the cryptographic signature">
247     $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
248     </pre>
249 swift 1.1
250     <p>
251     To burn the downloaded ISO(s), you have to select raw-burning. How you
252 swift 1.14 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
253     <c>K3B</c> here; more information can be found in our <uri
254     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
255 swift 1.1 </p>
256    
257     <ul>
258     <li>
259 swift 1.14 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
260     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
261 swift 1.16 device path).
262 swift 1.1 </li>
263     <li>
264 swift 1.14 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
265 swift 1.1 you can locate your ISO file within the 'Image to Burn' area. Finally click
266     <c>Start</c>.
267     </li>
268 swift 1.7 <li>
269     With Mac OS X Panther, launch <c>Disk Utility</c> from
270     <path>Applications/Utilities</path>, select <c>Open</c> from the
271     <c>Images</c> menu, select the mounted disk image in the main window and
272     select <c>Burn</c> in the <c>Images</c> menu.
273     </li>
274     <li>
275     With Mac OS X Jaguar, launch <c>Disk Copy</c> from
276     <path>Applications/Utilities</path>, select <c>Burn Image</c> from the
277     <c>File</c> menu, select the ISO and click the <c>Burn</c> button.
278     </li>
279 swift 1.1 </ul>
280    
281     </body>
282     </subsection>
283     <subsection>
284 swift 1.17 <title>Default: Booting the Installation CD on an Apple/IBM</title>
285 swift 1.1 <body>
286    
287     <p>
288 swift 1.17 Place the Installation CD in the CD-ROM and reboot the system. Hold down the
289     'C' key at bootup. You will be greeted by a friendly welcome message and a
290     <e>boot:</e> prompt at the bottom of the screen.
291 swift 1.1 </p>
292    
293     <p>
294     You are also able to tweak some kernel options at this prompt. The following
295     table lists the available boot options you can add:
296     </p>
297    
298     <table>
299     <tr>
300     <th>Boot Option</th>
301     <th>Description</th>
302     </tr>
303     <tr>
304     <ti><c>video</c></ti>
305     <ti>
306     This option takes one of the following vendor-specific tags:
307 nightmorph 1.32 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
308     or <c>ofonly</c>. You can follow this tag with the resolution and
309     refreshrate you want to use. For instance <c>video=radeonfb:1280x1024@75</c>
310     . If you are uncertain what to choose, <c>ofonly</c> will most certainly
311     work.
312 swift 1.1 </ti>
313     </tr>
314     <tr>
315     <ti><c>nol3</c></ti>
316     <ti>
317     Disables level 3 cache on some powerbooks (needed for at least the 17'')
318     </ti>
319     </tr>
320     <tr>
321     <ti><c>debug</c></ti>
322     <ti>
323     Enables verbose booting, spawns an initrd shell that can be used to debug
324 swift 1.17 the Installation CD
325 swift 1.1 </ti>
326     </tr>
327     <tr>
328     <ti><c>sleep=X</c></ti>
329     <ti>
330     Wait X seconds before continuing; this can be needed by some very old SCSI
331     CD-ROMs which don't speed up the CD quick enough
332     </ti>
333     </tr>
334     <tr>
335     <ti><c>bootfrom=X</c></ti>
336     <ti>
337     Boot from a different device
338     </ti>
339     </tr>
340     </table>
341    
342     <p>
343     At this prompt, hit enter, and a complete Gentoo Linux environment will be
344     loaded from the CD. Continue with <uri link="#booted">And When You're
345     Booted...</uri>.
346     </p>
347    
348     </body>
349     </subsection>
350     <subsection>
351     <title>IBM pSeries</title>
352     <body>
353    
354     <p>
355 neysx 1.30 The CD should autoboot on your pSeries box, but sometimes it does not. In that
356     case, you have to set up your cdrom as a bootable device in the multi-boot
357     menu. If you start your machine with a monitor and a keyboard attached, you can
358     reach the multi-boot menu pressing the F1 key on startup. But if you start your
359     machine using the serial console, then you have to press <c>1</c>. Press the
360     key when you see the beginning of the following line on the serial console:
361 swift 1.1 </p>
362    
363 neysx 1.30 <pre caption="Hit the '1' key when this line appears">
364     memory keyboard network scsi speaker
365     </pre>
366    
367 swift 1.1 <p>
368 neysx 1.30 The other option is to jump into OpenFirmware and do it from there:
369 swift 1.1 </p>
370 neysx 1.30
371     <ol>
372     <li>
373     Boot into OpenFirmware: same procedure as getting into multi-boot
374     (described a few lines above), but use F8 and 8 instead of F1 and 1.
375     </li>
376     <li>Run the command 0> boot cdrom:1,yaboot</li>
377     <li>Stand back and enjoy!</li>
378     </ol>
379    
380     <note>
381     If you get something like the following output, then OpenFirmware isn't set up
382     correctly. Please use the multi-boot option described above.
383     </note>
384    
385 fox2mike 1.31 <pre caption="Output if OpenFirmware is not set up correctly">
386 neysx 1.30 0 > boot cdrom:1,yaboot
387     ok
388     0 >
389     </pre>
390 swift 1.1
391     </body>
392     </subsection>
393     <subsection id="booted">
394     <title>And When You're Booted...</title>
395     <body>
396    
397     <p>
398     You will be greeted by a root ("#") prompt on the current console. You can also
399     switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
400     back to the one you started on by pressing Alt-fn-F1.
401     </p>
402    
403     <p>
404     If you are installing Gentoo on a system with a non-US keyboard, use
405     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
406     keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
407     </p>
408    
409     <pre caption="Listing available keymaps">
410     <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
411 swift 1.17 on the Installation CD are ADB keymaps and unusable with the
412     Installation CD kernel)</comment>
413 swift 1.1 # <i>ls /usr/share/keymaps/i386</i>
414     </pre>
415    
416     <p>
417     Now load the keymap of your choice:
418     </p>
419    
420     <pre caption="Loading a keymap">
421     # <i>loadkeys be-latin1</i>
422     </pre>
423    
424     <p>
425     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
426     </p>
427    
428     </body>
429     </subsection>
430     <subsection id="hardware">
431     <title>Extra Hardware Configuration</title>
432     <body>
433    
434     <p>
435 swift 1.17 When the Installation CD boots, it tries to detect all your hardware devices and
436 swift 1.1 loads the appropriate kernel modules to support your hardware. In the
437 swift 1.17 vast majority of cases, it does a very good job. However, in some cases it may
438     not auto-load the kernel
439 swift 1.1 modules you need. If the PCI auto-detection missed some of your system's
440     hardware, you will have to load the appropriate kernel modules manually.
441     </p>
442    
443     <p>
444     In the next example we try to load the <c>8139too</c> module (support for
445     certain kinds of network interfaces):
446     </p>
447    
448     <pre caption="Loading kernel modules">
449     # <i>modprobe 8139too</i>
450     </pre>
451    
452     </body>
453     </subsection>
454     <subsection>
455     <title>Optional: Tweaking Hard Disk Performance</title>
456     <body>
457    
458     <p>
459     If you are an advanced user, you might want to tweak the IDE hard disk
460     performance using <c>hdparm</c>. With the <c>-tT</c> options you can
461     test the performance of your disk (execute it several times to get a
462     more precise impression):
463     </p>
464    
465     <pre caption="Testing disk performance">
466     # <i>hdparm -tT /dev/hda</i>
467     </pre>
468    
469     <p>
470     To tweak, you can use any of the following examples (or experiment
471     yourself) which use <path>/dev/hda</path> as disk (substitute with your
472     disk):
473     </p>
474    
475     <pre caption="Tweaking hard disk performance">
476     <comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
477     <comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
478     </pre>
479    
480     </body>
481     </subsection>
482 swift 1.2 <subsection id="useraccounts">
483 swift 1.1 <title>Optional: User Accounts</title>
484     <body>
485    
486     <p>
487     If you plan on giving other people access to your installation
488     environment or you want to chat using <c>irssi</c> without root privileges (for
489     security reasons), you need to create the necessary user accounts and change
490     the root password.
491     </p>
492    
493     <p>
494     To change the root password, use the <c>passwd</c> utility:
495     </p>
496    
497     <pre caption="Changing the root password">
498     # <i>passwd</i>
499     New password: <comment>(Enter your new password)</comment>
500     Re-enter password: <comment>(Re-enter your password)</comment>
501     </pre>
502    
503     <p>
504     To create a user account, we first enter their credentials, followed by
505     its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
506     In the next example, we create a user called &quot;john&quot;.
507     </p>
508    
509     <pre caption="Creating a user account">
510 swift 1.8 # <i>useradd -m -G users john</i>
511 swift 1.1 # <i>passwd john</i>
512     New password: <comment>(Enter john's password)</comment>
513     Re-enter password: <comment>(Re-enter john's password)</comment>
514     </pre>
515    
516     <p>
517     You can change your user id from root to the newly created user by using
518     <c>su</c>:
519     </p>
520    
521     <pre caption="Changing user id">
522 swift 1.4 # <i>su - john</i>
523 swift 1.1 </pre>
524    
525     </body>
526     </subsection>
527     <subsection>
528 swift 1.2 <title>Optional: Viewing Documentation while Installing</title>
529     <body>
530    
531     <p>
532 neysx 1.20 If you want to view the Gentoo Handbook during the installation, make sure you
533     have created a user account (see <uri link="#useraccounts">Optional: User
534     Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
535 swift 1.2 </p>
536    
537     <p>
538     If you want to view the documentation on the CD you can immediately run
539 fox2mike 1.29 <c>links</c> to read it:
540 swift 1.2 </p>
541    
542     <pre caption="Viewing the on-CD documentation">
543 fox2mike 1.29 # <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
544 swift 1.2 </pre>
545    
546     <p>
547     However, it is preferred that you use the online Gentoo Handbook as it will be
548 neysx 1.20 more recent than the one provided on the CD.
549 swift 1.2 </p>
550    
551     <pre caption="Viewing the Online Documentation">
552 fox2mike 1.29 # <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
553 swift 1.2 </pre>
554    
555     <p>
556     You can go back to your original terminal by pressing <c>Alt-F1</c>.
557     </p>
558    
559     </body>
560     </subsection>
561     <subsection>
562 swift 1.1 <title>Optional: Starting the SSH Daemon</title>
563     <body>
564    
565     <p>
566     If you want to allow other users to access your computer during the
567     Gentoo installation (perhaps because those users are going to help you
568     install Gentoo, or even do it for you), you need to create a user
569     account for them and perhaps even provide them with your root password
570     (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
571     </p>
572    
573     <p>
574     To fire up the SSH daemon, execute the following command:
575     </p>
576    
577     <pre caption="Starting the SSH daemon">
578     # <i>/etc/init.d/sshd start</i>
579     </pre>
580    
581     <p>
582 swift 1.6 To be able to use sshd, you first need to set up your networking. Continue with
583 swift 1.1 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
584     </p>
585    
586     </body>
587     </subsection>
588     </section>
589     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20