/[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.50 - (show annotations) (download) (as text)
Mon Nov 21 16:38:19 2005 UTC (9 years ago) by neysx
Branch: MAIN
Changes since 1.49: +9 -9 lines
File MIME type: application/xml
#112511 Chapter 2, minor grammatical error

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/hb-install-ppc-medium.xml,v 1.49 2005/11/11 17:27:15 swift Exp $ -->
8
9 <sections>
10
11 <version>2.7</version>
12 <date>2005-11-11</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 up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo
75 PPC FAQ</uri> before you begin.
76 </p>
77
78 </body>
79 </subsection>
80 </section>
81 <!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) -->
82 <!-- START -->
83 <section>
84 <title>The Gentoo Installation CDs</title>
85 <subsection>
86 <title>Introduction</title>
87 <body>
88
89 <p>
90 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
91 self-sustained Gentoo environment. They allow you to boot Linux from the CD.
92 During the boot process your hardware is detected and the appropriate drivers
93 are loaded. They are maintained by Gentoo developers.
94 </p>
95
96 <p>
97 All Installation CDs allow you to boot, set up networking, initialize your
98 partitions and start installing Gentoo from the Internet. We currently provide
99 two Installation CDs which are equaly suitable to install Gentoo from, as long
100 as you're planning on performing an Internet-based installation using the
101 latest version of the available packages.
102 </p>
103
104 <p>
105 If you wish to install Gentoo without a working Internet connection, please use
106 the installation instructions described in the <uri
107 link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>.
108 </p>
109
110 <p>
111 The two Installation CDs that we currently provide are:
112 </p>
113
114 <ul>
115 <li>
116 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
117 CD which sole purpose is to boot the system, prepare the networking and
118 continue with the Gentoo installation.
119 </li>
120 <li>
121 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
122 abilities as the Minimal Installation CD. Additionally, it contains
123 several stage3 tarballs (optimized for the individual subarchitectures).
124 </li>
125 </ul>
126
127 <p>
128 To help you decide which Installation CD you need, we have written down the
129 major advantages and disadvantages of each Installation CD.
130 </p>
131
132 </body>
133 </subsection>
134 <subsection>
135 <title>Gentoo's Minimal Installation CD</title>
136 <body>
137
138 <p>
139 The Minimal Installation CD is called <c>install-ppc-minimal-2005.1.iso</c> and
140 takes up only 52 MB of diskspace. You can use this Installation CD to install
141 Gentoo, but always with a working Internet connection only.
142 </p>
143
144 <table>
145 <tr>
146 <th>Minimal Installation CD</th>
147 <th>Pros and Cons</th>
148 </tr>
149 <tr>
150 <th>+</th>
151 <ti>Smallest download</ti>
152 </tr>
153 <tr>
154 <th>-</th>
155 <ti>
156 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
157 therefore not suitable for networkless installation
158 </ti>
159 </tr>
160 </table>
161
162 </body>
163 </subsection>
164 <subsection>
165 <title>Gentoo's Universal Installation CD</title>
166 <body>
167
168 <p>
169 The Universal Installation CD is called <c>install-ppc-universal-2005.1.iso</c>
170 and consumes the entire surface of a 650 MB CD. You can use this Installation
171 CD to install Gentoo, and you can even use it to install Gentoo without a
172 working internet connection, just in case you want to bring Gentoo to another
173 PC than the one you are currently installing Gentoo on :)
174 </p>
175
176 <table>
177 <tr>
178 <th>Universal Installation CD</th>
179 <th>Pros and Cons</th>
180 </tr>
181 <tr>
182 <th>+</th>
183 <ti>
184 Contains everything you need. You can even install without a network
185 connection.
186 </ti>
187 </tr>
188 <tr>
189 <th>-</th>
190 <ti>Huge download</ti>
191 </tr>
192 </table>
193
194 </body>
195 </subsection>
196 <subsection>
197 <title>Other CDs</title>
198 <body>
199
200 <p>
201 You might find a <e>Package CD</e> on one of our mirrors. This CD is not an
202 Installation CD but an additional resource that can be exploited during a
203 networkless installation. It contains prebuilt packages (also known as the GRP
204 set) that allow you to easily and quickly install additional applications (such
205 as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo
206 installation.
207 </p>
208
209 <p>
210 If you intend to use the Packages CD to quickly install additional software,
211 make sure that you use the same subarchitecture as the stage3 tarball you use.
212 </p>
213
214 </body>
215 </subsection>
216 <subsection>
217 <title>The Stage3 Tarball</title>
218 <body>
219
220 <p>
221 A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
222 to continue the Gentoo installation using the instructions in this manual.
223 Previously, the Gentoo Handbook described the installation using one of three
224 stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
225 official installation method uses the stage3 tarball. If you are interested in
226 performing a Gentoo installation using a stage1 or stage2 tarball, please read
227 the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
228 Using a Stage1 or Stage2 Tarball?</uri>
229 </p>
230
231 </body>
232 </subsection>
233 </section>
234 <!-- STOP -->
235 <section>
236 <title>Download, Burn and Boot a Gentoo Installation CD</title>
237 <subsection>
238 <title>Downloading and Burning the Installation CDs</title>
239 <body>
240
241 <p>
242 You have chosen to use a Gentoo Installation CD. We'll first start by
243 downloading and burning the chosen Installation CD. We previously discussed
244 the several available Installation CDs, but where can you find them?
245 </p>
246
247 <p>
248 You can download any of the Installation CDs (and, if you want to, a Packages
249 CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
250 Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path>
251 directory.
252 </p>
253
254 <p>
255 Inside that directory you'll find ISO-files. Those are full CD images which you
256 can write on a CD-R.
257 </p>
258
259 <p>
260 In case you wonder if your downloaded file is corrupted or not, you can
261 check its MD5 checksum and compare it with the MD5 checksum we provide (such as
262 <path>install-ppc-minimal-2005.1.iso.md5</path>). You can check the MD5 checksum
263 with the <c>md5sum</c> tool under Linux/Unix or
264 <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If
265 <c>md5sum</c> is not available on Mac OS X, see the
266 <uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help.
267 </p>
268
269 <p>
270 Another way to check the validity of the downloaded file is to use GnuPG to
271 verify the cryptographic signature that we provide (the file ending with
272 <path>.asc</path>). Download the signature file and obtain the public key:
273 </p>
274
275 <pre caption="Obtaining the public key">
276 $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
277 </pre>
278
279 <p>
280 Now verify the signature:
281 </p>
282
283 <pre caption="Verify the cryptographic signature">
284 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
285 </pre>
286
287 <p>
288 To burn the downloaded ISO(s), you have to select raw-burning. How you
289 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
290 <c>K3B</c> here; more information can be found in our <uri
291 link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
292 </p>
293
294 <ul>
295 <li>
296 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
297 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
298 device path).
299 </li>
300 <li>
301 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
302 you can locate your ISO file within the 'Image to Burn' area. Finally click
303 <c>Start</c>.
304 </li>
305 </ul>
306
307 </body>
308 </subsection>
309 <subsection>
310 <title>Default: Booting the Installation CD with Yaboot</title>
311 <body>
312
313 <p>
314 On NewWorld machines place the Installation CD in the CD-ROM and reboot the
315 system. When the system-start-bell sounds, simply hold down the 'C' until the
316 CD loads.
317 </p>
318
319 <p>
320 After the Installation CD loaded, you will be greeted by a friendly welcome
321 message and a <e>boot:</e> prompt at the bottom of the screen.
322 </p>
323
324 <p>
325 At this prompt you are able to select a kernel for the subarchitecture you use.
326 We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
327 support for multiple CPUs, but they will boot on single processor machines as
328 well.
329 </p>
330
331 <p>
332 You are also able to tweak some kernel options at this prompt. The following
333 table lists some of the available boot options you can add:
334 </p>
335
336 <table>
337 <tr>
338 <th>Boot Option</th>
339 <th>Description</th>
340 </tr>
341 <tr>
342 <ti><c>video</c></ti>
343 <ti>
344 This option takes one of the following vendor-specific tags:
345 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
346 <c>ofonly</c>. You can follow this tag with the resolution and refreshrate
347 you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
348 uncertain what to choose, <c>ofonly</c> will most certainly work.
349 </ti>
350 </tr>
351 <tr>
352 <ti><c>nol3</c></ti>
353 <ti>
354 Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
355 </ti>
356 </tr>
357 <tr>
358 <ti><c>dofirewire</c></ti>
359 <ti>
360 Enables support for IEEE1394 (FireWire) devices, like external harddisks.
361 </ti>
362 </tr>
363 <tr>
364 <ti><c>dopcmcia</c></ti>
365 <ti>
366 If you want to use PCMCIA devices during your installation (like PCMCIA
367 network cards) you have to enable this option.
368 </ti>
369 </tr>
370 </table>
371
372 <p>
373 At this prompt, hit enter, and a complete Gentoo Linux environment will be
374 loaded from the CD. Continue with <uri link="#booted">And When You're
375 Booted...</uri>.
376 </p>
377
378 </body>
379 </subsection>
380 <subsection>
381 <title>Alternative: Booting the Installation CD on a Pegasos</title>
382 <body>
383
384 <p>
385 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
386 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
387 between several preconfigured video configs. If you need any special boot
388 options you can append them to the command-line. For instance <c>boot cd
389 /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. The complete list of
390 kernel appends (in case something goes wrong and you need it) is preconfigured
391 in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
392 looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>.
393 </p>
394
395 </body>
396 </subsection>
397
398 <subsection>
399 <title>Alternative: Booting the Installation CD with BootX</title>
400 <body>
401
402 <p>
403 If you have an OldWorld Mac the bootable portion of the livecd can't be used.
404 The most simple solution is to use MacOS to bootstrap into a Linux environment
405 with a tool called BootX. Boot floppies are being prepared for Macs without
406 MacOS, but they are not available at this time.
407 </p>
408
409 <p>
410 First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
411 and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
412 archive into <c>Extensions Folder</c> and the BootX App Control Panel into
413 <c>Control Panels</c>, both of which are located in your MacOS System Folder.
414 Next, create a folder called "Linux Kernels" in your System folder and copy the
415 <c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c>
416 from the Installation CD <path>boot</path> folder into the MacOS
417 <c>System Folder</c>.
418 </p>
419
420 <p>
421 To prepare BootX, start the BootX App Control Panel. First select the Options
422 dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from
423 your System Folder. Continue back to the initial screen and ensure that the
424 ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
425 shown below:
426 </p>
427
428 <pre caption="BootX kernel arguments">
429 cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev
430 </pre>
431
432 <note>
433 The kernel parameters in the yaboot section above are also applicable here.
434 </note>
435
436 <p>
437 Check once more to make sure the settings are correct and then save the
438 configuration. This saves typing just in case it doesn't boot or something is
439 missing. Press the Linux button at the top of the window to boot into the
440 Installation CD and continue with <uri link="#booted">And When
441 You're Booted...</uri>
442 </p>
443
444 </body>
445 </subsection>
446
447 <subsection id="booted">
448 <title>And When You're Booted...</title>
449 <body>
450
451 <p>
452 You will be greeted by a root ("#") prompt on the current console. You can also
453 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
454 back to the one you started on by pressing Alt-F1. Probably you have to hit
455 Alt-fn-Fx on Apple machines.
456 </p>
457
458 <p>
459 If you are installing Gentoo on a system with a non-US keyboard, use
460 <c>loadkeys</c> to load the keymap for your keyboard. To list the available
461 keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
462 Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
463 are for ADB-based OldWorld machines.
464 </p>
465
466 <pre caption="Listing available keymaps">
467 <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
468 on the Installation CD are ADB keymaps and unusable with the Installation CD
469 kernel)</comment>
470 # <i>ls /usr/share/keymaps/i386</i>
471 </pre>
472
473 <p>
474 Now load the keymap of your choice:
475 </p>
476
477 <pre caption="Loading a keymap">
478 # <i>loadkeys be-latin1</i>
479 </pre>
480
481 <p>
482 Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
483 </p>
484
485 </body>
486 </subsection>
487 <subsection id="hardware">
488 <title>Extra Hardware Configuration</title>
489 <body>
490
491 <p>
492 When the Installation CD boots, it tries to detect all your hardware devices and
493 loads the appropriate kernel modules to support your hardware. In the
494 vast majority of cases, it does a very good job. However, in some cases, it may
495 not auto-load the kernel modules you need. If the PCI auto-detection missed some
496 of your system's hardware, you will have to load the appropriate kernel modules
497 manually.
498 </p>
499
500 <p>
501 In the next example we try to load the <c>airport</c> module. This module
502 supports only the old Airport cards (b-net). AirportExtreme is currently not
503 supported under Linux:
504 </p>
505
506 <pre caption="Loading kernel modules">
507 # <i>modprobe airport</i>
508 </pre>
509
510 </body>
511 </subsection>
512 <subsection>
513 <title>Optional: Tweaking Hard Disk Performance</title>
514 <body>
515
516 <p>
517 If you are an advanced user, you might want to tweak the IDE hard disk
518 performance using <c>hdparm</c>. With the <c>-tT</c> options you can
519 test the performance of your disk (execute it several times to get a
520 more precise impression):
521 </p>
522
523 <pre caption="Testing disk performance">
524 # <i>hdparm -tT /dev/hda</i>
525 </pre>
526
527 <p>
528 To tweak, you can use any of the following examples (or experiment
529 yourself) which use <path>/dev/hda</path> as disk (substitute with your
530 disk):
531 </p>
532
533 <pre caption="Tweaking hard disk performance">
534 <comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
535 <comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
536 </pre>
537
538 </body>
539 </subsection>
540 <subsection id="useraccounts">
541 <title>Optional: User Accounts</title>
542 <body>
543
544 <p>
545 If you plan on giving other people access to your installation
546 environment or you want to chat using <c>irssi</c> without root privileges (for
547 security reasons), you need to create the necessary user accounts and change
548 the root password.
549 </p>
550
551 <p>
552 To change the root password, use the <c>passwd</c> utility:
553 </p>
554
555 <pre caption="Changing the root password">
556 # <i>passwd</i>
557 New password: <comment>(Enter your new password)</comment>
558 Re-enter password: <comment>(Re-enter your password)</comment>
559 </pre>
560
561 <p>
562 To create a user account, we first enter their credentials, followed by
563 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
564 In the next example, we create a user called &quot;john&quot;.
565 </p>
566
567 <pre caption="Creating a user account">
568 # <i>useradd -m -G users john</i>
569 # <i>passwd john</i>
570 New password: <comment>(Enter john's password)</comment>
571 Re-enter password: <comment>(Re-enter john's password)</comment>
572 </pre>
573
574 <p>
575 You can change your user id from root to the newly created user by using
576 <c>su</c>:
577 </p>
578
579 <pre caption="Changing user id">
580 # <i>su - john</i>
581 </pre>
582
583 </body>
584 </subsection>
585 <subsection>
586 <title>Optional: Viewing Documentation while Installing</title>
587 <body>
588
589 <p>
590 If you want to view the Gentoo Handbook (either from-CD or online) during the
591 installation, make sure you have created a user account (see <uri
592 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
593 go to a new terminal and log in.
594 </p>
595
596 <p>
597 If you want to view the documentation on the CD you can immediately run
598 <c>links2</c> to read it:
599 </p>
600
601 <pre caption="Viewing the on-CD documentation">
602 # <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
603 </pre>
604
605 <p>
606 However, it is preferred that you use the online Gentoo Handbook as it will be
607 more recent than the one provided on the CD. You can view it using <c>links2</c>
608 as well, but only after having completed the <e>Configuring your Network</e>
609 chapter (otherwise you won't be able to go on the Internet to view the
610 document):
611 </p>
612
613 <pre caption="Viewing the Online Documentation">
614 # <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
615 </pre>
616
617 <p>
618 You can go back to your original terminal by pressing <c>Alt-F1</c>.
619 </p>
620
621 </body>
622 </subsection>
623 <subsection>
624 <title>Optional: Starting the SSH Daemon</title>
625 <body>
626
627 <p>
628 If you want to allow other users to access your computer during the
629 Gentoo installation (perhaps because those users are going to help you
630 install Gentoo, or even do it for you), you need to create a user
631 account for them and perhaps even provide them with your root password
632 (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
633 </p>
634
635 <p>
636 To fire up the SSH daemon, execute the following command:
637 </p>
638
639 <pre caption="Starting the SSH daemon">
640 # <i>/etc/init.d/sshd start</i>
641 </pre>
642
643 <p>
644 To be able to use sshd, you first need to set up your networking. Continue with
645 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
646 </p>
647
648 </body>
649 </subsection>
650 </section>
651 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20