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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (show annotations) (download) (as text)
Sun Apr 1 23:16:09 2007 UTC (13 years, 7 months ago) by nightmorph
Branch: MAIN
Changes since 1.2: +21 -20 lines
File MIME type: application/xml
ppc64 done

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/2007.0/hb-install-ppc64-medium.xml,v 1.2 2007/03/20 05:31:13 nightmorph Exp $ -->
8
9 <sections>
10
11 <version>8.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, 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 <!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
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 </section>
131 <!-- STOP -->
132 <section>
133 <title>Download, Burn and Boot a Gentoo Installation CD</title>
134 <subsection>
135 <title>Downloading and Burning the Installation CDs</title>
136 <body>
137
138 <p>
139 You can download the Universal Installation CD (and, if you want to, the
140 Packages CD as well) from one of our <uri
141 link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
142 the <path><keyval id="release-dir"/>installcd</path> directory; the Package CDs
143 are located in the <path><keyval id="release-dir"/>packagecd</path> directory.
144 </p>
145
146 <p>
147 Inside those directories you'll find ISO-files. Those are full CD images which
148 you can write on a CD-R.
149 </p>
150
151 <p>
152 After downloading the file, you can verify its integrity to see if it is
153 corrupted or not:
154 </p>
155
156 <ul>
157 <li>
158 You can check its MD5 checksum and compare it with the MD5 checksum we
159 provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
160 <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows). How
161 to verify MD5 checksums with Mac OS X is described in the <uri
162 link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
163 </li>
164 <li>
165 You can verify the cryptographic signature that we provide. You need to
166 obtain the public key we use (0x17072058) before you proceed though.
167 </li>
168 </ul>
169
170 <p>
171 To fetch our public key using the GnuPG application, run the following command:
172 </p>
173
174 <pre caption="Obtaining the public key">
175 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
176 </pre>
177
178 <p>
179 Now verify the signature:
180 </p>
181
182 <pre caption="Verify the cryptographic signature">
183 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
184 </pre>
185
186 <p>
187 To burn the downloaded ISO(s), you have to select raw-burning. How you
188 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
189 <c>K3B</c> here; more information can be found in our <uri
190 link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
191 </p>
192
193 <ul>
194 <li>
195 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
196 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
197 path).
198 </li>
199 <li>
200 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
201 you can locate your ISO file within the 'Image to Burn' area. Finally click
202 <c>Start</c>.
203 </li>
204 </ul>
205
206 </body>
207 </subsection>
208 <subsection>
209 <title>Booting the Installation CD on an Apple</title>
210 <body>
211
212 <p>
213 Please check the <path>README.kernel</path> on the Installation CD for the
214 latest information on how to boot various kernels and getting hardware support.
215 </p>
216
217 <p>
218 Place the Installation CD in the CD-ROM and reboot the system. Hold down the
219 'C' key at bootup. You will be greeted by a friendly welcome message and a
220 <e>boot:</e> prompt at the bottom of the screen.
221 </p>
222
223 <p>
224 You are also able to tweak some kernel options at this prompt. The following
225 table lists the available boot options you can add:
226 </p>
227
228 <table>
229 <tr>
230 <th>Boot Option</th>
231 <th>Description</th>
232 </tr>
233 <tr>
234 <ti><c>video</c></ti>
235 <ti>
236 This option takes one of the following vendor-specific tags:
237 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
238 or <c>ofonly</c>. You can follow this tag with the resolution and
239 refreshrate you want to use. For instance
240 <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
241 <c>ofonly</c> will most certainly work.
242 </ti>
243 </tr>
244 <tr>
245 <ti><c>nol3</c></ti>
246 <ti>
247 Disables level 3 cache on some powerbooks (needed for at least the 17")
248 </ti>
249 </tr>
250 <tr>
251 <ti><c>debug</c></ti>
252 <ti>
253 Enables verbose booting, spawns an initrd shell that can be used to debug
254 the Installation CD
255 </ti>
256 </tr>
257 <tr>
258 <ti><c>sleep=X</c></ti>
259 <ti>
260 Wait X seconds before continuing; this can be needed by some very old SCSI
261 CD-ROMs which don't speed up the CD quick enough
262 </ti>
263 </tr>
264 <tr>
265 <ti><c>bootfrom=X</c></ti>
266 <ti>
267 Boot from a different device
268 </ti>
269 </tr>
270 </table>
271
272 <p>
273 At this prompt, hit enter, and a complete Gentoo Linux environment will be
274 loaded from the CD. Continue with <uri link="#booted">And When You're
275 Booted...</uri>.
276 </p>
277
278 </body>
279 </subsection>
280 <subsection>
281 <title>Booting the Installation CD on an IBM pSeries, OpenPower and Power5
282 iSeries servers</title>
283 <body>
284
285 <p>
286 Please check the <path>README.kernel</path> on the Installation CD for the
287 latest information on how to boot various kernels and getting hardware support.
288 </p>
289
290 <p>
291 Most modern pSeries servers can boot from the CDROM drive through SMS ('1' when
292 the “IBM IBM IBM” messages flash across the console). On some older pSeries
293 boxes, sometimes the cds might not autoboot. You might have to set up your
294 cdrom as a bootable device in the multi-boot menu. (F1 at startup) The other
295 option is to jump into OF and do it from there:
296 </p>
297
298 <ol>
299 <li>
300 Boot into OF (this is 8 from the serial cons or F8 from a graphics
301 cons, start hitting the key when you see the keyboard mouse etc etc
302 messages.
303 </li>
304 <li>Run the command 0> boot cdrom:1,yaboot</li>
305 <li>Stand back and enjoy!</li>
306 </ol>
307
308 </body>
309 </subsection>
310 <subsection id="booted">
311 <title>And When You're Booted...</title>
312 <body>
313
314 <p>
315 You will be greeted by a root ("#") prompt on the current console. You can also
316 switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
317 back to the one you started on by pressing Alt-fn-F1.
318 </p>
319
320 <p>
321 If you are installing Gentoo on a system with a non-US keyboard, use
322 <c>loadkeys</c> to load the keymap for your keyboard. To list the available
323 keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
324 </p>
325
326 <pre caption="Listing available keymaps">
327 <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
328 on the Installation CD are ADB keymaps and unusable with the
329 Installation CD kernel)</comment>
330 # <i>ls /usr/share/keymaps/i386</i>
331 </pre>
332
333 <p>
334 Now load the keymap of your choice:
335 </p>
336
337 <pre caption="Loading a keymap">
338 # <i>loadkeys be-latin1</i>
339 </pre>
340
341 <p>
342 Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
343 </p>
344
345 </body>
346 </subsection>
347 <subsection id="hardware">
348 <title>Extra Hardware Configuration</title>
349 <body>
350
351 <p>
352 When the Installation CD boots, it tries to detect all your hardware devices and
353 loads the appropriate kernel modules to support your hardware. In the vast
354 majority of cases, it does a very good job. However, in some cases it may not
355 auto-load the kernel modules you need. If the PCI auto-detection missed some of
356 your system's hardware, you will have to load the appropriate kernel modules
357 manually.
358 </p>
359
360 <p>
361 In the next example we try to load the <c>8139too</c> module (support for
362 certain kinds of network interfaces):
363 </p>
364
365 <pre caption="Loading kernel modules">
366 # <i>modprobe 8139too</i>
367 </pre>
368
369 </body>
370 </subsection>
371 <subsection>
372 <title>Optional: Tweaking Hard Disk Performance</title>
373 <body>
374
375 <p>
376 If you are an advanced user, you might want to tweak the IDE hard disk
377 performance using <c>hdparm</c>. With the <c>-tT</c> options you can
378 test the performance of your disk (execute it several times to get a
379 more precise impression):
380 </p>
381
382 <pre caption="Testing disk performance">
383 # <i>hdparm -tT /dev/hda</i>
384 </pre>
385
386 <p>
387 To tweak, you can use any of the following examples (or experiment
388 yourself) which use <path>/dev/hda</path> as disk (substitute with your
389 disk):
390 </p>
391
392 <pre caption="Tweaking hard disk performance">
393 <comment>Activate DMA:</comment>
394 # <i>hdparm -d 1 /dev/hda</i>
395 <comment>Activate DMA + Safe Performance-enhancing Options:</comment>
396 # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
397 </pre>
398
399 </body>
400 </subsection>
401 <subsection id="useraccounts">
402 <title>Optional: User Accounts</title>
403 <body>
404
405 <p>
406 If you plan on giving other people access to your installation
407 environment or you want to chat using <c>irssi</c> without root privileges (for
408 security reasons), you need to create the necessary user accounts and change
409 the root password.
410 </p>
411
412 <p>
413 To change the root password, use the <c>passwd</c> utility:
414 </p>
415
416 <pre caption="Changing the root password">
417 # <i>passwd</i>
418 New password: <comment>(Enter your new password)</comment>
419 Re-enter password: <comment>(Re-enter your password)</comment>
420 </pre>
421
422 <p>
423 To create a user account, we first enter their credentials, followed by
424 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
425 In the next example, we create a user called &quot;john&quot;.
426 </p>
427
428 <pre caption="Creating a user account">
429 # <i>useradd -m -G users john</i>
430 # <i>passwd john</i>
431 New password: <comment>(Enter john's password)</comment>
432 Re-enter password: <comment>(Re-enter john's password)</comment>
433 </pre>
434
435 <p>
436 You can change your user id from root to the newly created user by using
437 <c>su</c>:
438 </p>
439
440 <pre caption="Changing user id">
441 # <i>su - john</i>
442 </pre>
443
444 </body>
445 </subsection>
446 <subsection>
447 <title>Optional: Viewing Documentation while Installing</title>
448 <body>
449
450 <p>
451 If you want to view the Gentoo Handbook during the installation, make sure you
452 have created a user account (see <uri link="#useraccounts">Optional: User
453 Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
454 </p>
455
456 <p>
457 If you want to view the documentation on the CD you can immediately run
458 <c>links</c> to read it:
459 </p>
460
461 <pre caption="Viewing the on-CD documentation">
462 # <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
463 </pre>
464
465 <p>
466 However, it is preferred that you use the online Gentoo Handbook as it will be
467 more recent than the one provided on the CD.
468 </p>
469
470 <pre caption="Viewing the Online Documentation">
471 # <i>links http://www.gentoo.org/doc/en/handbook/2007.0/handbook-ppc64.xml</i>
472 </pre>
473
474 <p>
475 You can go back to your original terminal by pressing <c>Alt-F1</c>.
476 </p>
477
478 </body>
479 </subsection>
480 <subsection>
481 <title>Optional: Starting the SSH Daemon</title>
482 <body>
483
484 <p>
485 If you want to allow other users to access your computer during the
486 Gentoo installation (perhaps because those users are going to help you
487 install Gentoo, or even do it for you), you need to create a user
488 account for them and perhaps even provide them with your root password
489 (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
490 </p>
491
492 <p>
493 To fire up the SSH daemon, execute the following command:
494 </p>
495
496 <pre caption="Starting the SSH daemon">
497 # <i>/etc/init.d/sshd start</i>
498 </pre>
499
500 <p>
501 To be able to use sshd, you first need to set up your networking. Continue with
502 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
503 </p>
504
505 </body>
506 </subsection>
507 </section>
508 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20