/[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.78 - (show annotations) (download) (as text)
Sat Apr 12 12:25:48 2014 UTC (7 months, 2 weeks ago) by swift
Branch: MAIN
CVS Tags: HEAD
Changes since 1.77: +15 -27 lines
File MIME type: application/xml
Fix bug #506132 - Most architectures only have a single installation CD. Also, LiveDVD is not created every 6 months. Thanks to Vladimir Romanov

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.77 2014/01/23 19:32:49 swift Exp $ -->
8
9 <sections>
10
11 <abstract>
12 You can install Gentoo in many ways. This chapter explains how to install
13 Gentoo using the minimal Installation CD.
14 </abstract>
15
16 <version>19</version>
17 <date>2014-04-12</date>
18
19 <section>
20 <title>Hardware Requirements</title>
21 <subsection>
22 <title>Introduction</title>
23 <body>
24
25 <p>
26 Before we start, we first list what hardware requirements you need to
27 successfully install Gentoo on your box.
28 </p>
29
30 </body>
31 </subsection>
32 <subsection>
33 <title>Hardware Requirements</title>
34 <body>
35
36 <table>
37 <tr>
38 <th>Apple NewWorld Machines</th>
39 <ti>
40 Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
41 PowerBook, Xserver, PowerMac
42 </ti>
43 </tr>
44 <tr>
45 <th>Apple OldWorld machines</th>
46 <ti>
47 Apple Machines with an Open Firmware revision less than 3, such as the Beige
48 G3s, PCI PowerMacs and PCI PowerBooks. PCI-based Apple Clones should also
49 be supported.
50 </ti>
51 </tr>
52 <tr>
53 <th>Genesi</th>
54 <ti>
55 Pegasos I/II, Open Desktop Workstation, Efika
56 </ti>
57 </tr>
58 <tr>
59 <th>IBM</th>
60 <ti>
61 RS/6000, iSeries, pSeries
62 </ti>
63 </tr>
64 <tr>
65 <th>Memory</th>
66 <ti>At least 64 MB</ti>
67 </tr>
68 <tr>
69 <th>Diskspace</th>
70 <ti>1.5 GB (excluding swap space)</ti>
71 </tr>
72 <tr>
73 <th>Swap space</th>
74 <ti>At least 256 MB</ti>
75 </tr>
76 </table>
77
78 <p>
79 Be sure to read the <uri link="https://wiki.gentoo.org/wiki/PPC/FAQ">Gentoo PPC FAQ</uri>
80 for help with some common installation related issues or if you're unsure as to
81 just what's in that PowerPC machine you've got sitting on your desk right now.
82 </p>
83
84 </body>
85 </subsection>
86 </section>
87
88 <!-- START -->
89 <section>
90 <title>The Gentoo Installation CD</title>
91 <subsection>
92 <title>Gentoo Minimal Installation CD</title>
93 <body>
94
95 <p>
96 The <e>Minimal Installation CD</e> is a bootable CD which contains a
97 self-sustained Gentoo environment. It allows you to boot Linux from the CD.
98 During the boot process your hardware is detected and the appropriate drivers
99 are loaded. The CD is maintained by Gentoo developers and allows you to install
100 Gentoo with an active Internet connection.
101 </p>
102
103 <p>
104 The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
105 takes up around <keyval id="min-cd-size"/> MB of diskspace.
106 </p>
107
108 </body>
109 </subsection>
110 <subsection>
111 <title>The Stage3 Tarball</title>
112 <body>
113
114 <p>
115 A stage3 tarball is an archive containing a minimal Gentoo environment,
116 suitable to continue the Gentoo installation using the instructions in this
117 manual. Previously, the Gentoo Handbook described the installation using one of
118 three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
119 official installation method uses the stage3 tarball. If you are interested in
120 performing a Gentoo installation using a stage1 or stage2 tarball, please read
121 the Gentoo FAQ on <uri link="https://wiki.gentoo.org/wiki/FAQ#How_do_I_Install_Gentoo_Using_a_Stage1_or_Stage2_Tarball.3F">How
122 do I Install Gentoo Using a Stage1 or Stage2 Tarball?</uri>
123 </p>
124
125 <p>
126 Stage3 tarballs can be downloaded from <path><keyval
127 id="release-dir"/>current-stage3/</path> on any of the <uri
128 link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
129 on the LiveCD.
130 </p>
131
132 </body>
133 </subsection>
134 </section>
135
136
137 <!-- STOP -->
138 <section>
139 <title>Download, Burn and Boot a Gentoo Installation CD</title>
140 <subsection>
141 <title>Downloading and Burning the Installation CD</title>
142 <body>
143
144 <p>
145 You have chosen to use a Gentoo Installation CD. We'll first start by
146 downloading and burning the chosen Installation CD. We previously discussed
147 the Installation CD, but where can you find it?
148 </p>
149
150 <p>
151 You can download the Installation CD from one of our <uri
152 link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
153 the <path><keyval id="release-dir"/>current-iso/</path> directory.
154 </p>
155
156 <p>
157 Inside that directory you'll find the ISO file. This is a full CD image which you
158 can write on a CD-R.
159 </p>
160
161 <p>
162 In case you wonder if your downloaded file is corrupted or not, you can check
163 its SHA-2 checksum and compare it with the SHA-2 checksum we provide (such as
164 <path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the SHA-2
165 checksum with the <c>sha512sum</c> tool under Linux/Unix or <uri
166 link="http://www.sinf.gr/en/hashcalc.html">Checksums calculator</uri> for Windows.
167 </p>
168
169 <note>
170 The tool will attempt to verify the checksums in the list, even if the checksum
171 is made with a different algorithm. Therefore, the output of the command might
172 give both success (for SHA checksums) and failures (for other checksums). At
173 least one OK needs to be provided for each file.
174 </note>
175
176 <pre caption="Verifying the SHA-2 checksum">
177 $ <i>sha512sum -c &lt;downloaded iso.DIGESTS&gt;</i>
178 </pre>
179
180 <note>
181 If you get the message that no properly formatted SHA checksum was found, take a
182 look at the DIGESTS file yourself to see what the supported checksums are.
183 </note>
184
185 <p>
186 Another way to check the validity of the downloaded file is to use GnuPG to
187 verify the cryptographic signature that we provide (the file ending with
188 <path>.asc</path>). Download the signature file and obtain the public keys whose
189 key ids can be found on the <uri link="/proj/en/releng/index.xml">release
190 engineering project site</uri>.
191 </p>
192
193 <pre caption="Obtaining the public key">
194 <comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
195 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
196 </pre>
197
198 <p>
199 Now verify the signature:
200 </p>
201
202 <pre caption="Verify the files">
203 $ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
204 $ <i>sha512sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
205 </pre>
206
207 <p>
208 To burn the downloaded ISO(s), you have to select raw-burning. How you
209 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
210 <c>K3B</c> here; more information can be found in our <uri
211 link="https://wiki.gentoo.org/wiki/FAQ#How_do_I_burn_an_ISO_file.3F">Gentoo FAQ</uri>.
212 </p>
213
214 <ul>
215 <li>
216 With cdrecord, you simply type <c>cdrecord dev=/dev/sr0 &lt;downloaded iso
217 file&gt;</c> (replace <path>/dev/sr0</path> with your CD-RW drive's device
218 path).
219 </li>
220 <li>
221 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
222 your ISO file within the 'Image to Burn' area. Finally click <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>ppc32</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 <tr>
291 <ti><c>dosshd</c></ti>
292 <ti>Starts <c>sshd</c>. Useful for unattended installs.</ti>
293 </tr>
294 <tr>
295 <ti><c>passwd=foo</c></ti>
296 <ti>
297 Sets whatever is after the = as the root password. Use with <c>dosshd</c>
298 for remote installs.
299 </ti>
300 </tr>
301 </table>
302
303 <p>
304 To use the above options, at the <e>boot:</e> prompt, type <e>ppc32</e> followed
305 by the desired option. In the example below, we'll force the kernel to use the
306 Open Firmware framebuffer instead of the device specific driver.
307 </p>
308
309 <pre caption="Force the use of the Open Firmware framebuffer">
310 boot: <i>ppc32 video=ofonly</i>
311 </pre>
312
313 <p>
314 If you don't need to add any options, just type ppc32 at this prompt, and a
315 complete Gentoo Linux environment will be loaded from the CD. Continue with
316 <uri link="#booted">And When You're Booted...</uri>.
317 </p>
318
319 </body>
320 </subsection>
321 <subsection>
322 <title>Alternative: Booting the Installation CD on a Pegasos</title>
323 <body>
324
325 <p>
326 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
327 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
328 between several preconfigured video configs. If you need any special boot
329 options you can append them to the command-line just like with Yaboot above.
330 For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
331 The default kernel options (in case something goes wrong and you need it) are
332 preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
333 looptype=squashfs loop=/image.squashfs cdroot root=/dev/ram0</c>.
334 </p>
335
336 </body>
337 </subsection>
338
339 <subsection>
340 <title>Alternative: Booting the Installation CD with BootX</title>
341 <body>
342
343 <p>
344 If you have an OldWorld Mac the bootable portion of the livecd can't be used.
345 The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
346 environment with a tool called BootX.
347 </p>
348
349 <p>
350 First, download <uri link="http://penguinppc.org/bootloaders/bootx/">BootX</uri>
351 and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
352 archive into <c>Extensions Folder</c> and the BootX App Control Panel into
353 <c>Control Panels</c>, both of which are located in your MacOS System Folder.
354 Next, create a folder called "Linux Kernels" in your System folder and copy the
355 <c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c>
356 from the Installation CD <path>boot</path> folder into the MacOS
357 <c>System Folder</c>.
358 </p>
359
360 <p>
361 To prepare BootX, start the BootX App Control Panel. First select the Options
362 dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from
363 your System Folder. Continue back to the initial screen and ensure that the
364 ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
365 shown below:
366 </p>
367
368 <pre caption="BootX kernel arguments">
369 cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0
370 </pre>
371
372 <note>
373 The kernel parameters in the yaboot section above are also applicable here. You
374 can append any of those options to the kernel arguments above.
375 </note>
376
377 <p>
378 Check once more to make sure the settings are correct and then save the
379 configuration. This saves typing just in case it doesn't boot or something is
380 missing. Press the Linux button at the top of the window. If everything goes
381 correctly, it should boot into the Installation CD. Continue with
382 <uri link="#booted">And When You're Booted...</uri>
383 </p>
384
385 </body>
386 </subsection>
387
388 <subsection id="booted">
389 <title>And When You're Booted...</title>
390 <body>
391
392 <p>
393 You will be greeted by a root ("#") prompt on the current console. You can also
394 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
395 back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
396 you may need to press Alt-fn-Fx on Apple machines.
397 </p>
398
399 <p>
400 If you are installing Gentoo on a system with a non-US keyboard, use
401 <c>loadkeys</c> to load the keymap for your keyboard. To list the available
402 keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
403 </p>
404
405 <pre caption="Listing available keymaps">
406 <comment>(PPC uses x86 keymaps on most systems.)</comment>
407 # <i>ls /usr/share/keymaps/i386</i>
408 </pre>
409
410 <p>
411 Now load the keymap of your choice:
412 </p>
413
414 <pre caption="Loading a keymap">
415 # <i>loadkeys be-latin1</i>
416 </pre>
417
418 <p>
419 Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
420 </p>
421
422 </body>
423 </subsection>
424
425 <subsection>
426 <include href="hb-install-bootconfig.xml"/>
427 </subsection>
428
429 </section>
430 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20