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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.54 - (show annotations) (download) (as text)
Wed Aug 30 22:52:28 2006 UTC (7 years, 11 months ago) by nightmorph
Branch: MAIN
Changes since 1.53: +84 -165 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-ppc-medium.xml,v 1.35 2006/08/30 21:54:34 josejx 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>Apple NewWorld Machines</th>
34 <ti>
35 Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
36 PowerBook, Xserver, PowerMac
37 </ti>
38 </tr>
39 <tr>
40 <th>Apple OldWorld machines</th>
41 <ti>
42 Apple Machines with an OpenFirmware revision less than 3, such as the Beige
43 G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also
44 be supported.
45 </ti>
46 </tr>
47 <tr>
48 <th>Genesi's Pegasos</th>
49 <ti>
50 Pegasos I/II, Open Desktop Workstation
51 </ti>
52 </tr>
53 <tr>
54 <th>IBM</th>
55 <ti>
56 RS/6000, iSeries, pSeries
57 </ti>
58 </tr>
59 <tr>
60 <th>Memory</th>
61 <ti>At least 64 MB</ti>
62 </tr>
63 <tr>
64 <th>Diskspace</th>
65 <ti>1.5 GB (excluding swap space)</ti>
66 </tr>
67 <tr>
68 <th>Swap space</th>
69 <ti>At least 256 MB</ti>
70 </tr>
71 </table>
72
73 <p>
74 Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
75 for help with some common installation related issues or if you're unsure as to
76 just what's in that PowerPC machine you've got sitting on your desk right now.
77 </p>
78
79 </body>
80 </subsection>
81 </section>
82 <!-- Copy/paste of hb-install-x86-medium.xml, with s/x86/ppc/ -->
83 <!-- START -->
84 <section>
85 <title>The Gentoo Universal Installation CD</title>
86 <subsection>
87 <title>Introduction</title>
88 <body>
89
90 <p>
91 Gentoo Linux can be installed using a <e>stage3</e> tarball file.
92 Such a tarball is an archive that contains a minimal environment from
93 which you can succesfully install Gentoo Linux onto your system.
94 </p>
95
96 <p>
97 Installations using a stage1 or stage2 tarball file are not documented in the
98 Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
99 FAQ</uri> on these matters.
100 </p>
101
102 </body>
103 </subsection>
104 <subsection>
105 <title>Gentoo Universal Installation CD</title>
106 <body>
107
108 <p>
109 An Installation CD is a bootable medium which contains a self-sustained Gentoo
110 environment. It allows you to boot Linux from the CD. During the boot process
111 your hardware is detected and the appropriate drivers are loaded. The Gentoo
112 Installation CDs are maintained by Gentoo developers.
113 </p>
114
115 <p>
116 There currently are two Installation CDs available:
117 </p>
118
119 <ul>
120 <li>
121 The Universal Installation CD contains everything you need to install
122 Gentoo. It provides stage3 files for common architectures, source code
123 for the extra applications you need to choose from and, of course, the
124 installation instructions for your architecture.
125 </li>
126 <li>
127 The Minimal Installation CD contains only a minimal environment that allows
128 you to boot up and configure your network so you can connect to the
129 Internet. It does not contain any additional files and cannot be used
130 during the current installation approach.
131 </li>
132 </ul>
133
134 <p>
135 Gentoo also provides a Package CD. This is not an Installation CD but an
136 additional resource that you can exploit during the installation of your Gentoo
137 system. It contains prebuilt packages (also known as the GRP set) that allow
138 you to easily and quickly install additional applications (such as
139 OpenOffice.org, KDE, GNOME, ...) immediately after the Gentoo installation and
140 right before you update your Portage tree.
141 </p>
142
143 <p>
144 The use of the Package CD is covered later in this document.
145 </p>
146
147 </body>
148 </subsection>
149 </section>
150 <!-- STOP -->
151 <section>
152 <title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
153 <subsection>
154 <title>Downloading and Burning the Installation CD</title>
155 <body>
156
157 <p>
158 You can download the Universal Installation CD (and, if you want to, the
159 Packages CD as well) from one of our <uri
160 link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located
161 in the <path>releases/ppc/2006.1/ppc32/installcd</path> directory;
162 the Package CDs are located in the
163 <path>releases/ppc/2006.1/ppc32/packagecd</path> directory.
164 </p>
165
166 <p>
167 Inside those directories you'll find ISO-files. Those are full CD images which
168 you can write on a CD-R.
169 </p>
170
171 <p>
172 After downloading the file, you can verify its integrity to see if it is
173 corrupted or not:
174 </p>
175
176 <ul>
177 <li>
178 You can check its MD5 checksum and compare it with the MD5 checksum we
179 provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
180 <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows).
181 Verifying MD5 checksums with Mac OS X is described in the <uri
182 link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
183 </li>
184 <li>
185 You can verify the cryptographic signature that we provide. You need to
186 obtain the public key we use (0x17072058) before you proceed though.
187 </li>
188 </ul>
189
190 <p>
191 To fetch our public key using the GnuPG application, run the following command:
192 </p>
193
194 <pre caption="Obtaining the public key">
195 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
196 </pre>
197
198 <p>
199 Now verify the signature:
200 </p>
201
202 <pre caption="Verify the cryptographic signature">
203 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
204 </pre>
205
206 <p>
207 To burn the downloaded ISO(s), you have to select raw-burning. How you
208 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
209 <c>K3B</c> here; more information can be found in our <uri
210 link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
211 </p>
212
213 <ul>
214 <li>
215 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
216 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
217 path).
218 </li>
219 <li>
220 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
221 you can locate your ISO file within the 'Image to Burn' area. Finally click
222 <c>Start</c>.
223 </li>
224 </ul>
225
226 </body>
227 </subsection>
228 <subsection>
229 <title>Default: Booting the Installation CD with Yaboot</title>
230 <body>
231
232 <p>
233 On NewWorld machines place the Installation CD in the CD-ROM and reboot the
234 system. When the system-start-bell sounds, simply hold down the 'C' until the
235 CD loads.
236 </p>
237
238 <p>
239 After the Installation CD loaded, you will be greeted by a friendly welcome
240 message and a <e>boot:</e> prompt at the bottom of the screen.
241 </p>
242
243 <p>
244 We provide one generic kernel, <e>apple</e>. This kernel is built with support
245 for multiple CPUs, but it will boot on single processor machines as well.
246 </p>
247
248 <p>
249 You can tweak some kernel options at this prompt. The following table lists
250 some of the available boot options you can add:
251 </p>
252
253 <table>
254 <tr>
255 <th>Boot Option</th>
256 <th>Description</th>
257 </tr>
258 <tr>
259 <ti><c>video</c></ti>
260 <ti>
261 This option takes one of the following vendor-specific tags:
262 <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
263 <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
264 refresh rate and color depth you want to use. For instance,
265 <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
266 at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
267 32 bits. If you are uncertain what to choose, and the default doesn't work,
268 <c>video=ofonly</c> will most certainly work.
269 </ti>
270 </tr>
271 <tr>
272 <ti><c>nol3</c></ti>
273 <ti>
274 Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
275 </ti>
276 </tr>
277 <tr>
278 <ti><c>dofirewire</c></ti>
279 <ti>
280 Enables support for IEEE1394 (FireWire) devices, like external harddisks.
281 </ti>
282 </tr>
283 <tr>
284 <ti><c>dopcmcia</c></ti>
285 <ti>
286 If you want to use PCMCIA devices during your installation (like PCMCIA
287 network cards) you have to enable this option.
288 </ti>
289 </tr>
290 </table>
291
292 <p>
293 To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
294 by the desired option. In the example below, we'll force the kernel to use the
295 OpenFirmware framebuffer instead of the device specific driver.
296 </p>
297
298 <pre caption="Force the use of the OpenFirmware framebuffer">
299 boot: <i>apple video=ofonly</i>
300 </pre>
301
302 <p>
303 If you don't need to add any options, just hit enter at this prompt, and a
304 complete Gentoo Linux environment will be loaded from the CD. Continue with
305 <uri link="#booted">And When You're Booted...</uri>.
306 </p>
307
308 </body>
309 </subsection>
310 <subsection>
311 <title>Alternative: Booting the Installation CD on a Pegasos</title>
312 <body>
313
314 <p>
315 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
316 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
317 between several preconfigured video configs. If you need any special boot
318 options you can append them to the command-line just like with Yaboot above.
319 For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
320 The default kernel options (in case something goes wrong and you need it) are
321 preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
322 looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
323 </p>
324
325 </body>
326 </subsection>
327
328 <subsection>
329 <title>Alternative: Booting the Installation CD with BootX</title>
330 <body>
331
332 <p>
333 If you have an OldWorld Mac the bootable portion of the livecd can't be used.
334 The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
335 environment with a tool called BootX.
336 </p>
337
338 <p>
339 First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
340 and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
341 archive into <c>Extensions Folder</c> and the BootX App Control Panel into
342 <c>Control Panels</c>, both of which are located in your MacOS System Folder.
343 Next, create a folder called "Linux Kernels" in your System folder and copy the
344 <c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c>
345 from the Installation CD <path>boot</path> folder into the MacOS
346 <c>System Folder</c>.
347 </p>
348
349 <p>
350 To prepare BootX, start the BootX App Control Panel. First select the Options
351 dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
352 your System Folder. Continue back to the initial screen and ensure that the
353 ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
354 shown below:
355 </p>
356
357 <pre caption="BootX kernel arguments">
358 cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
359 </pre>
360
361 <note>
362 The kernel parameters in the yaboot section above are also applicable here. You
363 can append any of those options to the kernel arguments above.
364 </note>
365
366 <p>
367 Check once more to make sure the settings are correct and then save the
368 configuration. This saves typing just in case it doesn't boot or something is
369 missing. Press the Linux button at the top of the window. If everything goes
370 correctly, it should boot into the Installation CD. Continue with
371 <uri link="#booted">And When You're Booted...</uri>
372 </p>
373
374 </body>
375 </subsection>
376
377 <subsection id="booted">
378 <title>And When You're Booted...</title>
379 <body>
380
381 <p>
382 You will be greeted by a root ("#") prompt on the current console. You can also
383 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
384 back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
385 you may need to press Alt-fn-Fx on Apple machines.
386 </p>
387
388 <p>
389 If you are installing Gentoo on a system with a non-US keyboard, use
390 <c>loadkeys</c> to load the keymap for your keyboard. To list the available
391 keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
392 Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
393 are for ADB-based OldWorld machines.
394 </p>
395
396 <pre caption="Listing available keymaps">
397 <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
398 on the Installation CD are ADB keymaps and unusable with the Installation CD
399 kernel)</comment>
400 # <i>ls /usr/share/keymaps/i386</i>
401 </pre>
402
403 <p>
404 Now load the keymap of your choice:
405 </p>
406
407 <pre caption="Loading a keymap">
408 # <i>loadkeys be-latin1</i>
409 </pre>
410
411 <p>
412 Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
413 </p>
414
415 </body>
416 </subsection>
417 <subsection id="hardware">
418 <title>Extra Hardware Configuration</title>
419 <body>
420
421 <p>
422 When the Installation CD boots, it tries to detect all your hardware devices and
423 loads the appropriate kernel modules to support your hardware. In the
424 vast majority of cases, it does a very good job. However, in some cases, it may
425 not auto-load the kernel modules you need. If the PCI auto-detection missed some
426 of your system's hardware, you will have to load the appropriate kernel modules
427 manually.
428 </p>
429
430 <p>
431 In the next example we try to load the <c>airport</c> module. This module
432 supports only the old Airport cards (802.11b). Airport Extreme (802.11g) is not
433 supported on the InstallCD due to restrictions on firmware distribution.
434 </p>
435
436 <pre caption="Loading the airport module">
437 # <i>modprobe airport</i>
438 </pre>
439
440 <p>
441 On older iMacs, sometimes the network card is not detected properly. These use
442 the BMAC driver:
443 </p>
444
445 <pre caption="Loading the bmac module">
446 # <i>modprobe bmac</i>
447 </pre>
448
449 </body>
450 </subsection>
451 <subsection>
452 <title>Optional: Tweaking Hard Disk Performance</title>
453 <body>
454
455 <p>
456 If you are an advanced user, you might want to tweak the IDE hard disk
457 performance using <c>hdparm</c>. With the <c>-tT</c> options you can
458 test the performance of your disk (execute it several times to get a
459 more precise impression):
460 </p>
461
462 <pre caption="Testing disk performance">
463 # <i>hdparm -tT /dev/hda</i>
464 </pre>
465
466 <p>
467 To tweak, you can use any of the following examples (or experiment
468 yourself) which use <path>/dev/hda</path> as disk (substitute with your
469 disk):
470 </p>
471
472 <pre caption="Tweaking hard disk performance">
473 <comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
474 <comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
475 </pre>
476
477 </body>
478 </subsection>
479 <subsection id="useraccounts">
480 <title>Optional: User Accounts</title>
481 <body>
482
483 <p>
484 If you plan on giving other people access to your installation
485 environment or you want to chat using <c>irssi</c> without root privileges (for
486 security reasons), you need to create the necessary user accounts and change
487 the root password.
488 </p>
489
490 <p>
491 To change the root password, use the <c>passwd</c> utility:
492 </p>
493
494 <pre caption="Changing the root password">
495 # <i>passwd</i>
496 New password: <comment>(Enter your new password)</comment>
497 Re-enter password: <comment>(Re-enter your password)</comment>
498 </pre>
499
500 <p>
501 To create a user account, we first enter their credentials, followed by
502 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
503 In the next example, we create a user called &quot;john&quot;.
504 </p>
505
506 <pre caption="Creating a user account">
507 # <i>useradd -m -G users john</i>
508 # <i>passwd john</i>
509 New password: <comment>(Enter john's password)</comment>
510 Re-enter password: <comment>(Re-enter john's password)</comment>
511 </pre>
512
513 <p>
514 You can change your user id from root to the newly created user by using
515 <c>su</c>:
516 </p>
517
518 <pre caption="Changing user id">
519 # <i>su - john</i>
520 </pre>
521
522 </body>
523 </subsection>
524 <subsection>
525 <title>Optional: Viewing Documentation while Installing</title>
526 <body>
527
528 <p>
529 If you want to view the Gentoo Handbook (either from-CD or online) during the
530 installation, make sure you have created a user account (see <uri
531 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
532 go to a new terminal and log in.
533 </p>
534
535 <p>
536 If you want to view the documentation on the CD you can immediately run
537 <c>links</c> or even <c>links -g</c> for a graphical framebuffer browser to
538 read it:
539 </p>
540
541 <pre caption="Viewing the on-CD documentation">
542 # <i>links /mnt/cdrom/docs/html/index.html</i>
543 </pre>
544
545 <p>
546 However, it is preferred that you use the online Gentoo Handbook as it will be
547 more recent than the one provided on the CD. You can view it using <c>links</c>
548 as well, but only after having completed the <e>Configuring your Network</e>
549 chapter (otherwise you won't be able to go on the Internet to view the
550 document):
551 </p>
552
553 <pre caption="Viewing the Online Documentation">
554 # <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
555 </pre>
556
557 <p>
558 You can go back to your original terminal by pressing <c>Alt-F1</c>.
559 </p>
560
561 </body>
562 </subsection>
563 <subsection>
564 <title>Optional: Starting the SSH Daemon</title>
565 <body>
566
567 <p>
568 If you want to allow other users to access your computer during the
569 Gentoo installation (perhaps because those users are going to help you
570 install Gentoo, or even do it for you), you need to create a user
571 account for them and perhaps even provide them with your root password
572 (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
573 </p>
574
575 <p>
576 To fire up the SSH daemon, execute the following command:
577 </p>
578
579 <pre caption="Starting the SSH daemon">
580 # <i>/etc/init.d/sshd start</i>
581 </pre>
582
583 <p>
584 To be able to use sshd, you first need to set up your networking. Continue with
585 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
586 </p>
587
588 </body>
589 </subsection>
590 </section>
591 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20