/[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.32 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/1.0 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.32 2004/11/09 13:01:52 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.33 2004/11/15 12:47:47 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>1.31</version> 11<version>1.31</version>
12<date>November 4, 2004</date> 12<date>November 4, 2004</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>
18<body> 18<body>
19 19
20<p> 20<p>
21Before we start, we first list what hardware requirements you need to 21Before we start, we first list what hardware requirements you need to
22successfully install Gentoo on your box. This of course depends on your 22successfully install Gentoo on your box. This of course depends on your
245be interested to know that, if you decide to use different optimization settings 245be interested to know that, if you decide to use different optimization settings
246after having installed Gentoo, you will be able to recompile your entire system 246after having installed Gentoo, you will be able to recompile your entire system
247with the new optimization settings. 247with the new optimization settings.
248</p> 248</p>
249 249
250<p> 250<p>
251Now take a look at the available installation media. 251Now take a look at the available installation media.
252</p> 252</p>
253 253
254</body> 254</body>
255</subsection> 255</subsection>
256<subsection> 256<subsection>
257<title>Gentoo LiveCDs</title> 257<title>Gentoo LiveCDs</title>
258<body> 258<body>
259 259
260<note>
261The Gentoo/PPC 2004.2 release is not official, so you will not find them on the
262mirrors. All of our self-organised mirrors are currently down. The only chance
263you can get the LiveCDs is via <uri
264link="http://torrents.gentoo.org/torrents/">BitTorrent</uri>.
265</note>
266
267<note>
268It is known that the Pegasos II will not boot the 2004.2 LiveCD. Please use the
2692004.1 LiveCD.
270</note>
271
272<p> 260<p>
273The <e>Gentoo LiveCDs</e> are bootable CDs which contain a 261The <e>Gentoo LiveCDs</e> are bootable CDs which contain a
274self-sustained Gentoo environment. They allow you to boot Linux from the CD. 262self-sustained Gentoo environment. They allow you to boot Linux from the CD.
275During the boot process your hardware is detected and the appropriate drivers 263During the boot process your hardware is detected and the appropriate drivers
276are loaded. They are maintained by Gentoo developers. 264are loaded. They are maintained by Gentoo developers.
277</p> 265</p>
278 266
279<p> 267<p>
280All LiveCDs allow you to boot, set up networking, initialize your 268All LiveCDs allow you to boot, set up networking, initialize your
281partitions and start installing Gentoo from the Internet. However, some 269partitions and start installing Gentoo from the Internet. However, some
282LiveCDs also contain all necessary source code so you are able to install 270LiveCDs also contain all necessary source code so you are able to install
283Gentoo without a working network configuration. 271Gentoo without a working network configuration.
284</p> 272</p>
285 273
286<p> 274<p>
287Now what do these LiveCDs contain? 275Now what do these LiveCDs contain?
288</p> 276</p>
289 277
290</body> 278</body>
291</subsection> 279</subsection>
292<subsection> 280<subsection>
293<title>Gentoo's Minimal LiveCD</title> 281<title>Gentoo's Minimal LiveCD</title>
294<body> 282<body>
295 283
296<p> 284<p>
297This is a small, no-nonsense, bootable CD which sole purpose is to boot the 285This is a small, no-nonsense, bootable CD which sole purpose is to boot the
298system, prepare the networking and continue with the Gentoo installation. It 286system, prepare the networking and continue with the Gentoo installation. It
299does not contain any stages (or, in some cases, a single stage1 file), 287does not contain any stages (or, in some cases, a single stage1 file),
300source code or precompiled packages. For example the ppc variant of this 288source code or precompiled packages. For example the ppc variant of this
301LiveCD can be found in the <path>livecd</path> subdirectory and is called 289LiveCD can be found in the <path>livecd</path> subdirectory and is called
302<c>install-ppc-minimal-2004.2.iso</c>. 290<c>install-ppc-minimal-2004.3.iso</c>.
303</p> 291</p>
304 292
305<table> 293<table>
306<tr> 294<tr>
307 <th>Minimal LiveCD</th> 295 <th>Minimal LiveCD</th>
308 <th>Pros and Cons</th> 296 <th>Pros and Cons</th>
309</tr> 297</tr>
310<tr> 298<tr>
311 <th>+</th> 299 <th>+</th>
312 <ti>Smallest download</ti> 300 <ti>Smallest download</ti>
313</tr> 301</tr>
314<tr> 302<tr>
315 <th>+</th> 303 <th>+</th>
316 <ti>Suitable for a complete architecture</ti> 304 <ti>Suitable for a complete architecture</ti>
317</tr> 305</tr>
329 suitable for networkless installation 317 suitable for networkless installation
330 </ti> 318 </ti>
331</tr> 319</tr>
332</table> 320</table>
333 321
334</body> 322</body>
335</subsection> 323</subsection>
336<subsection> 324<subsection>
337<title>Gentoo's Universal LiveCD</title> 325<title>Gentoo's Universal LiveCD</title>
338<body> 326<body>
339 327
340<p> 328<p>
341Gentoo's Universal LiveCD is a bootable CD suitable to install Gentoo without 329Gentoo's Universal LiveCD is a bootable CD suitable to install Gentoo without
342networking. It contains a stage1 and several stage3 tarballs (optimized for the 330networking. It contains a stage1 and several stage3 tarballs (optimized for the
343individual subarchitectures). For example the ppc variant of this CD is called 331individual subarchitectures). For example the ppc variant of this CD is called
344<c>install-ppc-universal-2004.2.iso</c> and can be found in the 332<c>install-ppc-universal-2004.3.iso</c> and can be found in the
345<path>livecd</path> subdirectory. 333<path>livecd</path> subdirectory.
346</p> 334</p>
347 335
348<p> 336<p>
349If you take a closer look on our mirrors, you will see 337If you take a closer look on our mirrors, you will see
350that we provide <e>Gentoo Package CDs</e>. This CD (which isn't 338that we provide <e>Gentoo Package CDs</e>. This CD (which isn't
351bootable) only contains precompiled packages and can be used to install software 339bootable) only contains precompiled packages and can be used to install software
352after a succesfull Gentoo Installation. To install Gentoo, you only 340after a succesfull Gentoo Installation. To install Gentoo, you only
353need the Universal LiveCD, but if you want OpenOffice.org, Mozilla, KDE, GNOME 341need the Universal LiveCD, but if you want OpenOffice.org, Mozilla, KDE, GNOME
354etc. without having to compile every single one of them, you need the Packages 342etc. without having to compile every single one of them, you need the Packages
355CD too. For example the G4 (a subarchitecture of ppc) Packages CD is 343CD too. For example the G4 (a subarchitecture of ppc) Packages CD is
356called <c>packages-g4-2004.2.iso</c> and can be found in the appropriate 344called <c>packages-g4-2004.3.iso</c> and can be found in the appropriate
357subdirectory (<path>g4/</path>). 345subdirectory (<path>g4/</path>).
358</p> 346</p>
359 347
360<p> 348<p>
361You only need the Packages CD if you want to perform a stage3 with GRP 349You only need the Packages CD if you want to perform a stage3 with GRP
362installation. 350installation.
363</p> 351</p>
364 352
365<table> 353<table>
366<tr> 354<tr>
367 <th>Universal LiveCD with Packages CD</th> 355 <th>Universal LiveCD with Packages CD</th>
368 <th>Pros and Cons</th> 356 <th>Pros and Cons</th>
369</tr> 357</tr>
370<tr> 358<tr>
371 <th>+</th> 359 <th>+</th>
397<title>Download, Burn and Boot a Gentoo LiveCD</title> 385<title>Download, Burn and Boot a Gentoo LiveCD</title>
398<subsection> 386<subsection>
399<title>Downloading and Burning the LiveCDs</title> 387<title>Downloading and Burning the LiveCDs</title>
400<body> 388<body>
401 389
402<p> 390<p>
403You have chosen to use a Gentoo LiveCD (if not, then you are reading the 391You have chosen to use a Gentoo LiveCD (if not, then you are reading the
404wrong section). We'll first start by downloading and burning the chosen 392wrong section). We'll first start by downloading and burning the chosen
405LiveCD. We previously discussed the several available LiveCDs, but where can you 393LiveCD. We previously discussed the several available LiveCDs, but where can you
406find them? 394find them?
407</p> 395</p>
408 396
409<p> 397<p>
410Visit one of our <uri 398Visit one of our <uri
411link="/main/en/mirrors.xml">mirrors</uri> and go to 399link="/main/en/mirrors.xml">mirrors</uri> and go to
412<path>releases/ppc/2004.2/livecd</path>, which is 400<path>releases/ppc/2004.3/livecd</path>, which is
413the path where the LiveCD(s) of your choice are located. Inside that 401the path where the LiveCD(s) of your choice are located. Inside that
414directory you'll find so-called ISO-files. Those are full CD images 402directory you'll find so-called ISO-files. Those are full CD images
415which you can write on a CD-R. 403which you can write on a CD-R.
416</p> 404</p>
417 405
418<p> 406<p>
419In case you wonder if your downloaded file is corrupted or not, you can 407In case you wonder if your downloaded file is corrupted or not, you can
420check its MD5 checksum and compare it with the MD5 checksum we provide (such as 408check its MD5 checksum and compare it with the MD5 checksum we provide (such as
421<path>install-ppc-minimal-2004.2.iso.md5</path>). You can check the MD5 checksum 409<path>install-ppc-minimal-2004.3.iso.md5</path>). You can check the MD5 checksum
422with the <c>md5sum</c> tool under Linux/Unix or <uri 410with the <c>md5sum</c> tool under Linux/Unix or <uri
423link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 411link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
424</p> 412</p>
425 413
426<p> 414<p>
427As long as Mac OS X does not support <c>md5sum</c> you have to use the md5 415As long as Mac OS X does not support <c>md5sum</c> you have to use the md5
428capability of <c>openssl</c>. Therefore type in Terminal.app: 416capability of <c>openssl</c>. Therefore type in Terminal.app:
429</p> 417</p>
430 418
431<pre caption="md5sum with the help of openssl"> 419<pre caption="md5sum with the help of openssl">
432$ <i>openssl md5 /path/to/iso</i> 420$ <i>openssl md5 /path/to/iso</i>
433<comment>This could take some time depending of the size of the ISO and your CPU</comment> 421<comment>This could take some time depending of the size of the ISO and your CPU</comment>
434</pre> 422</pre>
435 423
436<p> 424<p>
437Now compare this output with the appropriate file found on the server where you 425Now compare this output with the appropriate file found on the server where you
438downloaded the ISO (the file will end with .md5). If it is the same, the ISO 426downloaded the ISO (the file will end with .md5). If it is the same, the ISO
439image downloaded correctly. Be sure you have not mounted it (e.g. with Disk 427image downloaded correctly. Be sure you have not mounted it (e.g. with Disk
440Copy) yet! 428Copy) yet!
441</p> 429</p>
442 430
443<p> 431<p>
444More information are available in our <uri 432More information are available in our <uri
445link="/doc/en/gentoo-ppc-faq.xml">PPC FAQ.</uri> 433link="/doc/en/gentoo-ppc-faq.xml">PPC FAQ</uri>.
446</p> 434</p>
447 435
448<p> 436<p>
449To burn the downloaded ISO(s), you have to select raw-burning. How you 437To burn the downloaded ISO(s), you have to select raw-burning. How you
450do this is highly program-dependent. We will discuss <c>cdrecord</c>, 438do this is highly program-dependent. We will discuss <c>cdrecord</c>,
451<c>k3b</c> and the MacOS burning possibilities here; more information can 439<c>k3b</c> and the MacOS burning possibilities here; more information can be
452be found in our <uri link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri> and 440found in our <uri link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri> and the
453the <uri link="/doc/en/gentoo-ppc-faq.xml">PPC FAQ</uri>. 441<uri link="/doc/en/gentoo-ppc-faq.xml">PPC FAQ</uri>.
454</p> 442</p>
455 443
456<ul> 444<ul>
457 <li> 445 <li>
458 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc</c> (replace 446 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc</c> (replace
459 <path>/dev/hdc</path> with your CD-RW drive's device path) followed 447 <path>/dev/hdc</path> with your CD-RW drive's device path) followed
460 by the path to the ISO file :) 448 by the path to the ISO file :)
461 </li> 449 </li>
462 <li> 450 <li>
463 With k3b, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then 451 With k3b, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
464 you can locate your ISO file within the 'Image to Burn' area. Finally click 452 you can locate your ISO file within the 'Image to Burn' area. Finally click
465 <c>Start</c>. 453 <c>Start</c>.
466 </li> 454 </li>
467 <li> 455 <li>
468 With Mac OS X Panther, launch <c>Disk Utility</c> from 456 With Mac OS X Panther, launch <c>Disk Utility</c> from
486<title>Default: Apple/IBM</title> 474<title>Default: Apple/IBM</title>
487<body> 475<body>
488 476
489<p> 477<p>
490On NewWorld machines place the LiveCD in the CD-ROM and reboot the system. When 478On NewWorld machines place the LiveCD in the CD-ROM and reboot the system. When
491the system-start-bell sounds, simply hold down the 'C' until the CD loads. 479the system-start-bell sounds, simply hold down the 'C' until the CD loads.
492</p> 480</p>
493 481
494<p> 482<p>
495If you have an OldWorld Mac the bootable portion of the livecd can't be used. 483If you have an OldWorld Mac the bootable portion of the livecd can't be used.
496Instead you need to download <uri 484Instead you need to download <uri
497link="http://penguinppc.org/projects/bootx/">BootX</uri> and have a working 485link="http://penguinppc.org/projects/bootx/">BootX</uri> and have a working
498MacOS installed on your system. You need to copy the <c>BootX Extension</c> from 486MacOS installed on your system. You need to copy the <c>BootX Extension</c> from
499the unpacked archive-file into the <c>Extensions Folder</c> and make a new 487the unpacked archive-file into the <c>Extensions Folder</c> and make a new
500directory called <c>Linux Kernels</c> in the System Folder. In the next step you 488directory called <c>Linux Kernels</c> in the System Folder. In the next step you
501need to copy the <c>G3</c> kernel and the <c>initrd.img.gz</c> from the LiveCD 489need to copy the files <c>G3G4kernel</c> and <c>initrd.img.gz</c> from the
502into the <c>Linux Kernels</c> directory. Then reboot the system and wait for 490LiveCD <path>boot</path> folder into the <c>Linux Kernels</c> directory. Then
503BootX to load. After BootX loaded you still have to set up a few items. In the 491reboot the system and wait for BootX to load. After BootX loaded you still have
504options dialog you need to check <c>Use Specified RAM Disk</c> and select the 492to set up a few items. In the options dialog you need to check <c>Use Specified
505<c>initrd.img.gz</c> which you put in the <c>Linux Kernels</c> directory. The 493RAM Disk</c> and select the <c>initrd.img.gz</c> which you put in the <c>Linux
506ramdisk size should be set to at least <c>32000</c>. Furthermore the kernel 494Kernels</c> directory. The ramdisk size should be set to at least <c>32000</c>.
507argument needs to be set to <c>rw init=/linuxrc cdroot</c>. Eventually you are 495Furthermore the kernel argument needs to be set to <c>rw init=/linuxrc
508able to boot the LiveCD when you select Linux on Startup. 496cdroot</c>. Eventually you are able to boot the LiveCD when you select Linux on
497Startup.
509</p> 498</p>
510 499
511<p> 500<p>
512After the LiveCD loaded, you will be greeted by a friendly welcome message and a 501After the LiveCD loaded, you will be greeted by a friendly welcome message and a
513<e>boot:</e> prompt at the bottom of the screen. 502<e>boot:</e> prompt at the bottom of the screen.
514</p> 503</p>
515 504
516<p> 505<p>
517At this prompt you are able to select a kernel for the subarchitecture you use. 506At this prompt you are able to select a kernel for the subarchitecture you use.
518We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with 507We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
519support for multiple CPUs, but they will boot on single processor machines as 508support for multiple CPUs, but they will boot on single processor machines as
520well. 509well.
521</p> 510</p>
522 511
523<p> 512<p>
570 559
571<p> 560<p>
572At this prompt, hit enter, and a complete Gentoo Linux environment will be 561At this prompt, hit enter, and a complete Gentoo Linux environment will be
573loaded from the CD. Continue with <uri link="#booted">And When You're 562loaded from the CD. Continue with <uri link="#booted">And When You're
574Booted...</uri>. 563Booted...</uri>.
575</p> 564</p>
576 565
577</body> 566</body>
578</subsection> 567</subsection>
579<subsection> 568<subsection>
580<title>Alternative: Pegasos</title> 569<title>Alternative: Pegasos</title>
581<body> 570<body>
582 571
583<p> 572<p>
584On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type 573On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
585<c>boot cd /boot/pegasos root=/dev/ram0 init=/linuxrc looptype=gcloop
586cdroot</c>. If you need any special boot options you can append them to the 574<c>boot cd /boot/pegasos</c>. If you need any special boot options you can append them to the
587command-line. For instance <c>boot cd /boot/pegasos root=/dev/ram0 575command-line. For instance <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
588init=/linuxrc looptype=gcloop cdroot video=radeonfb:1280x1024@75 mem=256M</c>.
589</p> 576</p>
590 577
591</body> 578</body>
592</subsection> 579</subsection>
593<subsection id="booted"> 580<subsection id="booted">
594<title>And When You're Booted...</title> 581<title>And When You're Booted...</title>
595<body> 582<body>
596 583
597<p> 584<p>
598You will be greeted by a root ("#") prompt on the current console. You can also 585You will be greeted by a root ("#") prompt on the current console. You can also
599switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get 586switch to other consoles by pressing Alt-fn-F2, Alt-fn-F3 and Alt-fn-F4. Get
600back to the one you started on by pressing Alt-fn-F1. 587back to the one you started on by pressing Alt-fn-F1.
601</p> 588</p>
602 589
603<p> 590<p>
630</subsection> 617</subsection>
631<subsection id="hardware"> 618<subsection id="hardware">
632<title>Extra Hardware Configuration</title> 619<title>Extra Hardware Configuration</title>
633<body> 620<body>
634 621
635<p> 622<p>
636When the LiveCD boots, it tries to detect all your hardware devices and 623When the LiveCD boots, it tries to detect all your hardware devices and
637loads the appropriate kernel modules to support your hardware. In the 624loads the appropriate kernel modules to support your hardware. In the
638vast majority of cases, it does a very good job. However, in some cases, it may 625vast majority of cases, it does a very good job. However, in some cases, it may
639not auto-load the kernel modules you need. If the PCI auto-detection missed some 626not auto-load the kernel modules you need. If the PCI auto-detection missed some
640of your system's hardware, you will have to load the appropriate kernel modules 627of your system's hardware, you will have to load the appropriate kernel modules
641manually. 628manually.
642</p> 629</p>
643 630
644<p> 631<p>
645In the next example we try to load the <c>8139too</c> module (support for 632In the next example we try to load the <c>airport</c> module (support for
646certain kinds of network interfaces): 633certain kinds of network interfaces):
647</p> 634</p>
648 635
649<pre caption="Loading kernel modules"> 636<pre caption="Loading kernel modules">
650# <i>modprobe 8139too</i> 637# <i>modprobe airport</i>
651</pre> 638</pre>
652 639
653</body> 640</body>
654</subsection> 641</subsection>
655<subsection> 642<subsection>
656<title>Optional: Tweaking Hard Disk Performance</title> 643<title>Optional: Tweaking Hard Disk Performance</title>
657<body> 644<body>
658 645
659<p> 646<p>
660If you are an advanced user, you might want to tweak the IDE hard disk 647If you are an advanced user, you might want to tweak the IDE hard disk
661performance using <c>hdparm</c>. With the <c>-tT</c> options you can 648performance using <c>hdparm</c>. With the <c>-tT</c> options you can
662test the performance of your disk (execute it several times to get a 649test the performance of your disk (execute it several times to get a
663more precise impression): 650more precise impression):
664</p> 651</p>
665 652

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

  ViewVC Help
Powered by ViewVC 1.1.20