/[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.61 - (hide annotations) (download) (as text)
Fri May 2 08:04:23 2008 UTC (6 years, 4 months ago) by nightmorph
Branch: MAIN
Changes since 1.60: +4 -174 lines
File MIME type: application/xml
As announced on the list (http://archives.gentoo.org/gentoo-doc/msg_e721be404c6a5ae8ce5c5bf02f45381c.xml), assume all arches are using the libata framework, so sd* everywhere. includes updating block device and partition descriptions. also added a new included file for boot config (starting sshd, hdparm, etc). synced up several wayward files, including sparc. also changed/dropped usage of some now useless keys, since everyone's using sd*. lots of intensive, invasive changes. and i never even used sed once.

1 swift 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 neysx 1.47 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 swift 1.1
7 nightmorph 1.61 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.60 2008/04/01 08:53:46 nightmorph Exp $ -->
8 swift 1.1
9     <sections>
10 swift 1.32
11 nightmorph 1.61 <version>9.1</version>
12     <date>2008-05-02</date>
13 swift 1.32
14 swift 1.1 <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 swift 1.35 successfully install Gentoo on your box.
23 swift 1.1 </p>
24    
25     </body>
26     </subsection>
27     <subsection>
28 swift 1.35 <title>Hardware Requirements</title>
29 swift 1.1 <body>
30    
31 swift 1.35 <table>
32     <tr>
33 swift 1.45 <th>Apple NewWorld Machines</th>
34 swift 1.35 <ti>
35     Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
36 swift 1.45 PowerBook, Xserver, PowerMac
37 swift 1.35 </ti>
38     </tr>
39     <tr>
40 swift 1.45 <th>Apple OldWorld machines</th>
41 swift 1.35 <ti>
42 nightmorph 1.57 Apple Machines with an Open Firmware revision less than 3, such as the Beige
43     G3s, PCI PowerMacs and PCI PowerBooks. PCI based Apple Clones should also
44 swift 1.45 be supported.
45     </ti>
46     </tr>
47     <tr>
48 nightmorph 1.55 <th>Genesi</th>
49 swift 1.45 <ti>
50 nightmorph 1.55 Pegasos I/II, Open Desktop Workstation, Efika
51 swift 1.45 </ti>
52     </tr>
53     <tr>
54     <th>IBM</th>
55     <ti>
56     RS/6000, iSeries, pSeries
57 swift 1.35 </ti>
58     </tr>
59     <tr>
60     <th>Memory</th>
61 swift 1.39 <ti>At least 64 MB</ti>
62 swift 1.35 </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 swift 1.1 <p>
74 fox2mike 1.52 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 swift 1.1 </p>
78    
79     </body>
80     </subsection>
81     </section>
82 nightmorph 1.60
83 swift 1.35 <!-- START -->
84 swift 1.1 <section>
85 nightmorph 1.54 <title>The Gentoo Universal Installation CD</title>
86 swift 1.1 <subsection>
87 swift 1.35 <title>Introduction</title>
88 swift 1.1 <body>
89    
90     <p>
91 nightmorph 1.54 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 swift 1.1 </p>
95    
96     <p>
97 nightmorph 1.54 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 swift 1.35 </p>
101    
102 nightmorph 1.54 </body>
103     </subsection>
104     <subsection>
105     <title>Gentoo Universal Installation CD</title>
106     <body>
107    
108 swift 1.35 <p>
109 nightmorph 1.54 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 swift 1.1 </p>
114    
115     <p>
116 nightmorph 1.54 There currently are two Installation CDs available:
117 swift 1.35 </p>
118    
119     <ul>
120     <li>
121 nightmorph 1.54 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 swift 1.35 </li>
126     <li>
127 nightmorph 1.54 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 swift 1.35 </li>
132     </ul>
133    
134     <p>
135 nightmorph 1.54 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 swift 1.35 </p>
142    
143 swift 1.48 <p>
144 nightmorph 1.54 The use of the Package CD is covered later in this document.
145 swift 1.48 </p>
146    
147 swift 1.35 </body>
148     </subsection>
149 swift 1.1 </section>
150 swift 1.35 <!-- STOP -->
151 swift 1.1 <section>
152 nightmorph 1.54 <title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
153 swift 1.1 <subsection>
154 nightmorph 1.54 <title>Downloading and Burning the Installation CD</title>
155 swift 1.1 <body>
156    
157     <p>
158 nightmorph 1.55 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 swift 1.35 </p>
164    
165     <p>
166 nightmorph 1.60 Inside those directories you'll find ISO files. Those are full CD images which
167 nightmorph 1.54 you can write on a CD-R.
168 swift 1.1 </p>
169    
170     <p>
171 nightmorph 1.54 After downloading the file, you can verify its integrity to see if it is
172     corrupted or not:
173 swift 1.1 </p>
174    
175 nightmorph 1.54 <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 swift 1.1
189     <p>
190 nightmorph 1.54 To fetch our public key using the GnuPG application, run the following command:
191 swift 1.12 </p>
192    
193 swift 1.35 <pre caption="Obtaining the public key">
194 nightmorph 1.54 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 0x17072058</i>
195 swift 1.12 </pre>
196    
197     <p>
198 swift 1.35 Now verify the signature:
199 swift 1.12 </p>
200    
201 swift 1.35 <pre caption="Verify the cryptographic signature">
202     $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
203     </pre>
204 swift 1.12
205     <p>
206 swift 1.1 To burn the downloaded ISO(s), you have to select raw-burning. How you
207 swift 1.35 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 swift 1.1 </p>
211    
212     <ul>
213     <li>
214 nightmorph 1.54 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 swift 1.1 </li>
218     <li>
219 nightmorph 1.56 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 swift 1.3 </li>
222 swift 1.1 </ul>
223    
224     </body>
225     </subsection>
226     <subsection>
227 josejx 1.41 <title>Default: Booting the Installation CD with Yaboot</title>
228 swift 1.1 <body>
229    
230     <p>
231 swift 1.39 On NewWorld machines place the Installation CD in the CD-ROM and reboot the
232 nightmorph 1.54 system. When the system-start-bell sounds, simply hold down the 'C' until the
233 swift 1.39 CD loads.
234 dertobi123 1.17 </p>
235    
236     <p>
237 swift 1.39 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 swift 1.1 </p>
240    
241     <p>
242 nightmorph 1.54 We provide one generic kernel, <e>apple</e>. This kernel is built with support
243 fox2mike 1.52 for multiple CPUs, but it will boot on single processor machines as well.
244 swift 1.1 </p>
245    
246     <p>
247 fox2mike 1.52 You can tweak some kernel options at this prompt. The following table lists
248     some of the available boot options you can add:
249 swift 1.1 </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 fox2mike 1.52 <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 swift 1.1 </ti>
268     </tr>
269     <tr>
270 pylon 1.2 <ti><c>nol3</c></ti>
271 swift 1.1 <ti>
272 dertobi123 1.17 Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
273 swift 1.1 </ti>
274     </tr>
275     <tr>
276 swift 1.39 <ti><c>dofirewire</c></ti>
277 swift 1.1 <ti>
278 swift 1.39 Enables support for IEEE1394 (FireWire) devices, like external harddisks.
279 swift 1.1 </ti>
280     </tr>
281 swift 1.7 <tr>
282 swift 1.39 <ti><c>dopcmcia</c></ti>
283 swift 1.7 <ti>
284 nightmorph 1.54 If you want to use PCMCIA devices during your installation (like PCMCIA
285     network cards) you have to enable this option.
286 swift 1.7 </ti>
287     </tr>
288 nightmorph 1.60 <tr>
289     <ti><c>dosshd</c></ti>
290     <ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
291     </tr>
292     <tr>
293     <ti><c>passwd=foo</c></ti>
294     <ti>
295     Sets whatever is after the = as the root password. Use with <c>dosshd</c>
296     for remote installs.
297     </ti>
298     </tr>
299 swift 1.1 </table>
300    
301     <p>
302 nightmorph 1.54 To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
303 josejx 1.53 by the desired option. In the example below, we'll force the kernel to use the
304 nightmorph 1.57 Open Firmware framebuffer instead of the device specific driver.
305 josejx 1.53 </p>
306    
307 nightmorph 1.57 <pre caption="Force the use of the Open Firmware framebuffer">
308 nightmorph 1.54 boot: <i>apple video=ofonly</i>
309 josejx 1.53 </pre>
310    
311     <p>
312     If you don't need to add any options, just hit enter at this prompt, and a
313     complete Gentoo Linux environment will be loaded from the CD. Continue with
314     <uri link="#booted">And When You're Booted...</uri>.
315 swift 1.1 </p>
316    
317 swift 1.7 </body>
318     </subsection>
319     <subsection>
320 swift 1.39 <title>Alternative: Booting the Installation CD on a Pegasos</title>
321 swift 1.7 <body>
322    
323 swift 1.1 <p>
324 swift 1.7 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
325 swift 1.39 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
326     between several preconfigured video configs. If you need any special boot
327 fox2mike 1.52 options you can append them to the command-line just like with Yaboot above.
328     For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
329     The default kernel options (in case something goes wrong and you need it) are
330     preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
331 nightmorph 1.54 looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
332 swift 1.1 </p>
333    
334 swift 1.7 </body>
335     </subsection>
336 josejx 1.41
337     <subsection>
338     <title>Alternative: Booting the Installation CD with BootX</title>
339     <body>
340    
341     <p>
342     If you have an OldWorld Mac the bootable portion of the livecd can't be used.
343 josejx 1.53 The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
344     environment with a tool called BootX.
345 josejx 1.41 </p>
346 swift 1.45
347 josejx 1.41 <p>
348 grahl 1.58 First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
349 josejx 1.41 and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
350     archive into <c>Extensions Folder</c> and the BootX App Control Panel into
351     <c>Control Panels</c>, both of which are located in your MacOS System Folder.
352 josejx 1.42 Next, create a folder called "Linux Kernels" in your System folder and copy the
353 nightmorph 1.54 <c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c>
354 josejx 1.42 from the Installation CD <path>boot</path> folder into the MacOS
355     <c>System Folder</c>.
356 josejx 1.41 </p>
357 swift 1.45
358 josejx 1.41 <p>
359     To prepare BootX, start the BootX App Control Panel. First select the Options
360 nightmorph 1.54 dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
361 josejx 1.41 your System Folder. Continue back to the initial screen and ensure that the
362     ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
363     shown below:
364     </p>
365    
366     <pre caption="BootX kernel arguments">
367 nightmorph 1.54 cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
368 josejx 1.41 </pre>
369 swift 1.45
370 josejx 1.41 <note>
371 fox2mike 1.52 The kernel parameters in the yaboot section above are also applicable here. You
372     can append any of those options to the kernel arguments above.
373 josejx 1.41 </note>
374 swift 1.45
375 josejx 1.41 <p>
376     Check once more to make sure the settings are correct and then save the
377     configuration. This saves typing just in case it doesn't boot or something is
378 fox2mike 1.52 missing. Press the Linux button at the top of the window. If everything goes
379     correctly, it should boot into the Installation CD. Continue with
380     <uri link="#booted">And When You're Booted...</uri>
381 josejx 1.41 </p>
382 swift 1.45
383 josejx 1.41 </body>
384     </subsection>
385    
386 swift 1.7 <subsection id="booted">
387     <title>And When You're Booted...</title>
388     <body>
389 swift 1.1
390     <p>
391 swift 1.7 You will be greeted by a root ("#") prompt on the current console. You can also
392 swift 1.39 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
393 fox2mike 1.52 back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
394     you may need to press Alt-fn-Fx on Apple machines.
395 swift 1.1 </p>
396    
397     <p>
398     If you are installing Gentoo on a system with a non-US keyboard, use
399     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
400 nightmorph 1.54 keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
401 swift 1.39 Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
402     are for ADB-based OldWorld machines.
403 swift 1.1 </p>
404    
405     <pre caption="Listing available keymaps">
406     <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
407 swift 1.39 on the Installation CD are ADB keymaps and unusable with the Installation CD
408     kernel)</comment>
409 swift 1.1 # <i>ls /usr/share/keymaps/i386</i>
410     </pre>
411    
412     <p>
413     Now load the keymap of your choice:
414     </p>
415    
416     <pre caption="Loading a keymap">
417 swift 1.7 # <i>loadkeys be-latin1</i>
418 swift 1.1 </pre>
419    
420     <p>
421     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
422     </p>
423    
424     </body>
425     </subsection>
426    
427     <subsection>
428 nightmorph 1.61 <include href="hb-install-bootconfig.xml"/>
429 swift 1.1 </subsection>
430    
431     </section>
432     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20