| … | |
… | |
| 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.100 2009/02/11 08:40:54 nightmorph Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.107 2011/09/11 08:53:34 swift Exp $ --> |
| 8 | |
8 | |
| 9 | <sections> |
9 | <sections> |
| 10 | |
10 | |
| 11 | <abstract> |
11 | <abstract> |
| 12 | You need to edit some important configuration files. In this chapter |
12 | You need to edit some important configuration files. In this chapter |
| 13 | you receive an overview of these files and an explanation on how to |
13 | you receive an overview of these files and an explanation on how to |
| 14 | proceed. |
14 | proceed. |
| 15 | </abstract> |
15 | </abstract> |
| 16 | |
16 | |
| 17 | <version>9.3</version> |
17 | <version>14</version> |
| 18 | <date>2009-02-11</date> |
18 | <date>2011-09-11</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> |
| … | |
… | |
| 125 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
125 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
| 126 | /dev/sda3 none swap sw 0 0 |
126 | /dev/sda3 none swap sw 0 0 |
| 127 | /dev/sda4 / ext3 noatime 0 1 |
127 | /dev/sda4 / ext3 noatime 0 1 |
| 128 | |
128 | |
| 129 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
129 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
|
|
130 | |
|
|
131 | proc /proc proc defaults 0 0 |
|
|
132 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 130 | </pre> |
133 | </pre> |
| 131 | |
134 | |
| 132 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS' or func:keyval('arch')='x86' or func:keyval('arch')='AMD64'"> |
135 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS' or func:keyval('arch')='x86' or func:keyval('arch')='AMD64'"> |
| 133 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
136 | <keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 |
| 134 | /dev/sda2 none swap sw 0 0 |
137 | /dev/sda2 none swap sw 0 0 |
| 135 | /dev/sda3 / ext3 noatime 0 1 |
138 | /dev/sda3 / ext3 noatime 0 1 |
| 136 | |
139 | |
| 137 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
140 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
|
|
141 | |
|
|
142 | proc /proc proc defaults 0 0 |
|
|
143 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 138 | </pre> |
144 | </pre> |
| 139 | |
145 | |
| 140 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='SPARC'"> |
146 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='SPARC'"> |
| 141 | /dev/sda1 / ext3 noatime 0 1 |
147 | /dev/sda1 / ext3 noatime 0 1 |
| 142 | /dev/sda2 none swap sw 0 0 |
148 | /dev/sda2 none swap sw 0 0 |
| … | |
… | |
| 146 | |
152 | |
| 147 | <comment># You must add the rules for openprom</comment> |
153 | <comment># You must add the rules for openprom</comment> |
| 148 | openprom /proc/openprom openpromfs defaults 0 0 |
154 | openprom /proc/openprom openpromfs defaults 0 0 |
| 149 | |
155 | |
| 150 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
156 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
|
|
157 | |
|
|
158 | proc /proc proc defaults 0 0 |
|
|
159 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 151 | </pre> |
160 | </pre> |
| 152 | |
161 | |
| 153 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC' or |
162 | <pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC' or |
| 154 | func:keyval('arch')='PPC64'"> |
163 | func:keyval('arch')='PPC64'"> |
| 155 | /dev/sda4 / ext3 noatime 0 1 |
164 | /dev/sda4 / ext3 noatime 0 1 |
| 156 | /dev/sda3 none swap sw 0 0 |
165 | /dev/sda3 none swap sw 0 0 |
| 157 | |
166 | |
| 158 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
167 | /dev/cdrom /mnt/cdrom auto noauto,user 0 0 |
|
|
168 | |
|
|
169 | proc /proc proc defaults 0 0 |
|
|
170 | shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 159 | </pre> |
171 | </pre> |
| 160 | |
172 | |
| 161 | <p> |
173 | <p> |
| 162 | <c>auto</c> makes <c>mount</c> guess for the filesystem (recommended for |
174 | <c>auto</c> makes <c>mount</c> guess for the filesystem (recommended for |
| 163 | removable media as they can be created with one of many filesystems) and |
175 | removable media as they can be created with one of many filesystems) and |
| … | |
… | |
| 192 | </p> |
204 | </p> |
| 193 | |
205 | |
| 194 | <pre caption="Setting the host name"> |
206 | <pre caption="Setting the host name"> |
| 195 | # <i>nano -w /etc/conf.d/hostname</i> |
207 | # <i>nano -w /etc/conf.d/hostname</i> |
| 196 | |
208 | |
| 197 | <comment>(Set the HOSTNAME variable to your host name)</comment> |
209 | <comment>(Set the hostname variable to your host name)</comment> |
| 198 | HOSTNAME="<i>tux</i>" |
210 | hostname="<i>tux</i>" |
| 199 | </pre> |
211 | </pre> |
| 200 | |
212 | |
| 201 | <p> |
213 | <p> |
| 202 | Second, <e>if</e> you need a domainname, set it in <path>/etc/conf.d/net</path>. |
214 | Second, <e>if</e> you need a domainname, set it in <path>/etc/conf.d/net</path>. |
| 203 | You only need a domain if your ISP or network administrator says so, or if you |
215 | You only need a domain if your ISP or network administrator says so, or if you |
| … | |
… | |
| 296 | To enter your own IP address, netmask and gateway, you need |
308 | To enter your own IP address, netmask and gateway, you need |
| 297 | to set both <c>config_eth0</c> and <c>routes_eth0</c>: |
309 | to set both <c>config_eth0</c> and <c>routes_eth0</c>: |
| 298 | </p> |
310 | </p> |
| 299 | |
311 | |
| 300 | <pre caption="Manually setting IP information for eth0"> |
312 | <pre caption="Manually setting IP information for eth0"> |
| 301 | config_eth0=( "192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" ) |
313 | config_eth0="192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" |
| 302 | routes_eth0=( "default via 192.168.0.1" ) |
314 | routes_eth0="default via 192.168.0.1" |
| 303 | </pre> |
315 | </pre> |
| 304 | |
316 | |
| 305 | <p> |
317 | <p> |
| 306 | To use DHCP, define <c>config_eth0</c>: |
318 | To use DHCP, define <c>config_eth0</c>: |
| 307 | </p> |
319 | </p> |
| 308 | |
320 | |
| 309 | <pre caption="Automatically obtaining an IP address for eth0"> |
321 | <pre caption="Automatically obtaining an IP address for eth0"> |
| 310 | config_eth0=( "dhcp" ) |
322 | config_eth0="dhcp" |
| 311 | </pre> |
323 | </pre> |
| 312 | |
324 | |
| 313 | <p> |
325 | <p> |
| 314 | Please read <path>/etc/conf.d/net.example</path> for a list of all available |
326 | Please read <path>/etc/conf.d/net.example</path> for a list of all available |
| 315 | options. Be sure to also read your DHCP client manpage if you need to set |
327 | options. Be sure to also read your DHCP client manpage if you need to set |
| … | |
… | |
| 335 | To have your network interfaces activated at boot, you need to add them to the |
347 | To have your network interfaces activated at boot, you need to add them to the |
| 336 | default runlevel. |
348 | default runlevel. |
| 337 | </p> |
349 | </p> |
| 338 | |
350 | |
| 339 | <pre caption="Adding net.eth0 to the default runlevel"> |
351 | <pre caption="Adding net.eth0 to the default runlevel"> |
|
|
352 | # <i>cd /etc/init.d</i> |
|
|
353 | # <i>ln -s net.lo net.eth0</i> |
| 340 | # <i>rc-update add net.eth0 default</i> |
354 | # <i>rc-update add net.eth0 default</i> |
| 341 | </pre> |
355 | </pre> |
| 342 | |
356 | |
| 343 | <p> |
357 | <p> |
| 344 | If you have several network interfaces, you need to create the appropriate |
358 | If you have several network interfaces, you need to create the appropriate |
| 345 | <path>net.eth1</path>, <path>net.eth2</path> etc. initscripts for those. You can |
359 | <path>net.eth1</path>, <path>net.eth2</path> etc. just like you did with |
| 346 | use <c>ln</c> to do this: |
360 | <path>net.eth0</path>. |
| 347 | </p> |
|
|
| 348 | |
|
|
| 349 | <pre caption="Creating extra initscripts"> |
|
|
| 350 | # <i>cd /etc/init.d</i> |
|
|
| 351 | # <i>ln -s net.lo net.eth1</i> |
|
|
| 352 | # <i>rc-update add net.eth1 default</i> |
|
|
| 353 | </pre> |
361 | </p> |
| 354 | |
362 | |
| 355 | </body> |
363 | </body> |
| 356 | </subsection> |
364 | </subsection> |
| 357 | <subsection> |
365 | <subsection> |
| 358 | <title>Writing Down Network Information</title> |
366 | <title>Writing Down Network Information</title> |
| … | |
… | |
| 455 | <pre caption="Opening /etc/conf.d/keymaps"> |
463 | <pre caption="Opening /etc/conf.d/keymaps"> |
| 456 | # <i>nano -w /etc/conf.d/keymaps</i> |
464 | # <i>nano -w /etc/conf.d/keymaps</i> |
| 457 | </pre> |
465 | </pre> |
| 458 | |
466 | |
| 459 | <p> |
467 | <p> |
| 460 | Take special care with the <c>KEYMAP</c> variable. If you select the wrong |
468 | Take special care with the <c>keymap</c> variable. If you select the wrong |
| 461 | <c>KEYMAP</c>, you will get weird results when typing on your keyboard. |
469 | <c>keymap</c>, you will get weird results when typing on your keyboard. |
| 462 | </p> |
470 | </p> |
| 463 | |
471 | |
| 464 | <note test="substring(func:keyval('arch'),1,3)='PPC'"> |
472 | <note test="substring(func:keyval('arch'),1,3)='PPC'"> |
| 465 | PPC uses x86 keymaps on most systems. Users who want to be able to use ADB |
473 | PPC uses x86 keymaps on most systems. |
| 466 | keymaps on boot have to enable ADB keycode sendings in their kernel and have to |
|
|
| 467 | set a mac/ppc keymap in <path>/etc/conf.d/keymaps</path>. |
|
|
| 468 | </note> |
474 | </note> |
| 469 | |
475 | |
| 470 | <p> |
476 | <p> |
| 471 | When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and |
477 | When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and |
| 472 | exit. |
478 | exit. |
| 473 | </p> |
479 | </p> |
| 474 | |
480 | |
| 475 | <p> |
481 | <p> |
| 476 | Gentoo uses <path>/etc/conf.d/clock</path> to set clock options. Edit it |
482 | Gentoo uses <path>/etc/conf.d/hwclock</path> to set clock options. Edit it |
| 477 | according to your needs. |
483 | according to your needs. |
| 478 | </p> |
484 | </p> |
| 479 | |
485 | |
| 480 | <pre caption="Opening /etc/conf.d/clock"> |
486 | <pre caption="Opening /etc/conf.d/hwclock"> |
| 481 | # <i>nano -w /etc/conf.d/clock</i> |
487 | # <i>nano -w /etc/conf.d/hwclock</i> |
| 482 | </pre> |
488 | </pre> |
| 483 | |
489 | |
| 484 | <p> |
490 | <p> |
| 485 | If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c> |
491 | If your hardware clock is not using UTC, you need to add <c>clock="local"</c> |
| 486 | to the file. Otherwise you will notice some clock skew. |
492 | to the file. Otherwise you will notice some clock skew. |
| 487 | </p> |
493 | </p> |
| 488 | |
494 | |
| 489 | <p> |
495 | <p> |
|
|
496 | When you're finished configuring <path>/etc/conf.d/hwclock</path>, save and |
|
|
497 | exit. |
|
|
498 | </p> |
|
|
499 | |
|
|
500 | <p> |
| 490 | You should define the timezone that you previously copied to |
501 | You should define the timezone that you previously copied to |
| 491 | <path>/etc/localtime</path> so that further upgrades of the |
502 | <path>/etc/localtime</path> in the <path>/etc/timezone</path> file so that |
| 492 | <c>sys-libs/timezone-data</c> package can update <path>/etc/localtime</path> |
503 | further upgrades of the <c>sys-libs/timezone-data</c> package can update |
| 493 | automatically. For instance, if you used the GMT timezone, you would add |
504 | <path>/etc/localtime</path> automatically. For instance, if you used the GMT |
| 494 | <c>TIMEZONE="GMT"</c> |
505 | timezone, you would write <c>GMT</c> in the <path>/etc/timezone</path> file. |
| 495 | </p> |
|
|
| 496 | |
|
|
| 497 | <p> |
|
|
| 498 | When you're finished configuring <path>/etc/conf.d/clock</path>, save and |
|
|
| 499 | exit. |
|
|
| 500 | </p> |
506 | </p> |
| 501 | |
507 | |
| 502 | <p test="not(func:keyval('arch')='PPC64')"> |
508 | <p test="not(func:keyval('arch')='PPC64')"> |
| 503 | Please continue with <uri link="?part=1&chap=9">Installing Necessary System |
509 | Please continue with <uri link="?part=1&chap=9">Installing Necessary System |
| 504 | Tools</uri>. |
510 | Tools</uri>. |