/[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.30 - (hide annotations) (download) (as text)
Sat Aug 10 13:23:50 2013 UTC (11 months ago) by swift
Branch: MAIN
Changes since 1.29: +4 -4 lines
File MIME type: application/xml
Fix bug #480416 - Suggest different hash calculator software as krylack now includes adware. Thanks to Ben Kohler.

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.30 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86+amd64-medium.xml,v 1.29 2013/08/01 19:02:27 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.30 <version>18</version>
17     <date>2013-08-10</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 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     <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 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     <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 swift 1.24 takes up around <keyval id="min-cd-size"/> MB of diskspace. You can use this
163 neysx 1.2 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 swift 1.26 <subsection>
188     <title>Gentoo Linux LiveDVDs</title>
189     <body>
190    
191     <p>
192     Every 6 months (give or take), a special DVD is crafted by the Gentoo Ten
193     project which can be used to install Gentoo with too. The instructions further
194     down this chapter target the Minimal Installation CDs so might be a bit
195     different. However, the LiveDVD (or any other bootable
196     Linux environment) supports getting a root prompt by just invoking <c>sudo
197     su -</c> or <c>sudo -i</c> on a terminal.
198     </p>
199    
200     </body>
201     </subsection>
202 nightmorph 1.17 <!--
203 nightmorph 1.3 <subsection>
204 neysx 1.2 <title>Gentoo Installer LiveCD</title>
205 neysx 1.1 <body>
206    
207     <p>
208 neysx 1.2 The Installer LiveCD is called <c><keyval id="live-cd-name"/></c> and takes up
209     <keyval id="live-cd-size"/> MB. You can use this Installation CD to install
210     Gentoo, and you can even use it to install Gentoo without a working internet
211 nightmorph 1.16 connection.
212 neysx 1.1 </p>
213    
214     <table>
215     <tr>
216     <th>Installer LiveCD</th>
217     <th>Pros and Cons</th>
218     </tr>
219     <tr>
220     <th>+</th>
221     <ti>
222     Contains everything you need. You can even install without a network
223     connection.
224     </ti>
225     </tr>
226     <tr>
227     <th>-</th>
228     <ti>Huge download</ti>
229     </tr>
230     </table>
231    
232     </body>
233     </subsection>
234 nightmorph 1.17 -->
235 neysx 1.1 <subsection>
236     <title>The Stage3 Tarball</title>
237     <body>
238    
239     <p>
240 neysx 1.2 A stage3 tarball is an archive containing a minimal Gentoo environment,
241     suitable to continue the Gentoo installation using the instructions in this
242     manual. Previously, the Gentoo Handbook described the installation using one of
243     three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
244 neysx 1.1 official installation method uses the stage3 tarball. If you are interested in
245     performing a Gentoo installation using a stage1 or stage2 tarball, please read
246     the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
247     Using a Stage1 or Stage2 Tarball?</uri>
248     </p>
249    
250     <p>
251 neysx 1.2 Stage3 tarballs can be downloaded from <path><keyval
252 nightmorph 1.17 id="release-dir"/>current-stage3/</path> on any of the <uri
253 neysx 1.2 link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
254     on the LiveCD.
255 neysx 1.1 </p>
256    
257     </body>
258     </subsection>
259     </section>
260     <!-- STOP -->
261     <section>
262     <title>Download, Burn and Boot a Gentoo Installation CD</title>
263     <subsection>
264     <title>Downloading and Burning the Installation CDs</title>
265     <body>
266    
267     <p>
268 neysx 1.11 You have chosen to use a Gentoo Installation CD. We'll first start by
269     downloading and burning the chosen Installation CD. We previously discussed
270     the several available Installation CDs, but where can you find them?
271 neysx 1.1 </p>
272    
273 nightmorph 1.3 <p>
274 neysx 1.2 You can download any of the Installation CDs from one of our <uri
275     link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
276 nightmorph 1.17 the <path><keyval id="release-dir"/>current-iso/</path> directory.
277 neysx 1.2 </p>
278    
279 neysx 1.1 <p>
280 nightmorph 1.10 Inside that directory you'll find ISO files. Those are full CD images which you
281 neysx 1.1 can write on a CD-R.
282     </p>
283    
284     <p>
285     In case you wonder if your downloaded file is corrupted or not, you can check
286 swift 1.28 its SHA-2 checksum and compare it with the SHA-2 checksum we provide (such as
287     <path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the SHA-2
288     checksum with the <c>sha512sum</c> tool under Linux/Unix or <uri
289 swift 1.30 link="http://www.sinf.gr/en/hashcalc.html">Checksums calculator</uri> for Windows.
290 neysx 1.1 </p>
291    
292 swift 1.29 <pre caption="Verifying the SHA-2 checksum">
293     $ <i>sha512sum -c &lt;downloaded iso.DIGESTS&gt;</i>
294     </pre>
295    
296     <note>
297     If you get the message that no properly formatted SHA checksum was found, take a
298     look at the DIGESTS file yourself to see what the supported checksums are.
299     </note>
300    
301 neysx 1.1 <p>
302     Another way to check the validity of the downloaded file is to use GnuPG to
303     verify the cryptographic signature that we provide (the file ending with
304 swift 1.25 <path>.asc</path>). Download the signature file and obtain the public keys whose
305     key ids can be found on the <uri link="/proj/en/releng/index.xml">release
306     engineering project site</uri>.
307 neysx 1.1 </p>
308    
309     <pre caption="Obtaining the public key">
310 swift 1.25 <comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
311 swift 1.22 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
312 neysx 1.1 </pre>
313    
314     <p>
315     Now verify the signature:
316     </p>
317    
318 nightmorph 1.19 <pre caption="Verify the files">
319     $ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
320 swift 1.29 $ <i>sha512sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
321 neysx 1.1 </pre>
322    
323     <p>
324     To burn the downloaded ISO(s), you have to select raw-burning. How you
325     do this is highly program-dependent. We will discuss <c>cdrecord</c> and
326     <c>K3B</c> here; more information can be found in our <uri
327     link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>.
328     </p>
329    
330     <ul>
331     <li>
332 neysx 1.11 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso
333     file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's
334 neysx 1.1 device path).
335     </li>
336     <li>
337 nightmorph 1.9 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
338     your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
339 neysx 1.1 </li>
340     </ul>
341    
342     </body>
343     </subsection>
344     <subsection>
345     <title>Booting the Installation CD</title>
346     <body>
347    
348     <p>
349 neysx 1.2 Once you have burnt your installation CD, it is time to boot it.
350 neysx 1.11 Remove all CDs from your CD drives, reboot your system and enter the BIOS.
351     This is usually done by hitting DEL, F1 or ESC, depending on your BIOS. Inside
352     the BIOS, change the boot order so that the CD-ROM is tried before the hard
353     disk. This is often found under "CMOS Setup". If you don't do this, your system
354 neysx 1.1 will just reboot from the hard disk, ignoring the CD-ROM.
355     </p>
356    
357     <p>
358 neysx 1.2 Now place the installation CD in the CD-ROM drive and reboot. You should see a
359     boot prompt. At this screen, you can hit Enter to begin the boot process with
360     the default boot options, or boot the Installation CD with custom boot options
361 swift 1.20 by specifying a kernel followed by boot options and then hitting Enter.
362 neysx 1.1 </p>
363    
364     <p>
365 swift 1.20 When the boot prompt is shown, you get the option of displaying the available
366     kernels (<c>F1</c>) and boot options (<c>F2</c>). If you make no selection
367 nightmorph 1.27 within 15 seconds (either displaying information or using a kernel) then the
368 swift 1.20 LiveCD will fall back to booting from disk. This allows installations to reboot
369     and try out their installed environment without the need to remove the CD from
370     the tray (something well appreciated for remote installations).
371     </p>
372    
373     <p>
374     Now we mentioned specifying a kernel. On our Installation CDs, we provide
375     several kernels. The default one is <c>gentoo</c>. Other kernels are for
376     specific hardware needs and the <c>-nofb</c> variants which disable
377     framebuffer.
378 neysx 1.1 </p>
379    
380     <p>
381     Below you'll find a short overview on the available kernels:
382     </p>
383    
384     <table>
385     <tr>
386     <th>Kernel</th>
387     <th>Description</th>
388     </tr>
389 nightmorph 1.14 <tr test="func:keyval('arch')='x86'">
390 neysx 1.1 <ti>gentoo</ti>
391     <ti>Default 2.6 kernel with support for multiple CPUs</ti>
392     </tr>
393 nightmorph 1.14 <tr test="func:keyval('arch')='AMD64'">
394 neysx 1.2 <ti>gentoo</ti>
395 nightmorph 1.3 <ti>
396 nightmorph 1.14 Default kernel with support for K8 CPUS (including NUMA support) and EM64T
397 nightmorph 1.3 CPUs
398     </ti>
399 neysx 1.2 </tr>
400     <tr>
401 nightmorph 1.14 <ti>gentoo-nofb</ti>
402     <ti>Same as <c>gentoo</c> but without framebuffer support</ti>
403     </tr>
404     <tr>
405 nightmorph 1.3 <ti>memtest86</ti>
406     <ti>Test your local RAM for errors</ti>
407 neysx 1.2 </tr>
408     </table>
409    
410 neysx 1.1 <p>
411     You can also provide kernel options. They represent optional settings you can
412 nightmorph 1.15 (de)activate at will.
413 neysx 1.1 </p>
414    
415 neysx 1.12 </body>
416    
417     <body>
418     <include href="hb-install-kernelparams.xml"/>
419     </body>
420 nightmorph 1.10
421 neysx 1.12 <body>
422 neysx 1.1
423 nightmorph 1.10 <note>
424     The CD will check for "no*" options before "do*" options, so that you can
425     override any option in the exact order you specify.
426     </note>
427    
428 neysx 1.1 <p>
429     Now boot your CD, select a kernel (if you are not happy with the default
430     <c>gentoo</c> kernel) and boot options. As an example, we show you how
431     to boot the <c>gentoo</c> kernel, with <c>dopcmcia</c> as kernel
432     parameters:
433     </p>
434    
435     <pre caption="Booting an Installation CD">
436     boot: <i>gentoo dopcmcia</i>
437     </pre>
438    
439     <p>
440 neysx 1.2 You will then be greeted with a boot screen and progress bar. If you are
441 neysx 1.1 installing Gentoo on a system with a non-US keyboard, make sure you immediately
442 neysx 1.2 press Alt-F1 to switch to verbose mode and follow the prompt. If no selection
443     is made in 10 seconds the default (US keyboard) will be accepted and the boot
444 neysx 1.1 process will continue. Once the boot process completes, you will be
445 neysx 1.2 automatically logged in to the "Live" Gentoo Linux as "root", the super user.
446     You should have a root ("#") prompt on the current console and can also switch
447     to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one
448     you started on by pressing Alt-F1.
449 neysx 1.1 </p>
450    
451     <p>
452     Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
453     </p>
454    
455     </body>
456     </subsection>
457    
458     <subsection>
459 nightmorph 1.15 <include href="hb-install-bootconfig.xml"/>
460 neysx 1.1 </subsection>
461    
462     </section>
463     </sections>

  ViewVC Help
Powered by ViewVC 1.1.20