/[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 - (show annotations) (download) (as text)
Thu May 22 16:05:47 2014 UTC (2 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 <?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 <!-- $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
9 <sections>
10
11 <abstract>
12 You can install Gentoo in many ways. This chapter explains how to install
13 Gentoo using the minimal Installation CD.
14 </abstract>
15
16 <version>23</version>
17 <date>2014-04-12</date>
18
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 successfully install Gentoo on your box.
28 </p>
29
30 </body>
31 </subsection>
32 <subsection>
33 <title>Hardware Requirements</title>
34 <body test="func:keyval('arch')='x86'">
35
36 <table>
37 <tr>
38 <ti/>
39 <th>Minimal CD</th>
40 <th>LiveDVD</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>256 MB</ti>
50 <ti>512 MB</ti>
51 </tr>
52 <tr>
53 <th>Diskspace</th>
54 <ti colspan="2">2.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 <body test="func:keyval('arch')='AMD64'">
64
65 <table>
66 <tr>
67 <ti/>
68 <th>Minimal CD</th>
69 <th>LiveDVD</th>
70 </tr>
71 <tr>
72 <th>CPU</th>
73 <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 </tr>
79 <tr>
80 <th>Memory</th>
81 <ti>256 MB</ti>
82 <ti>512 MB</ti>
83 </tr>
84 <tr>
85 <th>Diskspace</th>
86 <ti colspan="2">2.5 GB (excluding swap space)</ti>
87 </tr>
88 <tr>
89 <th>Swap space</th>
90 <ti colspan="2">At least 256 MB</ti>
91 </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 </subsection>
101 </section>
102 <!-- This part can be propagated to the other architectures as well. -->
103 <!-- START -->
104 <section>
105 <title>The Gentoo Installation CD</title>
106 <subsection>
107 <title>Gentoo Minimal Installation CD</title>
108 <body>
109
110 <p>
111 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 During the boot process your hardware is detected and the appropriate drivers
114 are loaded. The CD is maintained by Gentoo developers and allows you to install
115 Gentoo with an active Internet connection.
116 </p>
117
118 <p>
119 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 </p>
122
123 </body>
124 </subsection>
125 <subsection>
126 <title>Gentoo Linux LiveDVDs</title>
127 <body>
128
129 <p>
130 Occasionally, a special DVD is crafted by the Gentoo Ten
131 project which can be used to install Gentoo with too. The instructions further
132 down this chapter target the Minimal Installation CD so might be a bit
133 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 <subsection>
141 <title>The Stage3 Tarball</title>
142 <body>
143
144 <p>
145 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 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 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 </p>
154
155 <p>
156 Stage3 tarballs can be downloaded from <path><keyval
157 id="release-dir"/>current-stage3/</path> on any of the <uri
158 link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
159 on the LiveDVD.
160 </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 <title>Downloading and Burning the Installation CD</title>
170 <body>
171
172 <p>
173 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 the Installation CD, but where can you find it?
176 </p>
177
178 <p>
179 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 the <path><keyval id="release-dir"/>current-iso/</path> directory.
182 </p>
183
184 <p>
185 Inside that directory you'll find the ISO file. This is a full CD image which you
186 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 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 link="http://www.sinf.gr/en/hashcalc.html">Checksums calculator</uri> for Windows.
195 </p>
196
197 <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 <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 <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 <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 </p>
220
221 <pre caption="Obtaining the public key">
222 <comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
223 $ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
224 </pre>
225
226 <p>
227 Now verify the signature:
228 </p>
229
230 <pre caption="Verify the files">
231 $ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
232 $ <i>sha512sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
233 </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 link="https://wiki.gentoo.org/wiki/FAQ#How_do_I_burn_an_ISO_file.3F">Gentoo FAQ</uri>.
240 </p>
241
242 <ul>
243 <li>
244 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 device path).
247 </li>
248 <li>
249 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 </li>
252 </ul>
253
254 </body>
255 </subsection>
256 <subsection>
257 <title>Booting the Installation CD</title>
258 <body>
259
260 <p>
261 Once you have burnt your installation CD, it is time to boot it.
262 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 will just reboot from the hard disk, ignoring the CD-ROM.
267 </p>
268
269 <p>
270 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 by specifying a kernel followed by boot options and then hitting Enter.
274 </p>
275
276 <p>
277 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 within 15 seconds (either displaying information or using a kernel) then the
280 LiveDVD will fall back to booting from disk. This allows installations to reboot
281 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 Now we mentioned specifying a kernel. On our Installation CD, we provide
287 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 </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 <tr test="func:keyval('arch')='x86'">
302 <ti>gentoo</ti>
303 <ti>Default 2.6 kernel with support for multiple CPUs</ti>
304 </tr>
305 <tr test="func:keyval('arch')='AMD64'">
306 <ti>gentoo</ti>
307 <ti>
308 Default kernel with support for K8 CPUS (including NUMA support) and EM64T
309 CPUs
310 </ti>
311 </tr>
312 <tr>
313 <ti>gentoo-nofb</ti>
314 <ti>Same as <c>gentoo</c> but without framebuffer support</ti>
315 </tr>
316 <tr>
317 <ti>memtest86</ti>
318 <ti>Test your local RAM for errors</ti>
319 </tr>
320 </table>
321
322 <p>
323 You can also provide kernel options. They represent optional settings you can
324 (de)activate at will.
325 </p>
326
327 </body>
328
329 <body>
330 <include href="hb-install-kernelparams.xml"/>
331 </body>
332
333 <body>
334
335 <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 <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 You will then be greeted with a boot screen and progress bar. If you are
353 installing Gentoo on a system with a non-US keyboard, make sure you immediately
354 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 process will continue. Once the boot process completes, you will be
357 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 </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 <include href="hb-install-bootconfig.xml"/>
372 </subsection>
373
374 </section>
375 </sections>

  ViewVC Help
Powered by ViewVC 1.1.20