/[gentoo]/xml/htdocs/doc/en/handbook/2008.0/hb-install-ppc64-medium.xml
Gentoo

Contents of /xml/htdocs/doc/en/handbook/2008.0/hb-install-ppc64-medium.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (hide annotations) (download) (as text)
Mon Mar 31 21:48:08 2008 UTC (10 years, 6 months ago) by nightmorph
Branch: MAIN
Changes since 1.2: +2 -2 lines
File MIME type: application/xml
some final changes. added include for block devices, and other cleanups. also included final date bump

1 nightmorph 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     <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6    
7 nightmorph 1.3 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2008.0/hb-install-ppc64-medium.xml,v 1.2 2008/03/01 06:43:00 nightmorph Exp $ -->
8 nightmorph 1.1
9     <sections>
10    
11     <version>9.0</version>
12 nightmorph 1.3 <date>2008-04-01</date>
13 nightmorph 1.1
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, iMac G5, IBP pSeries and IBM OpenPower
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    
65     <!-- START -->
66     <section>
67     <title>The Gentoo Universal Installation CD</title>
68     <subsection>
69     <title>Introduction</title>
70     <body>
71    
72     <p>
73     Gentoo Linux can be installed using a <e>stage3</e> tarball file.
74     Such a tarball is an archive that contains a minimal environment from
75     which you can succesfully install Gentoo Linux onto your system.
76     </p>
77    
78     <p>
79     Installations using a stage1 or stage2 tarball file are not documented in the
80     Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
81     FAQ</uri> on these matters.
82     </p>
83    
84     </body>
85     </subsection>
86     <subsection>
87     <title>Gentoo Universal Installation CD</title>
88     <body>
89    
90     <p>
91     An Installation CD is a bootable medium which contains a self-sustained Gentoo
92     environment. It allows you to boot Linux from the CD. During the boot process
93     your hardware is detected and the appropriate drivers are loaded. The Gentoo
94     Installation CDs are maintained by Gentoo developers.
95     </p>
96    
97     <p>
98     There currently are two Installation CDs available:
99     </p>
100    
101     <ul>
102     <li>
103     The Universal Installation CD contains everything you need to install
104     Gentoo. It provides stage3 files for common architectures, source code
105     for the extra applications you need to choose from and, of course, the
106     installation instructions for your architecture.
107     </li>
108     <li>
109     The Minimal Installation CD contains only a minimal environment that allows
110     you to boot up and configure your network so you can connect to the
111     Internet. It does not contain any additional files and cannot be used
112     during the current installation approach.
113     </li>
114     </ul>
115    
116     <p>
117     Gentoo also provides a Package CD. This is not an Installation CD but an
118     additional resource that you can exploit during the installation of your Gentoo
119     system. It contains prebuilt packages (also known as the GRP set) that allow
120     you to easily and quickly install additional applications immediately after the
121     Gentoo installation and right before you update your Portage tree.
122     </p>
123    
124     <p>
125     The use of the Package CD is covered later in this document.
126     </p>
127    
128     </body>
129     </subsection>
130     <subsection>
131     <title>Choosing a userland</title>
132     <body>
133    
134     <p>
135     On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit. The
136     userland is basically the applications you are running, such as
137     <c>bash</c> or <c>mozilla-firefox</c>. They can be compiled and run in either
138     64-bit or 32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit
139     userlands, so which one should you use?
140     </p>
141    
142     <p>
143     You may have heard that 64-bit applications are better, but in fact, 32-bit
144     applications take up slightly less memory and often run a little bit faster than
145     64-bit applications.
146     </p>
147    
148     <p>
149     You really only need 64-bit applications when you need more memory than a 32-bit
150     userland allows, or if you do a lot of 64-bit number crunching. If you run
151     applications that require more than 4GB of memory or you run scientific
152     applications, you should choose the 64-bit userland. Otherwise, choose the
153     32-bit userland, as it is recommended by the Gentoo/PPC64 developers.
154     </p>
155    
156     <p>
157     Additionally, the 32-bit userland has been available in Portage longer than the
158     64-bit userland has. This means that there are more applications tested in the
159     32-bit userland that just work "out of the box." Many applications compiled for
160     the 64-bit userland may be just as stable as the 32-bit version, but they
161     haven't been tested yet. Though testing isn't difficult to do, it can be
162     annoying and time consuming if you want to use many untested 64-bit
163     applications. Also, some programs just won't run in the 64-bit userland until
164     their code is fixed, such as OpenOffice.
165     </p>
166    
167     <p>
168     The Gentoo/PPC64 team provides stages and Package CDs for both 32-bit and 64-bit
169     userlands, so no matter which one you choose, you'll be able to successfully
170     install Gentoo and get a full system up and running with minimal fuss.
171     </p>
172    
173     </body>
174     </subsection>
175     </section>
176     <!-- STOP -->
177     <section>
178     <title>Download, Burn and Boot a Gentoo Installation CD</title>
179     <subsection>
180     <title>Downloading and Burning the Installation CDs</title>
181     <body>
182    
183     <p>
184     You can download the Universal Installation CD (and, if you want to, the
185     Packages CD as well) from one of our <uri
186     link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
187     the <path><keyval id="release-dir"/>installcd</path> directory; the Package CDs
188     are located in the <path><keyval id="release-dir"/>packagecd</path> directory.
189     </p>
190    
191     <p>
192     Inside those directories you'll find ISO files. Those are full CD images which
193     you can write on a CD-R.
194     </p>
195    
196     <p>
197     After downloading the file, you can verify its integrity to see if it is
198     corrupted or not:
199     </p>
200    
201     <ul>
202     <li>
203     You can check its MD5 checksum and compare it with the MD5 checksum we
204     provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
205     <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows). How
206     to verify MD5 checksums with Mac OS X is described in the <uri
207     link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
208     </li>
209     <li>
210     You can verify the cryptographic signature that we provide. You need to
211     obtain the public key we use (0x17072058) before you proceed though.
212     </li>
213     </ul>
214    
215     <p>
216     To fetch our public key using the GnuPG application, run the following command:
217     </p>
218    
219     <pre caption="Obtaining the public key">
220     $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
221     </pre>
222    
223     <p>
224     Now verify the signature:
225     </p>
226    
227     <pre caption="Verify the cryptographic signature">
228     $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
229     </pre>
230    
231     <p>
232     To burn the downloaded ISO(s), you have to select raw-burning. How you
233     do this is highly program-dependent. We will discuss <c>cdrecord</c> and
234     <c>K3B</c> here; more information can be found in our <uri
235     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
236     </p>
237    
238     <ul>
239     <li>
240     With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
241     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
242     path).
243     </li>
244     <li>
245     With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
246     your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
247     </li>
248     </ul>
249    
250     </body>
251     </subsection>
252     <subsection>
253     <title>Booting the Installation CD on an Apple</title>
254     <body>
255    
256     <p>
257     Please check the <path>README.kernel</path> on the Installation CD for the
258     latest information on how to boot various kernels and getting hardware support.
259     </p>
260    
261     <p>
262     Place the Installation CD in the CD-ROM and reboot the system. Hold down the
263     'C' key at bootup. You will be greeted by a friendly welcome message and a
264     <e>boot:</e> prompt at the bottom of the screen.
265     </p>
266    
267     <p>
268     You are also able to tweak some kernel options at this prompt. The following
269     table lists the available boot options you can add:
270     </p>
271    
272     <table>
273     <tr>
274     <th>Boot Option</th>
275     <th>Description</th>
276     </tr>
277     <tr>
278     <ti><c>video</c></ti>
279     <ti>
280     This option takes one of the following vendor-specific tags:
281     <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
282     or <c>ofonly</c>. You can follow this tag with the resolution and
283     refreshrate you want to use. For instance
284     <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
285     <c>ofonly</c> will most certainly work.
286     </ti>
287     </tr>
288     <tr>
289     <ti><c>nol3</c></ti>
290     <ti>
291     Disables level 3 cache on some powerbooks (needed for at least the 17")
292     </ti>
293     </tr>
294     <tr>
295     <ti><c>debug</c></ti>
296     <ti>
297     Enables verbose booting, spawns an initrd shell that can be used to debug
298     the Installation CD
299     </ti>
300     </tr>
301     <tr>
302     <ti><c>sleep=X</c></ti>
303     <ti>
304     Wait X seconds before continuing; this can be needed by some very old SCSI
305     CD-ROMs which don't speed up the CD quick enough
306     </ti>
307     </tr>
308     <tr>
309     <ti><c>bootfrom=X</c></ti>
310     <ti>
311     Boot from a different device
312     </ti>
313     </tr>
314     </table>
315    
316     <p>
317     At this prompt, hit enter, and a complete Gentoo Linux environment will be
318     loaded from the CD. Continue with <uri link="#booted">And When You're
319     Booted...</uri>.
320     </p>
321    
322     </body>
323     </subsection>
324     <subsection>
325     <title>Booting the Installation CD on an IBM pSeries, OpenPower and Power5
326     iSeries servers</title>
327     <body>
328    
329     <p>
330     Please check the <path>README.kernel</path> on the Installation CD for the
331     latest information on how to boot various kernels and getting hardware support.
332     </p>
333    
334     <p>
335     Most modern pSeries servers can boot from the CDROM drive through SMS ('1' when
336     the “IBM IBM IBM” messages flash across the console). On some older pSeries
337     boxes, sometimes the cds might not autoboot. You might have to set up your
338     cdrom as a bootable device in the multi-boot menu. (F1 at startup) The other
339     option is to jump into OF and do it from there:
340     </p>
341    
342     <ol>
343     <li>
344     Boot into OF (this is 8 from the serial cons or F8 from a graphics
345     cons, start hitting the key when you see the keyboard mouse etc etc
346     messages.
347     </li>
348     <li>Run the command 0> boot cdrom:1,yaboot</li>
349     <li>Stand back and enjoy!</li>
350     </ol>
351    
352     </body>
353     </subsection>
354     <subsection id="booted">
355     <title>And When You're Booted...</title>
356     <body>
357    
358     <p>
359     You will be greeted by a root ("#") prompt on the current console. You can also
360     switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
361     back to the one you started on by pressing Alt-fn-F1.
362     </p>
363    
364     <p>
365     If you are installing Gentoo on a system with a non-US keyboard, use
366     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
367     keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
368     </p>
369    
370     <pre caption="Listing available keymaps">
371     <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
372     on the Installation CD are ADB keymaps and unusable with the
373     Installation CD kernel)</comment>
374     # <i>ls /usr/share/keymaps/i386</i>
375     </pre>
376    
377     <p>
378     Now load the keymap of your choice:
379     </p>
380    
381     <pre caption="Loading a keymap">
382     # <i>loadkeys be-latin1</i>
383     </pre>
384    
385     <p>
386     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
387     </p>
388    
389     </body>
390     </subsection>
391     <subsection id="hardware">
392     <title>Extra Hardware Configuration</title>
393     <body>
394    
395     <p>
396     When the Installation CD boots, it tries to detect all your hardware devices and
397     loads the appropriate kernel modules to support your hardware. In the vast
398     majority of cases, it does a very good job. However, in some cases it may not
399     auto-load the kernel modules you need. If the PCI auto-detection missed some of
400     your system's hardware, you will have to load the appropriate kernel modules
401     manually.
402     </p>
403    
404     <p>
405     In the next example we try to load the <c>8139too</c> module (support for
406     certain kinds of network interfaces):
407     </p>
408    
409     <pre caption="Loading kernel modules">
410     # <i>modprobe 8139too</i>
411     </pre>
412    
413     </body>
414     </subsection>
415     <subsection>
416     <title>Optional: Tweaking Hard Disk Performance</title>
417     <body>
418    
419     <p>
420     If you are an advanced user, you might want to tweak the IDE hard disk
421     performance using <c>hdparm</c>. With the <c>-tT</c> options you can
422     test the performance of your disk (execute it several times to get a
423     more precise impression):
424     </p>
425    
426     <pre caption="Testing disk performance">
427     # <i>hdparm -tT /dev/hda</i>
428     </pre>
429    
430     <p>
431     To tweak, you can use any of the following examples (or experiment
432     yourself) which use <path>/dev/hda</path> as disk (substitute with your
433     disk):
434     </p>
435    
436     <pre caption="Tweaking hard disk performance">
437     <comment>Activate DMA:</comment>
438     # <i>hdparm -d 1 /dev/hda</i>
439     <comment>Activate DMA + Safe Performance-enhancing Options:</comment>
440     # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
441     </pre>
442    
443     </body>
444     </subsection>
445     <subsection id="useraccounts">
446     <title>Optional: User Accounts</title>
447     <body>
448    
449     <p>
450     If you plan on giving other people access to your installation
451     environment or you want to chat using <c>irssi</c> without root privileges (for
452     security reasons), you need to create the necessary user accounts and change
453     the root password.
454     </p>
455    
456     <p>
457     To change the root password, use the <c>passwd</c> utility:
458     </p>
459    
460     <pre caption="Changing the root password">
461     # <i>passwd</i>
462     New password: <comment>(Enter your new password)</comment>
463     Re-enter password: <comment>(Re-enter your password)</comment>
464     </pre>
465    
466     <p>
467     To create a user account, we first enter their credentials, followed by
468     its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
469     In the next example, we create a user called &quot;john&quot;.
470     </p>
471    
472     <pre caption="Creating a user account">
473     # <i>useradd -m -G users john</i>
474     # <i>passwd john</i>
475     New password: <comment>(Enter john's password)</comment>
476     Re-enter password: <comment>(Re-enter john's password)</comment>
477     </pre>
478    
479     <p>
480     You can change your user id from root to the newly created user by using
481     <c>su</c>:
482     </p>
483    
484     <pre caption="Changing user id">
485     # <i>su - john</i>
486     </pre>
487    
488     </body>
489     </subsection>
490     <subsection>
491     <title>Optional: Viewing Documentation while Installing</title>
492     <body>
493    
494     <p>
495     If you want to view the Gentoo Handbook during the installation, make sure you
496     have created a user account (see <uri link="#useraccounts">Optional: User
497     Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
498     </p>
499    
500     <p>
501     If you want to view the documentation on the CD you can immediately run
502     <c>links</c> to read it:
503     </p>
504    
505     <pre caption="Viewing the on-CD documentation">
506     # <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
507     </pre>
508    
509     <p>
510     However, it is preferred that you use the online Gentoo Handbook as it will be
511     more recent than the one provided on the CD.
512     </p>
513    
514     <pre caption="Viewing the Online Documentation">
515     # <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
516     </pre>
517    
518     <p>
519     You can go back to your original terminal by pressing <c>Alt-F1</c>.
520     </p>
521    
522     </body>
523     </subsection>
524     <subsection>
525     <title>Optional: Starting the SSH Daemon</title>
526     <body>
527    
528     <p>
529     If you want to allow other users to access your computer during the
530     Gentoo installation (perhaps because those users are going to help you
531     install Gentoo, or even do it for you), you need to create a user
532     account for them and perhaps even provide them with your root password
533     (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
534     </p>
535    
536     <p>
537     To fire up the SSH daemon, execute the following command:
538     </p>
539    
540     <pre caption="Starting the SSH daemon">
541     # <i>/etc/init.d/sshd start</i>
542     </pre>
543    
544     <p>
545     To be able to use sshd, you first need to set up your networking. Continue with
546     the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
547     </p>
548    
549     </body>
550     </subsection>
551     </section>
552     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20