/[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.31
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.31 2006/04/18 05:34:59 fox2mike Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.7</version> 11<version>2.12</version>
12<date>2005-10-09</date> 12<date>2006-04-18</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="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>. This is currently not
291supported for the PPC64 architecture though. 91supported for the PPC64 architecture though.
292</p> 92</p>
293 93
294<p> 94<p>
295For the PowerPC64 architecture, we only supply a <e>Minimal</e> Installation CD, 95The two Installation CDs that we currently provide are:
296a small, no-nonsense, bootable CD which sole purpose is to boot the system, 96</p>
297prepare the networking and continue with the Gentoo installation. 97
98<ul>
99 <li>
100 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
101 CD which sole purpose is to boot the system, prepare the networking and
102 continue with the Gentoo installation.
103 </li>
104 <li>
105 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
106 abilities as the Minimal Installation CD. Additionally, it contains
107 several stage3 tarballs (optimized for the individual subarchitectures).
108 </li>
109</ul>
110
111<p>
112To help you decide which Installation CD you need, we have written down the
113major advantages and disadvantages of each Installation CD.
298</p> 114</p>
299 115
300</body> 116</body>
301</subsection> 117</subsection>
302<subsection> 118<subsection>
303<title>Gentoo's Minimal Installation CD</title> 119<title>Gentoo's Minimal Installation CD</title>
304<body> 120<body>
305 121
306<p> 122<p>
307The Minimal Installation CD is called 123The 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 124<c>install-ppc64-minimal-2006.0.iso</c> and takes up only 124 MB of
310diskspace. You can use this Installation CD to install Gentoo, but always with a 125diskspace. You can use this Installation CD to install Gentoo, but always with a
311working Internet connection only. 126working Internet connection only.
312</p> 127</p>
313 128
314<table> 129<table>
319<tr> 134<tr>
320 <th>+</th> 135 <th>+</th>
321 <ti>Smallest download</ti> 136 <ti>Smallest download</ti>
322</tr> 137</tr>
323<tr> 138<tr>
139 <th>-</th>
140 <ti>
141 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
142 therefore not suitable for networkless installation
143 </ti>
144</tr>
145</table>
146
147</body>
148</subsection>
149<subsection>
150<title>Gentoo's Universal Installation CD</title>
151<body>
152
153<p>
154The Universal Installation CD is called
155<c>install-ppc64-universal-2006.0-32ul.iso</c> and uses 460 MB. You can use
156this Installation CD to install Gentoo, and you can even use it to install
157Gentoo without a working internet connection, just in case you want to bring
158Gentoo to another PC than the one you are currently installing Gentoo on :)
159</p>
160
161<table>
162<tr>
163 <th>Universal Installation CD</th>
164 <th>Pros and Cons</th>
165</tr>
166<tr>
324 <th>+</th> 167 <th>+</th>
325 <ti> 168 <ti>
326 You can do a stage1, stage2 or stage3 by getting the stage tarball off the 169 Contains everything you need. You can even install without a network
327 net 170 connection.
328 </ti> 171 </ti>
329</tr> 172</tr>
330<tr> 173<tr>
331 <th>-</th> 174 <th>-</th>
332 <ti> 175 <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> 176</tr>
337</table> 177</table>
178
179</body>
180</subsection>
181<subsection>
182<title>The Stage3 Tarball</title>
183<body>
184
185<p>
186A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
187to continue the Gentoo installation using the instructions in this manual.
188Previously, the Gentoo Handbook described the installation using one of three
189stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
190official installation method uses the stage3 tarball. If you are interested in
191performing a Gentoo installation using a stage1 or stage2 tarball, please read
192the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
193Using a Stage1 or Stage2 Tarball?</uri>
194</p>
338 195
339</body> 196</body>
340</subsection> 197</subsection>
341</section> 198</section>
342<!-- STOP --> 199<!-- STOP -->
351downloading and burning the chosen Installation CD. We previously discussed the 208downloading and burning the chosen Installation CD. We previously discussed the
352several available Installation CDs, but where can you find them? 209several available Installation CDs, but where can you find them?
353</p> 210</p>
354 211
355<p> 212<p>
356You can download any of the Installation CDs (and, if you want to, a Packages 213You can download any of the Installation CDs (and, if you want to, a Packages
357CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The 214CD as 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> 215Installation CDs are located in the
359directory. 216<path>releases/ppc/2006.0/ppc64/installcd</path> directory.
360</p>
361
362<p> 217</p>
218
219<p>
363Inside that directory you'll find so-called ISO-files. Those are full CD images 220Inside that directory you'll find ISO-files. Those are full CD images
364which you can write on a CD-R. 221which you can write on a CD-R.
365</p> 222</p>
366 223
367<p> 224<p>
368In case you wonder if your downloaded file is corrupted or not, you can 225In 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 226check 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 227<path>install-ppc64-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5
371checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 228checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
372link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 229link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
373</p> 230</p>
374 231
375<p> 232<p>
377verify the cryptographic signature that we provide (the file ending with 234verify the cryptographic signature that we provide (the file ending with
378<path>.asc</path>). Download the signature file and obtain the public key: 235<path>.asc</path>). Download the signature file and obtain the public key:
379</p> 236</p>
380 237
381<pre caption="Obtaining the public key"> 238<pre caption="Obtaining the public key">
382$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> 239$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
383</pre> 240</pre>
384 241
385<p> 242<p>
386Now verify the signature: 243Now verify the signature:
387</p> 244</p>
492<subsection> 349<subsection>
493<title>IBM pSeries</title> 350<title>IBM pSeries</title>
494<body> 351<body>
495 352
496<p> 353<p>
497For pSeries boxes, sometimes the cds might not autoboot. You might have 354The 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 355case, 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: 356menu. If you start your machine with a monitor and a keyboard attached, you can
500</p> 357reach the multi-boot menu pressing the F1 key on startup. But if you start your
501 358machine using the serial console, then you have to press <c>1</c>. Press the
359key when you see the beginning of the following line on the serial console:
502<p> 360</p>
5031) Boot into OF (this is 8 from the serial cons or F8 from a graphics 361
504cons, start hitting the key when you see the keyboard mouse etc etc 362<pre caption="Hit the '1' key when this line appears">
505messages 363memory keyboard network scsi speaker
364</pre>
365
506</p> 366<p>
367The other option is to jump into OpenFirmware and do it from there:
507<p> 368</p>
369
370<ol>
371 <li>
372 Boot into OpenFirmware: same procedure as getting into multi-boot
373 (described a few lines above), but use F8 and 8 instead of F1 and 1.
374 </li>
5082) run the command 0> boot cdrom:1,yaboot 375 <li>Run the command 0> boot cdrom:1,yaboot</li>
376 <li>Stand back and enjoy!</li>
377</ol>
378
379<note>
380If you get something like the following output, then OpenFirmware isn't set up
381correctly. Please use the multi-boot option described above.
382</note>
383
384<pre caption="Output if OpenFirmware is not set up correctly">
3850 > boot cdrom:1,yaboot
386 ok
3870 >
509</p> 388</pre>
510<p>
5113) stand back and enjoy!
512</p>
513 389
514</body> 390</body>
515</subsection> 391</subsection>
516<subsection id="booted"> 392<subsection id="booted">
517<title>And When You're Booted...</title> 393<title>And When You're Booted...</title>
657Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in. 533Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
658</p> 534</p>
659 535
660<p> 536<p>
661If you want to view the documentation on the CD you can immediately run 537If you want to view the documentation on the CD you can immediately run
662<c>links2</c> to read it: 538<c>links</c> to read it:
663</p> 539</p>
664 540
665<pre caption="Viewing the on-CD documentation"> 541<pre caption="Viewing the on-CD documentation">
666# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i> 542# <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
667</pre> 543</pre>
668 544
669<p> 545<p>
670However, it is preferred that you use the online Gentoo Handbook as it will be 546However, it is preferred that you use the online Gentoo Handbook as it will be
671more recent than the one provided on the CD. 547more recent than the one provided on the CD.
672</p> 548</p>
673 549
674<pre caption="Viewing the Online Documentation"> 550<pre caption="Viewing the Online Documentation">
675# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i> 551# <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
676</pre> 552</pre>
677 553
678<p> 554<p>
679You can go back to your original terminal by pressing <c>Alt-F1</c>. 555You can go back to your original terminal by pressing <c>Alt-F1</c>.
680</p> 556</p>

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

  ViewVC Help
Powered by ViewVC 1.1.20