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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (hide annotations) (download) (as text)
Mon Mar 19 20:37:28 2007 UTC (13 years, 6 months ago) by nightmorph
Branch: MAIN
File MIME type: application/xml
initial import

1 nightmorph 1.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/2006.1/hb-install-ppc-medium.xml,v 1.1 2006/08/30 20:17:31 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>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