/[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.9 - (hide annotations) (download) (as text)
Fri Jul 13 08:40:58 2007 UTC (13 years, 2 months ago) by nightmorph
Branch: MAIN
CVS Tags: HEAD
Changes since 1.8: +4 -4 lines
File MIME type: application/xml
made Open Firmware usage consistent for all handbooks and translations, as suggested by grahl and rane on IRC, and approved by JoseJX. s/openfirmware/Open Firmware/g, so no revbump.

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 nightmorph 1.9 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2007.0/hb-install-ppc-medium.xml,v 1.8 2007/06/30 00:50:06 nightmorph Exp $ -->
8 nightmorph 1.1
9     <sections>
10    
11 nightmorph 1.8 <version>8.1</version>
12     <date>2007-06-29</date>
13 nightmorph 1.1
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 nightmorph 1.9 Apple Machines with an Open Firmware revision less than 3, such as the Beige
43 nightmorph 1.1 G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also
44     be supported.
45     </ti>
46     </tr>
47     <tr>
48 josejx 1.5 <th>Genesi</th>
49 nightmorph 1.1 <ti>
50 josejx 1.5 Pegasos I/II, Open Desktop Workstation, Efika
51 nightmorph 1.1 </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 nightmorph 1.3 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 in
161     the <path><keyval id="release-dir"/>installcd</path> directory; the Package CDs
162     are located in the <path><keyval id="release-dir"/>packagecd</path> directory.
163 nightmorph 1.1 </p>
164    
165     <p>
166     Inside those directories you'll find ISO-files. Those are full CD images which
167     you can write on a CD-R.
168     </p>
169    
170     <p>
171     After downloading the file, you can verify its integrity to see if it is
172     corrupted or not:
173     </p>
174    
175     <ul>
176     <li>
177     You can check its MD5 checksum and compare it with the MD5 checksum we
178     provide (for instance with the <c>md5sum</c> tool under Linux/Unix or
179     <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows).
180     Verifying MD5 checksums with Mac OS X is described in the <uri
181     link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>.
182     </li>
183     <li>
184     You can verify the cryptographic signature that we provide. You need to
185     obtain the public key we use (0x17072058) before you proceed though.
186     </li>
187     </ul>
188    
189     <p>
190     To fetch our public key using the GnuPG application, run the following command:
191     </p>
192    
193     <pre caption="Obtaining the public key">
194     $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
195     </pre>
196    
197     <p>
198     Now verify the signature:
199     </p>
200    
201     <pre caption="Verify the cryptographic signature">
202     $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
203     </pre>
204    
205     <p>
206     To burn the downloaded ISO(s), you have to select raw-burning. How you
207     do this is highly program-dependent. We will discuss <c>cdrecord</c> and
208     <c>K3B</c> here; more information can be found in our <uri
209     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
210     </p>
211    
212     <ul>
213     <li>
214     With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
215     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
216     path).
217     </li>
218     <li>
219 nightmorph 1.8 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
220     your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
221 nightmorph 1.1 </li>
222     </ul>
223    
224     </body>
225     </subsection>
226     <subsection>
227     <title>Default: Booting the Installation CD with Yaboot</title>
228     <body>
229    
230     <p>
231     On NewWorld machines place the Installation CD in the CD-ROM and reboot the
232     system. When the system-start-bell sounds, simply hold down the 'C' until the
233     CD loads.
234     </p>
235    
236     <p>
237     After the Installation CD loaded, you will be greeted by a friendly welcome
238     message and a <e>boot:</e> prompt at the bottom of the screen.
239     </p>
240    
241     <p>
242     We provide one generic kernel, <e>apple</e>. This kernel is built with support
243     for multiple CPUs, but it will boot on single processor machines as well.
244     </p>
245    
246     <p>
247     You can tweak some kernel options at this prompt. The following table lists
248     some of the available boot options you can add:
249     </p>
250    
251     <table>
252     <tr>
253     <th>Boot Option</th>
254     <th>Description</th>
255     </tr>
256     <tr>
257     <ti><c>video</c></ti>
258     <ti>
259     This option takes one of the following vendor-specific tags:
260     <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
261     <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
262     refresh rate and color depth you want to use. For instance,
263     <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
264     at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
265     32 bits. If you are uncertain what to choose, and the default doesn't work,
266     <c>video=ofonly</c> will most certainly work.
267     </ti>
268     </tr>
269     <tr>
270     <ti><c>nol3</c></ti>
271     <ti>
272     Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
273     </ti>
274     </tr>
275     <tr>
276     <ti><c>dofirewire</c></ti>
277     <ti>
278     Enables support for IEEE1394 (FireWire) devices, like external harddisks.
279     </ti>
280     </tr>
281     <tr>
282     <ti><c>dopcmcia</c></ti>
283     <ti>
284     If you want to use PCMCIA devices during your installation (like PCMCIA
285     network cards) you have to enable this option.
286     </ti>
287     </tr>
288     </table>
289    
290     <p>
291     To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
292     by the desired option. In the example below, we'll force the kernel to use the
293 nightmorph 1.9 Open Firmware framebuffer instead of the device specific driver.
294 nightmorph 1.1 </p>
295    
296 nightmorph 1.9 <pre caption="Force the use of the Open Firmware framebuffer">
297 nightmorph 1.1 boot: <i>apple video=ofonly</i>
298     </pre>
299    
300     <p>
301     If you don't need to add any options, just hit enter at this prompt, and a
302     complete Gentoo Linux environment will be loaded from the CD. Continue with
303     <uri link="#booted">And When You're Booted...</uri>.
304     </p>
305    
306     </body>
307     </subsection>
308     <subsection>
309     <title>Alternative: Booting the Installation CD on a Pegasos</title>
310     <body>
311    
312     <p>
313     On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
314     <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
315     between several preconfigured video configs. If you need any special boot
316     options you can append them to the command-line just like with Yaboot above.
317     For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
318     The default kernel options (in case something goes wrong and you need it) are
319     preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
320     looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
321     </p>
322    
323     </body>
324     </subsection>
325    
326     <subsection>
327     <title>Alternative: Booting the Installation CD with BootX</title>
328     <body>
329    
330     <p>
331     If you have an OldWorld Mac the bootable portion of the livecd can't be used.
332     The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
333     environment with a tool called BootX.
334     </p>
335    
336     <p>
337     First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
338     and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
339     archive into <c>Extensions Folder</c> and the BootX App Control Panel into
340     <c>Control Panels</c>, both of which are located in your MacOS System Folder.
341     Next, create a folder called "Linux Kernels" in your System folder and copy the
342     <c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c>
343     from the Installation CD <path>boot</path> folder into the MacOS
344     <c>System Folder</c>.
345     </p>
346    
347     <p>
348     To prepare BootX, start the BootX App Control Panel. First select the Options
349     dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
350     your System Folder. Continue back to the initial screen and ensure that the
351     ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
352     shown below:
353     </p>
354    
355     <pre caption="BootX kernel arguments">
356     cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
357     </pre>
358    
359     <note>
360     The kernel parameters in the yaboot section above are also applicable here. You
361     can append any of those options to the kernel arguments above.
362     </note>
363    
364     <p>
365     Check once more to make sure the settings are correct and then save the
366     configuration. This saves typing just in case it doesn't boot or something is
367     missing. Press the Linux button at the top of the window. If everything goes
368     correctly, it should boot into the Installation CD. Continue with
369     <uri link="#booted">And When You're Booted...</uri>
370     </p>
371    
372     </body>
373     </subsection>
374    
375     <subsection id="booted">
376     <title>And When You're Booted...</title>
377     <body>
378    
379     <p>
380     You will be greeted by a root ("#") prompt on the current console. You can also
381     switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
382     back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
383     you may need to press Alt-fn-Fx on Apple machines.
384     </p>
385    
386     <p>
387     If you are installing Gentoo on a system with a non-US keyboard, use
388     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
389     keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
390     Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
391     are for ADB-based OldWorld machines.
392     </p>
393    
394     <pre caption="Listing available keymaps">
395     <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
396     on the Installation CD are ADB keymaps and unusable with the Installation CD
397     kernel)</comment>
398     # <i>ls /usr/share/keymaps/i386</i>
399     </pre>
400    
401     <p>
402     Now load the keymap of your choice:
403     </p>
404    
405     <pre caption="Loading a keymap">
406     # <i>loadkeys be-latin1</i>
407     </pre>
408    
409     <p>
410     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
411     </p>
412    
413     </body>
414     </subsection>
415     <subsection id="hardware">
416     <title>Extra Hardware Configuration</title>
417     <body>
418    
419     <p>
420     When the Installation CD boots, it tries to detect all your hardware devices and
421     loads the appropriate kernel modules to support your hardware. In the
422     vast majority of cases, it does a very good job. However, in some cases, it may
423     not auto-load the kernel modules you need. If the PCI auto-detection missed some
424     of your system's hardware, you will have to load the appropriate kernel modules
425     manually.
426     </p>
427    
428     <p>
429     In the next example we try to load the <c>airport</c> module. This module
430     supports only the old Airport cards (802.11b). Airport Extreme (802.11g) is not
431     supported on the InstallCD due to restrictions on firmware distribution.
432     </p>
433    
434     <pre caption="Loading the airport module">
435     # <i>modprobe airport</i>
436     </pre>
437    
438     <p>
439     On older iMacs, sometimes the network card is not detected properly. These use
440     the BMAC driver:
441     </p>
442    
443     <pre caption="Loading the bmac module">
444     # <i>modprobe bmac</i>
445     </pre>
446    
447     </body>
448     </subsection>
449     <subsection>
450     <title>Optional: Tweaking Hard Disk Performance</title>
451     <body>
452    
453     <p>
454     If you are an advanced user, you might want to tweak the IDE hard disk
455     performance using <c>hdparm</c>. With the <c>-tT</c> options you can
456     test the performance of your disk (execute it several times to get a
457     more precise impression):
458     </p>
459    
460     <pre caption="Testing disk performance">
461     # <i>hdparm -tT /dev/hda</i>
462     </pre>
463    
464     <p>
465     To tweak, you can use any of the following examples (or experiment
466     yourself) which use <path>/dev/hda</path> as disk (substitute with your
467     disk):
468     </p>
469    
470     <pre caption="Tweaking hard disk performance">
471 nightmorph 1.3 <comment>Activate DMA:</comment>
472     # <i>hdparm -d 1 /dev/hda</i>
473     <comment>Activate DMA + Safe Performance-enhancing Options:</comment>
474     # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
475 nightmorph 1.1 </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 nightmorph 1.4 # <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
555 nightmorph 1.1 </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