/[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.35 - (hide annotations) (download) (as text)
Sat Apr 12 12:25:48 2014 UTC (8 days, 15 hours ago) by swift
Branch: MAIN
CVS Tags: HEAD
Changes since 1.34: +19 -81 lines
File MIME type: application/xml
Fix bug #506132 - Most architectures only have a single installation CD. Also, LiveDVD is not created every 6 months. Thanks to Vladimir Romanov

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 swift 1.35 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.34 2014/01/23 19:32:49 swift 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 swift 1.35 <version>23</version>
17     <date>2014-04-12</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 swift 1.32 <th>LiveDVD</th>
41 neysx 1.1 </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 neysx 1.8 <ti>256 MB</ti>
50 swift 1.23 <ti>512 MB</ti>
51 neysx 1.1 </tr>
52     <tr>
53     <th>Diskspace</th>
54 swift 1.23 <ti colspan="2">2.5 GB (excluding swap space)</ti>
55 neysx 1.1 </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 swift 1.32 <th>LiveDVD</th>
70 neysx 1.8 </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 neysx 1.8 <ti>256 MB</ti>
82 swift 1.23 <ti>512 MB</ti>
83 neysx 1.2 </tr>
84     <tr>
85     <th>Diskspace</th>
86 swift 1.23 <ti colspan="2">2.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 swift 1.35 <title>The Gentoo Installation CD</title>
106 neysx 1.1 <subsection>
107 swift 1.35 <title>Gentoo Minimal Installation CD</title>
108 neysx 1.1 <body>
109    
110     <p>
111 swift 1.35 The <e>Minimal Installation CD</e> is a bootable CD which contains a
112     self-sustained Gentoo environment. It allows you to boot Linux from the CD.
113 neysx 1.1 During the boot process your hardware is detected and the appropriate drivers
114 swift 1.35 are loaded. The CD is maintained by Gentoo developers and allows you to install
115     Gentoo with an active Internet connection.
116 neysx 1.1 </p>
117    
118     <p>
119 swift 1.35 The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
120     takes up around <keyval id="min-cd-size"/> MB of diskspace.
121 neysx 1.1 </p>
122    
123     </body>
124     </subsection>
125 swift 1.26 <subsection>
126     <title>Gentoo Linux LiveDVDs</title>
127     <body>
128    
129     <p>
130 swift 1.35 Occasionally, a special DVD is crafted by the Gentoo Ten
131 swift 1.26 project which can be used to install Gentoo with too. The instructions further
132 swift 1.35 down this chapter target the Minimal Installation CD so might be a bit
133 swift 1.26 different. However, the LiveDVD (or any other bootable
134     Linux environment) supports getting a root prompt by just invoking <c>sudo
135     su -</c> or <c>sudo -i</c> on a terminal.
136     </p>
137    
138     </body>
139     </subsection>
140 nightmorph 1.17 <!--
141 nightmorph 1.3 <subsection>
142 neysx 1.2 <title>Gentoo Installer LiveCD</title>
143 neysx 1.1 <body>
144    
145     <p>
146 neysx 1.2 The Installer LiveCD is called <c><keyval id="live-cd-name"/></c> and takes up
147     <keyval id="live-cd-size"/> MB. You can use this Installation CD to install
148     Gentoo, and you can even use it to install Gentoo without a working internet
149 nightmorph 1.16 connection.
150 neysx 1.1 </p>
151    
152     <table>
153     <tr>
154     <th>Installer LiveCD</th>
155     <th>Pros and Cons</th>
156     </tr>
157     <tr>
158     <th>+</th>
159     <ti>
160     Contains everything you need. You can even install without a network
161     connection.
162     </ti>
163     </tr>
164     <tr>
165     <th>-</th>
166     <ti>Huge download</ti>
167     </tr>
168     </table>
169    
170     </body>
171     </subsection>
172 nightmorph 1.17 -->
173 neysx 1.1 <subsection>
174     <title>The Stage3 Tarball</title>
175     <body>
176    
177     <p>
178 neysx 1.2 A stage3 tarball is an archive containing a minimal Gentoo environment,
179     suitable to continue the Gentoo installation using the instructions in this
180     manual. Previously, the Gentoo Handbook described the installation using one of
181     three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
182 neysx 1.1 official installation method uses the stage3 tarball. If you are interested in
183     performing a Gentoo installation using a stage1 or stage2 tarball, please read
184 swift 1.33 the Gentoo FAQ on <uri link="https://wiki.gentoo.org/wiki/FAQ#How_do_I_Install_Gentoo_Using_a_Stage1_or_Stage2_Tarball.3F">How
185     do I Install Gentoo Using a Stage1 or Stage2 Tarball?</uri>
186 neysx 1.1 </p>
187    
188     <p>
189 neysx 1.2 Stage3 tarballs can be downloaded from <path><keyval
190 nightmorph 1.17 id="release-dir"/>current-stage3/</path> on any of the <uri
191 neysx 1.2 link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
192 swift 1.32 on the LiveDVD.
193 neysx 1.1 </p>
194    
195     </body>
196     </subsection>
197     </section>
198     <!-- STOP -->
199     <section>
200     <title>Download, Burn and Boot a Gentoo Installation CD</title>
201     <subsection>
202 swift 1.35 <title>Downloading and Burning the Installation CD</title>
203 neysx 1.1 <body>
204    
205     <p>
206 neysx 1.11 You have chosen to use a Gentoo Installation CD. We'll first start by
207     downloading and burning the chosen Installation CD. We previously discussed
208 swift 1.35 the Installation CD, but where can you find it?
209 neysx 1.1 </p>
210    
211 nightmorph 1.3 <p>
212 swift 1.35 You can download any of the Installation CD from one of our <uri
213     link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
214 nightmorph 1.17 the <path><keyval id="release-dir"/>current-iso/</path> directory.
215 neysx 1.2 </p>
216    
217 neysx 1.1 <p>
218 swift 1.35 Inside that directory you'll find the ISO file. This is a full CD image which you
219 neysx 1.1 can write on a CD-R.
220     </p>
221    
222     <p>
223     In case you wonder if your downloaded file is corrupted or not, you can check
224 swift 1.28 its SHA-2 checksum and compare it with the SHA-2 checksum we provide (such as
225     <path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the SHA-2
226     checksum with the <c>sha512sum</c> tool under Linux/Unix or <uri
227 swift 1.30 link="http://www.sinf.gr/en/hashcalc.html">Checksums calculator</uri> for Windows.
228 neysx 1.1 </p>
229    
230 swift 1.34 <note>
231     The tool will attempt to verify the checksums in the list, even if the checksum
232     is made with a different algorithm. Therefore, the output of the command might
233     give both success (for SHA checksums) and failures (for other checksums). At
234     least one OK needs to be provided for each file.
235     </note>
236    
237 swift 1.29 <pre caption="Verifying the SHA-2 checksum">
238     $ <i>sha512sum -c &lt;downloaded iso.DIGESTS&gt;</i>
239     </pre>
240    
241     <note>
242     If you get the message that no properly formatted SHA checksum was found, take a
243     look at the DIGESTS file yourself to see what the supported checksums are.
244     </note>
245    
246 neysx 1.1 <p>
247     Another way to check the validity of the downloaded file is to use GnuPG to
248     verify the cryptographic signature that we provide (the file ending with
249 swift 1.25 <path>.asc</path>). Download the signature file and obtain the public keys whose
250     key ids can be found on the <uri link="/proj/en/releng/index.xml">release
251     engineering project site</uri>.
252 neysx 1.1 </p>
253    
254     <pre caption="Obtaining the public key">
255 swift 1.25 <comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
256 swift 1.22 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
257 neysx 1.1 </pre>
258    
259     <p>
260     Now verify the signature:
261     </p>
262    
263 nightmorph 1.19 <pre caption="Verify the files">
264     $ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
265 swift 1.29 $ <i>sha512sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
266 neysx 1.1 </pre>
267    
268     <p>
269     To burn the downloaded ISO(s), you have to select raw-burning. How you
270     do this is highly program-dependent. We will discuss <c>cdrecord</c> and
271     <c>K3B</c> here; more information can be found in our <uri
272 swift 1.33 link="https://wiki.gentoo.org/wiki/FAQ#How_do_I_burn_an_ISO_file.3F">Gentoo FAQ</uri>.
273 neysx 1.1 </p>
274    
275     <ul>
276     <li>
277 swift 1.31 With cdrecord, you simply type <c>cdrecord dev=/dev/sr0 &lt;downloaded iso
278     file&gt;</c> (replace <path>/dev/sr0</path> with your CD-RW drive's
279 neysx 1.1 device path).
280     </li>
281     <li>
282 nightmorph 1.9 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
283     your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
284 neysx 1.1 </li>
285     </ul>
286    
287     </body>
288     </subsection>
289     <subsection>
290     <title>Booting the Installation CD</title>
291     <body>
292    
293     <p>
294 neysx 1.2 Once you have burnt your installation CD, it is time to boot it.
295 neysx 1.11 Remove all CDs from your CD drives, reboot your system and enter the BIOS.
296     This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
297     the BIOS, change the boot order so that the CD-ROM is tried before the hard
298     disk. This is often found under "CMOS Setup". If you don't do this, your system
299 neysx 1.1 will just reboot from the hard disk, ignoring the CD-ROM.
300     </p>
301    
302     <p>
303 neysx 1.2 Now place the installation CD in the CD-ROM drive and reboot. You should see a
304     boot prompt. At this screen, you can hit Enter to begin the boot process with
305     the default boot options, or boot the Installation CD with custom boot options
306 swift 1.20 by specifying a kernel followed by boot options and then hitting Enter.
307 neysx 1.1 </p>
308    
309     <p>
310 swift 1.20 When the boot prompt is shown, you get the option of displaying the available
311     kernels (<c>F1</c>) and boot options (<c>F2</c>). If you make no selection
312 nightmorph 1.27 within 15 seconds (either displaying information or using a kernel) then the
313 swift 1.32 LiveDVD will fall back to booting from disk. This allows installations to reboot
314 swift 1.20 and try out their installed environment without the need to remove the CD from
315     the tray (something well appreciated for remote installations).
316     </p>
317    
318     <p>
319 swift 1.35 Now we mentioned specifying a kernel. On our Installation CD, we provide
320 swift 1.20 several kernels. The default one is <c>gentoo</c>. Other kernels are for
321     specific hardware needs and the <c>-nofb</c> variants which disable
322     framebuffer.
323 neysx 1.1 </p>
324    
325     <p>
326     Below you'll find a short overview on the available kernels:
327     </p>
328    
329     <table>
330     <tr>
331     <th>Kernel</th>
332     <th>Description</th>
333     </tr>
334 nightmorph 1.14 <tr test="func:keyval('arch')='x86'">
335 neysx 1.1 <ti>gentoo</ti>
336     <ti>Default 2.6 kernel with support for multiple CPUs</ti>
337     </tr>
338 nightmorph 1.14 <tr test="func:keyval('arch')='AMD64'">
339 neysx 1.2 <ti>gentoo</ti>
340 nightmorph 1.3 <ti>
341 nightmorph 1.14 Default kernel with support for K8 CPUS (including NUMA support) and EM64T
342 nightmorph 1.3 CPUs
343     </ti>
344 neysx 1.2 </tr>
345     <tr>
346 nightmorph 1.14 <ti>gentoo-nofb</ti>
347     <ti>Same as <c>gentoo</c> but without framebuffer support</ti>
348     </tr>
349     <tr>
350 nightmorph 1.3 <ti>memtest86</ti>
351     <ti>Test your local RAM for errors</ti>
352 neysx 1.2 </tr>
353     </table>
354    
355 neysx 1.1 <p>
356     You can also provide kernel options. They represent optional settings you can
357 nightmorph 1.15 (de)activate at will.
358 neysx 1.1 </p>
359    
360 neysx 1.12 </body>
361    
362     <body>
363     <include href="hb-install-kernelparams.xml"/>
364     </body>
365 nightmorph 1.10
366 neysx 1.12 <body>
367 neysx 1.1
368 nightmorph 1.10 <note>
369     The CD will check for "no*" options before "do*" options, so that you can
370     override any option in the exact order you specify.
371     </note>
372    
373 neysx 1.1 <p>
374     Now boot your CD, select a kernel (if you are not happy with the default
375     <c>gentoo</c> kernel) and boot options. As an example, we show you how
376     to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
377     parameters:
378     </p>
379    
380     <pre caption="Booting an Installation CD">
381     boot: <i>gentoo dopcmcia</i>
382     </pre>
383    
384     <p>
385 neysx 1.2 You will then be greeted with a boot screen and progress bar. If you are
386 neysx 1.1 installing Gentoo on a system with a non-US keyboard, make sure you immediately
387 neysx 1.2 press Alt-F1 to switch to verbose mode and follow the prompt. If no selection
388     is made in 10 seconds the default (US keyboard) will be accepted and the boot
389 neysx 1.1 process will continue. Once the boot process completes, you will be
390 neysx 1.2 automatically logged in to the "Live" Gentoo Linux as "root", the super user.
391     You should have a root ("#") prompt on the current console and can also switch
392     to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one
393     you started on by pressing Alt-F1.
394 neysx 1.1 </p>
395    
396     <p>
397     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
398     </p>
399    
400     </body>
401     </subsection>
402    
403     <subsection>
404 nightmorph 1.15 <include href="hb-install-bootconfig.xml"/>
405 neysx 1.1 </subsection>
406    
407     </section>
408     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20