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

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

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

Revision 1.89 Revision 1.98
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-config.xml,v 1.89 2007/03/12 08:12:38 nightmorph Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.98 2008/04/17 21:11:30 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<abstract> 11<abstract>
12You need to edit some important configuration files. In this chapter 12You need to edit some important configuration files. In this chapter
13you receive an overview of these files and an explanation on how to 13you receive an overview of these files and an explanation on how to
14proceed. 14proceed.
15</abstract> 15</abstract>
16 16
17<version>7.7</version> 17<version>9.1</version>
18<date>2007-03-11</date> 18<date>2008-04-17</date>
19 19
20<section> 20<section>
21<title>Filesystem Information</title> 21<title>Filesystem Information</title>
22<subsection> 22<subsection>
23<title>What is fstab?</title> 23<title>What is fstab?</title>
73</li> 73</li>
74</ul> 74</ul>
75 75
76<impo> 76<impo>
77The default <path>/etc/fstab</path> file provided by Gentoo <e>is not a valid 77The default <path>/etc/fstab</path> file provided by Gentoo <e>is not a valid
78fstab file</e>, You <b>have to create</b> your own <path>/etc/fstab</path>. 78fstab file</e>. You <b>have to create</b> your own <path>/etc/fstab</path>.
79</impo> 79</impo>
80 80
81<pre caption="Opening /etc/fstab"> 81<pre caption="Opening /etc/fstab">
82# <i>nano -w /etc/fstab</i> 82# <i>nano -w /etc/fstab</i>
83</pre> 83</pre>
118</body> 118</body>
119<body> 119<body>
120 120
121<p test="not(func:keyval('arch')='SPARC')"> 121<p test="not(func:keyval('arch')='SPARC')">
122Add the rules that match your partitioning scheme and append rules for 122Add the rules that match your partitioning scheme and append rules for
123<path>/proc</path>, <c>tmpfs</c>, for your CD-ROM drive(s), and of course, if 123your CD-ROM drive(s), and of course, if you have other partitions or drives,
124you have other partitions or drives, for those too. 124for those too.
125</p> 125</p>
126 126
127<p test="func:keyval('arch')='SPARC'"> 127<p test="func:keyval('arch')='SPARC'">
128Add the rules that match your partitioning schema and append rules for 128Add the rules that match your partitioning schema and append rules for
129<path>/proc/openprom</path>, <path>/proc</path>, <c>tmpfs</c> , for your CD-ROM 129<path>/proc/openprom</path>, for your CD-ROM drive(s), and of course, if
130drive(s), and of course, if you have other partitions or drives, for those too. 130you have other partitions or drives, for those too.
131</p> 131</p>
132 132
133<p> 133<p>
134Now use the <e>example</e> below to create your <path>/etc/fstab</path>: 134Now use the <e>example</e> below to create your <path>/etc/fstab</path>:
135</p> 135</p>
137<pre caption="A full /etc/fstab example" test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86'"> 137<pre caption="A full /etc/fstab example" test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86'">
138<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 138<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2
139/dev/hda2 none swap sw 0 0 139/dev/hda2 none swap sw 0 0
140/dev/hda3 / ext3 noatime 0 1 140/dev/hda3 / ext3 noatime 0 1
141 141
142proc /proc proc defaults 0 0
143shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
144
145/dev/cdrom /mnt/cdrom auto noauto,user 0 0 142/dev/cdrom /mnt/cdrom auto noauto,user 0 0
146</pre> 143</pre>
147 144
148<pre caption="A full /etc/fstab example" test="func:keyval('arch')='HPPA'"> 145<pre caption="A full /etc/fstab example" test="func:keyval('arch')='HPPA'">
149<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 146<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2
150/dev/sda3 none swap sw 0 0 147/dev/sda3 none swap sw 0 0
151/dev/sda4 / ext3 noatime 0 1 148/dev/sda4 / ext3 noatime 0 1
152 149
153proc /proc proc defaults 0 0
154shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
155
156/dev/cdrom /mnt/cdrom auto noauto,user 0 0 150/dev/cdrom /mnt/cdrom auto noauto,user 0 0
157</pre> 151</pre>
158 152
159<pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS'"> 153<pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS'">
160<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 154<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2
161/dev/sda2 none swap sw 0 0 155/dev/sda2 none swap sw 0 0
162/dev/sda3 / ext3 noatime 0 1 156/dev/sda3 / ext3 noatime 0 1
163
164proc /proc proc defaults 0 0
165shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
166 157
167/dev/cdrom /mnt/cdrom auto noauto,user 0 0 158/dev/cdrom /mnt/cdrom auto noauto,user 0 0
168</pre> 159</pre>
169 160
170<pre caption="A full /etc/fstab example" test="func:keyval('arch')='SPARC'"> 161<pre caption="A full /etc/fstab example" test="func:keyval('arch')='SPARC'">
173/dev/sda4 /usr ext3 noatime 0 2 164/dev/sda4 /usr ext3 noatime 0 2
174/dev/sda5 /var ext3 noatime 0 2 165/dev/sda5 /var ext3 noatime 0 2
175/dev/sda6 /home ext3 noatime 0 2 166/dev/sda6 /home ext3 noatime 0 2
176 167
177openprom /proc/openprom openpromfs defaults 0 0 168openprom /proc/openprom openpromfs defaults 0 0
178proc /proc proc defaults 0 0
179shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
180 169
181/dev/cdrom /mnt/cdrom auto noauto,user 0 0 170/dev/cdrom /mnt/cdrom auto noauto,user 0 0
182</pre> 171</pre>
183 172
184<note test="func:keyval('arch')='PPC'"> 173<note test="func:keyval('arch')='PPC'">
188 177
189<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC'"> 178<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC'">
190/dev/hda4 / ext3 noatime 0 1 179/dev/hda4 / ext3 noatime 0 1
191/dev/hda3 none swap sw 0 0 180/dev/hda3 none swap sw 0 0
192 181
193proc /proc proc defaults 0 0
194shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
195
196/dev/cdrom /mnt/cdrom auto noauto,user 0 0 182/dev/cdrom /mnt/cdrom auto noauto,user 0 0
197</pre> 183</pre>
198 184
199<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC64'"> 185<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC64'">
200/dev/sda4 / ext3 noatime 0 1 186/dev/sda4 / ext3 noatime 0 1
201/dev/sda3 none swap sw 0 0 187/dev/sda3 none swap sw 0 0
202
203proc /proc proc defaults 0 0
204shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
205 188
206/dev/cdrom /mnt/cdrom auto noauto,user 0 0 189/dev/cdrom /mnt/cdrom auto noauto,user 0 0
207</pre> 190</pre>
208 191
209<p> 192<p>
279</pre> 262</pre>
280 263
281<note> 264<note>
282For more information on configuring DNS and NIS, please read the examples 265For more information on configuring DNS and NIS, please read the examples
283provided in <path>/etc/conf.d/net.example</path>. Also, you may want to emerge 266provided in <path>/etc/conf.d/net.example</path>. Also, you may want to emerge
284<c>resolvconf-gentoo</c> to help manage your DNS/NIS setup. 267<c>openresolv</c> to help manage your DNS/NIS setup.
285</note> 268</note>
286 269
287</body> 270</body>
288</subsection> 271</subsection>
289<subsection> 272<subsection>
345to set both <c>config_eth0</c> and <c>routes_eth0</c>: 328to set both <c>config_eth0</c> and <c>routes_eth0</c>:
346</p> 329</p>
347 330
348<pre caption="Manually setting IP information for eth0"> 331<pre caption="Manually setting IP information for eth0">
349config_eth0=( "192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" ) 332config_eth0=( "192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" )
350routes_eth0=( "default gw 192.168.0.1" ) 333routes_eth0=( "default via 192.168.0.1" )
351</pre> 334</pre>
352 335
353<p> 336<p>
354To use DHCP and add specific DHCP options, define <c>config_eth0</c> and 337To use DHCP and add specific DHCP options, define <c>config_eth0</c> and
355<c>dhcp_eth0</c>: 338<c>dhcp_eth0</c>:
380<title>Automatically Start Networking at Boot</title> 363<title>Automatically Start Networking at Boot</title>
381<body> 364<body>
382 365
383<p> 366<p>
384To have your network interfaces activated at boot, you need to add them to the 367To have your network interfaces activated at boot, you need to add them to the
385default runlevel. If you have PCMCIA interfaces you should skip this action as 368default runlevel.
386the PCMCIA interfaces are started by the PCMCIA init script.
387</p> 369</p>
388 370
389<pre caption="Adding net.eth0 to the default runlevel"> 371<pre caption="Adding net.eth0 to the default runlevel">
390# <i>rc-update add net.eth0 default</i> 372# <i>rc-update add net.eth0 default</i>
391</pre> 373</pre>
445<subsection test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86' or substring(func:keyval('arch'),1,3)='PPC'"> 427<subsection test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86' or substring(func:keyval('arch'),1,3)='PPC'">
446<title>Optional: Get PCMCIA Working</title> 428<title>Optional: Get PCMCIA Working</title>
447<body> 429<body>
448 430
449<p> 431<p>
450PCMCIA-users should first install the <c>pcmcia-cs</c> package. This also 432PCMCIA users should first install the <c>pcmciautils</c> package.
451includes users who will be working with a 2.6 kernel (even though they won't be
452using the PCMCIA drivers from this package). The <c>USE="-X"</c> is necessary
453to avoid installing xorg-x11 at this moment:
454</p> 433</p>
455 434
456<pre caption="Installing pcmcia-cs"> 435<pre caption="Installing pcmciautils">
457# <i>USE="-X" emerge pcmcia-cs</i> 436# <i>emerge pcmciautils</i>
458</pre>
459
460<p>
461When <c>pcmcia-cs</c> is installed, add <c>pcmcia</c> to the <e>default</e>
462runlevel:
463</p>
464
465<pre caption="Adding pcmcia to the default runlevel">
466# <i>rc-update add pcmcia default</i>
467</pre> 437</pre>
468 438
469</body> 439</body>
470</subsection> 440</subsection>
471</section> 441</section>
480First we set the root password by typing: 450First we set the root password by typing:
481</p> 451</p>
482 452
483<pre caption="Setting the root password"> 453<pre caption="Setting the root password">
484# <i>passwd</i> 454# <i>passwd</i>
485</pre>
486
487<p>
488If you want root to be able to log on through the serial console, add
489<c>tts/0</c> to <path>/etc/securetty</path>:
490</p>
491
492<pre caption="Adding tts/0 to /etc/securetty">
493# <i>echo "tts/0" &gt;&gt; /etc/securetty</i>
494</pre> 455</pre>
495 456
496</body> 457</body>
497</subsection> 458</subsection>
498<subsection> 459<subsection>
529 490
530<p> 491<p>
531Take special care with the <c>KEYMAP</c> variable. If you select the wrong 492Take special care with the <c>KEYMAP</c> variable. If you select the wrong
532<c>KEYMAP</c>, you will get weird results when typing on your keyboard. 493<c>KEYMAP</c>, you will get weird results when typing on your keyboard.
533</p> 494</p>
534
535<note test="func:keyval('arch')='SPARC'">
536Users of USB-based SPARC systems and SPARC clones might need to select an i386
537keymap (such as "us") instead of "sunkeymap".
538</note>
539 495
540<note test="substring(func:keyval('arch'),1,3)='PPC'"> 496<note test="substring(func:keyval('arch'),1,3)='PPC'">
541PPC uses x86 keymaps on most systems. Users who want to be able to use ADB 497PPC uses x86 keymaps on most systems. Users who want to be able to use ADB
542keymaps on boot have to enable ADB keycode sendings in their kernel and have to 498keymaps on boot have to enable ADB keycode sendings in their kernel and have to
543set a mac/ppc keymap in <path>/etc/conf.d/keymaps</path>. 499set a mac/ppc keymap in <path>/etc/conf.d/keymaps</path>.
561If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c> 517If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c>
562to the file. Otherwise you will notice some clock skew. 518to the file. Otherwise you will notice some clock skew.
563</p> 519</p>
564 520
565<p> 521<p>
522You should define the timezone that you previously copied to
523<path>/etc/localtime</path> so that further upgrades of the
524<c>sys-libs/timezone-data</c> package can update <path>/etc/localtime</path>
525automatically. For instance, if you used the GMT timezone, you would add
526<c>TIMEZONE="GMT"</c>
527</p>
528
529<p>
566When you're finished configuring <path>/etc/conf.d/clock</path>, save and 530When you're finished configuring <path>/etc/conf.d/clock</path>, save and
567exit. 531exit.
568</p> 532</p>
569 533
570<p test="not(func:keyval('arch')='PPC64')"> 534<p test="not(func:keyval('arch')='PPC64')">

Legend:
Removed from v.1.89  
changed lines
  Added in v.1.98

  ViewVC Help
Powered by ViewVC 1.1.20