/[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.2 - (show annotations) (download) (as text)
Tue Mar 20 05:31:13 2007 UTC (13 years, 8 months ago) by nightmorph
Branch: MAIN
Changes since 1.1: +3 -3 lines
File MIME type: application/xml
s/2006.1/2007.0

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

  ViewVC Help
Powered by ViewVC 1.1.20