/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.42 Revision 1.66
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v 1.42 2006/09/05 06:50:30 rane Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-medium.xml,v 1.66 2014/04/12 12:25:48 swift Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<version>7.1</version> 11<version>23</version>
12<date>2006-09-04</date> 12<date>2014-04-12</date>
13 13
14<section> 14<section>
15<title>Hardware Requirements</title> 15<title>Hardware Requirements</title>
16<subsection> 16<subsection>
17<title>Introduction</title> 17<title>Introduction</title>
52 52
53</body> 53</body>
54</subsection> 54</subsection>
55</section> 55</section>
56 56
57<!-- Copy/paste from hb-install-x86-medium.xml -->
58<!-- START -->
59<section> 57<section>
60<title>The Gentoo Installation CDs</title> 58<title>The Gentoo Installation CD</title>
61<subsection> 59<subsection>
62<title>Introduction</title> 60<title>Gentoo Minimal Installation CD</title>
63<body> 61<body>
64 62
65<p> 63<p>
66The <e>Gentoo Installation CDs</e> are bootable CDs which contain a 64The <e>Minimal Installation CD</e> is a bootable CD which contains a
67self-sustained Gentoo environment. They allow you to boot Linux from the CD. 65self-sustained Gentoo environment. It allows you to boot Linux from the CD.
68During the boot process your hardware is detected and the appropriate drivers 66During the boot process your hardware is detected and the appropriate drivers
69are loaded. They are maintained by Gentoo developers. 67are loaded. The CD is maintained by Gentoo developers and allows you to install
70</p> 68Gentoo with an active Internet connection.
71
72<p> 69</p>
73All Installation CDs allow you to boot, set up networking, initialize your 70
74partitions and start installing Gentoo from the Internet. We currently provide
75two Installation CDs which are equaly suitable to install Gentoo from, as long
76as you're planning on performing an Internet-based installation using the
77latest version of the available packages.
78</p> 71<p>
79 72The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
73takes up around <keyval id="min-cd-size"/> MB of diskspace.
80<p> 74</p>
81If you wish to install Gentoo without a working Internet connection, please use
82the installation instructions described in the <uri
83link="2006.1/index.xml">Gentoo 2006.1 Handbooks</uri>.
84</p>
85 75
86<p>
87The two Installation CDs we currently provide are:
88</p>
89
90<ul>
91 <li>
92 The Gentoo Minimal Installation CD, a small, no-nonsense, bootable CD which
93 sole purpose is to boot the system, prepare the networking and continue
94 with the Gentoo installation.
95 </li>
96 <li>
97 The Gentoo Universal Installation CD, a bootable CD with the same abilities
98 as the Minimal Installation CD. Additionally, it contains several stage3
99 tarballs (optimized for the individual subarchitectures).
100 </li>
101</ul>
102
103<p>
104To help you decide which Installation CD you need, we have written down the
105major advantages and disadvantages of each Installation CD.
106</p>
107
108</body> 76</body>
109</subsection>
110<subsection> 77</subsection>
111<title>Gentoo's Minimal Installation CD</title>
112<body>
113
114<p>
115The Minimal Installation CD is called <c>install-alpha-minimal-2006.1.iso</c>
116and takes up only 65 MB of diskspace. You can use this Installation CD to
117install Gentoo, but always with a working Internet connection only.
118</p>
119
120<table>
121<tr>
122 <th>Minimal Installation CD</th>
123 <th>Pros and Cons</th>
124</tr>
125<tr>
126 <th>+</th>
127 <ti>Smallest download</ti>
128</tr>
129<tr>
130 <th>-</th>
131 <ti>
132 Contains no stage3 tarball, no Portage snapshot, no prebuilt packages and is
133 therefore not suitable for networkless installation
134 </ti>
135</tr>
136</table>
137
138</body>
139</subsection>
140<subsection>
141<title>Gentoo's Universal Installation CD</title>
142<body>
143
144<p>
145The Universal Installation CD is called <c>install-alpha-universal-2006.1.iso</c>
146and consumes about 316 MB on a CD. You can use this Installation CD to install
147Gentoo, and you can even use it to install Gentoo without a working internet
148connection, just in case you want to bring Gentoo to another PC than the one
149you are currently installing Gentoo on :)
150</p>
151
152<table>
153<tr>
154 <th>Universal Installation CD</th>
155 <th>Pros and Cons</th>
156</tr>
157<tr>
158 <ti>+</ti>
159 <ti>
160 Contains everything you need. You can even install without a network
161 connection.
162 </ti>
163</tr>
164<tr>
165 <ti>-</ti>
166 <ti>
167 Huge download
168 </ti>
169</tr>
170</table>
171
172</body>
173</subsection>
174<!-- No package CDs for Alpha - 2006.1
175<subsection>
176<title>Other CDs</title>
177<body>
178
179<p>
180You might find a Package CD on one of our mirrors. This CD is not an
181Installation CD but an additional resource that can be exploited during a
182networkless installation. It contains prebuilt packages (also known as the GRP
183set) that allow you to easily and quickly install additional applications
184(such as OpenOffice.org, KDE, GNOME, ...) immediately after the networkless
185Gentoo installation.
186</p>
187
188<p>
189If you intend to use the Packages CD to quickly install additional software,
190make sure that you use the same subarchitecture as the stage3 tarball you use.
191</p>
192
193</body>
194</subsection>-->
195<subsection> 78<subsection>
196<title>The Stage3 Tarball</title> 79<title>The Stage3 Tarball</title>
197<body> 80<body>
198 81
199<p> 82<p>
201to continue the Gentoo installation using the instructions in this manual. 84to continue the Gentoo installation using the instructions in this manual.
202Previously, the Gentoo Handbook described the installation using one of three 85Previously, the Gentoo Handbook described the installation using one of three
203stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the 86stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
204official installation method uses the stage3 tarball. If you are interested in 87official installation method uses the stage3 tarball. If you are interested in
205performing a Gentoo installation using a stage1 or stage2 tarball, please read 88performing a Gentoo installation using a stage1 or stage2 tarball, please read
206the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo 89the Gentoo FAQ on <uri link="https://wiki.gentoo.org/wiki/FAQ/#How_do_I_Install_Gentoo_Using_a_Stage1_or_Stage2_Tarball.3F">How
207Using a Stage1 or Stage2 Tarball?</uri> 90do I Install Gentoo Using a Stage1 or Stage2 Tarball?</uri>
91</p>
92
93<p>
94Stage3 tarballs can be downloaded from <path><keyval
95id="release-dir"/>current-stage3/</path> on any of the <uri
96link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
97on the LiveCD.
208</p> 98</p>
209 99
210</body> 100</body>
211</subsection> 101</subsection>
212</section> 102</section>
213<!-- STOP --> 103<!-- STOP -->
214<section> 104<section>
215<title>Download, Burn and Boot a Gentoo Installation CD</title> 105<title>Download, Burn and Boot a Gentoo Installation CD</title>
216<subsection> 106<subsection>
217<title>Downloading and Burning the Installation CDs</title> 107<title>Downloading and Burning the Installation CD</title>
218<body> 108<body>
219 109
220<p> 110<p>
221You have chosen to use a Gentoo Installation CD. We'll first start by 111You have chosen to use a Gentoo Installation CD. We'll first start by
222downloading and burning the chosen Installation CD. We previously discussed 112downloading and burning the chosen Installation CD. We previously discussed
223the several available Installation CDs, but where can you find them? 113the Installation CD, but where can you find it?
224</p>
225
226<p> 114</p>
227You can download any of the Installation CDs (and, if you want to, a Packages 115
228CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
229Installation CDs are located in the <path>releases/alpha/2006.1/installcd</path>
230directory.
231</p> 116<p>
232 117You can download the Installation CD from one of our <uri
118link="/main/en/mirrors.xml">mirrors</uri>. The Installation CD is located in
119the <path><keyval id="release-dir"/>current-iso/</path> directory.
233<p> 120</p>
121
122<p>
234Inside that directory you'll find ISO-files. Those are full CD images which you 123Inside that directory you'll find the ISO file. This is a full CD image which you
235can write on a CD-R. 124can write on a CD-R.
236</p> 125</p>
237 126
238<p> 127<p>
239In case you wonder if your downloaded file is corrupted or not, you can 128In case you wonder if your downloaded file is corrupted or not, you can check
240check its MD5 checksum and compare it with the MD5 checksum we provide (such as 129its SHA-2 checksum and compare it with the SHA-2 checksum we provide (such as
241<path>install-alpha-minimal-2006.1.iso.DIGESTS</path>). You can check the MD5 130<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the SHA-2 checksum
242checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 131with the <c>sha512sum</c> tool under Linux/Unix or <uri
243link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 132link="http://www.sinf.gr/en/hashcalc.html">Checksums calculator</uri> for Windows.
133</p>
134
135<note>
136The tool will attempt to verify the checksums in the list, even if the checksum
137is made with a different algorithm. Therefore, the output of the command might
138give both success (for SHA checksums) and failures (for other checksums). At
139least one OK needs to be provided for each file.
140</note>
141
142<pre caption="Verifying the SHA-2 checksum">
143$ <i>sha512sum -c &lt;downloaded iso.DIGESTS&gt;</i>
244</p> 144</pre>
145
146<note>
147If you get the message that no properly formatted SHA checksum was found, take a
148look at the DIGESTS file yourself to see what the supported checksums are.
149</note>
245 150
246<p> 151<p>
247Another way to check the validity of the downloaded file is to use GnuPG to 152Another way to check the validity of the downloaded file is to use GnuPG to
248verify the cryptographic signature that we provide (the file ending with 153verify the cryptographic signature that we provide (the file ending with
249<path>.asc</path>). Download the signature file and obtain the public key: 154<path>.asc</path>). Download the signature file and obtain the public keys whose
155key ids can be found on the <uri link="/proj/en/releng/index.xml">release
156engineering project site</uri>.
250</p> 157</p>
251 158
252<pre caption="Obtaining the public key"> 159<pre caption="Obtaining the public key">
160<comment>(... Substitute the key ids with those mentioned on the release engineering site ...)</comment>
253$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i> 161$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
254</pre> 162</pre>
255 163
256<p> 164<p>
257Now verify the signature: 165Now verify the signature:
258</p> 166</p>
259 167
260<pre caption="Verify the cryptographic signature"> 168<pre caption="Verify the files">
261$ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i> 169$ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
170$ <i>sha512sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
262</pre> 171</pre>
263 172
264<p> 173<p>
265To burn the downloaded ISO(s), you have to select raw-burning. How you 174To burn the downloaded ISO(s), you have to select raw-burning. How you
266do this is highly program-dependent. We will discuss <c>cdrecord</c> and 175do this is highly program-dependent. We will discuss <c>cdrecord</c> and
267<c>K3B</c> here; more information can be found in our <uri 176<c>K3B</c> here; more information can be found in our <uri
268link="/doc/en/faq.xml#isoburning">Gentoo FAQ</uri>. 177link="https://wiki.gentoo.org/wiki/FAQ#How_do_I_burn_an_ISO_file.3F">Gentoo FAQ</uri>.
269</p> 178</p>
270 179
271<ul> 180<ul>
272 <li> 181 <li>
273 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc &lt;downloaded iso 182 With cdrecord, you simply type <c>cdrecord dev=/dev/sr0 &lt;downloaded iso
274 file&gt;</c> (replace <path>/dev/hdc</path> with your CD-RW drive's 183 file&gt;</c> (replace <path>/dev/sr0</path> with your CD-RW drive's
275 device path). 184 device path).
276 </li> 185 </li>
277 <li> 186 <li>
278 With K3B, select <c>Tools</c> &gt; <c>CD</c> &gt; <c>Burn Image</c>. Then 187 With K3B, select <c>Tools</c> &gt; <c>Burn CD Image</c>. Then you can locate
279 you can locate your ISO file within the 'Image to Burn' area. Finally click 188 your ISO file within the 'Image to Burn' area. Finally click <c>Start</c>.
280 <c>Start</c>.
281 </li> 189 </li>
282</ul> 190</ul>
283 191
284</body> 192</body>
285</subsection> 193</subsection>
310are all set. If your system can only use ARCs (Ruffian, nautilus, xl, etc.) you 218are all set. If your system can only use ARCs (Ruffian, nautilus, xl, etc.) you
311will need to choose <c>MILO</c> later on when we are talking about bootloaders. 219will need to choose <c>MILO</c> later on when we are talking about bootloaders.
312</p> 220</p>
313 221
314<p> 222<p>
315Now to boot an Alpha Installation CD, put the CD-ROM in the tray and reboot the 223Now to boot an Alpha Installation CD, put the CD-ROM in the tray and reboot the
316system. You can use SRM to boot the Installation CD. If you cannot do that, you 224system. You can use SRM to boot the Installation CD. If you cannot do that, you
317will have to use <c>MILO</c>. If you don't have <c>MILO</c> installed already, 225will have to use <c>MILO</c>.
318use one of the precompiled <c>MILO</c> images available on <uri
319link="http://dev.gentoo.org/~taviso/milo/">taviso's homepage</uri>.
320</p>
321
322<p>
323This release also includes two entries for people who want to use a serial
324console during the installation, possibly boxes with no keyboard and
325screen attached. One allows you to boot 2.6 using the serial console and
326the other will do the same with our 2.4 kernel.
327</p> 226</p>
328 227
329<pre caption="Booting a CD-ROM using SRM"> 228<pre caption="Booting a CD-ROM using SRM">
330<comment>(List available hardware drives)</comment> 229<comment>(List available hardware drives)</comment>
331&gt;&gt;&gt; <i>show device</i> 230&gt;&gt;&gt; <i>show device</i>
332dkb0.0.1.4.0 DKB0 TOSHIBA CDROM 231dkb0.0.1.4.0 DKB0 TOSHIBA CDROM
333<comment>(...)</comment> 232<comment>(...)</comment>
334<comment>(Substitute dkb0 with your CD-ROM drive device)</comment> 233<comment>(Substitute dkb0 with your CD-ROM drive device)</comment>
335&gt;&gt;&gt; <i>boot dkb0 -flags 0</i> 234&gt;&gt;&gt; <i>boot dkb0 -flags 0</i>
336<comment>To boot the 2.4 kernel instead of the default 2.6 kernel use:</comment> 235<comment>(This flag will use serial port ttyS0 as the default console)</comment>
337&gt;&gt;&gt; <i>boot dkb -flags 1</i>
338<comment>(If you need serial console support)</comment>
339<comment>To boot the 2.6 kernel with serial console support use:</comment>
340&gt;&gt;&gt; <i>boot dkb0 -flags 2</i> 236&gt;&gt;&gt; <i>boot dkb0 -flags 2</i>
341<comment>To boot the 2.4 kernel with serial console support use:</comment>
342&gt;&gt;&gt; <i>boot dkb0 -flags 3</i>
343</pre> 237</pre>
344 238
345<pre caption="Booting a CD-ROM using MILO"> 239<pre caption="Booting a CD-ROM using MILO">
346<comment>(Substitute hdb with your CD-ROM drive device)</comment> 240<comment>(Substitute sdb with your CD-ROM drive device)</comment>
347MILO&gt; <i>boot hdb:/boot/gentoo_2.6 initrd=/boot/gentoo_2_6.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs cdroot</i> 241MILO&gt; <i>boot sdb:/boot/gentoo initrd=/boot/gentoo.igz root=/dev/ram0 init=/linuxrc looptype=squashfs loop=/image.squashfs cdroot</i>
348<comment>To boot the 2.4 kernel instead of the default 2.6 kernel use:</comment> 242<comment>(Using serial port ttyS0 as the default console)</comment>
349MILO&gt; <i>boot hdb:/boot/gentoo_2.4 initrd=/boot/gentoo_2_4.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs cdroot</i>
350<comment>(If you need serial console support)</comment>
351<comment>To boot the 2.6 kernel with serial console support use:</comment>
352MILO&gt; <i>boot hdb:/boot/gentoo_2.6 initrd=/boot/gentoo_2_6.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs console=ttyS0 cdroot</i> 243MILO&gt; <i>boot sdb:/boot/gentoo initrd=/boot/gentoo.igz root=/dev/ram0 init=/linuxrc looptype=squashfs loop=/image.squashfs console=ttyS0 cdroot</i>
353<comment>To boot the 2.4 kernel with serial console support use:</comment>
354MILO&gt; <i>boot hdb:/boot/gentoo_2.4 initrd=/boot/gentoo_2_4.igz root=/dev/ram0 init=/linuxrc looptype=zisofs loop=/zisofs console=ttyS0 cdroot</i>
355</pre> 244</pre>
356 245
357<p> 246<p>
358You should have a root ("#") prompt on the current console and can also switch 247You should have a root ("#") prompt on the current console and can also switch
359to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you 248to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get back to the one you
364Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. 253Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
365</p> 254</p>
366 255
367</body> 256</body>
368</subsection> 257</subsection>
369<subsection id="hardware">
370<title>Extra Hardware Configuration</title>
371<body>
372 258
373<p>
374When the Installation CD boots, it tries to detect all your hardware devices and
375loads the appropriate kernel modules to support your hardware. In the
376vast majority of cases, it does a very good job. However, in some cases it may
377not auto-load the kernel
378modules you need. If the PCI auto-detection missed some of your system's
379hardware, you will have to load the appropriate kernel modules manually.
380</p>
381
382<p>
383In the next example we try to load the <c>8139too</c> module (support for
384certain kinds of network interfaces):
385</p>
386
387<pre caption="Loading kernel modules">
388# <i>modprobe 8139too</i>
389</pre>
390
391</body>
392</subsection> 259<subsection>
260<include href="hb-install-bootconfig.xml"/>
393<subsection> 261</subsection>
394<title>Optional: Tweaking Hard Disk Performance</title>
395<body>
396 262
397<p>
398If you are an advanced user, you might want to tweak the IDE hard disk
399performance using <c>hdparm</c>. With the <c>-tT</c> options you can
400test the performance of your disk (execute it several times to get a
401more precise impression):
402</p>
403
404<pre caption="Testing disk performance">
405# <i>hdparm -tT /dev/hda</i>
406</pre>
407
408<p>
409To tweak, you can use any of the following examples (or experiment
410yourself) which use <path>/dev/hda</path> as disk (substitute with your
411disk):
412</p>
413
414<pre caption="Tweaking hard disk performance">
415<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
416<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
417</pre>
418
419</body>
420</subsection>
421<subsection id="useraccounts">
422<title>Optional: User Accounts</title>
423<body>
424
425<p>
426If you plan on giving other people access to your installation
427environment or you want to chat using <c>irssi</c> without root privileges (for
428security reasons), you need to create the necessary user accounts and change
429the root password.
430</p>
431
432<p>
433To change the root password, use the <c>passwd</c> utility:
434</p>
435
436<pre caption="Changing the root password">
437# <i>passwd</i>
438New password: <comment>(Enter your new password)</comment>
439Re-enter password: <comment>(Re-enter your password)</comment>
440</pre>
441
442<p>
443To create a user account, we first enter their credentials, followed by
444its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
445In the next example, we create a user called &quot;john&quot;.
446</p>
447
448<pre caption="Creating a user account">
449# <i>useradd -m -G users john</i>
450# <i>passwd john</i>
451New password: <comment>(Enter john's password)</comment>
452Re-enter password: <comment>(Re-enter john's password)</comment>
453</pre>
454
455<p>
456You can change your user id from root to the newly created user by using
457<c>su</c>:
458</p>
459
460<pre caption="Changing user id">
461# <i>su - john</i>
462</pre>
463
464</body>
465</subsection>
466<subsection>
467<title>Optional: Viewing Documentation while Installing</title>
468<body>
469
470<p>
471If you want to view the Gentoo Handbook (either from-CD or online) during the
472installation, make sure you have created a user account (see <uri
473link="#useraccounts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
474go to a new terminal and log in.
475</p>
476
477<p>
478If you want to view the documentation on the CD you can immediately run
479<c>lynx</c> to read it:
480</p>
481
482<pre caption="Viewing the on-CD documentation">
483# <i>lynx /mnt/cdrom/docs/html/index.html</i>
484</pre>
485
486<p>
487However, it is preferred that you use the online Gentoo Handbook as it will be
488more recent than the one provided on the CD. You can view it using <c>lynx</c>
489as well, but only after having completed the <e>Configuring your Network</e>
490chapter (otherwise you won't be able to go on the Internet to view the
491document):
492</p>
493
494<pre caption="Viewing the Online Documentation">
495# <i>lynx http://www.gentoo.org/doc/en/handbook/handbook-alpha.xml</i>
496</pre>
497
498<p>
499You can go back to your original terminal by pressing <c>Alt-F1</c>.
500</p>
501
502</body>
503</subsection>
504<subsection>
505<title>Optional: Starting the SSH Daemon</title>
506<body>
507
508<p>
509If you want to allow other users to access your computer during the
510Gentoo installation (perhaps because those users are going to help you
511install Gentoo, or even do it for you), you need to create a user
512account for them and perhaps even provide them with your root password
513(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
514</p>
515
516<p>
517To fire up the SSH daemon, execute the following command:
518</p>
519
520<pre caption="Starting the SSH daemon">
521# <i>/etc/init.d/sshd start</i>
522</pre>
523
524<p>
525To be able to use sshd, you first need to set up your networking. Continue with
526the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
527</p>
528
529</body>
530</subsection>
531</section> 263</section>
532</sections> 264</sections>

Legend:
Removed from v.1.42  
changed lines
  Added in v.1.66

  ViewVC Help
Powered by ViewVC 1.1.20