/[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.13 Revision 1.66
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
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/1.0 --> 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.13 2004/08/08 10:12:39 swift 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
11<version>23</version>
12<date>2014-04-12</date>
13
10<section> 14<section>
11<title>Hardware Requirements</title> 15<title>Hardware Requirements</title>
12<subsection> 16<subsection>
13<title>Introduction</title> 17<title>Introduction</title>
14<body> 18<body>
15 19
16<p> 20<p>
17Before we start, we first list what hardware requirements you need to 21Before we start, we first list what hardware requirements you need to
18successfully install Gentoo on your box. This of course depends on your 22successfully install Gentoo on your box.
19architecture.
20</p> 23</p>
21 24
22</body> 25</body>
23</subsection>
24<subsection> 26</subsection>
25<title>The Alpha Architecture</title> 27<subsection>
28<title>Hardware Requirements</title>
26<body> 29<body>
27 30
28<p> 31<table>
29Check the following requirements before you 32<tr>
30continue with the Gentoo installation: 33 <th>CPU</th>
31</p> 34 <ti>
32 35 Please check with the <uri
33<ul>
34<li>
35 You need at least 1 Gb of free disk space
36</li>
37<li>
38 For the <e>Alpha architecture</e>, you should check with the <uri
39 link="http://www.alphalinux.org/faq/FAQ-5.html">Alpha/Linux FAQ</uri> 36 link="http://www.alphalinux.org/faq/FAQ-5.html">Alpha/Linux FAQ</uri>
40</li> 37 </ti>
41</ul> 38</tr>
39<tr>
40 <th>Memory</th>
41 <ti>64 MB</ti>
42</tr>
43<tr>
44 <th>Diskspace</th>
45 <ti>1.5 GB (excluding swap space)</ti>
46</tr>
47<tr>
48 <th>Swap space</th>
49 <ti>At least 256 MB</ti>
50</tr>
51</table>
42 52
43</body> 53</body>
44</subsection> 54</subsection>
45</section> 55</section>
56
46<section> 57<section>
47<title>Make your Choice</title> 58<title>The Gentoo Installation CD</title>
48<subsection>
49<title>Introduction</title>
50<body>
51
52<p>
53Still interested in trying out Gentoo? Well, then it is now time to
54choose the installation medium you want to use. Yes, you have the
55choice, no, they are not all equal, and yes, the result is always the same: a
56Gentoo base system.
57</p>
58
59<p>
60The installation media we will describe are:
61</p>
62
63<ul>
64<li>The Gentoo Alpha LiveCD</li>
65</ul>
66
67<p>
68Before we continue, let's explain our three-stage installation.
69</p>
70
71</body>
72</subsection> 59<subsection>
73<subsection> 60<title>Gentoo Minimal Installation CD</title>
74<title>The Three Stages</title>
75<body>
76
77<p>
78Gentoo Linux can be installed using one of three <e>stage</e> tarball files.
79The one you choose depends on how much of the system you want to compile
80yourself. The <e>stage1</e> tarball is used when you want to bootstrap and
81build the entire system from scratch. The <e>stage2</e> tarball is used for
82building the entire system from a bootstrapped &quot;semi-compiled&quot; state.
83The <e>stage3</e> tarball already contains a basic Gentoo Linux system that has
84been built for you.
85</p>
86
87<p>
88Now what stage do you have to choose?
89</p>
90
91<p>
92Starting from a <e>stage1</e> allows you to have total control over the
93optimization settings and optional build-time functionality that is
94initially enabled on your system. This makes <e>stage1</e> installs good for
95power users who know what they are doing. It is also a great
96installation method for those who would like to know more about the
97inner workings of Gentoo Linux.
98</p>
99
100<p>
101A <e>stage1</e> installation can only be performed when you have a working
102Internet connection.
103</p>
104
105<table>
106<tr>
107 <th>Stage1</th>
108 <th>Pros and Cons</th>
109</tr>
110<tr>
111 <th>+</th>
112 <ti>
113 Allows you to have total control over the optimization settings and optional
114 build-time functionality that is initially enabled on your system
115 </ti>
116</tr>
117<tr>
118 <th>+</th>
119 <ti>Suitable for powerusers that know what they are doing</ti>
120</tr>
121<tr>
122 <th>+</th>
123 <ti>Allows you to learn more about the inner workings of Gentoo</ti>
124</tr>
125<tr>
126 <th>-</th>
127 <ti>Takes a long time to finish the installation</ti>
128</tr>
129<tr>
130 <th>-</th>
131 <ti>
132 If you don't intend to tweak the settings, it is probably a waste of time
133 </ti>
134</tr>
135<tr>
136 <th>-</th>
137 <ti>
138 Not suitable for networkless installations
139 </ti>
140</tr>
141</table>
142
143<p>
144<e>Stage2</e> installs allow you to skip the bootstrap process and doing this
145is fine if you are happy with the optimization settings that we chose
146for your particular <e>stage2</e> tarball.
147</p>
148
149<p>
150A <e>stage2</e> installation can only be performed when you have a working
151Internet connection.
152</p>
153
154<table>
155<tr>
156 <th>Stage2</th>
157 <th>Pros and Cons</th>
158</tr>
159<tr>
160 <th>+</th>
161 <ti>You don't need to bootstrap</ti>
162</tr>
163<tr>
164 <th>+</th>
165 <ti>Faster than starting with stage1</ti>
166</tr>
167<tr>
168 <th>+</th>
169 <ti>You can still tweak your settings</ti>
170</tr>
171<tr>
172 <th>-</th>
173 <ti>You cannot tweak as much as with a stage1</ti>
174</tr>
175<tr>
176 <th>-</th>
177 <ti>It's not the fastest way to install Gentoo</ti>
178</tr>
179<tr>
180 <th>-</th>
181 <ti>You have to accept the optimizations we chose for the bootstrap</ti>
182</tr>
183<tr>
184 <th>-</th>
185 <ti>
186 Not suitable for networkless installations
187 </ti>
188</tr>
189</table>
190
191<p>
192Choosing to go with a <e>stage3</e> allows for the fastest install of Gentoo
193Linux, but also means that your base system will have the optimization
194settings that we chose for you (which to be honest, are good settings
195and were carefully chosen to enhance performance while maintaining
196stability). <e>stage3</e> is also required if you want to install Gentoo using
197prebuilt packages or without a network connection.
198</p>
199
200<table>
201<tr>
202 <th>Stage3</th>
203 <th>Pros and Cons</th>
204</tr>
205<tr>
206 <th>+</th>
207 <ti>Fastest way to get a Gentoo base system</ti>
208</tr>
209<tr>
210 <th>+</th>
211 <ti>Suitable for networkless installations</ti>
212</tr>
213<tr>
214 <th>-</th>
215 <ti>You cannot tweak the base system - it's built already</ti>
216</tr>
217<tr>
218 <th>-</th>
219 <ti>You cannot brag about having used stage1 or stage2</ti>
220</tr>
221</table>
222
223<p>
224Write down (or remember) what stage you want to use. You need this later when
225you decide what LiveCD (or other installation medium) you want to use. You might
226be interested to know that, if you decide to use different optimization settings
227after having installed Gentoo, you will be able to recompile your entire system
228with the new optimization settings.
229</p>
230
231<p>
232Now take a look at the available installation media.
233</p>
234
235</body> 61<body>
236</subsection>
237<subsection>
238<title>The Gentoo Alpha LiveCD</title>
239<body>
240 62
241<p> 63<p>
242The <e>Gentoo Alpha LiveCD</e> is a bootable CD which contain a 64The <e>Minimal Installation CD</e> is a bootable CD which contains a
243self-sustained Gentoo environment. It allows you to boot Linux from the CD. 65self-sustained Gentoo environment. It allows you to boot Linux from the CD.
244During the boot process your hardware is detected and the appropriate drivers 66During the boot process your hardware is detected and the appropriate drivers
245are loaded. It is maintained by Gentoo developers. 67are loaded. The CD is maintained by Gentoo developers and allows you to install
246</p> 68Gentoo with an active Internet connection.
247
248<p> 69</p>
249The <e>Gentoo Alpha LiveCD</e> is a small, no-nonsense, bootable CD which sole 70
250purpose is to boot the system, prepare the networking and continue with the 71<p>
251Gentoo installation. It does not contain any stages (or, in some cases, a 72The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
252single stage1 file), source code or precompiled packages. For example the 73takes up around <keyval id="min-cd-size"/> MB of diskspace.
253alpha variant of this LiveCD can be found in the 74</p>
254<path>releases/1.4_rc1/alpha</path> subdirectory and is called 75
255<c>gentoo-alpha-1.4rc1-test3.iso.bz2</c>. 76</body>
77</subsection>
78<subsection>
79<title>The Stage3 Tarball</title>
80<body>
81
82<p>
83A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
84to continue the Gentoo installation using the instructions in this manual.
85Previously, the Gentoo Handbook described the installation using one of three
86stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
87official installation method uses the stage3 tarball. If you are interested in
88performing a Gentoo installation using a stage1 or stage2 tarball, please read
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
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.
256</p> 98</p>
257 99
258</body> 100</body>
259</subsection> 101</subsection>
260</section> 102</section>
103<!-- STOP -->
261<section> 104<section>
262<title>Download, Burn and Boot the Gentoo LiveCD</title> 105<title>Download, Burn and Boot a Gentoo Installation CD</title>
263<subsection> 106<subsection>
264<title>Downloading and Burning the LiveCDs</title> 107<title>Downloading and Burning the Installation CD</title>
265<body> 108<body>
266 109
267<p>
268You have chosen to use a Gentoo LiveCD (if not, then you are reading the
269wrong document). We'll first start by downloading and burning the chosen
270LiveCD.
271</p> 110<p>
272 111You have chosen to use a Gentoo Installation CD. We'll first start by
112downloading and burning the chosen Installation CD. We previously discussed
113the Installation CD, but where can you find it?
273<p> 114</p>
274Visit one of our <uri 115
275link="/main/en/mirrors.xml">mirrors</uri> and go to
276<path>releases/1.4rc1/alpha</path> which is where the LiveCD(s) of your choice
277are located. Inside that directory you'll find so-called ISO-files. Those are
278full CD images which you can write on a CD-R.
279</p> 116<p>
280 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.
281<p> 120</p>
121
122<p>
123Inside that directory you'll find the ISO file. This is a full CD image which you
124can write on a CD-R.
125</p>
126
127<p>
282In 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
283check 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
284<path>gentoo-alpha-1.4rc1-test3.iso.bz2.md5sum</path>). You can check the MD5 130<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the SHA-2 checksum
285checksum with the <c>md5sum</c> tool under Linux/Unix or <uri 131with the <c>sha512sum</c> tool under Linux/Unix or <uri
286link="http://www.etree.org/md5com.html">md5sum</uri> for Windows. 132link="http://www.sinf.gr/en/hashcalc.html">Checksums calculator</uri> for Windows.
287</p>
288
289<p> 133</p>
290Once downloaded, decompress the ISO file (as it is stored in a compressed format 134
291using the Burrows-Wheeler text compression algorithm) using <c>bunzip2</c> (on 135<note>
292Unix/Linux systems): 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>
293</p> 144</pre>
294 145
295<pre caption="Decompressing the iso.bz2 file"> 146<note>
296# <i>bunzip2 gentoo-alpha-1.4rc1-test3.iso.bz2</i> 147If you get the message that no properly formatted SHA checksum was found, take a
297</pre> 148look at the DIGESTS file yourself to see what the supported checksums are.
149</note>
298 150
299<p> 151<p>
300Another 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
301verify the cryptographic signature that we provide (the file ending with 153verify the cryptographic signature that we provide (the file ending with
302<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>.
303</p> 157</p>
304 158
305<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>
306$ <i>gpg --keyserver pgp.mit.edu --recv-keys 17072058</i> 161$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 96D8BF6D 2D182910 17072058</i>
307</pre> 162</pre>
308 163
309<p> 164<p>
310Now verify the signature: 165Now verify the signature:
311</p> 166</p>
312 167
313<pre caption="Verify the cryptographic signature"> 168<pre caption="Verify the files">
314$ <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>
315</pre> 171</pre>
316 172
317<p> 173<p>
318To 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
319do 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
320<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
321link="/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>.
322</p> 178</p>
323 179
324<ul> 180<ul>
325 <li> 181 <li>
326 With cdrecord, you simply type <c>cdrecord dev=/dev/hdc</c> (replace 182 With cdrecord, you simply type <c>cdrecord dev=/dev/sr0 &lt;downloaded iso
327 <path>/dev/hdc</path> with your CD-RW drive's device path) followed 183 file&gt;</c> (replace <path>/dev/sr0</path> with your CD-RW drive's
328 by the path to the ISO file :) 184 device path).
329 </li> 185 </li>
330 <li> 186 <li>
331 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
332 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>.
333 <c>Start</c>.
334 </li> 189 </li>
335</ul> 190</ul>
336 191
337</body> 192</body>
338</subsection> 193</subsection>
339<subsection> 194<subsection>
340<title>Booting the Alpha LiveCD(s)</title> 195<title>Booting the Installation CD</title>
341<body> 196<body>
342 197
343<p> 198<p>
344When your Alpha is powered on, the first thing that gets started is the 199When your Alpha is powered on, the first thing that gets started is the
345firmware. It is loosely synonymous with the BIOS software on PC systems. There 200firmware. It is loosely synonymous with the BIOS software on PC systems. There
347Manual</e>) and ARC (<e>Advanced Risc Console</e>). 202Manual</e>) and ARC (<e>Advanced Risc Console</e>).
348</p> 203</p>
349 204
350<p> 205<p>
351SRM is based on the Alpha Console Subsystem specification, which provides an 206SRM is based on the Alpha Console Subsystem specification, which provides an
352operating environment for OpenVMS, Tru64 UNIX, and Linux operating systems. ARM 207operating environment for OpenVMS, Tru64 UNIX, and Linux operating systems. ARC
353is based on the Advanced RISC Computing (ARC) specification, which provides 208is based on the Advanced RISC Computing (ARC) specification, which provides
354an operating environment for Windows NT. 209an operating environment for Windows NT. You can find a
355</p> 210<uri link="http://www.alphalinux.org/faq/SRM-HOWTO/">detailed guide</uri> on
356 211using SRM over at the Alpha Linux website.
357<p> 212</p>
213
214<p>
358If your Alpha system supports both SRC and ARCs (ARC, AlphaBIOS, ARCSBIOS) you 215If your Alpha system supports both SRM and ARCs (ARC, AlphaBIOS, ARCSBIOS) you
359should follow <uri link="http://www.alphalinux.org/faq/x31.html">these 216should follow <uri link="http://www.alphalinux.org/faq/x31.html">these
360instructions</uri> for switching to SRM. If your system already uses SRM, you 217instructions</uri> for switching to SRM. If your system already uses SRM, you
361are 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
362will 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.
363</p> 220</p>
364 221
365<p> 222<p>
366Now to boot an Alpha LiveCD, put the CD-ROM in the tray and reboot the system. 223Now to boot an Alpha Installation CD, put the CD-ROM in the tray and reboot the
367You can use SRM to boot the LiveCD. If you cannot do that, you will have to use 224system. You can use SRM to boot the Installation CD. If you cannot do that, you
368<c>MILO</c>. If you don't have <c>MILO</c> installed already, use one of the 225will have to use <c>MILO</c>.
369precompiled <c>MILO</c> images available on <uri
370link="http://dev.gentoo.org/~taviso/milo/">taviso's homepage</uri>.
371</p> 226</p>
372 227
373<pre caption="Booting a CD-ROM using SRM"> 228<pre caption="Booting a CD-ROM using SRM">
374<comment>(List available hardware drives)</comment> 229<comment>(List available hardware drives)</comment>
375&gt;&gt;&gt; <i>show device</i> 230&gt;&gt;&gt; <i>show device</i>
376dkb0.0.1.4.0 DKB0 TOSHIBA CDROM 231dkb0.0.1.4.0 DKB0 TOSHIBA CDROM
377<comment>(...)</comment> 232<comment>(...)</comment>
378<comment>(Substitute dkb0 with your CD-ROM drive device)</comment> 233<comment>(Substitute dkb0 with your CD-ROM drive device)</comment>
379&gt;&gt;&gt; <i>boot dkb0 -flags 0</i> 234&gt;&gt;&gt; <i>boot dkb0 -flags 0</i>
235<comment>(This flag will use serial port ttyS0 as the default console)</comment>
236&gt;&gt;&gt; <i>boot dkb0 -flags 2</i>
380</pre> 237</pre>
381 238
382<pre caption="Booting a CD-ROM using MILO"> 239<pre caption="Booting a CD-ROM using MILO">
383<comment>(Substitute hdb with your CD-ROM drive device)</comment> 240<comment>(Substitute sdb with your CD-ROM drive device)</comment>
384MILO&gt; <i>boot hdb:boot/vmlinuz initrd=initrd.img root=/dev/ram0 init=/linuxrc</i> 241MILO&gt; <i>boot sdb:/boot/gentoo initrd=/boot/gentoo.igz root=/dev/ram0 init=/linuxrc looptype=squashfs loop=/image.squashfs cdroot</i>
242<comment>(Using serial port ttyS0 as the default console)</comment>
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>
385</pre> 244</pre>
386 245
387<p> 246<p>
388You 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
389to 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
394Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. 253Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
395</p> 254</p>
396 255
397</body> 256</body>
398</subsection> 257</subsection>
399<subsection id="hardware">
400<title>Extra Hardware Configuration</title>
401<body>
402 258
403<p>
404When the Live CD boots, it tries to detect all your hardware devices and
405loads the appropriate kernel modules to support your hardware. In the
406vast majority of cases, it does a very good job. However, in some cases (the
407SPARC LiveCDs don't even do autodetection), it may not auto-load the kernel
408modules you need. If the PCI auto-detection missed some of your system's
409hardware, you will have to load the appropriate kernel modules manually.
410</p>
411
412<p>
413In the next example we try to load the <c>8139too</c> module (support for
414certain kinds of network interfaces):
415</p>
416
417<pre caption="Loading kernel modules">
418# <i>modprobe 8139too</i>
419</pre>
420
421</body>
422</subsection> 259<subsection>
260<include href="hb-install-bootconfig.xml"/>
423<subsection> 261</subsection>
424<title>Optional: Tweaking Hard Disk Performance</title>
425<body>
426 262
427<p>
428If you are an advanced user, you might want to tweak the IDE hard disk
429performance using <c>hdparm</c>. With the <c>-tT</c> options you can
430test the performance of your disk (execute it several times to get a
431more precise impression):
432</p>
433
434<pre caption="Testing disk performance">
435# <i>hdparm -tT /dev/hda</i>
436</pre>
437
438<p>
439To tweak, you can use any of the following examples (or experiment
440yourself) which use <path>/dev/hda</path> as disk (substitute with your
441disk):
442</p>
443
444<pre caption="Tweaking hard disk performance">
445<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
446<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
447</pre>
448
449</body>
450</subsection>
451<subsection id="useraccounts">
452<title>Optional: User Accounts</title>
453<body>
454
455<p>
456If you plan on giving other people access to your installation
457environment or you want to chat using <c>irssi</c> without root privileges (for
458security reasons), you need to create the necessary user accounts and change
459the root password.
460</p>
461
462<p>
463To change the root password, use the <c>passwd</c> utility:
464</p>
465
466<pre caption="Changing the root password">
467# <i>passwd</i>
468New password: <comment>(Enter your new password)</comment>
469Re-enter password: <comment>(Re-enter your password)</comment>
470</pre>
471
472<p>
473To create a user account, we first enter their credentials, followed by
474its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
475In the next example, we create a user called &quot;john&quot;.
476</p>
477
478<pre caption="Creating a user account">
479# <i>useradd john</i>
480# <i>passwd john</i>
481New password: <comment>(Enter john's password)</comment>
482Re-enter password: <comment>(Re-enter john's password)</comment>
483</pre>
484
485<p>
486You can change your user id from root to the newly created user by using
487<c>su</c>:
488</p>
489
490<pre caption="Changing user id">
491# <i>su john -</i>
492</pre>
493
494</body>
495</subsection>
496<subsection>
497<title>Optional: Viewing Documentation while Installing</title>
498<body>
499
500<p>
501If you want to view the Gentoo Handbook (either from-CD or online) during the
502installation, make sure you have created a user account (see <uri
503link="#useraccouts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
504go to a new terminal and log in.
505</p>
506
507<p>
508If you want to view the documentation on the CD you can immediately run
509<c>links2</c> to read it:
510</p>
511
512<pre caption="Viewing the on-CD documentation">
513# <i>links2 /mnt/cdrom/docs/html/index.html</i>
514</pre>
515
516<p>
517However, it is preferred that you use the online Gentoo Handbook as it will be
518more recent than the one provided on the CD. You can view it using <c>links2</c>
519as well, but only after having completed the <e>Configuring your Network</e>
520chapter (otherwise you won't be able to go on the Internet to view the
521document):
522</p>
523
524<pre caption="Viewing the Online Documentation">
525# <i>links2 http://www.gentoo.org/doc/en/handbook/handbook-alpha.xml</i>
526</pre>
527
528<p>
529You can go back to your original terminal by pressing <c>Alt-F1</c>.
530</p>
531
532</body>
533</subsection>
534<subsection>
535<title>Optional: Starting the SSH Daemon</title>
536<body>
537
538<p>
539If you want to allow other users to access your computer during the
540Gentoo installation (perhaps because those users are going to help you
541install Gentoo, or even do it for you), you need to create a user
542account for them and perhaps even provide them with your root password
543(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
544</p>
545
546<p>
547To fire up the SSH daemon, execute the following command:
548</p>
549
550<pre caption="Starting the SSH daemon">
551# <i>/etc/init.d/sshd start</i>
552</pre>
553
554<p>
555To be able to use sshd, you first need to setup your networking. Continue with
556the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
557</p>
558
559</body>
560</subsection>
561</section> 263</section>
562</sections> 264</sections>

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

  ViewVC Help
Powered by ViewVC 1.1.20