/[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.48
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.48 2005/10/09 16:33:54 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.1</version> 11<version>2.6</version>
12<date>2005-04-10</date> 12<date>2005-10-09</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>
111A <e>stage1</e> is used when you want to bootstrap and build the entire system 125A <e>stage1</e> is used when you want to bootstrap and build the entire system
112from scratch. 126from scratch.
113</p> 127</p>
114 128
115<p> 129<p>
116Starting from a stage1 allows you to have total control over the 130This approach builds core system packages that are vital to your system and is
117optimization settings and optional build-time functionality that is 131used by Gentoo developers to prepare the Gentoo release media. It is a great
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 132installation method for those who would like to learn more about the inner
121inner workings of Gentoo Linux. 133workings of bootstrapping, toolchains and the like.
134</p>
135
136<p>
137However, if you do not plan to tweak the bootstrapping instructions in the
138<path>bootstrap.sh</path> script written by the Gentoo developers, then a
139stage1 approach has no benefits for you.
122</p> 140</p>
123 141
124<table> 142<table>
125<tr> 143<tr>
126 <th>Stage1</th> 144 <th>Stage1</th>
127 <th>Pros and Cons</th> 145 <th>Pros and Cons</th>
128</tr> 146</tr>
129<tr> 147<tr>
130 <th>+</th> 148 <th>+</th>
131 <ti> 149 <ti>
132 Allows you to have total control over the optimization settings and optional 150 Allows you to have total control over the installation routine, bootstrap
133 build-time functionality that is initially enabled on your system 151 sequence, etc.
134 </ti> 152 </ti>
135</tr>
136<tr> 153</tr>
137 <th>+</th>
138 <ti>Suitable for powerusers that know what they are doing</ti>
139</tr> 154<tr>
140<tr>
141 <th>+</th> 155 <th>+</th>
142 <ti>Allows you to learn more about the inner workings of Gentoo</ti> 156 <ti>Suitable for powerusers and developers who know what they are doing</ti>
143</tr> 157</tr>
144<tr> 158<tr>
145 <th>-</th> 159 <th>-</th>
146 <ti>Takes a long time to finish the installation</ti> 160 <ti>
161 Takes a long time to finish the installation (it is the lengthiest approach)
162 </ti>
147</tr> 163</tr>
148<tr> 164<tr>
149 <th>-</th> 165 <th>-</th>
150 <ti> 166 <ti>
151 If you don't intend to tweak the settings, it is a waste of time 167 If you don't intend to tweak the settings, it is a waste of time
169A <e>stage2</e> is used for building the entire system from a bootstrapped 185A <e>stage2</e> is used for building the entire system from a bootstrapped
170"semi-compiled" state. 186"semi-compiled" state.
171</p> 187</p>
172 188
173<p> 189<p>
174Stage2 installs allow you to skip the bootstrap process; doing this 190When you perform a stage2 installation approach, you will build all system
175is fine if you are happy with the optimization settings that we chose 191packages (core packages, including toolchain) using your specific <c>USE</c>,
176for your particular stage2 tarball. 192<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
193optimized to your preference.
194</p>
195
196<p>
197However, this installation takes some time and if you do not intend to change
198the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
199default", using this approach only makes sense if your <c>USE</c> variable is
200sufficiently different from the default <c>USE</c> we provide.
177</p> 201</p>
178 202
179<table> 203<table>
180<tr> 204<tr>
181 <th>Stage2</th> 205 <th>Stage2</th>
193 <th>+</th> 217 <th>+</th>
194 <ti>You can still tweak your settings</ti> 218 <ti>You can still tweak your settings</ti>
195</tr> 219</tr>
196<tr> 220<tr>
197 <th>-</th> 221 <th>-</th>
198 <ti>You cannot tweak as much as with a stage1</ti> 222 <ti>It's still not the fastest way to install Gentoo</ti>
199</tr> 223</tr>
200<tr> 224<tr>
201 <th>-</th> 225 <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> 226 <ti>
211 Requires a working Internet connection during the installation 227 Requires a working Internet connection during the installation
212 </ti> 228 </ti>
213</tr> 229</tr>
214</table> 230</table>
219<title>A Stage3 Approach</title> 235<title>A Stage3 Approach</title>
220<body> 236<body>
221 237
222<p> 238<p>
223A <e>stage3</e> installation contains a basic Gentoo Linux system that has been 239A <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 240built for you. You will only need to build a few packages (such as system
225decide for you which one to choose. 241logger, networking tools, ...) before you can boot into a base Gentoo
242installation.
226</p> 243</p>
227 244
228<p> 245<p>
229Choosing to go with a stage3 allows for the fastest install of Gentoo 246Choosing to go with a stage3 allows for the fastest install of Gentoo
230Linux, but also means that your base system will have the optimization 247Linux, but also means that your base system will have the optimization
242<tr> 259<tr>
243 <th>+</th> 260 <th>+</th>
244 <ti>Fastest way to get a Gentoo base system</ti> 261 <ti>Fastest way to get a Gentoo base system</ti>
245</tr> 262</tr>
246<tr> 263<tr>
247 <th>-</th> 264 <th>+</th>
248 <ti>You cannot tweak the base system - it's built already</ti> 265 <ti>
266 You can still tweak your system
267 </ti>
249</tr> 268</tr>
250</table> 269</table>
251 270
252<p> 271<p>
253You might be interested to know that, if you decide to use different 272You might be interested to know that, if you decide to use different
254optimization settings after having installed Gentoo, you will be able to 273optimization settings after having installed Gentoo, you will be able to
255recompile your entire system with the new optimization settings. 274recompile your entire system with the new optimization settings. The same goes
275for any <c>USE</c> flag changes: Portage is intelligent enough to know what
276packages need to be rebuild.
256</p> 277</p>
257 278
258</body> 279</body>
259</subsection> 280</subsection>
260</section> 281</section>
282
261<section> 283<section>
262<title>The Gentoo Installation CDs</title> 284<title>The Gentoo Installation CDs</title>
263<subsection> 285<subsection>
264<title>Introduction</title> 286<title>Introduction</title>
265<body> 287<body>
280</p> 302</p>
281 303
282<p> 304<p>
283If you wish to install Gentoo without a working Internet connection, please use 305If you wish to install Gentoo without a working Internet connection, please use
284the installation instructions described in the <uri 306the installation instructions described in the <uri
285link="2005.0/index.xml">Gentoo 2005.0 Handbooks</uri>. 307link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>.
286</p> 308</p>
287 309
288<p> 310<p>
289The two Installation CDs that we currently provide are: 311The two Installation CDs that we currently provide are:
290</p> 312</p>
313<subsection> 335<subsection>
314<title>Gentoo's Minimal Installation CD</title> 336<title>Gentoo's Minimal Installation CD</title>
315<body> 337<body>
316 338
317<p> 339<p>
318The Minimal Installation CD is called <c>install-ppc-minimal-2005.0.iso</c> and 340The 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 341takes up only 52 MB of diskspace. You can use this Installation CD to install
320Gentoo, but always with a working Internet connection only. 342Gentoo, but always with a working Internet connection only.
321</p> 343</p>
322 344
323<table> 345<table>
350<subsection> 372<subsection>
351<title>Gentoo's Universal Installation CD</title> 373<title>Gentoo's Universal Installation CD</title>
352<body> 374<body>
353 375
354<p> 376<p>
355The Universal Installation CD is called <c>install-ppc-universal-2005.0.iso</c> 377The 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 378and 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 379CD 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 380working internet connection, just in case you want to bring Gentoo to another
359PC than the one you are currently installing Gentoo on :) 381PC than the one you are currently installing Gentoo on :)
360</p> 382</p>
390set) that allows you to easily and quickly install additional applications 412set) that allows you to easily and quickly install additional applications
391(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless 413(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless
392Gentoo installation. 414Gentoo installation.
393</p> 415</p>
394 416
417<p>
418If you intend to use the Packages CD to quickly install additional software,
419make sure that you use the same subarchitecture as the stage-3 tarball you use.
420</p>
421
395</body> 422</body>
396</subsection> 423</subsection>
397</section> 424</section>
398<!-- STOP --> 425<!-- STOP -->
399<section> 426<section>
409</p> 436</p>
410 437
411<p> 438<p>
412You can download any of the Installation CDs (and, if you want to, a Packages 439You 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 440CD 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> 441Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path>
415directory. 442directory.
416</p> 443</p>
417 444
418<p> 445<p>
419Inside that directory you'll find so-called ISO-files. Those are full CD images 446Inside that directory you'll find so-called ISO-files. Those are full CD images
421</p> 448</p>
422 449
423<p> 450<p>
424In case you wonder if your downloaded file is corrupted or not, you can 451In 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 452check 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 453<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 454with the <c>md5sum</c> tool under Linux/Unix or
428link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. How 455<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 456<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>. 457<uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help.
431</p> 458</p>
432 459
433<p> 460<p>
434Another way to check the validity of the downloaded file is to use GnuPG to 461Another 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 462verify 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. 594If 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 595The 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 596with a tool called BootX. Boot floppies are being prepared for Macs without
570MacOS, but they are not available at this time. 597MacOS, but they are not available at this time.
571</p> 598</p>
599
572<p> 600<p>
573First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri> 601First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
574and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked 602and 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 603archive 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. 604<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 605Next, 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> 606<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 607from the Installation CD <path>boot</path> folder into the MacOS
580<c>System Folder</c>. 608<c>System Folder</c>.
581</p> 609</p>
610
582<p> 611<p>
583To prepare BootX, start the BootX App Control Panel. First select the Options 612To 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 613dialog 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 614your 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 615ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
588</p> 617</p>
589 618
590<pre caption="BootX kernel arguments"> 619<pre caption="BootX kernel arguments">
591cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev 620cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev
592</pre> 621</pre>
622
593<note> 623<note>
594The kernel parameters in the yaboot section above are also applicable here. 624The kernel parameters in the yaboot section above are also applicable here.
595</note> 625</note>
626
596<p> 627<p>
597Check once more to make sure the settings are correct and then save the 628Check 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 629configuration. 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 630missing. 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> 631Installation CD and continue with <uri link="#booted">And When
632You're Booted...</uri>
601</p> 633</p>
634
602</body> 635</body>
603</subsection> 636</subsection>
604 637
605<subsection id="booted"> 638<subsection id="booted">
606<title>And When You're Booted...</title> 639<title>And When You're Booted...</title>
755If you want to view the documentation on the CD you can immediately run 788If you want to view the documentation on the CD you can immediately run
756<c>links2</c> to read it: 789<c>links2</c> to read it:
757</p> 790</p>
758 791
759<pre caption="Viewing the on-CD documentation"> 792<pre caption="Viewing the on-CD documentation">
760# <i>links2 /mnt/cdrom/docs/html/index.html</i> 793# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
761</pre> 794</pre>
762 795
763<p> 796<p>
764However, it is preferred that you use the online Gentoo Handbook as it will be 797However, 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> 798more 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.48

  ViewVC Help
Powered by ViewVC 1.1.20