/[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.48 - (hide annotations) (download) (as text)
Sun Oct 9 16:33:54 2005 UTC (9 years, 8 months ago) by swift
Branch: MAIN
Changes since 1.47: +46 -33 lines
File MIME type: application/xml
#105809 - Stage* description updates

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

  ViewVC Help
Powered by ViewVC 1.1.20