/[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.53 - (hide annotations) (download) (as text)
Tue Jul 25 18:01:45 2006 UTC (8 years, 1 month ago) by josejx
Branch: MAIN
Changes since 1.52: +18 -8 lines
File MIME type: application/xml
Added note that MacOS is MacOS 9 or earlier.  Added example for boot arguments.  Added note about OldWorld partitioning.

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 josejx 1.53 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-medium.xml,v 1.52 2006/02/27 00:55:34 fox2mike Exp $ -->
8 swift 1.1
9     <sections>
10 swift 1.32
11 josejx 1.53 <version>2.10</version>
12     <date>2006-07-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 fox2mike 1.52 Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
75     for help with some common installation related issues or if you're unsure as to
76     just what's in that PowerPC machine you've got sitting on your desk right now.
77 swift 1.1 </p>
78    
79     </body>
80     </subsection>
81     </section>
82 swift 1.35 <!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) -->
83     <!-- START -->
84 swift 1.1 <section>
85 swift 1.39 <title>The Gentoo Installation CDs</title>
86 swift 1.1 <subsection>
87 swift 1.35 <title>Introduction</title>
88 swift 1.1 <body>
89    
90     <p>
91 swift 1.39 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
92 swift 1.1 self-sustained Gentoo environment. They allow you to boot Linux from the CD.
93     During the boot process your hardware is detected and the appropriate drivers
94     are loaded. They are maintained by Gentoo developers.
95     </p>
96    
97     <p>
98 swift 1.39 All Installation CDs allow you to boot, set up networking, initialize your
99 swift 1.35 partitions and start installing Gentoo from the Internet. We currently provide
100 swift 1.39 two Installation CDs which are equaly suitable to install Gentoo from, as long
101     as you're planning on performing an Internet-based installation using the
102     latest version of the available packages.
103 swift 1.35 </p>
104    
105     <p>
106 swift 1.36 If you wish to install Gentoo without a working Internet connection, please use
107 swift 1.35 the installation instructions described in the <uri
108 fox2mike 1.52 link="2006.0/index.xml">Gentoo 2006.0 Handbooks</uri>.
109 swift 1.1 </p>
110    
111     <p>
112 swift 1.39 The two Installation CDs that we currently provide are:
113 swift 1.35 </p>
114    
115     <ul>
116     <li>
117 swift 1.39 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
118     CD which sole purpose is to boot the system, prepare the networking and
119     continue with the Gentoo installation.
120 swift 1.35 </li>
121     <li>
122 swift 1.39 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
123 swift 1.49 abilities as the Minimal Installation CD. Additionally, it contains
124     several stage3 tarballs (optimized for the individual subarchitectures).
125 swift 1.35 </li>
126     </ul>
127    
128     <p>
129 swift 1.39 To help you decide which Installation CD you need, we have written down the
130     major advantages and disadvantages of each Installation CD.
131 swift 1.1 </p>
132    
133     </body>
134     </subsection>
135     <subsection>
136 swift 1.39 <title>Gentoo's Minimal Installation CD</title>
137 swift 1.1 <body>
138    
139     <p>
140 fox2mike 1.52 The Minimal Installation CD is called <c>install-ppc-minimal-2006.0.iso</c> and
141 swift 1.39 takes up only 52 MB of diskspace. You can use this Installation CD to install
142     Gentoo, but always with a working Internet connection only.
143 swift 1.1 </p>
144    
145     <table>
146     <tr>
147 swift 1.39 <th>Minimal Installation CD</th>
148 swift 1.1 <th>Pros and Cons</th>
149     </tr>
150     <tr>
151     <th>+</th>
152     <ti>Smallest download</ti>
153     </tr>
154     <tr>
155     <th>-</th>
156     <ti>
157 swift 1.49 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
158 swift 1.35 therefore not suitable for networkless installation
159 swift 1.1 </ti>
160     </tr>
161     </table>
162    
163     </body>
164     </subsection>
165     <subsection>
166 swift 1.39 <title>Gentoo's Universal Installation CD</title>
167 swift 1.1 <body>
168    
169     <p>
170 fox2mike 1.52 The Universal Installation CD is called <c>install-ppc-universal-2006.0.iso</c>
171     and consumes about 578 MB on a CD. You can use this Installation CD to install
172     Gentoo, and you can even use it to install Gentoo without a working internet
173     connection, just in case you want to bring Gentoo to another PC than the one
174     you are currently installing Gentoo on :)
175 swift 1.11 </p>
176    
177 swift 1.1 <table>
178     <tr>
179 swift 1.39 <th>Universal Installation CD</th>
180 swift 1.1 <th>Pros and Cons</th>
181     </tr>
182     <tr>
183     <th>+</th>
184     <ti>
185     Contains everything you need. You can even install without a network
186     connection.
187     </ti>
188     </tr>
189     <tr>
190     <th>-</th>
191     <ti>Huge download</ti>
192     </tr>
193     </table>
194    
195     </body>
196     </subsection>
197 swift 1.35 <subsection>
198     <title>Other CDs</title>
199     <body>
200    
201     <p>
202 neysx 1.50 You might find a <e>Package CD</e> on one of our mirrors. This CD is not an
203     Installation CD but an additional resource that can be exploited during a
204     networkless installation. It contains prebuilt packages (also known as the GRP
205     set) that allow you to easily and quickly install additional applications (such
206     as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless Gentoo
207     installation.
208 swift 1.35 </p>
209    
210 swift 1.48 <p>
211     If you intend to use the Packages CD to quickly install additional software,
212 swift 1.49 make sure that you use the same subarchitecture as the stage3 tarball you use.
213     </p>
214    
215     </body>
216     </subsection>
217     <subsection>
218     <title>The Stage3 Tarball</title>
219     <body>
220    
221     <p>
222     A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
223     to continue the Gentoo installation using the instructions in this manual.
224     Previously, the Gentoo Handbook described the installation using one of three
225     stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
226     official installation method uses the stage3 tarball. If you are interested in
227     performing a Gentoo installation using a stage1 or stage2 tarball, please read
228     the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
229     Using a Stage1 or Stage2 Tarball?</uri>
230 swift 1.48 </p>
231    
232 swift 1.35 </body>
233     </subsection>
234 swift 1.1 </section>
235 swift 1.35 <!-- STOP -->
236 swift 1.1 <section>
237 swift 1.39 <title>Download, Burn and Boot a Gentoo Installation CD</title>
238 swift 1.1 <subsection>
239 swift 1.39 <title>Downloading and Burning the Installation CDs</title>
240 swift 1.1 <body>
241    
242     <p>
243 swift 1.39 You have chosen to use a Gentoo Installation CD. We'll first start by
244     downloading and burning the chosen Installation CD. We previously discussed
245     the several available Installation CDs, but where can you find them?
246 swift 1.35 </p>
247    
248     <p>
249 swift 1.39 You can download any of the Installation CDs (and, if you want to, a Packages
250     CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
251 fox2mike 1.52 Installation CDs are located in the <path>releases/ppc/2006.0/ppc32/installcd</path>
252 swift 1.39 directory.
253 swift 1.1 </p>
254    
255     <p>
256 neysx 1.50 Inside that directory you'll find ISO-files. Those are full CD images which you
257     can write on a CD-R.
258 swift 1.1 </p>
259    
260     <p>
261     In case you wonder if your downloaded file is corrupted or not, you can
262     check its MD5 checksum and compare it with the MD5 checksum we provide (such as
263 fox2mike 1.52 <path>install-ppc-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 checksum
264 swift 1.45 with the <c>md5sum</c> tool under Linux/Unix or
265     <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. If
266     <c>md5sum</c> is not available on Mac OS X, see the
267     <uri link="/doc/en/gentoo-ppc-faq.xml#doc_chap1">Gentoo PPC FAQ</uri> for help.
268 swift 1.1 </p>
269    
270     <p>
271 swift 1.35 Another way to check the validity of the downloaded file is to use GnuPG to
272     verify the cryptographic signature that we provide (the file ending with
273     <path>.asc</path>). Download the signature file and obtain the public key:
274 swift 1.12 </p>
275    
276 swift 1.35 <pre caption="Obtaining the public key">
277 jkt 1.51 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
278 swift 1.12 </pre>
279    
280     <p>
281 swift 1.35 Now verify the signature:
282 swift 1.12 </p>
283    
284 swift 1.35 <pre caption="Verify the cryptographic signature">
285     $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
286     </pre>
287 swift 1.12
288     <p>
289 swift 1.1 To burn the downloaded ISO(s), you have to select raw-burning. How you
290 swift 1.35 do this is highly program-dependent. We will discuss <c>cdrecord</c> and
291     <c>K3B</c> here; more information can be found in our <uri
292     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
293 swift 1.1 </p>
294    
295     <ul>
296     <li>
297 swift 1.35 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
298     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
299 swift 1.37 device path).
300 swift 1.1 </li>
301     <li>
302 swift 1.35 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
303 bennyc 1.6 you can locate your ISO file within the 'Image to Burn' area. Finally click
304 swift 1.3 <c>Start</c>.
305     </li>
306 swift 1.1 </ul>
307    
308     </body>
309     </subsection>
310     <subsection>
311 josejx 1.41 <title>Default: Booting the Installation CD with Yaboot</title>
312 swift 1.1 <body>
313    
314     <p>
315 swift 1.39 On NewWorld machines place the Installation CD in the CD-ROM and reboot the
316     system. When the system-start-bell sounds, simply hold down the 'C' until the
317     CD loads.
318 dertobi123 1.17 </p>
319    
320     <p>
321 swift 1.39 After the Installation CD loaded, you will be greeted by a friendly welcome
322     message and a <e>boot:</e> prompt at the bottom of the screen.
323 swift 1.1 </p>
324    
325     <p>
326 fox2mike 1.52 We provide one generic kernel, <e>ppc32</e>. This kernel is built with support
327     for multiple CPUs, but it will boot on single processor machines as well.
328 swift 1.1 </p>
329    
330     <p>
331 fox2mike 1.52 You can tweak some kernel options at this prompt. The following table lists
332     some of the available boot options you can add:
333 swift 1.1 </p>
334    
335     <table>
336     <tr>
337     <th>Boot Option</th>
338     <th>Description</th>
339     </tr>
340     <tr>
341     <ti><c>video</c></ti>
342     <ti>
343     This option takes one of the following vendor-specific tags:
344 fox2mike 1.52 <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>,
345     <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution
346     refresh rate and color depth you want to use. For instance,
347     <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
348     at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
349     32 bits. If you are uncertain what to choose, and the default doesn't work,
350     <c>video=ofonly</c> will most certainly work.
351 swift 1.1 </ti>
352     </tr>
353     <tr>
354 pylon 1.2 <ti><c>nol3</c></ti>
355 swift 1.1 <ti>
356 dertobi123 1.17 Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
357 swift 1.1 </ti>
358     </tr>
359     <tr>
360 swift 1.39 <ti><c>dofirewire</c></ti>
361 swift 1.1 <ti>
362 swift 1.39 Enables support for IEEE1394 (FireWire) devices, like external harddisks.
363 swift 1.1 </ti>
364     </tr>
365 swift 1.7 <tr>
366 swift 1.39 <ti><c>dopcmcia</c></ti>
367 swift 1.7 <ti>
368 swift 1.39 If you want to use PCMCIA devices during your installation (like PCMCIA
369     network cards) you have to enable this option.
370 swift 1.7 </ti>
371     </tr>
372 swift 1.1 </table>
373    
374     <p>
375 josejx 1.53 To use the above options, at the <e>boot:</e> prompt, type <e>ppc32</e> followed
376     by the desired option. In the example below, we'll force the kernel to use the
377     OpenFirmware framebuffer instead of the device specific driver.
378     </p>
379    
380     <pre caption="Force the use of the OpenFirmware framebuffer">
381     boot: <i>ppc32 video=ofonly</i>
382     </pre>
383    
384     <p>
385     If you don't need to add any options, just hit enter at this prompt, and a
386     complete Gentoo Linux environment will be loaded from the CD. Continue with
387     <uri link="#booted">And When You're Booted...</uri>.
388 swift 1.1 </p>
389    
390 swift 1.7 </body>
391     </subsection>
392     <subsection>
393 swift 1.39 <title>Alternative: Booting the Installation CD on a Pegasos</title>
394 swift 1.7 <body>
395    
396 swift 1.1 <p>
397 swift 1.7 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
398 swift 1.39 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
399     between several preconfigured video configs. If you need any special boot
400 fox2mike 1.52 options you can append them to the command-line just like with Yaboot above.
401     For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
402     The default kernel options (in case something goes wrong and you need it) are
403     preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
404     looptype=squashfs loop=/image.squashfs udev nodevfs cdroot root=/dev/ram0</c>.
405 swift 1.1 </p>
406    
407 swift 1.7 </body>
408     </subsection>
409 josejx 1.41
410     <subsection>
411     <title>Alternative: Booting the Installation CD with BootX</title>
412     <body>
413    
414     <p>
415     If you have an OldWorld Mac the bootable portion of the livecd can't be used.
416 josejx 1.53 The most simple solution is to use MacOS 9 or earlier to bootstrap into a Linux
417     environment with a tool called BootX.
418 josejx 1.41 </p>
419 swift 1.45
420 josejx 1.41 <p>
421     First, download <uri link="http://penguinppc.org/projects/bootx/">BootX</uri>
422     and unpack the archive. Copy the the <c>BootX Extension</c> from the unpacked
423     archive into <c>Extensions Folder</c> and the BootX App Control Panel into
424     <c>Control Panels</c>, both of which are located in your MacOS System Folder.
425 josejx 1.42 Next, create a folder called "Linux Kernels" in your System folder and copy the
426 fox2mike 1.52 <c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c>
427 josejx 1.42 from the Installation CD <path>boot</path> folder into the MacOS
428     <c>System Folder</c>.
429 josejx 1.41 </p>
430 swift 1.45
431 josejx 1.41 <p>
432     To prepare BootX, start the BootX App Control Panel. First select the Options
433 fox2mike 1.52 dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from
434 josejx 1.41 your System Folder. Continue back to the initial screen and ensure that the
435     ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
436     shown below:
437     </p>
438    
439     <pre caption="BootX kernel arguments">
440 fox2mike 1.52 cdroot root=/dev/ram0 init=linuxrc loop=image.squashfs looptype=squashfs console=tty0 nodevfs udev
441 josejx 1.41 </pre>
442 swift 1.45
443 josejx 1.41 <note>
444 fox2mike 1.52 The kernel parameters in the yaboot section above are also applicable here. You
445     can append any of those options to the kernel arguments above.
446 josejx 1.41 </note>
447 swift 1.45
448 josejx 1.41 <p>
449     Check once more to make sure the settings are correct and then save the
450     configuration. This saves typing just in case it doesn't boot or something is
451 fox2mike 1.52 missing. Press the Linux button at the top of the window. If everything goes
452     correctly, it should boot into the Installation CD. Continue with
453     <uri link="#booted">And When You're Booted...</uri>
454 josejx 1.41 </p>
455 swift 1.45
456 josejx 1.41 </body>
457     </subsection>
458    
459 swift 1.7 <subsection id="booted">
460     <title>And When You're Booted...</title>
461     <body>
462 swift 1.1
463     <p>
464 swift 1.7 You will be greeted by a root ("#") prompt on the current console. You can also
465 swift 1.39 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get
466 fox2mike 1.52 back to the one you started on by pressing Alt-F1. Due to the keyboard layout,
467     you may need to press Alt-fn-Fx on Apple machines.
468 swift 1.1 </p>
469    
470     <p>
471     If you are installing Gentoo on a system with a non-US keyboard, use
472     <c>loadkeys</c> to load the keymap for your keyboard. To list the available
473 swift 1.39 keymaps, execute <c>ls /usr/share/keymaps/i386</c>. On NewWorld machines or the
474     Pegasos do not use the keymaps in <path>ppc</path> or <path>mac</path> as they
475     are for ADB-based OldWorld machines.
476 swift 1.1 </p>
477    
478     <pre caption="Listing available keymaps">
479     <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
480 swift 1.39 on the Installation CD are ADB keymaps and unusable with the Installation CD
481     kernel)</comment>
482 swift 1.1 # <i>ls /usr/share/keymaps/i386</i>
483     </pre>
484    
485     <p>
486     Now load the keymap of your choice:
487     </p>
488    
489     <pre caption="Loading a keymap">
490 swift 1.7 # <i>loadkeys be-latin1</i>
491 swift 1.1 </pre>
492    
493     <p>
494     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
495     </p>
496    
497     </body>
498     </subsection>
499     <subsection id="hardware">
500     <title>Extra Hardware Configuration</title>
501     <body>
502    
503     <p>
504 swift 1.39 When the Installation CD boots, it tries to detect all your hardware devices and
505 swift 1.1 loads the appropriate kernel modules to support your hardware. In the
506 dertobi123 1.17 vast majority of cases, it does a very good job. However, in some cases, it may
507     not auto-load the kernel modules you need. If the PCI auto-detection missed some
508     of your system's hardware, you will have to load the appropriate kernel modules
509     manually.
510 swift 1.1 </p>
511 fox2mike 1.52
512     <p>
513     In the next example we try to load the <c>airport</c> module. This module
514     supports only the old Airport cards (802.11b). Airport Extreme (802.11g) is not
515     supported on the InstallCD due to restrictions on firmware distribution.
516     </p>
517    
518     <pre caption="Loading the airport module">
519     # <i>modprobe airport</i>
520     </pre>
521    
522 swift 1.1 <p>
523 fox2mike 1.52 On older iMacs, sometimes the network card is not detected properly. These use
524     the BMAC driver:
525 swift 1.1 </p>
526    
527 fox2mike 1.52 <pre caption="Loading the bmac module">
528     # <i>modprobe bmac</i>
529 swift 1.1 </pre>
530    
531     </body>
532     </subsection>
533     <subsection>
534     <title>Optional: Tweaking Hard Disk Performance</title>
535     <body>
536    
537     <p>
538     If you are an advanced user, you might want to tweak the IDE hard disk
539     performance using <c>hdparm</c>. With the <c>-tT</c> options you can
540     test the performance of your disk (execute it several times to get a
541     more precise impression):
542     </p>
543    
544     <pre caption="Testing disk performance">
545     # <i>hdparm -tT /dev/hda</i>
546     </pre>
547    
548     <p>
549     To tweak, you can use any of the following examples (or experiment
550     yourself) which use <path>/dev/hda</path> as disk (substitute with your
551     disk):
552     </p>
553    
554     <pre caption="Tweaking hard disk performance">
555     <comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
556     <comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
557     </pre>
558    
559     </body>
560     </subsection>
561 swift 1.20 <subsection id="useraccounts">
562 swift 1.1 <title>Optional: User Accounts</title>
563     <body>
564    
565     <p>
566     If you plan on giving other people access to your installation
567     environment or you want to chat using <c>irssi</c> without root privileges (for
568     security reasons), you need to create the necessary user accounts and change
569     the root password.
570     </p>
571    
572     <p>
573     To change the root password, use the <c>passwd</c> utility:
574     </p>
575    
576     <pre caption="Changing the root password">
577     # <i>passwd</i>
578     New password: <comment>(Enter your new password)</comment>
579     Re-enter password: <comment>(Re-enter your password)</comment>
580     </pre>
581    
582     <p>
583 swift 1.5 To create a user account, we first enter their credentials, followed by
584 swift 1.1 its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
585     In the next example, we create a user called &quot;john&quot;.
586     </p>
587    
588     <pre caption="Creating a user account">
589 swift 1.30 # <i>useradd -m -G users john</i>
590 swift 1.1 # <i>passwd john</i>
591     New password: <comment>(Enter john's password)</comment>
592     Re-enter password: <comment>(Re-enter john's password)</comment>
593     </pre>
594    
595     <p>
596     You can change your user id from root to the newly created user by using
597     <c>su</c>:
598     </p>
599    
600     <pre caption="Changing user id">
601 swift 1.26 # <i>su - john</i>
602 swift 1.1 </pre>
603    
604     </body>
605     </subsection>
606     <subsection>
607 swift 1.20 <title>Optional: Viewing Documentation while Installing</title>
608     <body>
609    
610     <p>
611     If you want to view the Gentoo Handbook (either from-CD or online) during the
612     installation, make sure you have created a user account (see <uri
613 neysx 1.31 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
614 swift 1.20 go to a new terminal and log in.
615     </p>
616    
617     <p>
618     If you want to view the documentation on the CD you can immediately run
619 fox2mike 1.52 <c>links</c> to read it:
620 swift 1.20 </p>
621    
622     <pre caption="Viewing the on-CD documentation">
623 fox2mike 1.52 # <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
624 swift 1.20 </pre>
625    
626     <p>
627     However, it is preferred that you use the online Gentoo Handbook as it will be
628 fox2mike 1.52 more recent than the one provided on the CD. You can view it using <c>links</c>
629 swift 1.20 as well, but only after having completed the <e>Configuring your Network</e>
630     chapter (otherwise you won't be able to go on the Internet to view the
631     document):
632     </p>
633    
634     <pre caption="Viewing the Online Documentation">
635 fox2mike 1.52 # <i>links http://www.gentoo.org/doc/en/handbook/handbook-ppc.xml</i>
636 swift 1.20 </pre>
637    
638     <p>
639     You can go back to your original terminal by pressing <c>Alt-F1</c>.
640     </p>
641    
642     </body>
643     </subsection>
644     <subsection>
645 swift 1.1 <title>Optional: Starting the SSH Daemon</title>
646     <body>
647    
648     <p>
649     If you want to allow other users to access your computer during the
650     Gentoo installation (perhaps because those users are going to help you
651     install Gentoo, or even do it for you), you need to create a user
652     account for them and perhaps even provide them with your root password
653     (<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
654     </p>
655    
656     <p>
657     To fire up the SSH daemon, execute the following command:
658     </p>
659    
660     <pre caption="Starting the SSH daemon">
661     # <i>/etc/init.d/sshd start</i>
662     </pre>
663    
664     <p>
665 swift 1.28 To be able to use sshd, you first need to set up your networking. Continue with
666 swift 1.1 the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
667     </p>
668    
669     </body>
670     </subsection>
671     </section>
672     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20