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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.19 - (hide annotations) (download) (as text)
Mon Jul 19 01:50:06 2010 UTC (4 years, 4 months ago) by nightmorph
Branch: MAIN
Changes since 1.18: +9 -6 lines
File MIME type: application/xml
fix file verification process for the x86/amd64 handbooks, bug 283402

1 neysx 1.1 <?xml version='1.0' encoding='UTF-8'?>
2     <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3    
4     <!-- The content of this document is licensed under the CC-BY-SA license -->
5     <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6    
7 nightmorph 1.19 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.18 2010/01/01 20:49:02 nightmorph Exp $ -->
8 neysx 1.1
9     <sections>
10    
11 neysx 1.5 <abstract>
12     You can install Gentoo in many ways. This chapter explains how to install
13 nightmorph 1.18 Gentoo using the minimal Installation CD.
14 neysx 1.5 </abstract>
15    
16 nightmorph 1.19 <version>7.2</version>
17     <date>2010-07-18</date>
18 neysx 1.1
19     <section>
20     <title>Hardware Requirements</title>
21     <subsection>
22     <title>Introduction</title>
23     <body>
24    
25     <p>
26     Before we start, we first list what hardware requirements you need to
27 neysx 1.11 successfully install Gentoo on your box.
28 neysx 1.1 </p>
29    
30     </body>
31     </subsection>
32     <subsection>
33     <title>Hardware Requirements</title>
34 neysx 1.2 <body test="func:keyval('arch')='x86'">
35 neysx 1.1
36     <table>
37     <tr>
38     <ti/>
39     <th>Minimal CD</th>
40     <th>LiveCD</th>
41     </tr>
42     <tr>
43     <th>CPU</th>
44     <ti>i486 or later</ti>
45     <ti><b>i686</b> or later</ti>
46     </tr>
47     <tr>
48     <th>Memory</th>
49     <ti>64 MB</ti>
50 neysx 1.8 <ti>256 MB</ti>
51 neysx 1.1 </tr>
52     <tr>
53     <th>Diskspace</th>
54     <ti colspan="2">1.5 GB (excluding swap space)</ti>
55     </tr>
56     <tr>
57     <th>Swap space</th>
58     <ti colspan="2">At least 256 MB</ti>
59     </tr>
60     </table>
61    
62     </body>
63 neysx 1.2 <body test="func:keyval('arch')='AMD64'">
64    
65     <table>
66     <tr>
67 neysx 1.8 <ti/>
68     <th>Minimal CD</th>
69     <th>LiveCD</th>
70     </tr>
71     <tr>
72 neysx 1.2 <th>CPU</th>
73 neysx 1.11 <ti colspan="2">
74     Any AMD64 CPU or <uri
75     link="http://en.wikipedia.org/wiki/EMT64#Intel_64">EM64T CPU</uri> (Core 2
76     Duo &amp; Quad processors are EM64T)
77     </ti>
78 neysx 1.2 </tr>
79     <tr>
80     <th>Memory</th>
81     <ti>64 MB</ti>
82 neysx 1.8 <ti>256 MB</ti>
83 neysx 1.2 </tr>
84     <tr>
85     <th>Diskspace</th>
86 neysx 1.8 <ti colspan="2">1.5 GB (excluding swap space)</ti>
87 neysx 1.2 </tr>
88     <tr>
89     <th>Swap space</th>
90 neysx 1.8 <ti colspan="2">At least 256 MB</ti>
91 neysx 1.2 </tr>
92     </table>
93    
94     <p>
95     You should check the <uri link="/proj/en/base/amd64/">Gentoo
96     AMD64 Project Page</uri> before proceeding.
97     </p>
98    
99     </body>
100 neysx 1.1 </subsection>
101     </section>
102     <!-- This part can be propagated to the other architectures as well. -->
103     <!-- START -->
104     <section>
105     <title>The Gentoo Installation CDs</title>
106     <subsection>
107     <title>Introduction</title>
108     <body>
109    
110     <p>
111     The <e>Gentoo Installation CDs</e> are bootable CDs which contain a
112     self-sustained Gentoo environment. They allow you to boot Linux from the CD.
113     During the boot process your hardware is detected and the appropriate drivers
114     are loaded. They are maintained by Gentoo developers.
115     </p>
116    
117     <p>
118     All Installation CDs allow you to boot, set up networking, initialize your
119 nightmorph 1.17 partitions and start installing Gentoo from the Internet.
120 neysx 1.1 </p>
121    
122 nightmorph 1.17 <!--
123 nightmorph 1.3 <impo>
124     If you wish to install Gentoo without a working Internet connection, or would
125 neysx 1.1 like to use one of the provided installers, please use the installation
126 nightmorph 1.10 instructions described in the <uri link="2008.0/">Gentoo 2008.0
127 neysx 1.1 Handbooks</uri>.
128     </impo>
129 nightmorph 1.17 -->
130     <!--
131 neysx 1.1 <p>
132 neysx 1.2 The Installation CDs that we currently provide are:
133 neysx 1.1 </p>
134    
135     <ul>
136     <li>
137 neysx 1.11 The Gentoo <e>Minimal</e> Installation CD, a small, no-nonsense, bootable
138     CD which sole purpose is to boot the system, prepare the networking and
139 neysx 1.1 continue with the Gentoo installation.
140     </li>
141 nightmorph 1.3 <li>
142 neysx 1.1 The Gentoo <e>Installer LiveCD</e> contains everything you need to install
143     Gentoo. It provides a graphical environment, a graphical as well as console
144     based installer which automatically carries out the installation for you,
145     and of course, the installation instructions for your architecture.
146     </li>
147     </ul>
148    
149     <p>
150     To help you decide which Installation CD you need, we have written down the
151     major advantages and disadvantages of each Installation CD.
152     </p>
153 nightmorph 1.17 -->
154 neysx 1.1 </body>
155     </subsection>
156     <subsection>
157 neysx 1.2 <title>Gentoo Minimal Installation CD</title>
158 neysx 1.1 <body>
159    
160     <p>
161 neysx 1.2 The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
162     takes up only <keyval id="min-cd-size"/> MB of diskspace. You can use this
163     Installation CD to install Gentoo, but <e>only</e> with a working Internet
164     connection.
165 neysx 1.1 </p>
166 nightmorph 1.17 <!--
167 neysx 1.1 <table>
168     <tr>
169     <th>Minimal Installation CD</th>
170     <th>Pros and Cons</th>
171     </tr>
172     <tr>
173     <th>+</th>
174     <ti>Smallest download</ti>
175     </tr>
176     <tr>
177     <th>-</th>
178     <ti>
179 neysx 1.2 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and
180     is therefore not suitable for networkless installation
181 neysx 1.1 </ti>
182     </tr>
183     </table>
184 nightmorph 1.17 -->
185 neysx 1.1 </body>
186     </subsection>
187 nightmorph 1.17 <!--
188 nightmorph 1.3 <subsection>
189 neysx 1.2 <title>Gentoo Installer LiveCD</title>
190 neysx 1.1 <body>
191    
192     <p>
193 neysx 1.2 The Installer LiveCD is called <c><keyval id="live-cd-name"/></c> and takes up
194     <keyval id="live-cd-size"/> MB. You can use this Installation CD to install
195     Gentoo, and you can even use it to install Gentoo without a working internet
196 nightmorph 1.16 connection.
197 neysx 1.1 </p>
198    
199     <table>
200     <tr>
201     <th>Installer LiveCD</th>
202     <th>Pros and Cons</th>
203     </tr>
204     <tr>
205     <th>+</th>
206     <ti>
207     Contains everything you need. You can even install without a network
208     connection.
209     </ti>
210     </tr>
211     <tr>
212     <th>-</th>
213     <ti>Huge download</ti>
214     </tr>
215     </table>
216    
217     </body>
218     </subsection>
219 nightmorph 1.17 -->
220 neysx 1.1 <subsection>
221     <title>The Stage3 Tarball</title>
222     <body>
223    
224     <p>
225 neysx 1.2 A stage3 tarball is an archive containing a minimal Gentoo environment,
226     suitable to continue the Gentoo installation using the instructions in this
227     manual. Previously, the Gentoo Handbook described the installation using one of
228     three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
229 neysx 1.1 official installation method uses the stage3 tarball. If you are interested in
230     performing a Gentoo installation using a stage1 or stage2 tarball, please read
231     the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
232     Using a Stage1 or Stage2 Tarball?</uri>
233     </p>
234    
235     <p>
236 neysx 1.2 Stage3 tarballs can be downloaded from <path><keyval
237 nightmorph 1.17 id="release-dir"/>current-stage3/</path> on any of the <uri
238 neysx 1.2 link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
239     on the LiveCD.
240 neysx 1.1 </p>
241    
242     </body>
243     </subsection>
244     </section>
245     <!-- STOP -->
246     <section>
247     <title>Download, Burn and Boot a Gentoo Installation CD</title>
248     <subsection>
249     <title>Downloading and Burning the Installation CDs</title>
250     <body>
251    
252     <p>
253 neysx 1.11 You have chosen to use a Gentoo Installation CD. We'll first start by
254     downloading and burning the chosen Installation CD. We previously discussed
255     the several available Installation CDs, but where can you find them?
256 neysx 1.1 </p>
257    
258 nightmorph 1.3 <p>
259 neysx 1.2 You can download any of the Installation CDs from one of our <uri
260     link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
261 nightmorph 1.17 the <path><keyval id="release-dir"/>current-iso/</path> directory.
262 neysx 1.2 </p>
263    
264 neysx 1.1 <p>
265 nightmorph 1.10 Inside that directory you'll find ISO files. Those are full CD images which you
266 neysx 1.1 can write on a CD-R.
267     </p>
268    
269     <p>
270     In case you wonder if your downloaded file is corrupted or not, you can check
271     its MD5 checksum and compare it with the MD5 checksum we provide (such as
272 neysx 1.2 <path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
273 neysx 1.1 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
274     link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
275     </p>
276    
277     <p>
278     Another way to check the validity of the downloaded file is to use GnuPG to
279     verify the cryptographic signature that we provide (the file ending with
280     <path>.asc</path>). Download the signature file and obtain the public key:
281     </p>
282    
283     <pre caption="Obtaining the public key">
284 nightmorph 1.19 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 2D182910</i>
285 neysx 1.1 </pre>
286    
287     <p>
288     Now verify the signature:
289     </p>
290    
291 nightmorph 1.19 <pre caption="Verify the files">
292     <comment>(Verify the cryptographic signature)</comment>
293     $ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
294     <comment>(Verify the checksum)</comment>
295     $ <i>sha1sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
296 neysx 1.1 </pre>
297    
298     <p>
299     To burn the downloaded ISO(s), you have to select raw-burning. How you
300     do this is highly program-dependent. We will discuss <c>cdrecord</c> and
301     <c>K3B</c> here; more information can be found in our <uri
302     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
303     </p>
304    
305     <ul>
306     <li>
307 neysx 1.11 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
308     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
309 neysx 1.1 device path).
310     </li>
311     <li>
312 nightmorph 1.9 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
313     your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
314 neysx 1.1 </li>
315     </ul>
316    
317     </body>
318     </subsection>
319     <subsection>
320     <title>Booting the Installation CD</title>
321     <body>
322    
323     <p>
324 neysx 1.2 Once you have burnt your installation CD, it is time to boot it.
325 neysx 1.11 Remove all CDs from your CD drives, reboot your system and enter the BIOS.
326     This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
327     the BIOS, change the boot order so that the CD-ROM is tried before the hard
328     disk. This is often found under "CMOS Setup". If you don't do this, your system
329 neysx 1.1 will just reboot from the hard disk, ignoring the CD-ROM.
330     </p>
331    
332     <p>
333 neysx 1.2 Now place the installation CD in the CD-ROM drive and reboot. You should see a
334     boot prompt. At this screen, you can hit Enter to begin the boot process with
335     the default boot options, or boot the Installation CD with custom boot options
336     by specifying a kernel followed by boot options and then hitting Enter.
337 neysx 1.1 </p>
338    
339     <p>
340 neysx 1.11 Specifying a kernel? Yes, we provide several kernels on our Installation CDs.
341 neysx 1.1 The default one is <c>gentoo</c>. Other kernels are for specific hardware needs
342     and the <c>-nofb</c> variants which disable framebuffer.
343     </p>
344    
345     <p>
346     Below you'll find a short overview on the available kernels:
347     </p>
348    
349     <table>
350     <tr>
351     <th>Kernel</th>
352     <th>Description</th>
353     </tr>
354 nightmorph 1.14 <tr test="func:keyval('arch')='x86'">
355 neysx 1.1 <ti>gentoo</ti>
356     <ti>Default 2.6 kernel with support for multiple CPUs</ti>
357     </tr>
358 nightmorph 1.14 <tr test="func:keyval('arch')='AMD64'">
359 neysx 1.2 <ti>gentoo</ti>
360 nightmorph 1.3 <ti>
361 nightmorph 1.14 Default kernel with support for K8 CPUS (including NUMA support) and EM64T
362 nightmorph 1.3 CPUs
363     </ti>
364 neysx 1.2 </tr>
365     <tr>
366 nightmorph 1.14 <ti>gentoo-nofb</ti>
367     <ti>Same as <c>gentoo</c> but without framebuffer support</ti>
368     </tr>
369     <tr>
370 nightmorph 1.3 <ti>memtest86</ti>
371     <ti>Test your local RAM for errors</ti>
372 neysx 1.2 </tr>
373     </table>
374    
375 neysx 1.1 <p>
376     You can also provide kernel options. They represent optional settings you can
377 nightmorph 1.15 (de)activate at will.
378 neysx 1.1 </p>
379    
380 neysx 1.12 </body>
381    
382     <body>
383     <include href="hb-install-kernelparams.xml"/>
384     </body>
385 nightmorph 1.10
386 neysx 1.12 <body>
387 neysx 1.1
388 nightmorph 1.10 <note>
389     The CD will check for "no*" options before "do*" options, so that you can
390     override any option in the exact order you specify.
391     </note>
392    
393 neysx 1.1 <p>
394     Now boot your CD, select a kernel (if you are not happy with the default
395     <c>gentoo</c> kernel) and boot options. As an example, we show you how
396     to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
397     parameters:
398     </p>
399    
400     <pre caption="Booting an Installation CD">
401     boot: <i>gentoo dopcmcia</i>
402     </pre>
403    
404     <p>
405 neysx 1.2 You will then be greeted with a boot screen and progress bar. If you are
406 neysx 1.1 installing Gentoo on a system with a non-US keyboard, make sure you immediately
407 neysx 1.2 press Alt-F1 to switch to verbose mode and follow the prompt. If no selection
408     is made in 10 seconds the default (US keyboard) will be accepted and the boot
409 neysx 1.1 process will continue. Once the boot process completes, you will be
410 neysx 1.2 automatically logged in to the "Live" Gentoo Linux as "root", the super user.
411     You should have a root ("#") prompt on the current console and can also switch
412     to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one
413     you started on by pressing Alt-F1.
414 neysx 1.1 </p>
415    
416     <p>
417     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
418     </p>
419    
420     </body>
421     </subsection>
422    
423     <subsection>
424 nightmorph 1.15 <include href="hb-install-bootconfig.xml"/>
425 neysx 1.1 </subsection>
426    
427     </section>
428     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20