/[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.2 - (show annotations) (download) (as text)
Sat Mar 1 06:43:00 2008 UTC (9 years, 10 months ago) by nightmorph
Branch: MAIN
Changes since 1.1: +2 -2 lines
File MIME type: application/xml
bumped dates. added libata framework mention for bug 208738. removed now-default kernel option as planned. other small fixes.

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/2008.0/hb-install-ppc64-medium.xml,v 1.1 2008/02/27 22:46:58 nightmorph Exp $ -->
8
9 <sections>
10
11 <version>9.0</version>
12 <date>2008-02-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, 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