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

Contents of /xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.47 - (hide annotations) (download) (as text)
Thu Aug 25 19:53:25 2005 UTC (9 years, 1 month ago) by neysx
Branch: MAIN
Changes since 1.46: +5 -5 lines
File MIME type: application/xml
#103724 Fix location of handbook on universal CD

1 swift 1.1 <?xml version='1.0' encoding='UTF-8'?>
2     <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3    
4     <!-- The content of this document is licensed under the CC-BY-SA license -->
5 neysx 1.47 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 swift 1.1
7 neysx 1.47 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.46 2005/08/11 11:28:54 swift Exp $ -->
8 swift 1.1
9     <sections>
10 swift 1.32
11 neysx 1.47 <version>2.5</version>
12     <date>2005-08-25</date>
13 swift 1.32
14 swift 1.1 <section>
15     <title>Hardware Requirements</title>
16     <subsection>
17     <title>Introduction</title>
18     <body>
19    
20     <p>
21     Before we start, we first list what hardware requirements you need to
22 swift 1.35 successfully install Gentoo on your box.
23 swift 1.1 </p>
24    
25     </body>
26     </subsection>
27     <subsection>
28 swift 1.35 <title>Hardware Requirements</title>
29 swift 1.1 <body>
30    
31 swift 1.35 <table>
32     <tr>
33 swift 1.45 <th>Apple NewWorld Machines</th>
34 swift 1.35 <ti>
35     Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
36 swift 1.45 PowerBook, Xserver, PowerMac
37 swift 1.35 </ti>
38     </tr>
39     <tr>
40 swift 1.45 <th>Apple OldWorld machines</th>
41 swift 1.35 <ti>
42 swift 1.45 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
57 swift 1.35 </ti>
58     </tr>
59     <tr>
60     <th>Memory</th>
61 swift 1.39 <ti>At least 64 MB</ti>
62 swift 1.35 </tr>
63     <tr>
64     <th>Diskspace</th>
65     <ti>1.5 GB (excluding swap space)</ti>
66     </tr>
67     <tr>
68     <th>Swap space</th>
69     <ti>At least 256 MB</ti>
70     </tr>
71     </table>
72    
73 swift 1.1 <p>
74 swift 1.35 Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo
75     PPC FAQ</uri> before you begin.
76 swift 1.1 </p>
77    
78     </body>
79     </subsection>
80     </section>
81 swift 1.35 <!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) -->
82     <!-- START -->
83 swift 1.1 <section>
84 swift 1.35 <title>The Gentoo Installation Approaches</title>
85 swift 1.1 <subsection>
86     <title>Introduction</title>
87     <body>
88    
89     <p>
90 swift 1.35 Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
91     A stage file is a tarball (compressed archive) that contains a minimal
92     environment.
93 swift 1.1 </p>
94    
95     <ul>
96 swift 1.35 <li>
97     A stage1 file contains nothing more than a compiler, Portage (Gentoo's
98     software management system) and a couple of packages on which the compiler
99     or Portage depends.
100     </li>
101     <li>
102     A stage2 file contains a so-called bootstrapped system, a minimal
103     environment from which one can start building all other necessary
104     applications that make a Gentoo environment complete.
105     </li>
106     <li>
107     A stage3 file contains a prebuilt minimal system which is almost fully
108     deployable. It only lacks a few applications where you, the Gentoo user,
109     needs to choose which one you want to install.
110     </li>
111 swift 1.1 </ul>
112    
113     <p>
114 swift 1.35 To help you decide what stage file you want to use, we have written down the
115     major advantages and disadvantages of each stage file.
116 swift 1.1 </p>
117    
118     </body>
119     </subsection>
120     <subsection>
121 swift 1.35 <title>A Stage1 Approach</title>
122 swift 1.1 <body>
123    
124     <p>
125 swift 1.35 A <e>stage1</e> is used when you want to bootstrap and build the entire system
126     from scratch.
127 swift 1.1 </p>
128    
129     <p>
130 swift 1.35 Starting from a stage1 allows you to have total control over the
131 swift 1.1 optimization settings and optional build-time functionality that is
132     initially enabled on your system. This makes <e>stage1</e> installs good for
133     power users who know what they are doing. It is also a great
134     installation method for those who would like to know more about the
135     inner workings of Gentoo Linux.
136     </p>
137    
138     <table>
139     <tr>
140     <th>Stage1</th>
141     <th>Pros and Cons</th>
142     </tr>
143     <tr>
144     <th>+</th>
145     <ti>
146     Allows you to have total control over the optimization settings and optional
147     build-time functionality that is initially enabled on your system
148     </ti>
149     </tr>
150     <tr>
151     <th>+</th>
152     <ti>Suitable for powerusers that know what they are doing</ti>
153     </tr>
154     <tr>
155     <th>+</th>
156     <ti>Allows you to learn more about the inner workings of Gentoo</ti>
157     </tr>
158     <tr>
159     <th>-</th>
160     <ti>Takes a long time to finish the installation</ti>
161     </tr>
162     <tr>
163     <th>-</th>
164     <ti>
165 swift 1.35 If you don't intend to tweak the settings, it is a waste of time
166 swift 1.10 </ti>
167     </tr>
168 swift 1.40 <tr>
169     <th>-</th>
170     <ti>
171     Requires a working Internet connection during the installation
172     </ti>
173     </tr>
174 swift 1.1 </table>
175    
176 swift 1.35 </body>
177     </subsection>
178     <subsection>
179     <title>A Stage2 Approach</title>
180     <body>
181    
182 swift 1.1 <p>
183 swift 1.35 A <e>stage2</e> is used for building the entire system from a bootstrapped
184     "semi-compiled" state.
185 swift 1.1 </p>
186    
187 swift 1.10 <p>
188 swift 1.35 Stage2 installs allow you to skip the bootstrap process; doing this
189     is fine if you are happy with the optimization settings that we chose
190     for your particular stage2 tarball.
191 swift 1.10 </p>
192    
193 swift 1.1 <table>
194     <tr>
195     <th>Stage2</th>
196     <th>Pros and Cons</th>
197     </tr>
198     <tr>
199     <th>+</th>
200     <ti>You don't need to bootstrap</ti>
201     </tr>
202     <tr>
203     <th>+</th>
204     <ti>Faster than starting with stage1</ti>
205     </tr>
206     <tr>
207     <th>+</th>
208     <ti>You can still tweak your settings</ti>
209     </tr>
210     <tr>
211     <th>-</th>
212     <ti>You cannot tweak as much as with a stage1</ti>
213     </tr>
214     <tr>
215     <th>-</th>
216 swift 1.35 <ti>It's still not the fastest way to install Gentoo</ti>
217 swift 1.1 </tr>
218     <tr>
219     <th>-</th>
220     <ti>You have to accept the optimizations we chose for the bootstrap</ti>
221     </tr>
222 swift 1.40 <tr>
223     <th>-</th>
224     <ti>
225     Requires a working Internet connection during the installation
226     </ti>
227     </tr>
228 swift 1.1 </table>
229    
230 swift 1.35 </body>
231     </subsection>
232     <subsection>
233     <title>A Stage3 Approach</title>
234     <body>
235    
236     <p>
237     A <e>stage3</e> installation contains a basic Gentoo Linux system that has been
238     built for you. You will only need to build a few packages of which we can't
239     decide for you which one to choose.
240     </p>
241    
242 swift 1.1 <p>
243 swift 1.35 Choosing to go with a stage3 allows for the fastest install of Gentoo
244 swift 1.1 Linux, but also means that your base system will have the optimization
245     settings that we chose for you (which to be honest, are good settings
246     and were carefully chosen to enhance performance while maintaining
247 swift 1.35 stability). Stage3 is also required if you want to install Gentoo using
248 swift 1.9 prebuilt packages or without a network connection.
249 swift 1.1 </p>
250    
251     <table>
252     <tr>
253     <th>Stage3</th>
254     <th>Pros and Cons</th>
255     </tr>
256     <tr>
257     <th>+</th>
258     <ti>Fastest way to get a Gentoo base system</ti>
259     </tr>
260     <tr>
261     <th>-</th>
262     <ti>You cannot tweak the base system - it's built already</ti>
263     </tr>
264     </table>
265    
266     <p>
267 swift 1.35 You might be interested to know that, if you decide to use different
268     optimization settings after having installed Gentoo, you will be able to
269     recompile your entire system with the new optimization settings.
270 swift 1.1 </p>
271    
272     </body>
273     </subsection>
274 swift 1.35 </section>
275     <section>
276 swift 1.39 <title>The Gentoo Installation CDs</title>
277 swift 1.1 <subsection>
278 swift 1.35 <title>Introduction</title>
279 swift 1.1 <body>
280    
281     <p>
282 swift 1.39 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
283 swift 1.1 self-sustained Gentoo environment. They allow you to boot Linux from the CD.
284     During the boot process your hardware is detected and the appropriate drivers
285     are loaded. They are maintained by Gentoo developers.
286     </p>
287    
288     <p>
289 swift 1.39 All Installation CDs allow you to boot, set up networking, initialize your
290 swift 1.35 partitions and start installing Gentoo from the Internet. We currently provide
291 swift 1.39 two Installation CDs which are equaly suitable to install Gentoo from, as long
292     as you're planning on performing an Internet-based installation using the
293     latest version of the available packages.
294 swift 1.35 </p>
295    
296     <p>
297 swift 1.36 If you wish to install Gentoo without a working Internet connection, please use
298 swift 1.35 the installation instructions described in the <uri
299 swift 1.45 link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>.
300 swift 1.1 </p>
301    
302     <p>
303 swift 1.39 The two Installation CDs that we currently provide are:
304 swift 1.35 </p>
305    
306     <ul>
307     <li>
308 swift 1.39 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
309     CD which sole purpose is to boot the system, prepare the networking and
310     continue with the Gentoo installation.
311 swift 1.35 </li>
312     <li>
313 swift 1.39 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
314     abilities as the Minimal Installation CD. Additionally, it contains a
315     stage1 and several stage3 tarballs (optimized for the individual
316     subarchitectures).
317 swift 1.35 </li>
318     </ul>
319    
320     <p>
321 swift 1.39 To help you decide which Installation CD you need, we have written down the
322     major advantages and disadvantages of each Installation CD.
323 swift 1.1 </p>
324    
325     </body>
326     </subsection>
327     <subsection>
328 swift 1.39 <title>Gentoo's Minimal Installation CD</title>
329 swift 1.1 <body>
330    
331     <p>
332 swift 1.45 The Minimal Installation CD is called <c>install-ppc-minimal-2005.1.iso</c> and
333 swift 1.39 takes up only 52 MB of diskspace. You can use this Installation CD to install
334     Gentoo, but always with a working Internet connection only.
335 swift 1.1 </p>
336    
337     <table>
338     <tr>
339 swift 1.39 <th>Minimal Installation CD</th>
340 swift 1.1 <th>Pros and Cons</th>
341     </tr>
342     <tr>
343     <th>+</th>
344     <ti>Smallest download</ti>
345     </tr>
346     <tr>
347     <th>+</th>
348     <ti>
349     You can do a stage1, stage2 or stage3 by getting the stage tarball off the
350     net
351     </ti>
352     </tr>
353     <tr>
354     <th>-</th>
355     <ti>
356 swift 1.35 Contains no stages, no Portage snapshot, no prebuilt packages and is
357     therefore not suitable for networkless installation
358 swift 1.1 </ti>
359     </tr>
360     </table>
361    
362     </body>
363     </subsection>
364     <subsection>
365 swift 1.39 <title>Gentoo's Universal Installation CD</title>
366 swift 1.1 <body>
367    
368     <p>
369 swift 1.45 The Universal Installation CD is called <c>install-ppc-universal-2005.1.iso</c>
370 swift 1.39 and consumes the entire surface of a 650 MB CD. You can use this Installation
371     CD to install Gentoo, and you can even use it to install Gentoo without a
372     working internet connection, just in case you want to bring Gentoo to another
373     PC than the one you are currently installing Gentoo on :)
374 swift 1.11 </p>
375    
376 swift 1.1 <table>
377     <tr>
378 swift 1.39 <th>Universal Installation CD</th>
379 swift 1.1 <th>Pros and Cons</th>
380     </tr>
381     <tr>
382     <th>+</th>
383     <ti>
384     Contains everything you need. You can even install without a network
385     connection.
386     </ti>
387     </tr>
388     <tr>
389     <th>-</th>
390     <ti>Huge download</ti>
391     </tr>
392     </table>
393    
394     </body>
395     </subsection>
396 swift 1.35 <subsection>
397     <title>Other CDs</title>
398     <body>
399    
400     <p>
401     You might find a so-called <e>Package CD</e> on one of our mirrors. This CD is
402 swift 1.39 no Installation CD but an additional resource that can be exploited during a
403     networkless installation. It contains prebuilt packages (the so-called GRP
404     set) that allows you to easily and quickly install additional applications
405     (such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless
406     Gentoo installation.
407 swift 1.35 </p>
408    
409     </body>
410     </subsection>
411 swift 1.1 </section>
412 swift 1.35 <!-- STOP -->
413 swift 1.1 <section>
414 swift 1.39 <title>Download, Burn and Boot a Gentoo Installation CD</title>
415 swift 1.1 <subsection>
416 swift 1.39 <title>Downloading and Burning the Installation CDs</title>
417 swift 1.1 <body>
418    
419     <p>
420 swift 1.39 You have chosen to use a Gentoo Installation CD. We'll first start by
421     downloading and burning the chosen Installation CD. We previously discussed
422     the several available Installation CDs, but where can you find them?
423 swift 1.35 </p>
424    
425     <p>
426 swift 1.39 You can download any of the Installation CDs (and, if you want to, a Packages
427     CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
428 swift 1.45 Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path>
429 swift 1.39 directory.
430 swift 1.1 </p>
431    
432     <p>
433 swift 1.35 Inside that directory you'll find so-called ISO-files. Those are full CD images
434 swift 1.1 which you can write on a CD-R.
435     </p>
436    
437     <p>
438     In case you wonder if your downloaded file is corrupted or not, you can
439     check its MD5 checksum and compare it with the MD5 checksum we provide (such as
440 swift 1.45 <path>install-ppc-minimal-2005.1.iso.md5</path>). You can check the MD5 checksum
441     with the <c>md5sum</c> tool under Linux/Unix or
442     <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If
443     <c>md5sum</c> is not available on Mac OS X, see the
444     <uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help.
445 swift 1.1 </p>
446    
447     <p>
448 swift 1.35 Another way to check the validity of the downloaded file is to use GnuPG to
449     verify the cryptographic signature that we provide (the file ending with
450     <path>.asc</path>). Download the signature file and obtain the public key:
451 swift 1.12 </p>
452    
453 swift 1.35 <pre caption="Obtaining the public key">
454     $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
455 swift 1.12 </pre>
456    
457     <p>
458 swift 1.35 Now verify the signature:
459 swift 1.12 </p>
460    
461 swift 1.35 <pre caption="Verify the cryptographic signature">
462     $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
463     </pre>
464 swift 1.12
465     <p>
466 swift 1.1 To burn the downloaded ISO(s), you have to select raw-burning. How you
467 swift 1.35 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
468     <c>K3B</c> here; more information can be found in our <uri
469     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
470 swift 1.1 </p>
471    
472     <ul>
473     <li>
474 swift 1.35 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
475     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
476 swift 1.37 device path).
477 swift 1.1 </li>
478     <li>
479 swift 1.35 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
480 bennyc 1.6 you can locate your ISO file within the 'Image to Burn' area. Finally click
481 swift 1.3 <c>Start</c>.
482     </li>
483 swift 1.1 </ul>
484    
485     </body>
486     </subsection>
487     <subsection>
488 josejx 1.41 <title>Default: Booting the Installation CD with Yaboot</title>
489 swift 1.1 <body>
490    
491     <p>
492 swift 1.39 On NewWorld machines place the Installation CD in the CD-ROM and reboot the
493     system. When the system-start-bell sounds, simply hold down the 'C' until the
494     CD loads.
495 dertobi123 1.17 </p>
496    
497     <p>
498 swift 1.39 After the Installation CD loaded, you will be greeted by a friendly welcome
499     message and a <e>boot:</e> prompt at the bottom of the screen.
500 swift 1.1 </p>
501    
502     <p>
503     At this prompt you are able to select a kernel for the subarchitecture you use.
504 dertobi123 1.17 We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
505     support for multiple CPUs, but they will boot on single processor machines as
506     well.
507 swift 1.1 </p>
508    
509     <p>
510     You are also able to tweak some kernel options at this prompt. The following
511 swift 1.39 table lists some of the available boot options you can add:
512 swift 1.1 </p>
513    
514     <table>
515     <tr>
516     <th>Boot Option</th>
517     <th>Description</th>
518     </tr>
519     <tr>
520     <ti><c>video</c></ti>
521     <ti>
522     This option takes one of the following vendor-specific tags:
523     <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
524     <c>ofonly</c>. You can follow this tag with the resolution and refreshrate
525     you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
526     uncertain what to choose, <c>ofonly</c> will most certainly work.
527     </ti>
528     </tr>
529     <tr>
530 pylon 1.2 <ti><c>nol3</c></ti>
531 swift 1.1 <ti>
532 dertobi123 1.17 Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
533 swift 1.1 </ti>
534     </tr>
535     <tr>
536 swift 1.39 <ti><c>dofirewire</c></ti>
537 swift 1.1 <ti>
538 swift 1.39 Enables support for IEEE1394 (FireWire) devices, like external harddisks.
539 swift 1.1 </ti>
540     </tr>
541 swift 1.7 <tr>
542 swift 1.39 <ti><c>dopcmcia</c></ti>
543 swift 1.7 <ti>
544 swift 1.39 If you want to use PCMCIA devices during your installation (like PCMCIA
545     network cards) you have to enable this option.
546 swift 1.7 </ti>
547     </tr>
548 swift 1.1 </table>
549    
550     <p>
551     At this prompt, hit enter, and a complete Gentoo Linux environment will be
552 swift 1.7 loaded from the CD. Continue with <uri link="#booted">And When You're
553     Booted...</uri>.
554 swift 1.1 </p>
555    
556 swift 1.7 </body>
557     </subsection>
558     <subsection>
559 swift 1.39 <title>Alternative: Booting the Installation CD on a Pegasos</title>
560 swift 1.7 <body>
561    
562 swift 1.1 <p>
563 swift 1.7 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
564 swift 1.39 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
565     between several preconfigured video configs. If you need any special boot
566     options you can append them to the command-line. For instance <c>boot cd
567     /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>. The complete list of
568     kernel appends (in case something goes wrong and you need it) is preconfigured
569     in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
570     looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>.
571 swift 1.1 </p>
572    
573 swift 1.7 </body>
574     </subsection>
575 josejx 1.41
576     <subsection>
577     <title>Alternative: Booting the Installation CD with BootX</title>
578     <body>
579    
580     <p>
581     If you have an OldWorld Mac the bootable portion of the livecd can't be used.
582     The most simple solution is to use MacOS to bootstrap into a Linux environment
583     with a tool called BootX. Boot floppies are being prepared for Macs without
584     MacOS, but they are not available at this time.
585     </p>
586 swift 1.45
587 josejx 1.41 <p>
588     First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
589     and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
590     archive into <c>Extensions Folder</c> and the BootX App Control Panel into
591     <c>Control Panels</c>, both of which are located in your MacOS System Folder.
592 josejx 1.42 Next, create a folder called "Linux Kernels" in your System folder and copy the
593     <c>G3G4</c> kernel from the CD to this folder. Finally, copy <c>G3G4.igz</c>
594     from the Installation CD <path>boot</path> folder into the MacOS
595     <c>System Folder</c>.
596 josejx 1.41 </p>
597 swift 1.45
598 josejx 1.41 <p>
599     To prepare BootX, start the BootX App Control Panel. First select the Options
600     dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from
601     your System Folder. Continue back to the initial screen and ensure that the
602     ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
603     shown below:
604     </p>
605    
606     <pre caption="BootX kernel arguments">
607     cdroot root=/dev/ram0 init=linuxrc loop=livecd.squashfs looptype=squashfs console=tty0 nodevfs udev
608     </pre>
609 swift 1.45
610 josejx 1.41 <note>
611     The kernel parameters in the yaboot section above are also applicable here.
612     </note>
613 swift 1.45
614 josejx 1.41 <p>
615     Check once more to make sure the settings are correct and then save the
616     configuration. This saves typing just in case it doesn't boot or something is
617     missing. Press the Linux button at the top of the window to boot into the
618 so 1.44 Installation CD and continue with <uri link="#booted">And When
619     You're Booted...</uri>
620 josejx 1.41 </p>
621 swift 1.45
622 josejx 1.41 </body>
623     </subsection>
624    
625 swift 1.7 <subsection id="booted">
626     <title>And When You're Booted...</title>
627     <body>
628 swift 1.1
629     <p>
630 swift 1.7 You will be greeted by a root ("#") prompt on the current console. You can also
631 swift 1.39 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
632     back to the one you started on by pressing Alt-F1. Probably you have to hit
633     Alt-fn-Fx on Apple machines.
634 swift 1.1 </p>
635    
636     <p>
637     If you are installing Gentoo on a system with a non-US keyboard, use
638     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
639 swift 1.39 keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
640     Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
641     are for ADB-based OldWorld machines.
642 swift 1.1 </p>
643    
644     <pre caption="Listing available keymaps">
645     <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
646 swift 1.39 on the Installation CD are ADB keymaps and unusable with the Installation CD
647     kernel)</comment>
648 swift 1.1 # <i>ls /usr/share/keymaps/i386</i>
649     </pre>
650    
651     <p>
652     Now load the keymap of your choice:
653     </p>
654    
655     <pre caption="Loading a keymap">
656 swift 1.7 # <i>loadkeys be-latin1</i>
657 swift 1.1 </pre>
658    
659     <p>
660     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
661     </p>
662    
663     </body>
664     </subsection>
665     <subsection id="hardware">
666     <title>Extra Hardware Configuration</title>
667     <body>
668    
669     <p>
670 swift 1.39 When the Installation CD boots, it tries to detect all your hardware devices and
671 swift 1.1 loads the appropriate kernel modules to support your hardware. In the
672 dertobi123 1.17 vast majority of cases, it does a very good job. However, in some cases, it may
673     not auto-load the kernel modules you need. If the PCI auto-detection missed some
674     of your system's hardware, you will have to load the appropriate kernel modules
675     manually.
676 swift 1.1 </p>
677    
678     <p>
679 swift 1.39 In the next example we try to load the <c>airport</c> module. This module
680     supports only the old Airport cards (b-net). AirportExtreme is currently not
681     supported under Linux:
682 swift 1.1 </p>
683    
684     <pre caption="Loading kernel modules">
685 swift 1.33 # <i>modprobe airport</i>
686 swift 1.1 </pre>
687    
688     </body>
689     </subsection>
690     <subsection>
691     <title>Optional: Tweaking Hard Disk Performance</title>
692     <body>
693    
694     <p>
695     If you are an advanced user, you might want to tweak the IDE hard disk
696     performance using <c>hdparm</c>. With the <c>-tT</c> options you can
697     test the performance of your disk (execute it several times to get a
698     more precise impression):
699     </p>
700    
701     <pre caption="Testing disk performance">
702     # <i>hdparm -tT /dev/hda</i>
703     </pre>
704    
705     <p>
706     To tweak, you can use any of the following examples (or experiment
707     yourself) which use <path>/dev/hda</path> as disk (substitute with your
708     disk):
709     </p>
710    
711     <pre caption="Tweaking hard disk performance">
712     <comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
713     <comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
714     </pre>
715    
716     </body>
717     </subsection>
718 swift 1.20 <subsection id="useraccounts">
719 swift 1.1 <title>Optional: User Accounts</title>
720     <body>
721    
722     <p>
723     If you plan on giving other people access to your installation
724     environment or you want to chat using <c>irssi</c> without root privileges (for
725     security reasons), you need to create the necessary user accounts and change
726     the root password.
727     </p>
728    
729     <p>
730     To change the root password, use the <c>passwd</c> utility:
731     </p>
732    
733     <pre caption="Changing the root password">
734     # <i>passwd</i>
735     New password: <comment>(Enter your new password)</comment>
736     Re-enter password: <comment>(Re-enter your password)</comment>
737     </pre>
738    
739     <p>
740 swift 1.5 To create a user account, we first enter their credentials, followed by
741 swift 1.1 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
742     In the next example, we create a user called &quot;john&quot;.
743     </p>
744    
745     <pre caption="Creating a user account">
746 swift 1.30 # <i>useradd -m -G users john</i>
747 swift 1.1 # <i>passwd john</i>
748     New password: <comment>(Enter john's password)</comment>
749     Re-enter password: <comment>(Re-enter john's password)</comment>
750     </pre>
751    
752     <p>
753     You can change your user id from root to the newly created user by using
754     <c>su</c>:
755     </p>
756    
757     <pre caption="Changing user id">
758 swift 1.26 # <i>su - john</i>
759 swift 1.1 </pre>
760    
761     </body>
762     </subsection>
763     <subsection>
764 swift 1.20 <title>Optional: Viewing Documentation while Installing</title>
765     <body>
766    
767     <p>
768     If you want to view the Gentoo Handbook (either from-CD or online) during the
769     installation, make sure you have created a user account (see <uri
770 neysx 1.31 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
771 swift 1.20 go to a new terminal and log in.
772     </p>
773    
774     <p>
775     If you want to view the documentation on the CD you can immediately run
776     <c>links2</c> to read it:
777     </p>
778    
779     <pre caption="Viewing the on-CD documentation">
780 neysx 1.47 # <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
781 swift 1.20 </pre>
782    
783     <p>
784     However, it is preferred that you use the online Gentoo Handbook as it will be
785     more recent than the one provided on the CD. You can view it using <c>links2</c>
786     as well, but only after having completed the <e>Configuring your Network</e>
787     chapter (otherwise you won't be able to go on the Internet to view the
788     document):
789     </p>
790    
791     <pre caption="Viewing the Online Documentation">
792     # <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
793     </pre>
794    
795     <p>
796     You can go back to your original terminal by pressing <c>Alt-F1</c>.
797     </p>
798    
799     </body>
800     </subsection>
801     <subsection>
802 swift 1.1 <title>Optional: Starting the SSH Daemon</title>
803     <body>
804    
805     <p>
806     If you want to allow other users to access your computer during the
807     Gentoo installation (perhaps because those users are going to help you
808     install Gentoo, or even do it for you), you need to create a user
809     account for them and perhaps even provide them with your root password
810     (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
811     </p>
812    
813     <p>
814     To fire up the SSH daemon, execute the following command:
815     </p>
816    
817     <pre caption="Starting the SSH daemon">
818     # <i>/etc/init.d/sshd start</i>
819     </pre>
820    
821     <p>
822 swift 1.28 To be able to use sshd, you first need to set up your networking. Continue with
823 swift 1.1 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
824     </p>
825    
826     </body>
827     </subsection>
828     </section>
829     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20