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

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/2.5 -->
6
7 <!-- $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
9 <sections>
10
11 <version>2.6</version>
12 <date>2005-10-09</date>
13
14 <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 successfully install Gentoo on your box.
23 </p>
24
25 </body>
26 </subsection>
27 <subsection>
28 <title>Hardware Requirements</title>
29 <body>
30
31 <table>
32 <tr>
33 <th>Apple NewWorld Machines</th>
34 <ti>
35 Power/PowerPC microprocessors (G3, G4, G5) such as iMac, eMac, iBook
36 PowerBook, Xserver, PowerMac
37 </ti>
38 </tr>
39 <tr>
40 <th>Apple OldWorld machines</th>
41 <ti>
42 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 </ti>
58 </tr>
59 <tr>
60 <th>Memory</th>
61 <ti>At least 64 MB</ti>
62 </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 <p>
74 Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo
75 PPC FAQ</uri> before you begin.
76 </p>
77
78 </body>
79 </subsection>
80 </section>
81 <!-- Copy/paste from hb-install-x86-medium.xml (with s/x86/ppc/) -->
82 <!-- START -->
83 <section>
84 <title>The Gentoo Installation Approaches</title>
85 <subsection>
86 <title>Introduction</title>
87 <body>
88
89 <p>
90 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 </p>
94
95 <ul>
96 <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 </ul>
112
113 <p>
114 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 </p>
117
118 </body>
119 </subsection>
120 <subsection>
121 <title>A Stage1 Approach</title>
122 <body>
123
124 <p>
125 A <e>stage1</e> is used when you want to bootstrap and build the entire system
126 from scratch.
127 </p>
128
129 <p>
130 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 </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 Allows you to have total control over the installation routine, bootstrap
151 sequence, etc.
152 </ti>
153 </tr>
154 <tr>
155 <th>+</th>
156 <ti>Suitable for powerusers and developers who know what they are doing</ti>
157 </tr>
158 <tr>
159 <th>-</th>
160 <ti>
161 Takes a long time to finish the installation (it is the lengthiest approach)
162 </ti>
163 </tr>
164 <tr>
165 <th>-</th>
166 <ti>
167 If you don't intend to tweak the settings, it is a waste of time
168 </ti>
169 </tr>
170 <tr>
171 <th>-</th>
172 <ti>
173 Requires a working Internet connection during the installation
174 </ti>
175 </tr>
176 </table>
177
178 </body>
179 </subsection>
180 <subsection>
181 <title>A Stage2 Approach</title>
182 <body>
183
184 <p>
185 A <e>stage2</e> is used for building the entire system from a bootstrapped
186 "semi-compiled" state.
187 </p>
188
189 <p>
190 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 </p>
202
203 <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 <ti>It's still not the fastest way to install Gentoo</ti>
223 </tr>
224 <tr>
225 <th>-</th>
226 <ti>
227 Requires a working Internet connection during the installation
228 </ti>
229 </tr>
230 </table>
231
232 </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 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 </p>
244
245 <p>
246 Choosing to go with a stage3 allows for the fastest install of Gentoo
247 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 stability). Stage3 is also required if you want to install Gentoo using
251 prebuilt packages or without a network connection.
252 </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 <th>+</th>
265 <ti>
266 You can still tweak your system
267 </ti>
268 </tr>
269 </table>
270
271 <p>
272 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 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 </p>
278
279 </body>
280 </subsection>
281 </section>
282
283 <section>
284 <title>The Gentoo Installation CDs</title>
285 <subsection>
286 <title>Introduction</title>
287 <body>
288
289 <p>
290 The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
291 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 All Installation CDs allow you to boot, set up networking, initialize your
298 partitions and start installing Gentoo from the Internet. We currently provide
299 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 </p>
303
304 <p>
305 If you wish to install Gentoo without a working Internet connection, please use
306 the installation instructions described in the <uri
307 link="2005.1/index.xml">Gentoo 2005.1 Handbooks</uri>.
308 </p>
309
310 <p>
311 The two Installation CDs that we currently provide are:
312 </p>
313
314 <ul>
315 <li>
316 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 </li>
320 <li>
321 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 </li>
326 </ul>
327
328 <p>
329 To help you decide which Installation CD you need, we have written down the
330 major advantages and disadvantages of each Installation CD.
331 </p>
332
333 </body>
334 </subsection>
335 <subsection>
336 <title>Gentoo's Minimal Installation CD</title>
337 <body>
338
339 <p>
340 The Minimal Installation CD is called <c>install-ppc-minimal-2005.1.iso</c> and
341 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 </p>
344
345 <table>
346 <tr>
347 <th>Minimal Installation CD</th>
348 <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 Contains no stages, no Portage snapshot, no prebuilt packages and is
365 therefore not suitable for networkless installation
366 </ti>
367 </tr>
368 </table>
369
370 </body>
371 </subsection>
372 <subsection>
373 <title>Gentoo's Universal Installation CD</title>
374 <body>
375
376 <p>
377 The Universal Installation CD is called <c>install-ppc-universal-2005.1.iso</c>
378 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 </p>
383
384 <table>
385 <tr>
386 <th>Universal Installation CD</th>
387 <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 <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 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 </p>
416
417 <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 </body>
423 </subsection>
424 </section>
425 <!-- STOP -->
426 <section>
427 <title>Download, Burn and Boot a Gentoo Installation CD</title>
428 <subsection>
429 <title>Downloading and Burning the Installation CDs</title>
430 <body>
431
432 <p>
433 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 </p>
437
438 <p>
439 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 Installation CDs are located in the <path>releases/ppc/2005.1/installcd</path>
442 directory.
443 </p>
444
445 <p>
446 Inside that directory you'll find so-called ISO-files. Those are full CD images
447 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 <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 </p>
459
460 <p>
461 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 </p>
465
466 <pre caption="Obtaining the public key">
467 $ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i>
468 </pre>
469
470 <p>
471 Now verify the signature:
472 </p>
473
474 <pre caption="Verify the cryptographic signature">
475 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
476 </pre>
477
478 <p>
479 To burn the downloaded ISO(s), you have to select raw-burning. How you
480 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 </p>
484
485 <ul>
486 <li>
487 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 device path).
490 </li>
491 <li>
492 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
493 you can locate your ISO file within the 'Image to Burn' area. Finally click
494 <c>Start</c>.
495 </li>
496 </ul>
497
498 </body>
499 </subsection>
500 <subsection>
501 <title>Default: Booting the Installation CD with Yaboot</title>
502 <body>
503
504 <p>
505 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 </p>
509
510 <p>
511 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 </p>
514
515 <p>
516 At this prompt you are able to select a kernel for the subarchitecture you use.
517 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 </p>
521
522 <p>
523 You are also able to tweak some kernel options at this prompt. The following
524 table lists some of the available boot options you can add:
525 </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 <ti><c>nol3</c></ti>
544 <ti>
545 Disables level 3 cache on some PowerBooks (needed for at least the 17&quot;)
546 </ti>
547 </tr>
548 <tr>
549 <ti><c>dofirewire</c></ti>
550 <ti>
551 Enables support for IEEE1394 (FireWire) devices, like external harddisks.
552 </ti>
553 </tr>
554 <tr>
555 <ti><c>dopcmcia</c></ti>
556 <ti>
557 If you want to use PCMCIA devices during your installation (like PCMCIA
558 network cards) you have to enable this option.
559 </ti>
560 </tr>
561 </table>
562
563 <p>
564 At this prompt, hit enter, and a complete Gentoo Linux environment will be
565 loaded from the CD. Continue with <uri link="#booted">And When You're
566 Booted...</uri>.
567 </p>
568
569 </body>
570 </subsection>
571 <subsection>
572 <title>Alternative: Booting the Installation CD on a Pegasos</title>
573 <body>
574
575 <p>
576 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
577 <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 </p>
585
586 </body>
587 </subsection>
588
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
600 <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 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 </p>
610
611 <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
623 <note>
624 The kernel parameters in the yaboot section above are also applicable here.
625 </note>
626
627 <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 Installation CD and continue with <uri link="#booted">And When
632 You're Booted...</uri>
633 </p>
634
635 </body>
636 </subsection>
637
638 <subsection id="booted">
639 <title>And When You're Booted...</title>
640 <body>
641
642 <p>
643 You will be greeted by a root ("#") prompt on the current console. You can also
644 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 </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 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 </p>
656
657 <pre caption="Listing available keymaps">
658 <comment>(PPC uses x86 keymaps on most systems. The mac/ppc keymaps provided
659 on the Installation CD are ADB keymaps and unusable with the Installation CD
660 kernel)</comment>
661 # <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 # <i>loadkeys be-latin1</i>
670 </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 When the Installation CD boots, it tries to detect all your hardware devices and
684 loads the appropriate kernel modules to support your hardware. In the
685 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 </p>
690
691 <p>
692 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 </p>
696
697 <pre caption="Loading kernel modules">
698 # <i>modprobe airport</i>
699 </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 <subsection id="useraccounts">
732 <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 To create a user account, we first enter their credentials, followed by
754 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 # <i>useradd -m -G users john</i>
760 # <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 # <i>su - john</i>
772 </pre>
773
774 </body>
775 </subsection>
776 <subsection>
777 <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 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
784 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 # <i>links2 /mnt/cdrom/docs/handbook/html/index.html</i>
794 </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 <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 To be able to use sshd, you first need to set up your networking. Continue with
836 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