/[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 - (show annotations) (download) (as text)
Wed Aug 30 22:52:28 2006 UTC (8 years 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 <?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/draft/hb-install-ppc64-medium.xml,v 1.18 2006/08/11 17:49:42 fox2mike Exp $ -->
8
9 <sections>
10
11 <version>7.0</version>
12 <date>2006-08-30</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, IBM 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 CDs</title>
68 <subsection>
69 <title>Introduction</title>
70 <body>
71
72 <p>
73 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
74 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 All Installation CDs allow you to boot, set up networking, initialize your
81 partitions and start installing Gentoo from the Internet. We currently provide
82 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 </p>
86
87 <p>
88 If you wish to install Gentoo without a working Internet connection, please use
89 the installation instructions described in the <uri
90 link="2006.1/index.xml">Gentoo 2006.1 Handbooks</uri>. This is currently not
91 supported for the PPC64 architecture though.
92 </p>
93
94 <p>
95 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 </p>
115
116 </body>
117 </subsection>
118 <subsection>
119 <title>Gentoo's Minimal Installation CD</title>
120 <body>
121
122 <p>
123 The Minimal Installation CD is called
124 <c>install-ppc64-minimal-2006.1.iso</c> and takes up only 124 MB of
125 diskspace. You can use this Installation CD to install Gentoo, but always with a
126 working Internet connection only.
127 </p>
128
129 <table>
130 <tr>
131 <th>Minimal Installation CD</th>
132 <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 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
142 therefore not suitable for networkless installation
143 </ti>
144 </tr>
145 </table>
146
147 </body>
148 </subsection>
149 <subsection>
150 <title>Gentoo's Universal Installation CD</title>
151 <body>
152
153 <p>
154 The Universal Installation CD is called
155 <c>install-ppc64-universal-2006.1.iso</c> and uses 460 MB. You can use
156 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 </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 <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 </section>
199 <!-- STOP -->
200 <section>
201 <title>Download, Burn and Boot a Gentoo Installation CD</title>
202 <subsection>
203 <title>Downloading and Burning the Installation CDs</title>
204 <body>
205
206 <p>
207 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 </p>
211
212 <p>
213 You can download any of the Installation CDs (and, if you want to, a Packages
214 CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
215 Installation CDs are located in the
216 <path>releases/ppc/2006.1/ppc64/installcd</path> directory.
217 </p>
218
219 <p>
220 Inside that directory you'll find ISO-files. Those are full CD images
221 which you can write on a CD-R.
222 </p>
223
224 <p>
225 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 <path>install-ppc64-minimal-2006.1.iso.DIGESTS</path>). You can check the MD5
228 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 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 </p>
237
238 <pre caption="Obtaining the public key">
239 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
240 </pre>
241
242 <p>
243 Now verify the signature:
244 </p>
245
246 <pre caption="Verify the cryptographic signature">
247 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
248 </pre>
249
250 <p>
251 To burn the downloaded ISO(s), you have to select raw-burning. How you
252 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 </p>
256
257 <ul>
258 <li>
259 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 device path).
262 </li>
263 <li>
264 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
265 you can locate your ISO file within the 'Image to Burn' area. Finally click
266 <c>Start</c>.
267 </li>
268 <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 </ul>
280
281 </body>
282 </subsection>
283 <subsection>
284 <title>Default: Booting the Installation CD on an Apple/IBM</title>
285 <body>
286
287 <p>
288 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 </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 <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 </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 the Installation CD
325 </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 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 </p>
362
363 <pre caption="Hit the '1' key when this line appears">
364 memory keyboard network scsi speaker
365 </pre>
366
367 <p>
368 The other option is to jump into OpenFirmware and do it from there:
369 </p>
370
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 <pre caption="Output if OpenFirmware is not set up correctly">
386 0 > boot cdrom:1,yaboot
387 ok
388 0 >
389 </pre>
390
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 on the Installation CD are ADB keymaps and unusable with the
412 Installation CD kernel)</comment>
413 # <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 When the Installation CD boots, it tries to detect all your hardware devices and
436 loads the appropriate kernel modules to support your hardware. In the
437 vast majority of cases, it does a very good job. However, in some cases it may
438 not auto-load the kernel
439 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 <subsection id="useraccounts">
483 <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 # <i>useradd -m -G users john</i>
511 # <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 # <i>su - john</i>
523 </pre>
524
525 </body>
526 </subsection>
527 <subsection>
528 <title>Optional: Viewing Documentation while Installing</title>
529 <body>
530
531 <p>
532 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 </p>
536
537 <p>
538 If you want to view the documentation on the CD you can immediately run
539 <c>links</c> to read it:
540 </p>
541
542 <pre caption="Viewing the on-CD documentation">
543 # <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
544 </pre>
545
546 <p>
547 However, it is preferred that you use the online Gentoo Handbook as it will be
548 more recent than the one provided on the CD.
549 </p>
550
551 <pre caption="Viewing the Online Documentation">
552 # <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
553 </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 <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 To be able to use sshd, you first need to set up your networking. Continue with
583 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