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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.42 Revision 1.50
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.42 2005/04/11 03:49:30 josejx Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.50 2005/11/21 16:38:19 neysx Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.1</version> 11<version>2.7</version>
12<date>2005-04-10</date> 12<date>2005-11-11</date>
13 13
14<section> 14<section>
15<title>Hardware Requirements</title> 15<title>Hardware Requirements</title>
16<subsection> 16<subsection>
17<title>Introduction</title> 17<title>Introduction</title>
28<title>Hardware Requirements</title> 28<title>Hardware Requirements</title>
29<body> 29<body>
30 30
31<table> 31<table>
32<tr> 32<tr>
33 <th>NewWorld machines</th> 33 <th>Apple NewWorld Machines</th>
34 <ti> 34 <ti>
35 Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook 35 Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
36 PowerBook, Xserver, PowerMac, Genesi's Pegasos II 36 PowerBook, Xserver, PowerMac
37 </ti>
38</tr>
39<tr>
40 <th>OldWorld machines</th>
41 <ti> 37 </ti>
42 Limited support for IBM (RS/6000, iSeries, pSeries) and Amiga systems 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
43 </ti> 57 </ti>
44</tr> 58</tr>
45<tr> 59<tr>
46 <th>Memory</th> 60 <th>Memory</th>
47 <ti>At least 64 MB</ti> 61 <ti>At least 64 MB</ti>
64</body> 78</body>
65</subsection> 79</subsection>
66</section> 80</section>
67<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) --> 81<!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) -->
68<!-- START --> 82<!-- START -->
69<section>
70<title>The Gentoo Installation Approaches</title>
71<subsection>
72<title>Introduction</title>
73<body>
74
75<p>
76Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
77A stage file is a tarball (compressed archive) that contains a minimal
78environment.
79</p>
80
81<ul>
82 <li>
83 A stage1 file contains nothing more than a compiler, Portage (Gentoo's
84 software management system) and a couple of packages on which the compiler
85 or Portage depends.
86 </li>
87 <li>
88 A stage2 file contains a so-called bootstrapped system, a minimal
89 environment from which one can start building all other necessary
90 applications that make a Gentoo environment complete.
91 </li>
92 <li>
93 A stage3 file contains a prebuilt minimal system which is almost fully
94 deployable. It only lacks a few applications where you, the Gentoo user,
95 needs to choose which one you want to install.
96 </li>
97</ul>
98
99<p>
100To help you decide what stage file you want to use, we have written down the
101major advantages and disadvantages of each stage file.
102</p>
103
104</body>
105</subsection>
106<subsection>
107<title>A Stage1 Approach</title>
108<body>
109
110<p>
111A <e>stage1</e> is used when you want to bootstrap and build the entire system
112from scratch.
113</p>
114
115<p>
116Starting from a stage1 allows you to have total control over the
117optimization settings and optional build-time functionality that is
118initially enabled on your system. This makes <e>stage1</e> installs good for
119power users who know what they are doing. It is also a great
120installation method for those who would like to know more about the
121inner workings of Gentoo Linux.
122</p>
123
124<table>
125<tr>
126 <th>Stage1</th>
127 <th>Pros and Cons</th>
128</tr>
129<tr>
130 <th>+</th>
131 <ti>
132 Allows you to have total control over the optimization settings and optional
133 build-time functionality that is initially enabled on your system
134 </ti>
135</tr>
136<tr>
137 <th>+</th>
138 <ti>Suitable for powerusers that know what they are doing</ti>
139</tr>
140<tr>
141 <th>+</th>
142 <ti>Allows you to learn more about the inner workings of Gentoo</ti>
143</tr>
144<tr>
145 <th>-</th>
146 <ti>Takes a long time to finish the installation</ti>
147</tr>
148<tr>
149 <th>-</th>
150 <ti>
151 If you don't intend to tweak the settings, it is a waste of time
152 </ti>
153</tr>
154<tr>
155 <th>-</th>
156 <ti>
157 Requires a working Internet connection during the installation
158 </ti>
159</tr>
160</table>
161
162</body>
163</subsection>
164<subsection>
165<title>A Stage2 Approach</title>
166<body>
167
168<p>
169A <e>stage2</e> is used for building the entire system from a bootstrapped
170"semi-compiled" state.
171</p>
172
173<p>
174Stage2 installs allow you to skip the bootstrap process; doing this
175is fine if you are happy with the optimization settings that we chose
176for your particular stage2 tarball.
177</p>
178
179<table>
180<tr>
181 <th>Stage2</th>
182 <th>Pros and Cons</th>
183</tr>
184<tr>
185 <th>+</th>
186 <ti>You don't need to bootstrap</ti>
187</tr>
188<tr>
189 <th>+</th>
190 <ti>Faster than starting with stage1</ti>
191</tr>
192<tr>
193 <th>+</th>
194 <ti>You can still tweak your settings</ti>
195</tr>
196<tr>
197 <th>-</th>
198 <ti>You cannot tweak as much as with a stage1</ti>
199</tr>
200<tr>
201 <th>-</th>
202 <ti>It's still not the fastest way to install Gentoo</ti>
203</tr>
204<tr>
205 <th>-</th>
206 <ti>You have to accept the optimizations we chose for the bootstrap</ti>
207</tr>
208<tr>
209 <th>-</th>
210 <ti>
211 Requires a working Internet connection during the installation
212 </ti>
213</tr>
214</table>
215
216</body>
217</subsection>
218<subsection>
219<title>A Stage3 Approach</title>
220<body>
221
222<p>
223A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
224built for you. You will only need to build a few packages of which we can't
225decide for you which one to choose.
226</p>
227
228<p>
229Choosing to go with a stage3 allows for the fastest install of Gentoo
230Linux, but also means that your base system will have the optimization
231settings that we chose for you (which to be honest, are good settings
232and were carefully chosen to enhance performance while maintaining
233stability). Stage3 is also required if you want to install Gentoo using
234prebuilt packages or without a network connection.
235</p>
236
237<table>
238<tr>
239 <th>Stage3</th>
240 <th>Pros and Cons</th>
241</tr>
242<tr>
243 <th>+</th>
244 <ti>Fastest way to get a Gentoo base system</ti>
245</tr>
246<tr>
247 <th>-</th>
248 <ti>You cannot tweak the base system - it's built already</ti>
249</tr>
250</table>
251
252<p>
253You might be interested to know that, if you decide to use different
254optimization settings after having installed Gentoo, you will be able to
255recompile your entire system with the new optimization settings.
256</p>
257
258</body>
259</subsection>
260</section>
261<section> 83<section>
262<title>The Gentoo Installation CDs</title> 84<title>The Gentoo Installation CDs</title>
263<subsection> 85<subsection>
264<title>Introduction</title> 86<title>Introduction</title>
265<body> 87<body>
280</p> 102</p>
281 103
282<p> 104<p>
283If you wish to install Gentoo without a working Internet connection, please use 105If you wish to install Gentoo without a working Internet connection, please use
284the installation instructions described in the <uri 106the installation instructions described in the <uri
285link="2005.0/index.xml">Gentoo 2005.0 Handbooks</uri>. 107link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>.
286</p> 108</p>
287 109
288<p> 110<p>
289The two Installation CDs that we currently provide are: 111The two Installation CDs that we currently provide are:
290</p> 112</p>
295 CD which sole purpose is to boot the system, prepare the networking and 117 CD which sole purpose is to boot the system, prepare the networking and
296 continue with the Gentoo installation. 118 continue with the Gentoo installation.
297 </li> 119 </li>
298 <li> 120 <li>
299 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same 121 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
300 abilities as the Minimal Installation CD. Additionally, it contains a 122 abilities as the Minimal Installation CD. Additionally, it contains
301 stage1 and several stage3 tarballs (optimized for the individual 123 several stage3 tarballs (optimized for the individual subarchitectures).
302 subarchitectures).
303 </li> 124 </li>
304</ul> 125</ul>
305 126
306<p> 127<p>
307To help you decide which Installation CD you need, we have written down the 128To help you decide which Installation CD you need, we have written down the
313<subsection> 134<subsection>
314<title>Gentoo's Minimal Installation CD</title> 135<title>Gentoo's Minimal Installation CD</title>
315<body> 136<body>
316 137
317<p> 138<p>
318The Minimal Installation CD is called <c>install-ppc-minimal-2005.0.iso</c> and 139The Minimal Installation CD is called <c>install-ppc-minimal-2005.1.iso</c> and
319takes up only 52 MB of diskspace. You can use this Installation CD to install 140takes up only 52 MB of diskspace. You can use this Installation CD to install
320Gentoo, but always with a working Internet connection only. 141Gentoo, but always with a working Internet connection only.
321</p> 142</p>
322 143
323<table> 144<table>
328<tr> 149<tr>
329 <th>+</th> 150 <th>+</th>
330 <ti>Smallest download</ti> 151 <ti>Smallest download</ti>
331</tr> 152</tr>
332<tr> 153<tr>
333 <th>+</th>
334 <ti>
335 You can do a stage1, stage2 or stage3 by getting the stage tarball off the
336 net
337 </ti>
338</tr>
339<tr>
340 <th>-</th> 154 <th>-</th>
341 <ti> 155 <ti>
342 Contains no stages, no Portage snapshot, no prebuilt packages and is 156 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
343 therefore not suitable for networkless installation 157 therefore not suitable for networkless installation
344 </ti> 158 </ti>
345</tr> 159</tr>
346</table> 160</table>
347 161
350<subsection> 164<subsection>
351<title>Gentoo's Universal Installation CD</title> 165<title>Gentoo's Universal Installation CD</title>
352<body> 166<body>
353 167
354<p> 168<p>
355The Universal Installation CD is called <c>install-ppc-universal-2005.0.iso</c> 169The Universal Installation CD is called <c>install-ppc-universal-2005.1.iso</c>
356and consumes the entire surface of a 650 MB CD. You can use this Installation 170and consumes the entire surface of a 650 MB CD. You can use this Installation
357CD to install Gentoo, and you can even use it to install Gentoo without a 171CD to install Gentoo, and you can even use it to install Gentoo without a
358working internet connection, just in case you want to bring Gentoo to another 172working internet connection, just in case you want to bring Gentoo to another
359PC than the one you are currently installing Gentoo on :) 173PC than the one you are currently installing Gentoo on :)
360</p> 174</p>
382<subsection> 196<subsection>
383<title>Other CDs</title> 197<title>Other CDs</title>
384<body> 198<body>
385 199
386<p> 200<p>
387You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is 201You might find a <e>Package CD</e> on one of our mirrors. This CD is not an
388no Installation CD but an additional resource that can be exploited during a 202Installation CD but an additional resource that can be exploited during a
389networkless installation. It contains prebuilt packages (the so-called GRP 203networkless installation. It contains prebuilt packages (also known as the GRP
390set) that allows you to easily and quickly install additional applications 204set) that allow you to easily and quickly install additional applications (such
391(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless 205as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo
392Gentoo installation. 206installation.
207</p>
208
209<p>
210If you intend to use the Packages CD to quickly install additional software,
211make sure that you use the same subarchitecture as the stage3 tarball you use.
212</p>
213
214</body>
215</subsection>
216<subsection>
217<title>The Stage3 Tarball</title>
218<body>
219
220<p>
221A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
222to continue the Gentoo installation using the instructions in this manual.
223Previously, the Gentoo Handbook described the installation using one of three
224stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
225official installation method uses the stage3 tarball. If you are interested in
226performing a Gentoo installation using a stage1 or stage2 tarball, please read
227the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
228Using a Stage1 or Stage2 Tarball?</uri>
393</p> 229</p>
394 230
395</body> 231</body>
396</subsection> 232</subsection>
397</section> 233</section>
409</p> 245</p>
410 246
411<p> 247<p>
412You can download any of the Installation CDs (and, if you want to, a Packages 248You can download any of the Installation CDs (and, if you want to, a Packages
413CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The 249CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
414Installation CDs are located in the <path>releases/ppc/2005.0/installcd</path> 250Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path>
415directory. 251directory.
416</p> 252</p>
417 253
418<p> 254<p>
419Inside that directory you'll find so-called ISO-files. Those are full CD images 255Inside that directory you'll find ISO-files. Those are full CD images which you
420which you can write on a CD-R. 256can write on a CD-R.
421</p> 257</p>
422 258
423<p> 259<p>
424In case you wonder if your downloaded file is corrupted or not, you can 260In case you wonder if your downloaded file is corrupted or not, you can
425check its MD5 checksum and compare it with the MD5 checksum we provide (such as 261check its MD5 checksum and compare it with the MD5 checksum we provide (such as
426<path>install-ppc-minimal-2005.0.iso.md5</path>). You can check the MD5 checksum 262<path>install-ppc-minimal-2005.1.iso.md5</path>). You can check the MD5 checksum
427with the <c>md5sum</c> tool under Linux/Unix or <uri 263with the <c>md5sum</c> tool under Linux/Unix or
428link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. How 264<uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If
429to verify MD5 checksums with Mac OS X is described in the <uri 265<c>md5sum</c> is not available on Mac OS X, see the
430link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri>. 266<uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help.
431</p> 267</p>
432 268
433<p> 269<p>
434Another way to check the validity of the downloaded file is to use GnuPG to 270Another way to check the validity of the downloaded file is to use GnuPG to
435verify the cryptographic signature that we provide (the file ending with 271verify the cryptographic signature that we provide (the file ending with
567If you have an OldWorld Mac the bootable portion of the livecd can't be used. 403If you have an OldWorld Mac the bootable portion of the livecd can't be used.
568The most simple solution is to use MacOS to bootstrap into a Linux environment 404The most simple solution is to use MacOS to bootstrap into a Linux environment
569with a tool called BootX. Boot floppies are being prepared for Macs without 405with a tool called BootX. Boot floppies are being prepared for Macs without
570MacOS, but they are not available at this time. 406MacOS, but they are not available at this time.
571</p> 407</p>
408
572<p> 409<p>
573First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri> 410First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
574and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked 411and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
575archive into <c>Extensions Folder</c> and the BootX App Control Panel into 412archive into <c>Extensions Folder</c> and the BootX App Control Panel into
576<c>Control Panels</c>, both of which are located in your MacOS System Folder. 413<c>Control Panels</c>, both of which are located in your MacOS System Folder.
577Next, create a folder called "Linux Kernels" in your System folder and copy the 414Next, create a folder called "Linux Kernels" in your System folder and copy the
578<c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c> 415<c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c>
579from the Installation CD <path>boot</path> folder into the MacOS 416from the Installation CD <path>boot</path> folder into the MacOS
580<c>System Folder</c>. 417<c>System Folder</c>.
581</p> 418</p>
419
582<p> 420<p>
583To prepare BootX, start the BootX App Control Panel. First select the Options 421To prepare BootX, start the BootX App Control Panel. First select the Options
584dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from 422dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from
585your System Folder. Continue back to the initial screen and ensure that the 423your System Folder. Continue back to the initial screen and ensure that the
586ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as 424ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
588</p> 426</p>
589 427
590<pre caption="BootX kernel arguments"> 428<pre caption="BootX kernel arguments">
591cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev 429cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev
592</pre> 430</pre>
431
593<note> 432<note>
594The kernel parameters in the yaboot section above are also applicable here. 433The kernel parameters in the yaboot section above are also applicable here.
595</note> 434</note>
435
596<p> 436<p>
597Check once more to make sure the settings are correct and then save the 437Check once more to make sure the settings are correct and then save the
598configuration. This saves typing just in case it doesn't boot or something is 438configuration. This saves typing just in case it doesn't boot or something is
599missing. Press the Linux button at the top of the window to boot into the 439missing. Press the Linux button at the top of the window to boot into the
600LiveCD and continue with <uri link="#booted">And When You're Booted...</uri> 440Installation CD and continue with <uri link="#booted">And When
441You're Booted...</uri>
601</p> 442</p>
443
602</body> 444</body>
603</subsection> 445</subsection>
604 446
605<subsection id="booted"> 447<subsection id="booted">
606<title>And When You're Booted...</title> 448<title>And When You're Booted...</title>
755If you want to view the documentation on the CD you can immediately run 597If you want to view the documentation on the CD you can immediately run
756<c>links2</c> to read it: 598<c>links2</c> to read it:
757</p> 599</p>
758 600
759<pre caption="Viewing the on-CD documentation"> 601<pre caption="Viewing the on-CD documentation">
760# <i>links2 /mnt/cdrom/docs/html/index.html</i> 602# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
761</pre> 603</pre>
762 604
763<p> 605<p>
764However, it is preferred that you use the online Gentoo Handbook as it will be 606However, it is preferred that you use the online Gentoo Handbook as it will be
765more recent than the one provided on the CD. You can view it using <c>links2</c> 607more recent than the one provided on the CD. You can view it using <c>links2</c>

Legend:
Removed from v.1.42  
changed lines
  Added in v.1.50

  ViewVC Help
Powered by ViewVC 1.1.20