/[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.62 - (show annotations) (download) (as text)
Wed Aug 5 15:25:23 2009 UTC (5 years, 1 month ago) by nightmorph
Branch: MAIN
Changes since 1.61: +5 -9 lines
File MIME type: application/xml
Kill ADB references where needed, bug 277958. the reference in the PPC FAQ stays where it is. Thanks to JoseJX for info on this.

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.61 2008/05/02 08:04:23 nightmorph Exp $ -->
8
9 <sections>
10
11 <version>9.2</version>
12 <date>2009-08-05</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 Open Firmware 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</th>
49 <ti>
50 Pegasos I/II, Open Desktop Workstation, Efika
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
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 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 </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 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 </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 <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 </table>
300
301 <p>
302 To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
303 by the desired option. In the example below, we'll force the kernel to use the
304 Open Firmware framebuffer instead of the device specific driver.
305 </p>
306
307 <pre caption="Force the use of the Open Firmware framebuffer">
308 boot: <i>apple video=ofonly</i>
309 </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 </p>
316
317 </body>
318 </subsection>
319 <subsection>
320 <title>Alternative: Booting the Installation CD on a Pegasos</title>
321 <body>
322
323 <p>
324 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
325 <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 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 looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
332 </p>
333
334 </body>
335 </subsection>
336
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 The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
344 environment with a tool called BootX.
345 </p>
346
347 <p>
348 First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
349 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 Next, create a folder called "Linux Kernels" in your System folder and copy the
353 <c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c>
354 from the Installation CD <path>boot</path> folder into the MacOS
355 <c>System Folder</c>.
356 </p>
357
358 <p>
359 To prepare BootX, start the BootX App Control Panel. First select the Options
360 dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
361 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 cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
368 </pre>
369
370 <note>
371 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 </note>
374
375 <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 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 </p>
382
383 </body>
384 </subsection>
385
386 <subsection id="booted">
387 <title>And When You're Booted...</title>
388 <body>
389
390 <p>
391 You will be greeted by a root ("#") prompt on the current console. You can also
392 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
393 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 </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 keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
401 </p>
402
403 <pre caption="Listing available keymaps">
404 <comment>(PPC uses x86 keymaps on most systems.)</comment>
405 # <i>ls /usr/share/keymaps/i386</i>
406 </pre>
407
408 <p>
409 Now load the keymap of your choice:
410 </p>
411
412 <pre caption="Loading a keymap">
413 # <i>loadkeys be-latin1</i>
414 </pre>
415
416 <p>
417 Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
418 </p>
419
420 </body>
421 </subsection>
422
423 <subsection>
424 <include href="hb-install-bootconfig.xml"/>
425 </subsection>
426
427 </section>
428 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20