Gentoo Archives: gentoo-doc-cvs

From: Xavier Neys <neysx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: handbook-amd64.xml handbook-x86.xml hb-install-amd64-medium.xml hb-install-gli-medium.xml hb-install-x86-medium.xml
Date: Sat, 12 Aug 2006 22:15:33
Message-Id: 20060812221512.43DA8646B3@smtp.gentoo.org
1 neysx 06/08/12 22:15:11
2
3 Modified: handbook-amd64.xml handbook-x86.xml
4 Added: hb-install-gli-medium.xml
5 Removed: hb-install-amd64-medium.xml
6 hb-install-x86-medium.xml
7 Log:
8 No point keeping two ~identical files
9
10 Revision Changes Path
11 1.3 xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml
12
13 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml?rev=1.3&view=markup
14 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml?rev=1.3&content-type=text/plain
15 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml?r1=1.2&r2=1.3
16
17 Index: handbook-amd64.xml
18 ===================================================================
19 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml,v
20 retrieving revision 1.2
21 retrieving revision 1.3
22 diff -u -r1.2 -r1.3
23 --- handbook-amd64.xml 12 Aug 2006 21:17:06 -0000 1.2
24 +++ handbook-amd64.xml 12 Aug 2006 22:15:11 -0000 1.3
25 @@ -1,10 +1,16 @@
26 <?xml version='1.0' encoding='UTF-8'?>
27 <!DOCTYPE book SYSTEM "/dtd/book.dtd">
28
29 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml,v 1.2 2006/08/12 21:17:06 nightmorph Exp $ -->
30 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-amd64.xml,v 1.3 2006/08/12 22:15:11 neysx Exp $ -->
31
32 -<book link="/doc/en/handbook/2006.1/handbook-x86.xml">
33 -<title>Gentoo Linux 2006.1 x86 Handbook</title>
34 +<book link="/doc/en/handbook/2006.1/handbook-amd64.xml">
35 +<title>Gentoo Linux 2006.1 AMD64 Handbook</title>
36 +
37 +<values>
38 + <key id="arch">AMD64</key>
39 + <key id="release-dir">releases/amd64/2006.1/</key>
40 + <key id="online-book">2006.1/handbook-amd64.xml</key>
41 +</values>
42
43 <author title="Author">
44 <mail link="swift@g.o">Sven Vermeulen</mail>
45 @@ -142,7 +148,7 @@
46 <title>About the Gentoo Linux Installation</title>
47 <abstract>
48 Users not familiar with Gentoo do not always know that choice is what
49 -Gentoo is all about.
50 +Gentoo is all about.
51 </abstract>
52 <include href="hb-installer-about.xml"/>
53 </chapter>
54 @@ -153,7 +159,7 @@
55 Using our Installer LiveCD you can boot up your system into a running
56 environment that allows you to install Gentoo.
57 </abstract>
58 - <include href="hb-install-amd64-medium.xml"/>
59 + <include href="hb-install-gli-medium.xml"/>
60 </chapter>
61
62 <chapter>
63 @@ -179,7 +185,7 @@
64 <chapter>
65 <title>Where to go from here?</title>
66 <abstract>
67 -Now you have your Gentoo system, but what's next?
68 +Now you have your Gentoo system, but what's next?
69 </abstract>
70 <include href="hb-install-next.xml"/>
71 </chapter>
72 @@ -188,8 +194,8 @@
73 <part>
74 <title>Working with Gentoo</title>
75 <abstract>
76 -Learn how to work with Gentoo: installing software, altering variables, changing
77 -Portage behaviour etc.
78 +Learn how to work with Gentoo: installing software, altering variables,
79 +changing Portage behaviour etc.
80 </abstract>
81
82 <chapter>
83
84
85
86 1.3 xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml
87
88 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml?rev=1.3&view=markup
89 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml?rev=1.3&content-type=text/plain
90 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml?r1=1.2&r2=1.3
91
92 Index: handbook-x86.xml
93 ===================================================================
94 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml,v
95 retrieving revision 1.2
96 retrieving revision 1.3
97 diff -u -r1.2 -r1.3
98 --- handbook-x86.xml 12 Aug 2006 21:18:03 -0000 1.2
99 +++ handbook-x86.xml 12 Aug 2006 22:15:11 -0000 1.3
100 @@ -1,11 +1,17 @@
101 <?xml version='1.0' encoding='UTF-8'?>
102 <!DOCTYPE book SYSTEM "/dtd/book.dtd">
103
104 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml,v 1.2 2006/08/12 21:18:03 nightmorph Exp $ -->
105 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/handbook-x86.xml,v 1.3 2006/08/12 22:15:11 neysx Exp $ -->
106
107 <book link="/doc/en/handbook/2006.1/handbook-x86.xml">
108 <title>Gentoo Linux 2006.1 x86 Handbook</title>
109
110 +<values>
111 + <key id="arch">x86</key>
112 + <key id="release-dir">releases/x86/2006.1/</key>
113 + <key id="online-book">2006.1/handbook-x86.xml</key>
114 +</values>
115 +
116 <author title="Author">
117 <mail link="swift@g.o">Sven Vermeulen</mail>
118 </author>
119 @@ -140,7 +146,7 @@
120 <title>About the Gentoo Linux Installation</title>
121 <abstract>
122 Users not familiar with Gentoo do not always know that choice is what
123 -Gentoo is all about.
124 +Gentoo is all about.
125 </abstract>
126 <include href="hb-installer-about.xml"/>
127 </chapter>
128 @@ -151,7 +157,7 @@
129 Using our Installer LiveCD you can boot up your system into a running
130 environment that allows you to install Gentoo.
131 </abstract>
132 - <include href="hb-install-x86-medium.xml"/>
133 + <include href="hb-install-gli-medium.xml"/>
134 </chapter>
135
136 <chapter>
137 @@ -177,7 +183,7 @@
138 <chapter>
139 <title>Where to go from here?</title>
140 <abstract>
141 -Now you have your Gentoo system, but what's next?
142 +Now you have your Gentoo system, but what's next?
143 </abstract>
144 <include href="hb-install-next.xml"/>
145 </chapter>
146 @@ -186,8 +192,8 @@
147 <part>
148 <title>Working with Gentoo</title>
149 <abstract>
150 -Learn how to work with Gentoo: installing software, altering variables, changing
151 -Portage behaviour etc.
152 +Learn how to work with Gentoo: installing software, altering variables,
153 +changing Portage behaviour etc.
154 </abstract>
155
156 <chapter>
157
158
159
160 1.1 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-medium.xml
161
162 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-medium.xml?rev=1.1&view=markup
163 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-medium.xml?rev=1.1&content-type=text/plain
164
165 Index: hb-install-gli-medium.xml
166 ===================================================================
167 <?xml version='1.0' encoding='UTF-8'?>
168 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
169
170 <!-- The content of this document is licensed under the CC-BY-SA license -->
171 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
172
173 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-gli-medium.xml,v 1.1 2006/08/12 22:15:11 neysx Exp $ -->
174
175 <sections>
176
177 <version>6.0</version>
178 <date>2006-08-12</date>
179
180 <section>
181 <title>Hardware Requirements</title>
182 <subsection>
183 <title>Introduction</title>
184 <body>
185
186 <p>
187 Before we start, we first list what hardware requirements you need to
188 successfully install Gentoo on your box using the Installer LiveCD.
189 </p>
190
191 </body>
192 </subsection>
193 <subsection>
194 <title>Hardware Requirements</title>
195 <body>
196
197 <table>
198 <tr test="func:keyval('arch')='x86'">
199 <th>CPU</th>
200 <ti>i686 or later</ti>
201 </tr>
202 <tr test="func:keyval('arch')='AMD64'">
203 <th>CPU</th>
204 <ti>Any AMD64 or EM64T CPU</ti>
205 </tr>
206 <tr>
207 <th>Memory</th>
208 <ti>128 MB</ti>
209 </tr>
210 <tr>
211 <th>Diskspace</th>
212 <ti>1.5 GB (excluding swap space)</ti>
213 </tr>
214 <tr>
215 <th>Swap space</th>
216 <ti>At least 256 MB</ti>
217 </tr>
218 </table>
219
220
221 </body>
222 </subsection>
223 </section>
224 <!-- General description, propagated to other architectures as well -->
225 <!-- START -->
226 <section>
227 <title>The Gentoo Linux Installer LiveCD</title>
228 <subsection>
229 <title>Introduction</title>
230 <body>
231
232 <p>
233 Gentoo Linux can be installed using a <e>stage3</e> tarball file.
234 Such a tarball is an archive that contains a minimal environment from
235 which you can successfully install Gentoo Linux onto your system.
236 </p>
237
238 <p>
239 Installations using a stage1 or stage2 tarball file are not documented in the
240 Gentoo Handbook - please read the <uri link="/doc/en/faq.xml#stage12">Gentoo
241 FAQ</uri> on these matters.
242 </p>
243
244 </body>
245 </subsection>
246 <subsection>
247 <title>Gentoo Linux Installer LiveCD</title>
248 <body>
249
250 <p>
251 A LiveCD is a bootable medium which contains a self-sustained Gentoo
252 environment. It allows you to boot Linux from the CD. During the boot process
253 your hardware is detected and the appropriate drivers are loaded. The Gentoo
254 Installation CDs are maintained by Gentoo developers.
255 </p>
256
257 <p>
258 There currently are two Installation CDs available:
259 </p>
260
261 <ul>
262 <li>
263 The Installer LiveCD contains everything you need to install Gentoo. It
264 provides a graphical environment, a graphical as well as console based
265 installer which automatically carries out the installation for you, and of
266 course, the installation instructions for your architecture.
267 </li>
268 <li>
269 The Minimal Installation CD contains only a minimal environment that allows
270 you to boot up and configure your network so you can connect to the
271 Internet. It does not contain any additional files and cannot be used
272 during the current installation approach.
273 </li>
274 </ul>
275
276 </body>
277 </subsection>
278 </section>
279 <!-- STOP -->
280 <section>
281 <title>Download, Burn and Boot the Gentoo Linux Installer LiveCD</title>
282 <subsection>
283 <title>Downloading and Burning the Installer LiveCD</title>
284 <body>
285
286 <p>
287 You can download the Installer LiveCDs from one of our <uri
288 link="/main/en/mirrors.xml">mirrors</uri>. They are located in the
289 <path><keyval id="release-dir"/>/livecd</path> directory.
290 </p>
291
292 <p>
293 Inside that directory you'll find an ISO-file. That is a full CD image which
294 you can write on a CD-R.
295 </p>
296
297 <p>
298 After downloading the file, you can verify its integrity to see if it is
299 corrupted or not:
300 </p>
301
302 <ul>
303 <li>
304 You can check its MD5 checksum and compare it with the MD5 checksum we
305 provide (for instance with the <c>md5sum</c> tool under Linux/Unix or <uri
306 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
307 </li>
308 <li>
309 You can verify the cryptographic signature that we provide. You need to
310 obtain the public key we use (17072058) before you proceed though.
311 </li>
312 </ul>
313
314 <p>
315 To fetch our public key using the GnuPG application, run the following command:
316 </p>
317
318 <pre caption="Obtaining the public key">
319 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
320 </pre>
321
322 <p>
323 Now verify the signature:
324 </p>
325
326 <pre caption="Verify the cryptographic signature">
327 $ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
328 </pre>
329
330 <p>
331 To burn the downloaded ISO(s), you have to select raw-burning. How you do this
332 is highly program-dependent. We will discuss <c>cdrecord</c> and <c>K3B</c>
333 here; more information can be found in our <uri
334 link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
335 </p>
336
337 <ul>
338 <li>
339 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
340 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's device
341 path).
342 </li>
343 <li>
344 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then
345 you can locate your ISO file within the 'Image to Burn' area. Finally click
346 <c>Start</c>.
347 </li>
348 </ul>
349
350 </body>
351 </subsection>
352 <subsection>
353 <title>Booting the Installer LiveCD</title>
354 <body>
355
356 <impo>
357 Read this whole subsection before continuing, as you will probably not have the
358 opportunity to read it before doing things later.
359 </impo>
360
361 <p>
362 Once you have burned your LiveCD, it is time to boot it. Remove all CDs from
363 your CD drives, reboot your system and enter the BIOS. This is usually done by
364 hitting DEL, F1 or ESC, depending on your BIOS. Inside the BIOS, change the
365 boot order so that the CD-ROM is tried before the hard disk. This is often
366 found under "CMOS Setup". If you don't do this, your system will just reboot
367 from the hard disk, ignoring the CD-ROM.
368 </p>
369
370 <p>
371 Now place the LiveCD in the CD-ROM drive and reboot. You should see a boot
372 prompt. At this screen, you can hit Enter to begin the boot process with the
373 default boot options, or boot the LiveCD with custom boot options by specifying
374 a kernel followed by boot options and then hitting Enter.
375 </p>
376
377 <p>
378 Specifying a kernel? Yes, we provide several kernels on our LiveCD. The default
379 one is <c>gentoo</c>. Other kernels are for specific hardware needs and the
380 <c>-nofb</c> variants which disable framebuffer.
381 </p>
382
383 <p>
384 Below you'll find a short overview on the available kernels:
385 </p>
386
387 <table>
388 <tr>
389 <th>Kernel</th>
390 <th>Description</th>
391 </tr>
392 <tr test="func:keyval('arch')='x86'">
393 <ti>gentoo</ti>
394 <ti>Default 2.6 kernel with support for multiple CPUs</ti>
395 </tr>
396 <tr test="func:keyval('arch')='x86'">
397 <ti>gentoo-nofb</ti>
398 <ti>Same as <c>gentoo</c> but without framebuffer support</ti>
399 </tr>
400 <tr test="func:keyval('arch')='AMD64'">
401 <ti>gentoo</ti>
402 <ti>
403 Default kernel with support for K8 CPUS (including NUMA support) and EM64T
404 CPUs
405 </ti>
406 </tr>
407 <tr>
408 <ti>memtest86</ti>
409 <ti>Test your local RAM for errors</ti>
410 </tr>
411 </table>
412
413 <p>
414 You can also provide kernel options. They represent optional settings you can
415 (de)activate at will. The following list is the same as the one you receive
416 when you press F2 through F7 at the bootscreen.
417 </p>
418
419 <pre caption="Options available to pass to your kernel of choice">
420 <comment>Hardware options:</comment>
421
422 acpi=on This loads support for ACPI and also causes the acpid daemon to
423 be started by the CD on boot. This is only needed if your
424 system requires ACPI to function properly. This is not
425 required for Hyperthreading support.
426
427 acpi=off Completely disables ACPI. This is useful on some older
428 systems, and is also a requirement for using APM. This will
429 disable any Hyperthreading support of your processor.
430
431 console=X This sets up serial console access for the CD. The first
432 option is the device, usually ttyS0 on x86, followed by any
433 connection options, which are comma separated. The default
434 options are 9600,8,n,1.
435
436 dmraid=X This allows for passing options to the device-mapper RAID
437 subsystem. Options should be encapsulated in quotes.
438
439 doapm This loads APM driver support. This requires you to also use
440 acpi=off.
441
442 dobladecenter This adds some extra pauses into the boot process for the slow
443 USB CDROM of the IBM BladeCenter.
444
445 dopcmcia This loads support for PCMCIA and Cardbus hardware and also
446 causes the pcmcia cardmgr to be started by the CD on boot.
447 This is only required when booting from a PCMCIA/Cardbus device.
448
449 doscsi This loads support for most SCSI controllers. This is also a
450 requirement for booting most USB devices, as they use the SCSI
451 subsystem of the kernel.
452
453 hda=stroke This allows you to partition the whole hard disk even when your
454 BIOS is unable to handle large disks. This option is only used
455 on machines with an older BIOS. Replace hda with the device
456 that is requiring this option.
457
458 ide=nodma This forces the disabling of DMA in the kernel and is required
459 by some IDE chipsets and also by some CDROM drives. If your
460 system is having trouble reading from your IDE CDROM, try this
461 option. This also disables the default hdparm settings from
462 being executed.
463
464 noapic This disables the Advanced Programmable Interrupt Controller
465 that is present on newer motherboards. It has been known to
466 cause some problems on older hardware.
467
468 nodetect This disables all of the autodetection done by the CD,
469 including device autodetection and DHCP probing. This is
470 useful for doing debugging of a failing CD or driver.
471
472 nodhcp This disables DHCP probing on detected network cards. This is
473 useful on networks with only static addresses.
474
475 nodmraid Disables support for device-mapper RAID, such as that used for
476 on-board IDE/SATA RAID controllers.
477
478 nofirewire This disables the loading of Firewire modules. This should only
479 be necessary if your Firewire hardware is causing a problem
480 with booting the CD.
481
482 nogpm This disables gpm console mouse support.
483
484 nohotplug This disables the loading of the hotplug and coldplug init
485 scripts at boot. This is useful for doing debugging of a
486 failing CD or driver.
487
488 nokeymap This disables the keymap selection used to select non-US
489 keyboard layouts.
490
491 nolapic This disables the local APIC on Uniprocessor kernels.
492
493 nosata This disables the loading of Serial ATA modules. This is
494 useful if your system is having problems with the SATA subsystem.
495
496 nosmp This disables SMP, or Symmetric Multiprocessing, on SMP-enabled
497 kernels. This is useful for debugging SMP-related issues with
498 certain drivers and motherboards.
499
500 nosound This disables sound support and volume setting. This is useful
501 for systems where sound support causes problems.
502
503 nousb This disables the autoloading of USB modules. This is useful
504 for debugging USB issues.
505
506 <comment>Volume/Device Management:</comment>
507
508 dodevfs This enables the deprecated device filesystem on 2.6 systems.
509 You will also need to use noudev for this to take effect.
510 Since devfs is the only option with a 2.4 kernel, this option
511 has no effect if booting a 2.4 kernel.
512
513 doevms2 This enables support for IBM's pluggable EVMS, or Enterprise
514 Volume Management System. This is not safe to use with lvm2.
515
516 dolvm2 This enables support for Linux's Logical Volume Management.
517 This is not safe to use with evms2.
518
519 noudev This disables udev support on 2.6 kernels. This option
520 requires that dodevfs is used. Since udev is not an option for
521 2.4 kernels, this options has no effect if booting a 2.4
522 kernel.
523
524 unionfs Enables support for Unionfs on supported CD images. This will
525 create a writable Unionfs overlay in a tmpfs, allowing you to
526 change any file on the CD.
527
528 unionfs=X Enables support for Unionfs on supported CD images. This will
529 create a writable Unionfs overlay on the device you specify.
530 The device must be formatted with a filesystem recognized and
531 writable by the kernel.
532
533 <comment>Other options:</comment>
534
535 debug Enables debugging code. This might get messy, as it displays
536 a lot of data to the screen.
537
538 docache This caches the entire runtime portion of the CD into RAM,
539 which allows you to umount /mnt/cdrom and mount another CDROM.
540 This option requires that you have at least twice as much
541 available RAM as the size of the CD.
542
543 doload=X This causes the initial ramdisk to load any module listed, as
544 well as dependencies. Replace X with the module name. Multiple
545 modules can be specified by a comma-separated list.
546
547 noload=X This causes the initial ramdisk to skip the loading of a
548 specific module that may be causing a problem. Syntax matches
549 that of doload.
550
551 nox This causes an X-enabled LiveCD to not automatically start X,
552 but rather, to drop to the command line instead.
553
554 scandelay This causes the CD to pause for 10 seconds during certain
555 portions the boot process to allow for devices that are slow to
556 initialize to be ready for use.
557
558 scandelay=X This allows you to specify a given delay, in seconds, to be
559 added to certain portions of the boot process to allow for
560 devices that are slow to initialize to be ready for use.
561 Replace X with the number of seconds to pause.
562 </pre>
563
564 <p>
565 Now boot your CD, select a kernel (if you are not happy with the default
566 <c>gentoo</c> kernel) and boot options. As an example, we show you how
567 to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
568 parameters:
569 </p>
570
571 <pre caption="Booting an Installation CD">
572 boot: <i>gentoo dopcmcia</i>
573 </pre>
574
575 <p>
576 You will then be greeted with a boot screen and progress bar. If you are
577 installing Gentoo on a system with a non-US keyboard, make sure you
578 immediately press Alt-F1 to switch to verbose mode and follow the prompt. If no
579 selection is made in 10 seconds the default (US keyboard) will be accepted and
580 the boot process will continue. Once the boot process completes, Gnome will
581 start up and you will be automatically logged in to the "Live" Gentoo Linux
582 system as "gentoo" in graphical mode. You will be logged in as "root", the
583 superuser on the other consoles and should have a root ("#") prompt there. You
584 can switch to those consoles by pressing Alt-F2, Alt-F3, Alt-F4 Alt-F5, Alt-F6.
585 Get back to the graphical desktop you started on by pressing Alt-F7. To switch
586 to other consoles from within X, you must prefix the above with Ctrl. You are
587 able to run commands as root from any terminal within the graphical environment
588 by using the <c>sudo</c> application. You can even become root within a
589 terminal to perform multiple tasks.
590 </p>
591
592 <pre caption="Using sudo to run applications">
593 <comment>(Example only)</comment>
594 <comment>(Editing the group file)</comment>
595 # <i>sudo vi /etc/group</i>
596 <comment>(Becoming root for a session)</comment>
597 # <i>sudo su -</i>
598 </pre>
599
600 </body>
601 </subsection>
602 <subsection id="hardware">
603 <title>Extra Hardware Configuration</title>
604 <body>
605
606 <p>
607 When the LiveCD boots, it tries to detect all your hardware devices and loads
608 the appropriate kernel modules to support your hardware. In the vast majority
609 of cases, it does a very good job. However, in some cases, it may not auto-load
610 the kernel modules you need. If the PCI auto-detection missed some of your
611 system's hardware, you will have to load the appropriate kernel modules
612 manually. These tasks require root access.
613 </p>
614
615 <p>
616 In the next example we try to load the <c>8139too</c> module (support for
617 certain kinds of network interfaces):
618 </p>
619
620 <pre caption="Loading kernel modules">
621 # <i>modprobe 8139too</i>
622 </pre>
623
624 <p>
625 If you need PCMCIA support, you should start the <c>pcmcia</c> init script:
626 </p>
627
628 <pre caption="Starting the PCMCIA init script">
629 # <i>/etc/init.d/pcmcia start</i>
630 </pre>
631
632 </body>
633 </subsection>
634 <subsection>
635 <title>Optional: Tweaking Hard Disk Performance</title>
636 <body>
637
638 <p>
639 If you are an advanced user, you might want to tweak the IDE hard disk
640 performance using <c>hdparm</c>. You will need root access to use <c>hdparm</c>.
641 With the <c>-tT</c> options you can test the performance of your disk (execute
642 it several times to get a more precise impression):
643 </p>
644
645 <pre caption="Testing disk performance">
646 # <i>hdparm -tT /dev/hda</i>
647 </pre>
648
649 <p>
650 To tweak, you can use any of the following examples (or experiment
651 yourself) which use <path>/dev/hda</path> as disk (substitute with your
652 disk):
653 </p>
654
655 <pre caption="Tweaking hard disk performance">
656 <comment>(Activate DMA:)</comment>
657 # <i>hdparm -d 1 /dev/hda</i>
658
659 <comment>(Or with Safe Performance Options:)</comment>
660 # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
661 </pre>
662
663 </body>
664 </subsection>
665 <subsection id="useraccounts">
666 <title>Optional: User Accounts</title>
667 <body>
668
669 <p>
670 If you plan on giving other people access to your installation environment or
671 you want to chat using <c>irssi</c> without root privileges (for security
672 reasons), you need to create the necessary user accounts and change the root
673 password. You need root access to change the root password and add new users.
674 </p>
675
676 <p>
677 To change the root password, use the <c>passwd</c> utility:
678 </p>
679
680 <pre caption="Changing the root password">
681 $ <i>sudo su -</i>
682 # <i>passwd</i>
683 New password: <comment>(Enter your new password)</comment>
684 Re-enter password: <comment>(Re-enter your password)</comment>
685 </pre>
686
687 <p>
688 To create a user account, we first enter their credentials, followed by its
689 password. We use <c>useradd</c> and <c>passwd</c> for these tasks. In the next
690 example, we create a user called "john".
691 </p>
692
693 <pre caption="Creating a user account">
694 # <i>useradd -m -G users john</i>
695 # <i>passwd john</i>
696 New password: <comment>(Enter john's password)</comment>
697 Re-enter password: <comment>(Re-enter john's password)</comment>
698 </pre>
699
700 <p>
701 You can change your user id from root to the newly created user by using
702 <c>su</c>:
703 </p>
704
705 <pre caption="Changing user id">
706 # <i>su - john</i>
707 </pre>
708
709 <p>
710 You can also change the password for the "gentoo" user in the graphical
711 environment. This account is already suitable for use on the Internet.
712 </p>
713
714 <pre caption="Changing the gentoo password">
715 $ <i>passwd</i>
716 New password: <comment>(Enter your new password)</comment>
717 Re-enter password: <comment>(Re-enter your password)</comment>
718 </pre>
719
720 </body>
721 </subsection>
722 <subsection>
723 <title>Optional: Viewing Documentation while Installing</title>
724 <body>
725
726 <p>
727 If you want to view the Gentoo Handbook (either from-CD or online) during the
728 installation, you can view it with Mozilla Firefox (from the graphical
729 environment) or with <c>links</c> (from a terminal environment).
730 </p>
731
732 <pre caption="Viewing the on-CD documentation with Firefox">
733 # <i>firefox /mnt/cdrom/docs/handbook/html/index.html</i>
734 </pre>
735
736 <p>
737 If you would prefer to use <c>links</c> to see a text-only version of the
738 handbook, make sure you have created a user account (see <uri
739 link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c>
740 to go to a new terminal and log in.
741 </p>
742
743 <pre caption="Viewing the on-CD documentation with links">
744 # <i>links /mnt/cdrom/docs/handbook/html/index.html</i>
745 </pre>
746
747 <p>
748 You can go back to your original window by pressing <c>Alt-F7</c>.
749 </p>
750
751 <p>
752 However, it is preferred that you use the online Gentoo Handbook as it will be
753 more recent than the one provided on the CD. You can view it using Firefox or
754 <c>links</c> as well, but only after having completed the <e>Configuring your
755 Network</e> chapter (otherwise you won't be able to go on the Internet to view
756 the document):
757 </p>
758
759 <pre caption="Viewing the online documentation with Firefox">
760 # <i>firefox http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
761 </pre>
762
763 <pre caption="Viewing the online documentation with links">
764 # <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
765 </pre>
766
767 <p>
768 You can now choose to proceed by using the <uri link="?part=1&amp;chap=3">GTK+
769 based installer</uri> (which needs X) or the <uri
770 link="?part=1&amp;chap=4">Dialog based installer</uri> that can be run on a
771 console.
772 </p>
773
774 </body>
775 </subsection>
776 </section>
777 </sections>
778
779
780
781 --
782 gentoo-doc-cvs@g.o mailing list