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 <signature file> <downloaded iso></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 <downloaded iso |
340 |
file></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> > <c>CD</c> > <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&chap=3">GTK+ |
769 |
based installer</uri> (which needs X) or the <uri |
770 |
link="?part=1&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 |