/[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.36 - (hide annotations) (download) (as text)
Thu May 22 16:05:47 2014 UTC (11 months ago) by swift
Branch: MAIN
CVS Tags: HEAD
Changes since 1.35: +1 -34 lines
File MIME type: application/xml
On request of blueboard, remove commented section (see bug #506132)

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

  ViewVC Help
Powered by ViewVC 1.1.20