/[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.15 Revision 1.24
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/1.0 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.15 2005/02/14 15:51:45 swift Exp $ --> 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 $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.10</version> 11<version>2.7</version>
12<date>2005-01-04</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>
34 <ti>Any PowerPC64 CPU</ti> 34 <ti>Any PowerPC64 CPU</ti>
35</tr> 35</tr>
36<tr> 36<tr>
37 <th>Systems</th> 37 <th>Systems</th>
38 <ti> 38 <ti>
39 IBM RS/6000s, Power Macintosh G5, IBP pSeries and IBM iSeries 39 IBM RS/6000s, Power Macintosh G5, IBM pSeries and IBM iSeries
40 </ti> 40 </ti>
41</tr> 41</tr>
42<tr> 42<tr>
43 <th>Memory</th> 43 <th>Memory</th>
44 <ti>64 MB</ti> 44 <ti>64 MB</ti>
108A <e>stage1</e> is used when you want to bootstrap and build the entire system 108A <e>stage1</e> is used when you want to bootstrap and build the entire system
109from scratch. 109from scratch.
110</p> 110</p>
111 111
112<p> 112<p>
113Starting from a stage1 allows you to have total control over the 113This approach builds core system packages that are vital to your system and is
114optimization settings and optional build-time functionality that is 114used by Gentoo developers to prepare the Gentoo release media. It is a great
115initially enabled on your system. This makes <e>stage1</e> installs good for
116power users who know what they are doing. It is also a great
117installation method for those who would like to know more about the 115installation method for those who would like to learn more about the inner
118inner workings of Gentoo Linux. 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.
119</p> 123</p>
120 124
121<table> 125<table>
122<tr> 126<tr>
123 <th>Stage1</th> 127 <th>Stage1</th>
124 <th>Pros and Cons</th> 128 <th>Pros and Cons</th>
125</tr> 129</tr>
126<tr> 130<tr>
127 <th>+</th> 131 <th>+</th>
128 <ti> 132 <ti>
129 Allows you to have total control over the optimization settings and optional 133 Allows you to have total control over the installation routine, bootstrap
130 build-time functionality that is initially enabled on your system 134 sequence, etc.
131 </ti> 135 </ti>
132</tr>
133<tr> 136</tr>
134 <th>+</th>
135 <ti>Suitable for powerusers that know what they are doing</ti>
136</tr> 137<tr>
137<tr>
138 <th>+</th> 138 <th>+</th>
139 <ti>Allows you to learn more about the inner workings of Gentoo</ti> 139 <ti>Suitable for powerusers and developers who know what they are doing</ti>
140</tr> 140</tr>
141<tr> 141<tr>
142 <th>-</th> 142 <th>-</th>
143 <ti>Takes a long time to finish the installation</ti> 143 <ti>
144 Takes a long time to finish the installation (it is the lengthiest approach)
145 </ti>
144</tr> 146</tr>
145<tr> 147<tr>
146 <th>-</th> 148 <th>-</th>
147 <ti> 149 <ti>
148 If you don't intend to tweak the settings, it is a waste of time 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
149 </ti> 157 </ti>
150</tr> 158</tr>
151</table> 159</table>
152 160
153</body> 161</body>
160A <e>stage2</e> is used for building the entire system from a bootstrapped 168A <e>stage2</e> is used for building the entire system from a bootstrapped
161"semi-compiled" state. 169"semi-compiled" state.
162</p> 170</p>
163 171
164<p> 172<p>
165Stage2 installs allow you to skip the bootstrap process; doing this 173When you perform a stage2 installation approach, you will build all system
166is fine if you are happy with the optimization settings that we chose 174packages (core packages, including toolchain) using your specific <c>USE</c>,
167for your particular stage2 tarball. 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.
168</p> 184</p>
169 185
170<table> 186<table>
171<tr> 187<tr>
172 <th>Stage2</th> 188 <th>Stage2</th>
184 <th>+</th> 200 <th>+</th>
185 <ti>You can still tweak your settings</ti> 201 <ti>You can still tweak your settings</ti>
186</tr> 202</tr>
187<tr> 203<tr>
188 <th>-</th> 204 <th>-</th>
189 <ti>You cannot tweak as much as with a stage1</ti> 205 <ti>It's still not the fastest way to install Gentoo</ti>
190</tr> 206</tr>
191<tr> 207<tr>
192 <th>-</th> 208 <th>-</th>
193 <ti>It's still not the fastest way to install Gentoo</ti> 209 <ti>
194</tr> 210 Requires a working Internet connection during the installation
195<tr> 211 </ti>
196 <th>-</th>
197 <ti>You have to accept the optimizations we chose for the bootstrap</ti>
198</tr> 212</tr>
199</table> 213</table>
200 214
201</body> 215</body>
202</subsection> 216</subsection>
204<title>A Stage3 Approach</title> 218<title>A Stage3 Approach</title>
205<body> 219<body>
206 220
207<p> 221<p>
208A <e>stage3</e> installation contains a basic Gentoo Linux system that has been 222A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
209built for you. You will only need to build a few packages of which we can't 223built for you. You will only need to build a few packages (such as system
210decide for you which one to choose. 224logger, networking tools, ...) before you can boot into a base Gentoo
225installation.
211</p> 226</p>
212 227
213<p> 228<p>
214Choosing to go with a stage3 allows for the fastest install of Gentoo 229Choosing to go with a stage3 allows for the fastest install of Gentoo
215Linux, but also means that your base system will have the optimization 230Linux, but also means that your base system will have the optimization
227<tr> 242<tr>
228 <th>+</th> 243 <th>+</th>
229 <ti>Fastest way to get a Gentoo base system</ti> 244 <ti>Fastest way to get a Gentoo base system</ti>
230</tr> 245</tr>
231<tr> 246<tr>
232 <th>-</th> 247 <th>+</th>
233 <ti>You cannot tweak the base system - it's built already</ti> 248 <ti>
249 You can still tweak your system
250 </ti>
234</tr> 251</tr>
235</table> 252</table>
236 253
237<p> 254<p>
238You might be interested to know that, if you decide to use different 255You might be interested to know that, if you decide to use different
239optimization settings after having installed Gentoo, you will be able to 256optimization settings after having installed Gentoo, you will be able to
240recompile your entire system with the new optimization settings. 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.
241</p> 260</p>
242 261
243</body> 262</body>
244</subsection> 263</subsection>
245</section> 264</section>
265
246<section> 266<section>
247<title>The Gentoo LiveCDs</title> 267<title>The Gentoo Installation CDs</title>
248<subsection> 268<subsection>
249<title>Introduction</title> 269<title>Introduction</title>
250<body> 270<body>
251 271
252<p> 272<p>
253The <e>Gentoo LiveCDs</e> are bootable CDs which contain a 273The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
254self-sustained Gentoo environment. They allow you to boot Linux from the CD. 274self-sustained Gentoo environment. They allow you to boot Linux from the CD.
255During the boot process your hardware is detected and the appropriate drivers 275During the boot process your hardware is detected and the appropriate drivers
256are loaded. They are maintained by Gentoo developers. 276are loaded. They are maintained by Gentoo developers.
257</p> 277</p>
258 278
259<p> 279<p>
260All LiveCDs allow you to boot, set up networking, initialize your 280All Installation CDs allow you to boot, set up networking, initialize your
261partitions and start installing Gentoo from the Internet. We currently provide 281partitions and start installing Gentoo from the Internet. We currently provide
262two LiveCDs which are equaly suitable to install Gentoo from, as long as you're 282two Installation CDs which are equaly suitable to install Gentoo from, as long
263planning on performing an Internet-based installation using the latest version 283as you're planning on performing an Internet-based installation using the
264of the available packages. 284latest version of the available packages.
265</p> 285</p>
266 286
267<p> 287<p>
268If you wish to install Gentoo without a working Internet connection, please use 288If you wish to install Gentoo without a working Internet connection, please use
269the installation instructions described in the <uri 289the installation instructions described in the <uri
270link="2004.3/index.xml">Gentoo 2004.3 Handbooks</uri>. This is currently not 290link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>. This is currently not
271supported for the PPC64 architecture though. 291supported for the PPC64 architecture though.
272</p> 292</p>
273 293
274<p> 294<p>
275For the PowerPC64 architecture, we only supply a <e>Minimal</e> LiveCD, 295For the PowerPC64 architecture, we only supply a <e>Minimal</e> Installation CD,
276a small, no-nonsense, bootable CD which sole purpose is to boot the system, 296a small, no-nonsense, bootable CD which sole purpose is to boot the system,
277prepare the networking and continue with the Gentoo installation. 297prepare the networking and continue with the Gentoo installation.
278</p> 298</p>
279 299
280</body> 300</body>
281</subsection> 301</subsection>
282<subsection> 302<subsection>
283<title>Gentoo's Minimal LiveCD</title> 303<title>Gentoo's Minimal Installation CD</title>
284<body> 304<body>
285 305
286<p> 306<p>
287The Minimal LiveCD is called <c>install-ppc64-pSeries-minimal-2004.3.iso</c> or 307The Minimal Installation CD is called
308<c>install-ppc64-g5-minimal-2005.1.iso</c> or
288<c>install-ppc64-g5-minimal-2004.3.iso</c> and takes up only 350 MB of 309<c>install-ppc64-ibm-minimal-2005.1.iso</c> and takes up only 350 MB of
289diskspace. You can use this LiveCD to install Gentoo, but always with a 310diskspace. You can use this Installation CD to install Gentoo, but always with a
290working Internet connection only. 311working Internet connection only.
291</p> 312</p>
292 313
293<table> 314<table>
294<tr> 315<tr>
295 <th>Minimal LiveCD</th> 316 <th>Minimal Installation CD</th>
296 <th>Pros and Cons</th> 317 <th>Pros and Cons</th>
297</tr> 318</tr>
298<tr> 319<tr>
299 <th>+</th> 320 <th>+</th>
300 <ti>Smallest download</ti> 321 <ti>Smallest download</ti>
318</body> 339</body>
319</subsection> 340</subsection>
320</section> 341</section>
321<!-- STOP --> 342<!-- STOP -->
322<section> 343<section>
323<title>Download, Burn and Boot a Gentoo LiveCD</title> 344<title>Download, Burn and Boot a Gentoo Installation CD</title>
324<subsection> 345<subsection>
325<title>Downloading and Burning the LiveCDs</title> 346<title>Downloading and Burning the Installation CDs</title>
326<body> 347<body>
327 348
328<p>
329You have chosen to use a Gentoo LiveCD. We'll first start by downloading and
330burning the chosen LiveCD. We previously discussed the several available
331LiveCDs, but where can you find them?
332</p> 349<p>
333 350You have chosen to use a Gentoo Installation CD. We'll first start by
351downloading and burning the chosen Installation CD. We previously discussed the
352several available Installation CDs, but where can you find them?
334<p> 353</p>
354
355<p>
335You can download any of the LiveCDs (and, if you want to, a Packages CD as 356You can download any of the Installation CDs (and, if you want to, a Packages
336well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The 357CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
337LiveCDs are located in the <path>releases/ppc64/2004.3/livecd</path> directory. 358Installation CDs are located in the <path>releases/ppc64/2005.1/installcd</path>
359directory.
338</p> 360</p>
339 361
340<p> 362<p>
341Inside that directory you'll find so-called ISO-files. Those are full CD images 363Inside that directory you'll find so-called ISO-files. Those are full CD images
342which you can write on a CD-R. 364which you can write on a CD-R.
343</p> 365</p>
344 366
345<p> 367<p>
346In case you wonder if your downloaded file is corrupted or not, you can 368In case you wonder if your downloaded file is corrupted or not, you can
347check its MD5 checksum and compare it with the MD5 checksum we provide (such as 369check its MD5 checksum and compare it with the MD5 checksum we provide (such as
348<path>install-ppc64-g5-minimal-2004.3.iso.md5</path>). You can check the MD5 370<path>install-ppc64-g5-minimal-2005.1.iso.md5</path>). You can check the MD5
349checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 371checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
350link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 372link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
351</p> 373</p>
352 374
353<p> 375<p>
377 399
378<ul> 400<ul>
379 <li> 401 <li>
380 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso 402 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
381 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's 403 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
382 device path) followed by the path to the ISO file :) 404 device path).
383 </li> 405 </li>
384 <li> 406 <li>
385 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then 407 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
386 you can locate your ISO file within the 'Image to Burn' area. Finally click 408 you can locate your ISO file within the 'Image to Burn' area. Finally click
387 <c>Start</c>. 409 <c>Start</c>.
400</ul> 422</ul>
401 423
402</body> 424</body>
403</subsection> 425</subsection>
404<subsection> 426<subsection>
405<title>Default: Booting the LiveCD on an Apple/IBM</title> 427<title>Default: Booting the Installation CD on an Apple/IBM</title>
406<body> 428<body>
407 429
408<p> 430<p>
409Place the LiveCD in the CD-ROM and reboot the system. Hold down the 'C' key at 431Place the Installation CD in the CD-ROM and reboot the system. Hold down the
410bootup. You will be greeted by a friendly welcome message and a <e>boot:</e> 432'C' key at bootup. You will be greeted by a friendly welcome message and a
411prompt at the bottom of the screen. 433<e>boot:</e> prompt at the bottom of the screen.
412</p> 434</p>
413 435
414<p> 436<p>
415You are also able to tweak some kernel options at this prompt. The following 437You are also able to tweak some kernel options at this prompt. The following
416table lists the available boot options you can add: 438table lists the available boot options you can add:
439</tr> 461</tr>
440<tr> 462<tr>
441 <ti><c>debug</c></ti> 463 <ti><c>debug</c></ti>
442 <ti> 464 <ti>
443 Enables verbose booting, spawns an initrd shell that can be used to debug 465 Enables verbose booting, spawns an initrd shell that can be used to debug
444 the LiveCD 466 the Installation CD
445 </ti> 467 </ti>
446</tr> 468</tr>
447<tr> 469<tr>
448 <ti><c>sleep=X</c></ti> 470 <ti><c>sleep=X</c></ti>
449 <ti> 471 <ti>
507keymaps, execute <c>ls /usr/share/keymaps/i386</c>. 529keymaps, execute <c>ls /usr/share/keymaps/i386</c>.
508</p> 530</p>
509 531
510<pre caption="Listing available keymaps"> 532<pre caption="Listing available keymaps">
511<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided 533<comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
512 on the LiveCD are ADB keymaps and unusable with the LiveCD kernel)</comment> 534 on the Installation CD are ADB keymaps and unusable with the
535 Installation CD kernel)</comment>
513# <i>ls /usr/share/keymaps/i386</i> 536# <i>ls /usr/share/keymaps/i386</i>
514</pre> 537</pre>
515 538
516<p> 539<p>
517Now load the keymap of your choice: 540Now load the keymap of your choice:
530<subsection id="hardware"> 553<subsection id="hardware">
531<title>Extra Hardware Configuration</title> 554<title>Extra Hardware Configuration</title>
532<body> 555<body>
533 556
534<p> 557<p>
535When the Live CD boots, it tries to detect all your hardware devices and 558When the Installation CD boots, it tries to detect all your hardware devices and
536loads the appropriate kernel modules to support your hardware. In the 559loads the appropriate kernel modules to support your hardware. In the
537vast majority of cases, it does a very good job. However, in some cases (the 560vast majority of cases, it does a very good job. However, in some cases it may
538SPARC LiveCDs don't even do autodetection), it may not auto-load the kernel 561not auto-load the kernel
539modules you need. If the PCI auto-detection missed some of your system's 562modules you need. If the PCI auto-detection missed some of your system's
540hardware, you will have to load the appropriate kernel modules manually. 563hardware, you will have to load the appropriate kernel modules manually.
541</p> 564</p>
542 565
543<p> 566<p>
627<subsection> 650<subsection>
628<title>Optional: Viewing Documentation while Installing</title> 651<title>Optional: Viewing Documentation while Installing</title>
629<body> 652<body>
630 653
631<p> 654<p>
632If you want to view the Gentoo Handbook (either from-CD or online) during the 655If you want to view the Gentoo Handbook during the installation, make sure you
633installation, make sure you have created a user account (see <uri 656have created a user account (see <uri link="#useraccounts">Optional: User
634link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to 657Accounts</uri>). Then press <c>Alt-F2</c> to go to a new terminal and log in.
635go to a new terminal and log in.
636</p> 658</p>
637 659
638<p> 660<p>
639If you want to view the documentation on the CD you can immediately run 661If you want to view the documentation on the CD you can immediately run
640<c>links2</c> to read it: 662<c>links2</c> to read it:
641</p> 663</p>
642 664
643<pre caption="Viewing the on-CD documentation"> 665<pre caption="Viewing the on-CD documentation">
644# <i>links2 /mnt/cdrom/docs/html/index.html</i> 666# <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
645</pre> 667</pre>
646 668
647<p> 669<p>
648However, it is preferred that you use the online Gentoo Handbook as it will be 670However, it is preferred that you use the online Gentoo Handbook as it will be
649more recent than the one provided on the CD. You can view it using <c>links2</c> 671more recent than the one provided on the CD.
650as well, but only after having completed the <e>Configuring your Network</e>
651chapter (otherwise you won't be able to go on the Internet to view the
652document):
653</p> 672</p>
654 673
655<pre caption="Viewing the Online Documentation"> 674<pre caption="Viewing the Online Documentation">
656# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i> 675# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc64.xml</i>
657</pre> 676</pre>

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

  ViewVC Help
Powered by ViewVC 1.1.20