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

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

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

Revision 1.24 Revision 1.33
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-ppc64-medium.xml,v 1.24 2005/10/09 16:33:54 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.33 2007/05/07 18:11:41 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.7</version> 11<version>8.0</version>
12<date>2005-10-09</date> 12<date>2007-05-07</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>
61</body> 61</body>
62</subsection> 62</subsection>
63</section> 63</section>
64<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ --> 64<!-- Copy/paste from hb-install-x86-medium.xml, with s/x86/ppc64/ -->
65<!-- START --> 65<!-- START -->
66<section>
67<title>The Gentoo Installation Approaches</title>
68<subsection>
69<title>Introduction</title>
70<body>
71
72<p>
73Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
74A stage file is a tarball (compressed archive) that contains a minimal
75environment.
76</p>
77
78<ul>
79 <li>
80 A stage1 file contains nothing more than a compiler, Portage (Gentoo's
81 software management system) and a couple of packages on which the compiler
82 or Portage depends.
83 </li>
84 <li>
85 A stage2 file contains a so-called bootstrapped system, a minimal
86 environment from which one can start building all other necessary
87 applications that make a Gentoo environment complete.
88 </li>
89 <li>
90 A stage3 file contains a prebuilt minimal system which is almost fully
91 deployable. It only lacks a few applications where you, the Gentoo user,
92 needs to choose which one you want to install.
93 </li>
94</ul>
95
96<p>
97To help you decide what stage file you want to use, we have written down the
98major advantages and disadvantages of each stage file.
99</p>
100
101</body>
102</subsection>
103<subsection>
104<title>A Stage1 Approach</title>
105<body>
106
107<p>
108A <e>stage1</e> is used when you want to bootstrap and build the entire system
109from scratch.
110</p>
111
112<p>
113This approach builds core system packages that are vital to your system and is
114used by Gentoo developers to prepare the Gentoo release media. It is a great
115installation method for those who would like to learn more about the inner
116workings of bootstrapping, toolchains and the like.
117</p>
118
119<p>
120However, if you do not plan to tweak the bootstrapping instructions in the
121<path>bootstrap.sh</path> script written by the Gentoo developers, then a
122stage1 approach has no benefits for you.
123</p>
124
125<table>
126<tr>
127 <th>Stage1</th>
128 <th>Pros and Cons</th>
129</tr>
130<tr>
131 <th>+</th>
132 <ti>
133 Allows you to have total control over the installation routine, bootstrap
134 sequence, etc.
135 </ti>
136</tr>
137<tr>
138 <th>+</th>
139 <ti>Suitable for powerusers and developers who know what they are doing</ti>
140</tr>
141<tr>
142 <th>-</th>
143 <ti>
144 Takes a long time to finish the installation (it is the lengthiest approach)
145 </ti>
146</tr>
147<tr>
148 <th>-</th>
149 <ti>
150 If you don't intend to tweak the settings, it is a waste of time
151 </ti>
152</tr>
153<tr>
154 <th>-</th>
155 <ti>
156 Requires a working Internet connection during the installation
157 </ti>
158</tr>
159</table>
160
161</body>
162</subsection>
163<subsection>
164<title>A Stage2 Approach</title>
165<body>
166
167<p>
168A <e>stage2</e> is used for building the entire system from a bootstrapped
169"semi-compiled" state.
170</p>
171
172<p>
173When you perform a stage2 installation approach, you will build all system
174packages (core packages, including toolchain) using your specific <c>USE</c>,
175<c>CFLAGS</c> and <c>CXXFLAGS</c> settings. Any package build will therefore be
176optimized to your preference.
177</p>
178
179<p>
180However, this installation takes some time and if you do not intend to change
181the <c>CFLAGS</c> and <c>CXXFLAGS</c> settings that we have defined as a "good
182default", using this approach only makes sense if your <c>USE</c> variable is
183sufficiently different from the default <c>USE</c> we provide.
184</p>
185
186<table>
187<tr>
188 <th>Stage2</th>
189 <th>Pros and Cons</th>
190</tr>
191<tr>
192 <th>+</th>
193 <ti>You don't need to bootstrap</ti>
194</tr>
195<tr>
196 <th>+</th>
197 <ti>Faster than starting with stage1</ti>
198</tr>
199<tr>
200 <th>+</th>
201 <ti>You can still tweak your settings</ti>
202</tr>
203<tr>
204 <th>-</th>
205 <ti>It's still not the fastest way to install Gentoo</ti>
206</tr>
207<tr>
208 <th>-</th>
209 <ti>
210 Requires a working Internet connection during the installation
211 </ti>
212</tr>
213</table>
214
215</body>
216</subsection>
217<subsection>
218<title>A Stage3 Approach</title>
219<body>
220
221<p>
222A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
223built for you. You will only need to build a few packages (such as system
224logger, networking tools, ...) before you can boot into a base Gentoo
225installation.
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>
249 You can still tweak your system
250 </ti>
251</tr>
252</table>
253
254<p>
255You might be interested to know that, if you decide to use different
256optimization settings after having installed Gentoo, you will be able to
257recompile your entire system with the new optimization settings. The same goes
258for any <c>USE</c> flag changes: Portage is intelligent enough to know what
259packages need to be rebuild.
260</p>
261
262</body>
263</subsection>
264</section>
265
266<section> 66<section>
267<title>The Gentoo Installation CDs</title> 67<title>The Gentoo Installation CDs</title>
268<subsection> 68<subsection>
269<title>Introduction</title> 69<title>Introduction</title>
270<body> 70<body>
285</p> 85</p>
286 86
287<p> 87<p>
288If you wish to install Gentoo without a working Internet connection, please use 88If you wish to install Gentoo without a working Internet connection, please use
289the installation instructions described in the <uri 89the installation instructions described in the <uri
290link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. This is currently not 90link="2007.0/index.xml">Gentoo 2007.0 Handbooks</uri>.
291supported for the PPC64 architecture though.
292</p>
293
294<p> 91</p>
295For the PowerPC64 architecture, we only supply a <e>Minimal</e> Installation CD, 92
296a small, no-nonsense, bootable CD which sole purpose is to boot the system, 93<p>
297prepare the networking and continue with the Gentoo installation. 94The two Installation CDs that we currently provide are:
95</p>
96
97<ul>
98 <li>
99 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
100 CD which sole purpose is to boot the system, prepare the networking and
101 continue with the Gentoo installation.
102 </li>
103 <li>
104 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
105 abilities as the Minimal Installation CD. Additionally, it contains
106 several stage3 tarballs (optimized for the individual subarchitectures).
107 </li>
108</ul>
109
110<p>
111To help you decide which Installation CD you need, we have written down the
112major advantages and disadvantages of each Installation CD.
298</p> 113</p>
299 114
300</body> 115</body>
301</subsection> 116</subsection>
302<subsection> 117<subsection>
303<title>Gentoo's Minimal Installation CD</title> 118<title>Gentoo's Minimal Installation CD</title>
304<body> 119<body>
305 120
306<p> 121<p>
307The Minimal Installation CD is called 122The Minimal Installation CD is called
308<c>install-ppc64-g5-minimal-2005.1.iso</c> or
309<c>install-ppc64-ibm-minimal-2005.1.iso</c> and takes up only 350 MB of 123<c>install-ppc64-minimal-2007.0.iso</c> and takes up only 124 MB of
310diskspace. You can use this Installation CD to install Gentoo, but always with a 124diskspace. You can use this Installation CD to install Gentoo, but always with a
311working Internet connection only. 125working Internet connection only.
312</p> 126</p>
313 127
314<table> 128<table>
319<tr> 133<tr>
320 <th>+</th> 134 <th>+</th>
321 <ti>Smallest download</ti> 135 <ti>Smallest download</ti>
322</tr> 136</tr>
323<tr> 137<tr>
138 <th>-</th>
139 <ti>
140 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
141 therefore not suitable for networkless installation
142 </ti>
143</tr>
144</table>
145
146</body>
147</subsection>
148<subsection>
149<title>Gentoo's Universal Installation CD</title>
150<body>
151
152<p>
153The Universal Installation CD is called
154<c>install-ppc64-universal-2007.0.iso</c> and uses 460 MB. You can use
155this Installation CD to install Gentoo, and you can even use it to install
156Gentoo without a working internet connection, just in case you want to bring
157Gentoo to another PC than the one you are currently installing Gentoo on :)
158</p>
159
160<table>
161<tr>
162 <th>Universal Installation CD</th>
163 <th>Pros and Cons</th>
164</tr>
165<tr>
324 <th>+</th> 166 <th>+</th>
325 <ti> 167 <ti>
326 You can do a stage1, stage2 or stage3 by getting the stage tarball off the 168 Contains everything you need. You can even install without a network
327 net 169 connection.
328 </ti> 170 </ti>
329</tr> 171</tr>
330<tr> 172<tr>
331 <th>-</th> 173 <th>-</th>
332 <ti> 174 <ti>Huge download</ti>
333 Contains no stages, no Portage snapshot, no prebuilt packages and is
334 therefore not suitable for networkless installation
335 </ti>
336</tr> 175</tr>
337</table> 176</table>
177
178</body>
179</subsection>
180<subsection>
181<title>The Stage3 Tarball</title>
182<body>
183
184<p>
185A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
186to continue the Gentoo installation using the instructions in this manual.
187Previously, the Gentoo Handbook described the installation using one of three
188stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
189official installation method uses the stage3 tarball. If you are interested in
190performing a Gentoo installation using a stage1 or stage2 tarball, please read
191the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
192Using a Stage1 or Stage2 Tarball?</uri>
193</p>
194
195</body>
196</subsection>
197<subsection>
198<title>Choosing a userland</title>
199<body>
200
201<p>
202On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit. The
203userland is basically the applications you are running, such as
204<c>bash</c> or <c>mozilla-firefox</c>. They can be compiled and run in either
20564-bit or 32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit
206userlands, so which one should you use?
207</p>
208
209<p>
210You may have heard that 64-bit applications are better, but in fact, 32-bit
211applications take up slightly less memory and often run a little bit faster than
21264-bit applications.
213</p>
214
215<p>
216You really only need 64-bit applications when you need more memory than a 32-bit
217userland allows, or if you do a lot of 64-bit number crunching. If you run
218applications that require more than 4GB of memory or you run scientific
219applications, you should choose the 64-bit userland. Otherwise, choose the
22032-bit userland, as it is recommended by the Gentoo/PPC64 developers.
221</p>
222
223<p>
224Additionally, the 32-bit userland has been available in Portage longer than the
22564-bit userland has. This means that there are more applications tested in the
22632-bit userland that just work "out of the box." Many applications compiled for
227the 64-bit userland may be just as stable as the 32-bit version, but they
228haven't been tested yet. Though testing isn't difficult to do, it can be
229annoying and time consuming if you want to use many untested 64-bit
230applications. Also, some programs just won't run in the 64-bit userland until
231their code is fixed, such as OpenOffice.
232</p>
233
234<p>
235The Gentoo/PPC64 team provides stages and Package CDs for both 32-bit and 64-bit
236userlands, so no matter which one you choose, you'll be able to successfully
237install Gentoo and get a full system up and running with minimal fuss.
238</p>
338 239
339</body> 240</body>
340</subsection> 241</subsection>
341</section> 242</section>
342<!-- STOP --> 243<!-- STOP -->
351downloading and burning the chosen Installation CD. We previously discussed the 252downloading and burning the chosen Installation CD. We previously discussed the
352several available Installation CDs, but where can you find them? 253several available Installation CDs, but where can you find them?
353</p> 254</p>
354 255
355<p> 256<p>
356You can download any of the Installation CDs (and, if you want to, a Packages 257You can download any of the Installation CDs (and, if you want to, a Packages CD
357CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The 258as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
358Installation CDs are located in the <path>releases/ppc64/2005.1/installcd</path> 259Installation CDs are located in the <path><keyval
359directory. 260id="release-dir"/>installcd</path> directory.
360</p>
361
362<p> 261</p>
262
263<p>
363Inside that directory you'll find so-called ISO-files. Those are full CD images 264Inside that directory you'll find ISO-files. Those are full CD images
364which you can write on a CD-R. 265which you can write on a CD-R.
365</p> 266</p>
366 267
367<p> 268<p>
368In case you wonder if your downloaded file is corrupted or not, you can 269In case you wonder if your downloaded file is corrupted or not, you can
369check its MD5 checksum and compare it with the MD5 checksum we provide (such as 270check its MD5 checksum and compare it with the MD5 checksum we provide (such as
370<path>install-ppc64-g5-minimal-2005.1.iso.md5</path>). You can check the MD5 271<path>install-ppc64-minimal-2007.0.iso.DIGESTS</path>). You can check the MD5
371checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 272checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
372link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 273link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
373</p> 274</p>
374 275
375<p> 276<p>
377verify the cryptographic signature that we provide (the file ending with 278verify the cryptographic signature that we provide (the file ending with
378<path>.asc</path>). Download the signature file and obtain the public key: 279<path>.asc</path>). Download the signature file and obtain the public key:
379</p> 280</p>
380 281
381<pre caption="Obtaining the public key"> 282<pre caption="Obtaining the public key">
382$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> 283$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
383</pre> 284</pre>
384 285
385<p> 286<p>
386Now verify the signature: 287Now verify the signature:
387</p> 288</p>
445</tr> 346</tr>
446<tr> 347<tr>
447 <ti><c>video</c></ti> 348 <ti><c>video</c></ti>
448 <ti> 349 <ti>
449 This option takes one of the following vendor-specific tags: 350 This option takes one of the following vendor-specific tags:
450 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or 351 <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</c>
451 <c>ofonly</c>. You can follow this tag with the resolution and refreshrate 352 or <c>ofonly</c>. You can follow this tag with the resolution and
452 you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are 353 refreshrate you want to use. For instance
354 <c>video=radeonfb:1280x1024@75</c>. If you are uncertain what to choose,
453 uncertain what to choose, <c>ofonly</c> will most certainly work. 355 <c>ofonly</c> will most certainly work.
454 </ti> 356 </ti>
455</tr> 357</tr>
456<tr> 358<tr>
457 <ti><c>nol3</c></ti> 359 <ti><c>nol3</c></ti>
458 <ti> 360 <ti>
459 Disables level 3 cache on some powerbooks (needed for at least the 17'') 361 Disables level 3 cache on some powerbooks (needed for at least the 17")
460 </ti> 362 </ti>
461</tr> 363</tr>
462<tr> 364<tr>
463 <ti><c>debug</c></ti> 365 <ti><c>debug</c></ti>
464 <ti> 366 <ti>
492<subsection> 394<subsection>
493<title>IBM pSeries</title> 395<title>IBM pSeries</title>
494<body> 396<body>
495 397
496<p> 398<p>
497For pSeries boxes, sometimes the cds might not autoboot. You might have 399The CD should autoboot on your pSeries box, but sometimes it does not. In that
498to set up your cdrom as a bootable device in the multi-boot menu. (F1 at 400case, you have to set up your cdrom as a bootable device in the multi-boot
499startup) The other option is to jump into OF and do it from there: 401menu. If you start your machine with a monitor and a keyboard attached, you can
500</p> 402reach the multi-boot menu pressing the F1 key on startup. But if you start your
501 403machine using the serial console, then you have to press <c>1</c>. Press the
404key when you see the beginning of the following line on the serial console:
502<p> 405</p>
5031) Boot into OF (this is 8 from the serial cons or F8 from a graphics 406
504cons, start hitting the key when you see the keyboard mouse etc etc 407<pre caption="Hit the '1' key when this line appears">
505messages 408memory keyboard network scsi speaker
409</pre>
410
506</p> 411<p>
412The other option is to jump into OpenFirmware and do it from there:
507<p> 413</p>
414
415<ol>
416 <li>
417 Boot into OpenFirmware: same procedure as getting into multi-boot
418 (described a few lines above), but use F8 and 8 instead of F1 and 1.
419 </li>
5082) run the command 0> boot cdrom:1,yaboot 420 <li>Run the command 0> boot cdrom:1,yaboot</li>
421 <li>Stand back and enjoy!</li>
422</ol>
423
424<note>
425If you get something like the following output, then OpenFirmware isn't set up
426correctly. Please use the multi-boot option described above.
427</note>
428
429<pre caption="Output if OpenFirmware is not set up correctly">
4300 > boot cdrom:1,yaboot
431 ok
4320 >
509</p> 433</pre>
510<p>
5113) stand back and enjoy!
512</p>
513 434
514</body> 435</body>
515</subsection> 436</subsection>
516<subsection id="booted"> 437<subsection id="booted">
517<title>And When You're Booted...</title> 438<title>And When You're Booted...</title>
554<title>Extra Hardware Configuration</title> 475<title>Extra Hardware Configuration</title>
555<body> 476<body>
556 477
557<p> 478<p>
558When the Installation CD boots, it tries to detect all your hardware devices and 479When the Installation CD boots, it tries to detect all your hardware devices and
559loads the appropriate kernel modules to support your hardware. In the 480loads the appropriate kernel modules to support your hardware. In the vast
560vast majority of cases, it does a very good job. However, in some cases it may 481majority of cases, it does a very good job. However, in some cases it may not
561not auto-load the kernel
562modules you need. If the PCI auto-detection missed some of your system's 482auto-load the kernel modules you need. If the PCI auto-detection missed some of
563hardware, you will have to load the appropriate kernel modules manually. 483your system's hardware, you will have to load the appropriate kernel modules
484manually.
564</p> 485</p>
565 486
566<p> 487<p>
567In the next example we try to load the <c>8139too</c> module (support for 488In the next example we try to load the <c>8139too</c> module (support for
568certain kinds of network interfaces): 489certain kinds of network interfaces):
594yourself) which use <path>/dev/hda</path> as disk (substitute with your 515yourself) which use <path>/dev/hda</path> as disk (substitute with your
595disk): 516disk):
596</p> 517</p>
597 518
598<pre caption="Tweaking hard disk performance"> 519<pre caption="Tweaking hard disk performance">
599<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i> 520<comment>Activate DMA:</comment>
600<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i> 521# <i>hdparm -d 1 /dev/hda</i>
522<comment>Activate DMA + Safe Performance-enhancing Options:</comment>
523# <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
601</pre> 524</pre>
602 525
603</body> 526</body>
604</subsection> 527</subsection>
605<subsection id="useraccounts"> 528<subsection id="useraccounts">
657Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in. 580Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
658</p> 581</p>
659 582
660<p> 583<p>
661If you want to view the documentation on the CD you can immediately run 584If you want to view the documentation on the CD you can immediately run
662<c>links2</c> to read it: 585<c>links</c> to read it:
663</p> 586</p>
664 587
665<pre caption="Viewing the on-CD documentation"> 588<pre caption="Viewing the on-CD documentation">
666# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i> 589# <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
667</pre> 590</pre>
668 591
669<p> 592<p>
670However, it is preferred that you use the online Gentoo Handbook as it will be 593However, it is preferred that you use the online Gentoo Handbook as it will be
671more recent than the one provided on the CD. 594more recent than the one provided on the CD.
672</p> 595</p>
673 596
674<pre caption="Viewing the Online Documentation"> 597<pre caption="Viewing the Online Documentation">
675# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i> 598# <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
676</pre> 599</pre>
677 600
678<p> 601<p>
679You can go back to your original terminal by pressing <c>Alt-F1</c>. 602You can go back to your original terminal by pressing <c>Alt-F1</c>.
680</p> 603</p>

Legend:
Removed from v.1.24  
changed lines
  Added in v.1.33

  ViewVC Help
Powered by ViewVC 1.1.20