/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.1 Revision 1.2
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.1 2006/08/02 21:15:02 neysx Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.2 2006/08/02 21:15:52 neysx Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>2.11</version> 11<version>2.12</version>
12<date>2006-07-19</date> 12<date>2006-07-26</date>
13 13
14<section> 14<section>
15<title>Hardware Requirements</title> 15<title>Hardware Requirements</title>
16<subsection> 16<subsection>
17<title>Introduction</title> 17<title>Introduction</title>
24 24
25</body> 25</body>
26</subsection> 26</subsection>
27<subsection> 27<subsection>
28<title>Hardware Requirements</title> 28<title>Hardware Requirements</title>
29<body> 29<body test="func:keyval('arch')='x86'">
30 30
31<table> 31<table>
32<tr> 32<tr>
33 <ti/> 33 <ti/>
34 <th>Minimal CD</th> 34 <th>Minimal CD</th>
51<tr> 51<tr>
52 <th>Swap space</th> 52 <th>Swap space</th>
53 <ti colspan="2">At least 256 MB</ti> 53 <ti colspan="2">At least 256 MB</ti>
54</tr> 54</tr>
55</table> 55</table>
56
57</body>
58<body test="func:keyval('arch')='AMD64'">
59
60<table>
61<tr>
62 <th>CPU</th>
63 <ti>Any AMD64 CPU</ti>
64</tr>
65<tr>
66 <th>Memory</th>
67 <ti>64 MB</ti>
68</tr>
69<tr>
70 <th>Diskspace</th>
71 <ti>1.5 GB (excluding swap space)</ti>
72</tr>
73<tr>
74 <th>Swap space</th>
75 <ti>At least 256 MB</ti>
76</tr>
77</table>
78
79<p>
80You should check the <uri link="/proj/en/base/amd64/">Gentoo
81AMD64 Project Page</uri> before proceeding.
82</p>
56 83
57</body> 84</body>
58</subsection> 85</subsection>
59</section> 86</section>
60<!-- This part can be propagated to the other architectures as well. --> 87<!-- This part can be propagated to the other architectures as well. -->
78two Installation CDs which are equaly suitable to install Gentoo from, as long 105two Installation CDs which are equaly suitable to install Gentoo from, as long
79as you're planning on performing an Internet-based installation using the 106as you're planning on performing an Internet-based installation using the
80latest version of the available packages. 107latest version of the available packages.
81</p> 108</p>
82 109
83<impo> 110<impo test="func:keyval('arch')='x86'">
84If you wish to install Gentoo without a working Internet connection or would 111If you wish to install Gentoo without a working Internet connection or would
85like to use one of the provided installers, please use the installation 112like to use one of the provided installers, please use the installation
86instructions described in the <uri link="2006.0/index.xml">Gentoo 2006.0 113instructions described in the <uri link="2006.0/">Gentoo 2006.0
87Handbooks</uri>. 114Handbooks</uri>.
88</impo> 115</impo>
89 116
117<impo test="func:keyval('arch')='AMD64'">
118If you wish to install Gentoo without a working Internet connection, please use
119the installation instructions described in the <uri link="2006.0/">Gentoo
1202006.0 Handbooks</uri>.
121</impo>
122
90<p> 123<p>
91The two Installation CDs that we currently provide are: 124The Installation CDs that we currently provide are:
92</p> 125</p>
93 126
94<ul> 127<ul>
95 <li> 128 <li>
96 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable 129 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
97 CD which sole purpose is to boot the system, prepare the networking and 130 CD which sole purpose is to boot the system, prepare the networking and
98 continue with the Gentoo installation. 131 continue with the Gentoo installation.
99 </li> 132 </li>
100 <li> 133 <li test="func:keyval('arch')='x86'">
101 The Gentoo <e>Installer LiveCD</e> contains everything you need to install 134 The Gentoo <e>Installer LiveCD</e> contains everything you need to install
102 Gentoo. It provides a graphical environment, a graphical as well as console 135 Gentoo. It provides a graphical environment, a graphical as well as console
103 based installer which automatically carries out the installation for you, 136 based installer which automatically carries out the installation for you,
104 and of course, the installation instructions for your architecture. 137 and of course, the installation instructions for your architecture.
105 </li> 138 </li>
139 <li test="func:keyval('arch')='AMD64'">
140 The Gentoo <e>Universal</e> Installation CD, a bootable CD with the same
141 abilities as the Minimal Installation CD. Additionally, it contains the
142 stage3 tarball.
143 </li>
106</ul> 144</ul>
107 145
108<p> 146<p>
109To help you decide which Installation CD you need, we have written down the 147To help you decide which Installation CD you need, we have written down the
110major advantages and disadvantages of each Installation CD. 148major advantages and disadvantages of each Installation CD.
111</p> 149</p>
112 150
113</body> 151</body>
114</subsection> 152</subsection>
115<subsection> 153<subsection>
116<title>Gentoo's Minimal Installation CD</title> 154<title>Gentoo Minimal Installation CD</title>
117<body> 155<body>
118 156
119<p> 157<p>
120The Minimal Installation CD is called <c>install-x86-minimal-2006.0.iso</c> 158The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
121and takes up only 49 MB of diskspace. You can use this Installation CD to 159takes up only <keyval id="min-cd-size"/> MB of diskspace. You can use this
122install Gentoo, but always with a working Internet connection only. 160Installation CD to install Gentoo, but <e>only</e> with a working Internet
161connection.
123</p> 162</p>
124 163
125<table> 164<table>
126<tr> 165<tr>
127 <th>Minimal Installation CD</th> 166 <th>Minimal Installation CD</th>
132 <ti>Smallest download</ti> 171 <ti>Smallest download</ti>
133</tr> 172</tr>
134<tr> 173<tr>
135 <th>-</th> 174 <th>-</th>
136 <ti> 175 <ti>
137 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is 176 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
138 therefore not suitable for networkless installation 177 is therefore not suitable for networkless installation
139 </ti> 178 </ti>
140</tr> 179</tr>
141</table> 180</table>
142 181
143</body> 182</body>
144</subsection> 183</subsection>
145<subsection> 184<subsection test="func:keyval('arch')='x86'">
146<title>Gentoo's Installer LiveCD</title> 185<title>Gentoo Installer LiveCD</title>
147<body> 186<body>
148 187
149<p> 188<p>
150The Installer LiveCD is called 189The Installer LiveCD is called <c><keyval id="live-cd-name"/></c> and takes up
151<c>livecd-i686-installer-2006.0.iso</c> and takes up 697 MB. You can use 190<keyval id="live-cd-size"/> MB. You can use this Installation CD to install
152this Installation CD to install Gentoo, and you can even use it to install 191Gentoo, and you can even use it to install Gentoo without a working internet
153Gentoo without a working internet connection, just in case you want to bring 192connection, just in case you want to bring Gentoo to another PC than the one
154Gentoo to another PC than the one you are currently installing Gentoo on :) 193you are currently installing Gentoo on.
155</p> 194</p>
156 195
157<table> 196<table>
158<tr> 197<tr>
159 <th>Installer LiveCD</th> 198 <th>Installer LiveCD</th>
172</tr> 211</tr>
173</table> 212</table>
174 213
175</body> 214</body>
176</subsection> 215</subsection>
177<!-- PackageCDs on x86 are outdated 216<subsection test="func:keyval('arch')='AMD64'">
217<title>Gentoo Universal Installation CD</title>
218<body>
219
220<p>
221The Universal Installation CD is called <c><keyval id="uni-cd-name"/></c> and
222takes up <keyval id="uni-cd-size"/> MB. You can use this Installation CD to
223install Gentoo, and you can even use it to install Gentoo without a working
224internet connection, just in case you want to bring Gentoo to another PC than
225the one you are currently installing Gentoo on.
226</p>
227
228<table>
229<tr>
230 <th>Universal Installation CD</th>
231 <th>Pros and Cons</th>
232</tr>
233<tr>
234 <th>+</th>
235 <ti>
236 Contains everything you need. You can even install without a network
237 connection.
238 </ti>
239</tr>
240<tr>
241 <th>-</th>
242 <ti>Huge download</ti>
243</tr>
244</table>
245
246</body>
178<subsection> 247</subsection>
248<subsection test="func:keyval('arch')='AMD64'">
179<title>Other CDs</title> 249<title>Other CDs</title>
180<body> 250<body>
181 251
182<p> 252<p>
183You might find a <e>Package CD</e> on one of our mirrors. This CD is not an 253You might find a <e>Package CD</e> on one of our mirrors. This CD is not an
192If you intend to use the Packages CD to quickly install additional software, 262If you intend to use the Packages CD to quickly install additional software,
193make sure that you use the same subarchitecture as the stage3 tarball you use. 263make sure that you use the same subarchitecture as the stage3 tarball you use.
194</p> 264</p>
195 265
196</body> 266</body>
197</subsection>--> 267</subsection>
198<subsection> 268<subsection>
199<title>The Stage3 Tarball</title> 269<title>The Stage3 Tarball</title>
200<body> 270<body>
201 271
202<p> 272<p>
203A stage3 tarball is an archive containing a minimal Gentoo environment, suitable 273A stage3 tarball is an archive containing a minimal Gentoo environment,
204to continue the Gentoo installation using the instructions in this manual. 274suitable to continue the Gentoo installation using the instructions in this
205Previously, the Gentoo Handbook described the installation using one of three 275manual. Previously, the Gentoo Handbook described the installation using one of
206stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 276three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
207official installation method uses the stage3 tarball. If you are interested in 277official installation method uses the stage3 tarball. If you are interested in
208performing a Gentoo installation using a stage1 or stage2 tarball, please read 278performing a Gentoo installation using a stage1 or stage2 tarball, please read
209the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo 279the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
210Using a Stage1 or Stage2 Tarball?</uri> 280Using a Stage1 or Stage2 Tarball?</uri>
211</p> 281</p>
212 282
213<p> 283<p>
214Stage3 tarballs can be downloaded from <path>releases/x86/2006.0/stages/</path> 284Stage3 tarballs can be downloaded from <path><keyval
215on any of the <uri link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> 285id="release-dir"/>stages/</path> on any of the <uri
216and are not provided on the LiveCD. 286link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
287on the LiveCD.
217</p> 288</p>
218 289
219</body> 290</body>
220</subsection> 291</subsection>
221</section> 292</section>
230You have chosen to use a Gentoo Installation CD. We'll first start by 301You have chosen to use a Gentoo Installation CD. We'll first start by
231downloading and burning the chosen Installation CD. We previously discussed 302downloading and burning the chosen Installation CD. We previously discussed
232the several available Installation CDs, but where can you find them? 303the several available Installation CDs, but where can you find them?
233</p> 304</p>
234 305
306<p test="func:keyval('arch')='x86'">
307You can download any of the Installation CDs from one of our <uri
308link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
309the <path><keyval id="release-dir"/>installcd/</path> directory.
235<p> 310</p>
311
312<p test="func:keyval('arch')='AMD64'">
236You can download any of the Installation CDs (and, if you want to, a Packages 313You can download any of the Installation CDs (and, if you want to, a Packages
237CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The 314CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
238Installation CDs are located in the <path>releases/x86/2006.0/installcd</path> 315Installation CDs are located in the <path><keyval
239directory. 316id="release-dir"/>installcd/</path> directory.
240</p> 317</p>
241 318
242<p> 319<p>
243Inside that directory you'll find ISO-files. Those are full CD images which you 320Inside that directory you'll find ISO-files. Those are full CD images which you
244can write on a CD-R. 321can write on a CD-R.
245</p> 322</p>
246 323
247<p> 324<p>
248In case you wonder if your downloaded file is corrupted or not, you can check 325In case you wonder if your downloaded file is corrupted or not, you can check
249its MD5 checksum and compare it with the MD5 checksum we provide (such as 326its MD5 checksum and compare it with the MD5 checksum we provide (such as
250<path>install-x86-minimal-2006.0.iso.DIGESTS</path>). You can check the MD5 327<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
251checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 328checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
252link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 329link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
253</p> 330</p>
254 331
255<p> 332<p>
294</subsection> 371</subsection>
295<subsection> 372<subsection>
296<title>Booting the Installation CD</title> 373<title>Booting the Installation CD</title>
297<body> 374<body>
298 375
299<impo>
300Read this whole subsection before continuing, as you will probably not have the
301opportunity to read it before doing things later.
302</impo>
303
304<p> 376<p>
305Once you have burned your installation CD, it is time to boot it. 377Once you have burnt your installation CD, it is time to boot it.
306Remove all CDs from your CD drives, reboot your system and enter the BIOS. 378Remove all CDs from your CD drives, reboot your system and enter the BIOS.
307This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside 379This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
308the BIOS, change the boot order so that the CD-ROM is tried before the hard 380the BIOS, change the boot order so that the CD-ROM is tried before the hard
309disk. This is often found under "CMOS Setup". If you don't do this, your system 381disk. This is often found under "CMOS Setup". If you don't do this, your system
310will just reboot from the hard disk, ignoring the CD-ROM. 382will just reboot from the hard disk, ignoring the CD-ROM.
311</p> 383</p>
312 384
313<p> 385<p>
314Now place the installation CD in the CD-ROM drive (duh) and reboot. You 386Now place the installation CD in the CD-ROM drive and reboot. You should see a
315should see a boot prompt. At this screen, you can hit Enter to begin the 387boot prompt. At this screen, you can hit Enter to begin the boot process with
316boot process with the default boot options, or boot the Installation CD with 388the default boot options, or boot the Installation CD with custom boot options
317custom boot options by specifying a kernel followed by boot options and then 389by specifying a kernel followed by boot options and then hitting Enter.
318hitting Enter.
319</p> 390</p>
320 391
321<p> 392<p>
322Specifying a kernel? Yes, we provide several kernels on our Installation CDs. 393Specifying a kernel? Yes, we provide several kernels on our Installation CDs.
323The default one is <c>gentoo</c>. Other kernels are for specific hardware needs 394The default one is <c>gentoo</c>. Other kernels are for specific hardware needs
326 397
327<p> 398<p>
328Below you'll find a short overview on the available kernels: 399Below you'll find a short overview on the available kernels:
329</p> 400</p>
330 401
402</body>
403<body test="func:keyval('arch')='x86'">
404
331<table> 405<table>
332<tr> 406<tr>
333 <th>Kernel</th> 407 <th>Kernel</th>
334 <th>Description</th> 408 <th>Description</th>
335</tr> 409</tr>
344<tr> 418<tr>
345 <ti>memtest86</ti> 419 <ti>memtest86</ti>
346 <ti>Test your local RAM for errors</ti> 420 <ti>Test your local RAM for errors</ti>
347</tr> 421</tr>
348</table> 422</table>
423
424</body>
425<body test="func:keyval('arch')='AMD64'">
426<table>
427<tr>
428 <th>Kernel</th>
429 <th>Description</th>
430</tr>
431<tr>
432 <ti>gentoo</ti>
433 <ti>Default kernel with support for K8 CPUs with NUMA</ti>
434</tr>
435<tr>
436 <ti>gentoo-nofb</ti>
437 <ti>Same as <c>gentoo</c> but without framebuffer support</ti>
438</tr>
439</table>
440
441</body>
442<body>
349 443
350<p> 444<p>
351You can also provide kernel options. They represent optional settings you can 445You can also provide kernel options. They represent optional settings you can
352(de)activate at will. The following list is the same as the one you receive 446(de)activate at will. The following list is the same as the one you receive
353when you press F2 at the bootscreen. 447when you press F2 at the bootscreen.
386<pre caption="Booting an Installation CD"> 480<pre caption="Booting an Installation CD">
387boot: <i>gentoo dopcmcia</i> 481boot: <i>gentoo dopcmcia</i>
388</pre> 482</pre>
389 483
390<p> 484<p>
391You will then be greeted with a boot screen and progress bar. If you are 485You will then be greeted with a boot screen and progress bar. If you are
392installing Gentoo on a system with a non-US keyboard, make sure you immediately 486installing Gentoo on a system with a non-US keyboard, make sure you immediately
393press Alt-F1 to switch to verbose mode and follow the prompt. If no selection is 487press Alt-F1 to switch to verbose mode and follow the prompt. If no selection
394made in 10 seconds the default (US keyboard) will be accepted and the boot 488is made in 10 seconds the default (US keyboard) will be accepted and the boot
395process will continue. Once the boot process completes, you will be 489process will continue. Once the boot process completes, you will be
396automatically logged in to the &quot;Live&quot; Gentoo Linux as 490automatically logged in to the "Live" Gentoo Linux as "root", the super user.
397&quot;root&quot;, the super user. You should have a root (&quot;#&quot;) prompt 491You should have a root ("#") prompt on the current console and can also switch
398on the current console and can also switch to other consoles by pressing Alt-F2, 492to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one
399Alt-F3 and Alt-F4. Get back to the one you started on by pressing Alt-F1. 493you started on by pressing Alt-F1.
400</p> 494</p>
401 495
402<p> 496<p>
403Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. 497Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
404</p> 498</p>
408<subsection id="hardware"> 502<subsection id="hardware">
409<title>Extra Hardware Configuration</title> 503<title>Extra Hardware Configuration</title>
410<body> 504<body>
411 505
412<p> 506<p>
413When the Installation CD boots, it tries to detect all your hardware devices and 507When the Installation CD boots, it tries to detect all your hardware devices
414loads the appropriate kernel modules to support your hardware. In the 508and loads the appropriate kernel modules to support your hardware. In the vast
415vast majority of cases, it does a very good job. However, in some cases 509majority of cases, it does a very good job. However, in some cases it may not
416it may not auto-load the kernel modules you need. If the PCI auto-detection 510auto-load the kernel modules you need. If the PCI auto-detection missed some of
417missed some of your system's hardware, you will have to load the appropriate 511your system's hardware, you will have to load the appropriate kernel modules
418kernel modules manually. 512manually.
419</p> 513</p>
420 514
421<p> 515<p>
422In the next example we try to load the <c>8139too</c> module (support for 516In the next example we try to load the <c>8139too</c> module (support for
423certain kinds of network interfaces): 517certain kinds of network interfaces):
457yourself) which use <path>/dev/hda</path> as disk (substitute with your 551yourself) which use <path>/dev/hda</path> as disk (substitute with your
458disk): 552disk):
459</p> 553</p>
460 554
461<pre caption="Tweaking hard disk performance"> 555<pre caption="Tweaking hard disk performance">
462<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i> 556<comment>(Activate DMA:)</comment>
463<comment>Activate Safe Performance Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i> 557# <i>hdparm -d 1 /dev/hda</i>
558
559<comment>(Activate Safe Performance Options:)</comment>
560# <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
464</pre> 561</pre>
465 562
466</body> 563</body>
467</subsection> 564</subsection>
468<subsection id="useraccounts"> 565<subsection id="useraccounts">
487</pre> 584</pre>
488 585
489<p> 586<p>
490To create a user account, we first enter their credentials, followed by 587To create a user account, we first enter their credentials, followed by
491its password. We use <c>useradd</c> and <c>passwd</c> for these tasks. 588its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
492In the next example, we create a user called &quot;john&quot;. 589In the next example, we create a user called "john".
493</p> 590</p>
494 591
495<pre caption="Creating a user account"> 592<pre caption="Creating a user account">
496# <i>useradd -m -G users john</i> 593# <i>useradd -m -G users john</i>
497# <i>passwd john</i> 594# <i>passwd john</i>
537chapter (otherwise you won't be able to go on the Internet to view the 634chapter (otherwise you won't be able to go on the Internet to view the
538document): 635document):
539</p> 636</p>
540 637
541<pre caption="Viewing the Online Documentation"> 638<pre caption="Viewing the Online Documentation">
542# <i>links http://www.gentoo.org/doc/en/handbook/handbook-x86.xml</i> 639# <i>links http://www.gentoo.org/doc/en/handbook/<keyval id="online-book"/></i>
543</pre> 640</pre>
544 641
545<p> 642<p>
546You can go back to your original terminal by pressing <c>Alt-F1</c>. 643You can go back to your original terminal by pressing <c>Alt-F1</c>.
547</p> 644</p>

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.2

  ViewVC Help
Powered by ViewVC 1.1.20