/[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.17 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.17 2004/10/23 11:02:06 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. You can find a 209an operating environment for Windows NT. You can find a
355<uri link="http://www.alphalinux.org/faq/SRM-HOWTO/">detailed guide</uri> on 210<uri link="http://www.alphalinux.org/faq/SRM-HOWTO/">detailed guide</uri> on
356using SRM over at the Alpha Linux website. 211using SRM over at the Alpha Linux website.
357</p> 212</p>
358 213
359<p> 214<p>
360If 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
361should follow <uri link="http://www.alphalinux.org/faq/x31.html">these 216should follow <uri link="http://www.alphalinux.org/faq/x31.html">these
362instructions</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
363are 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
364will 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.
365</p> 220</p>
366 221
367<p> 222<p>
368Now 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
369You 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
370<c>MILO</c>. If you don't have <c>MILO</c> installed already, use one of the 225will have to use <c>MILO</c>.
371precompiled <c>MILO</c> images available on <uri
372link="http://dev.gentoo.org/~taviso/milo/">taviso's homepage</uri>.
373</p> 226</p>
374 227
375<pre caption="Booting a CD-ROM using SRM"> 228<pre caption="Booting a CD-ROM using SRM">
376<comment>(List available hardware drives)</comment> 229<comment>(List available hardware drives)</comment>
377&gt;&gt;&gt; <i>show device</i> 230&gt;&gt;&gt; <i>show device</i>
378dkb0.0.1.4.0 DKB0 TOSHIBA CDROM 231dkb0.0.1.4.0 DKB0 TOSHIBA CDROM
379<comment>(...)</comment> 232<comment>(...)</comment>
380<comment>(Substitute dkb0 with your CD-ROM drive device)</comment> 233<comment>(Substitute dkb0 with your CD-ROM drive device)</comment>
381&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>
382</pre> 237</pre>
383 238
384<pre caption="Booting a CD-ROM using MILO"> 239<pre caption="Booting a CD-ROM using MILO">
385<comment>(Substitute hdb with your CD-ROM drive device)</comment> 240<comment>(Substitute sdb with your CD-ROM drive device)</comment>
386MILO&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>
387</pre> 244</pre>
388 245
389<p> 246<p>
390You 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
391to 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
396Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>. 253Now continue with <uri link="#hardware">Extra Hardware Configuration</uri>.
397</p> 254</p>
398 255
399</body> 256</body>
400</subsection> 257</subsection>
401<subsection id="hardware">
402<title>Extra Hardware Configuration</title>
403<body>
404 258
405<p>
406When the Live CD boots, it tries to detect all your hardware devices and
407loads the appropriate kernel modules to support your hardware. In the
408vast majority of cases, it does a very good job. However, in some cases (the
409SPARC LiveCDs don't even do autodetection), it may not auto-load the kernel
410modules you need. If the PCI auto-detection missed some of your system's
411hardware, you will have to load the appropriate kernel modules manually.
412</p>
413
414<p>
415In the next example we try to load the <c>8139too</c> module (support for
416certain kinds of network interfaces):
417</p>
418
419<pre caption="Loading kernel modules">
420# <i>modprobe 8139too</i>
421</pre>
422
423</body>
424</subsection> 259<subsection>
260<include href="hb-install-bootconfig.xml"/>
425<subsection> 261</subsection>
426<title>Optional: Tweaking Hard Disk Performance</title>
427<body>
428 262
429<p>
430If you are an advanced user, you might want to tweak the IDE hard disk
431performance using <c>hdparm</c>. With the <c>-tT</c> options you can
432test the performance of your disk (execute it several times to get a
433more precise impression):
434</p>
435
436<pre caption="Testing disk performance">
437# <i>hdparm -tT /dev/hda</i>
438</pre>
439
440<p>
441To tweak, you can use any of the following examples (or experiment
442yourself) which use <path>/dev/hda</path> as disk (substitute with your
443disk):
444</p>
445
446<pre caption="Tweaking hard disk performance">
447<comment>Activate DMA:</comment> # <i>hdparm -d 1 /dev/hda</i>
448<comment>Activate DMA + Safe Performance-enhancing Options:</comment> # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
449</pre>
450
451</body>
452</subsection>
453<subsection id="useraccounts">
454<title>Optional: User Accounts</title>
455<body>
456
457<p>
458If you plan on giving other people access to your installation
459environment or you want to chat using <c>irssi</c> without root privileges (for
460security reasons), you need to create the necessary user accounts and change
461the root password.
462</p>
463
464<p>
465To change the root password, use the <c>passwd</c> utility:
466</p>
467
468<pre caption="Changing the root password">
469# <i>passwd</i>
470New password: <comment>(Enter your new password)</comment>
471Re-enter password: <comment>(Re-enter your password)</comment>
472</pre>
473
474<p>
475To create a user account, we first enter their credentials, followed by
476its password. We use <c>useradd</c> and <c>passwd</c> for these tasks.
477In the next example, we create a user called &quot;john&quot;.
478</p>
479
480<pre caption="Creating a user account">
481# <i>useradd john</i>
482# <i>passwd john</i>
483New password: <comment>(Enter john's password)</comment>
484Re-enter password: <comment>(Re-enter john's password)</comment>
485</pre>
486
487<p>
488You can change your user id from root to the newly created user by using
489<c>su</c>:
490</p>
491
492<pre caption="Changing user id">
493# <i>su - john</i>
494</pre>
495
496</body>
497</subsection>
498<subsection>
499<title>Optional: Viewing Documentation while Installing</title>
500<body>
501
502<p>
503If you want to view the Gentoo Handbook (either from-CD or online) during the
504installation, make sure you have created a user account (see <uri
505link="#useraccouts">Optional: User Accounts</uri>). Then press <c>Alt-F2</c> to
506go to a new terminal and log in.
507</p>
508
509<p>
510If you want to view the documentation on the CD you can immediately run
511<c>lynx</c> to read it:
512</p>
513
514<pre caption="Viewing the on-CD documentation">
515# <i>lynx /mnt/cdrom/docs/html/index.html</i>
516</pre>
517
518<p>
519However, it is preferred that you use the online Gentoo Handbook as it will be
520more recent than the one provided on the CD. You can view it using <c>lynx</c>
521as well, but only after having completed the <e>Configuring your Network</e>
522chapter (otherwise you won't be able to go on the Internet to view the
523document):
524</p>
525
526<pre caption="Viewing the Online Documentation">
527# <i>lynx http://www.gentoo.org/doc/en/handbook/handbook-alpha.xml</i>
528</pre>
529
530<p>
531You can go back to your original terminal by pressing <c>Alt-F1</c>.
532</p>
533
534</body>
535</subsection>
536<subsection>
537<title>Optional: Starting the SSH Daemon</title>
538<body>
539
540<p>
541If you want to allow other users to access your computer during the
542Gentoo installation (perhaps because those users are going to help you
543install Gentoo, or even do it for you), you need to create a user
544account for them and perhaps even provide them with your root password
545(<e>only</e> do that <e>if</e> you <b>fully trust</b> that user).
546</p>
547
548<p>
549To fire up the SSH daemon, execute the following command:
550</p>
551
552<pre caption="Starting the SSH daemon">
553# <i>/etc/init.d/sshd start</i>
554</pre>
555
556<p>
557To be able to use sshd, you first need to set up your networking. Continue with
558the chapter on <uri link="?part=1&amp;chap=3">Configuring your Network</uri>.
559</p>
560
561</body>
562</subsection>
563</section> 263</section>
564</sections> 264</sections>

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

  ViewVC Help
Powered by ViewVC 1.1.20