/[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.36 - (hide annotations) (download) (as text)
Mon Feb 14 15:51:45 2005 UTC (9 years, 6 months ago) by swift
Branch: MAIN
Changes since 1.35: +2 -2 lines
File MIME type: application/xml
#81843 - Fix typo whish - wish

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

  ViewVC Help
Powered by ViewVC 1.1.20