… | |
… | |
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.68 2005/06/24 19:38:00 fox2mike Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.76 2006/03/28 10:35:59 neysx Exp $ --> |
8 | |
8 | |
9 | <sections> |
9 | <sections> |
10 | |
10 | |
11 | <version>2.9</version> |
11 | <version>2.18</version> |
12 | <date>2005-06-24</date> |
12 | <date>2006-03-28</date> |
13 | |
13 | |
14 | <section> |
14 | <section> |
15 | <title>Filesystem Information</title> |
15 | <title>Filesystem Information</title> |
16 | <subsection> |
16 | <subsection> |
17 | <title>What is fstab?</title> |
17 | <title>What is fstab?</title> |
… | |
… | |
78 | </pre> |
78 | </pre> |
79 | |
79 | |
80 | <p> |
80 | <p> |
81 | Let us take a look at how we write down the options for the <path>/boot</path> |
81 | Let us take a look at how we write down the options for the <path>/boot</path> |
82 | partition. This is just an example, so if your architecture doesn't require a |
82 | partition. This is just an example, so if your architecture doesn't require a |
83 | <path>/boot</path> partition (such as <b>PPC</b>), don't copy it verbatim. |
83 | <path>/boot</path> partition (such as Apple <b>PPC</b> machines), don't copy it |
|
|
84 | verbatim. |
84 | </p> |
85 | </p> |
85 | |
86 | |
86 | <p> |
87 | <p> |
87 | In our default x86 partitioning example <path>/boot</path> is the |
88 | In our default x86 partitioning example <path>/boot</path> is the |
88 | <path>/dev/hda1</path> partition, with <c>ext2</c> as filesystem. |
89 | <path>/dev/hda1</path> partition, with <c>ext2</c> as filesystem. |
… | |
… | |
208 | |
209 | |
209 | <comment>(Set the NISDOMAIN variable to your NIS domain name)</comment> |
210 | <comment>(Set the NISDOMAIN variable to your NIS domain name)</comment> |
210 | NISDOMAIN="<i>my-nisdomain</i>" |
211 | NISDOMAIN="<i>my-nisdomain</i>" |
211 | </pre> |
212 | </pre> |
212 | |
213 | |
213 | <p> |
|
|
214 | Now add the <c>domainname</c> script to the default runlevel: |
|
|
215 | </p> |
|
|
216 | |
|
|
217 | <pre caption="Adding domainname to the default runlevel"> |
|
|
218 | # <i>rc-update add domainname default</i> |
|
|
219 | </pre> |
|
|
220 | |
|
|
221 | </body> |
214 | </body> |
222 | </subsection> |
215 | </subsection> |
223 | <subsection> |
216 | <subsection> |
224 | <title>Configuring your Network</title> |
217 | <title>Configuring your Network</title> |
225 | <body> |
218 | <body> |
… | |
… | |
231 | your Gentoo system permanently. |
224 | your Gentoo system permanently. |
232 | </p> |
225 | </p> |
233 | |
226 | |
234 | <note> |
227 | <note> |
235 | More detailed information about networking, including advanced topics like |
228 | More detailed information about networking, including advanced topics like |
236 | bonding, bridging, 802.11q VLANs or wireless networking is covered in the <uri |
229 | bonding, bridging, 802.1Q VLANs or wireless networking is covered in the <uri |
237 | link="?part=4">Gentoo Network Configuration</uri> section. |
230 | link="?part=4">Gentoo Network Configuration</uri> section. |
238 | </note> |
231 | </note> |
239 | |
232 | |
240 | <p> |
233 | <p> |
241 | All networking information is gathered in <path>/etc/conf.d/net</path>. It uses |
234 | All networking information is gathered in <path>/etc/conf.d/net</path>. It uses |
242 | a straightforward yet not intuitive syntax if you don't know how to set up |
235 | a straightforward yet not intuitive syntax if you don't know how to set up |
243 | networking manually. But don't fear, we'll explain everything :) |
236 | networking manually. But don't fear, we'll explain everything. A fully |
244 | </p> |
237 | commented example that covers many different configurations is available in |
245 | |
238 | <path>/etc/conf.d/net.example</path>. |
246 | <p> |
239 | </p> |
|
|
240 | |
|
|
241 | <p> |
|
|
242 | DHCP is used by default and does not require any further configuration. |
|
|
243 | </p> |
|
|
244 | |
|
|
245 | <p> |
|
|
246 | If you need to configure your network connection either because you need |
|
|
247 | specific DHCP options or because you do not use DHCP at all, open |
247 | First open <path>/etc/conf.d/net</path> with your favorite editor (<c>nano</c> |
248 | <path>/etc/conf.d/net</path> with your favorite editor (<c>nano</c> is used in |
248 | is used in this example): |
249 | this example): |
249 | </p> |
250 | </p> |
250 | |
251 | |
251 | <pre caption="Opening /etc/conf.d/net for editing"> |
252 | <pre caption="Opening /etc/conf.d/net for editing"> |
252 | # <i>nano -w /etc/conf.d/net</i> |
253 | # <i>nano -w /etc/conf.d/net</i> |
253 | </pre> |
254 | </pre> |
254 | |
255 | |
255 | <p> |
256 | <p> |
256 | The first variable you'll find is called <c>config_eth0</c>. As you can probably |
257 | You will see the following file: |
257 | imagine, this variable configured the eth0 network interface. If the interface |
258 | </p> |
258 | needs to automatically obtain an IP address through DHCP, you should set it |
259 | |
259 | like so: |
260 | <pre caption="Default /etc/conf.d/net"> |
|
|
261 | # This blank configuration will automatically use DHCP for any net.* |
|
|
262 | # scripts in /etc/init.d. To create a more complete configuration, |
|
|
263 | # please review /etc/conf.d/net.example and save your configuration |
|
|
264 | # in /etc/conf.d/net (this file :]!). |
|
|
265 | </pre> |
|
|
266 | |
|
|
267 | <p> |
|
|
268 | To enter your own IP address, netmask and gateway, you need |
|
|
269 | to set both <c>config_eth0</c> and <c>routes_eth0</c>: |
|
|
270 | </p> |
|
|
271 | |
|
|
272 | <pre caption="Manually setting IP information for eth0"> |
|
|
273 | config_eth0=( "192.168.0.2 netmask 255.255.255.0 brd 192.168.0.255" ) |
|
|
274 | routes_eth0=( "default gw 192.168.0.1" ) |
|
|
275 | </pre> |
|
|
276 | |
|
|
277 | <p> |
|
|
278 | To use DHCP and add specific DHCP options, define <c>config_eth0</c> and |
|
|
279 | <c>dhcp_eth0</c>: |
260 | </p> |
280 | </p> |
261 | |
281 | |
262 | <pre caption="Automatically obtaining an IP address for eth0"> |
282 | <pre caption="Automatically obtaining an IP address for eth0"> |
263 | config_eth0=( "dhcp" ) |
283 | config_eth0=( "dhcp" ) |
|
|
284 | dhcp_eth0="nodns nontp nonis" |
264 | </pre> |
285 | </pre> |
265 | |
286 | |
266 | <p> |
|
|
267 | However, if you have to enter your own IP address, netmask and gateway, you need |
|
|
268 | to set both <c>config_eth0</c> and <c>routes_eth0</c>: |
|
|
269 | </p> |
287 | <p> |
270 | |
288 | Please read <path>/etc/conf.d/net.example</path> for a list of all available |
271 | <pre caption="Manually setting IP information for eth0"> |
289 | options. |
272 | config_eth0=( "192.168.0.2 netmask 255.255.255.0" ) |
|
|
273 | routes_eth0=( "default gw 192.168.0.1" ) |
|
|
274 | </pre> |
290 | </p> |
275 | |
291 | |
276 | <p> |
292 | <p> |
277 | If you have several network interfaces repeat the above steps for |
293 | If you have several network interfaces repeat the above steps for |
278 | <c>config_eth1</c>, <c>config_eth2</c>, etc. |
294 | <c>config_eth1</c>, <c>config_eth2</c>, etc. |
279 | </p> |
295 | </p> |
… | |
… | |
431 | When you're finished configuring <path>/etc/rc.conf</path>, save and exit. |
447 | When you're finished configuring <path>/etc/rc.conf</path>, save and exit. |
432 | </p> |
448 | </p> |
433 | |
449 | |
434 | <p> |
450 | <p> |
435 | As you can see, this file is well commented to help you set up the necessary |
451 | As you can see, this file is well commented to help you set up the necessary |
436 | configuration variables. Among other settings, you can configure your console |
452 | configuration variables. You can configure your system to use unicode and |
437 | fonts, your default editor and your display manager (like gdm or kdm). |
453 | define your default editor and your display manager (like gdm or kdm). |
438 | </p> |
454 | </p> |
439 | |
455 | |
440 | <p> |
456 | <p> |
441 | Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration. |
457 | Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration. |
442 | Edit it to configure your keyboard. |
458 | Edit it to configure your keyboard. |
… | |
… | |
451 | <c>KEYMAP</c>, you will get weird results when typing on your keyboard. |
467 | <c>KEYMAP</c>, you will get weird results when typing on your keyboard. |
452 | </p> |
468 | </p> |
453 | |
469 | |
454 | <note> |
470 | <note> |
455 | Users of USB-based <b>SPARC</b> systems and <b>SPARC</b> clones might need to |
471 | Users of USB-based <b>SPARC</b> systems and <b>SPARC</b> clones might need to |
456 | select an i386 keymap (such as "us") instead of "sunkeymap". |
472 | select an i386 keymap (such as "us") instead of "sunkeymap". <b>PPC</b> uses x86 |
|
|
473 | keymaps on most systems. Users who want to be able to use ADB keymaps on boot |
|
|
474 | have to enable ADB keycode sendings in their kernel and have to set a mac/ppc |
|
|
475 | keymap in <path>/etc/conf.d/keymaps</path>. |
457 | </note> |
476 | </note> |
458 | |
|
|
459 | <p> |
|
|
460 | <b>PPC</b> uses x86 keymaps on most systems. Users who want to be able to use |
|
|
461 | ADB keymaps on boot have to enable ADB keycode sendings in their kernel and have |
|
|
462 | to set a mac/ppc keymap in <path>/etc/conf.d/keymaps</path>. |
|
|
463 | </p> |
|
|
464 | |
477 | |
465 | <p> |
478 | <p> |
466 | When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and |
479 | When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and |
467 | exit. |
480 | exit. |
468 | </p> |
481 | </p> |
… | |
… | |
476 | # <i>nano -w /etc/conf.d/clock</i> |
489 | # <i>nano -w /etc/conf.d/clock</i> |
477 | </pre> |
490 | </pre> |
478 | |
491 | |
479 | <p> |
492 | <p> |
480 | If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c> to |
493 | If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c> to |
481 | the file. Otherwise you will notice some clock skew. |
494 | the file. Otherwise you will notice some clock skew. Furthermore, Windows |
|
|
495 | assumes that your hardware clock uses local time, so if you want to dualboot, |
|
|
496 | you should set this variable appropriately, otherwise your clock will go crazy. |
482 | </p> |
497 | </p> |
483 | |
498 | |
484 | <p> |
499 | <p> |
485 | When you're finished configuring <path>/etc/conf.d/clock</path>, save and |
500 | When you're finished configuring <path>/etc/conf.d/clock</path>, save and |
486 | exit. |
501 | exit. |
487 | </p> |
502 | </p> |
488 | |
503 | |
489 | <p> |
504 | <p> |
490 | If you are not installing Gentoo on an IBM POWER5 or JS20 system, continue with |
505 | If you are not installing Gentoo on IBM PPC64 hardware, continue with |
491 | <uri link="?part=1&chap=9">Installing Necessary System Tools</uri>. |
506 | <uri link="?part=1&chap=9">Installing Necessary System Tools</uri>. |
492 | </p> |
507 | </p> |
493 | |
508 | |
494 | </body> |
509 | </body> |
495 | </subsection> |
510 | </subsection> |
496 | <subsection> |
511 | <subsection> |
497 | <title>Configuring the Console</title> |
512 | <title>Configuring the Console</title> |
498 | <body> |
513 | <body> |
499 | |
514 | |
500 | <note> |
515 | <note> |
501 | The following section applies to the IBM POWER5 and JS20 hardware platforms. |
516 | The following section applies to the IBM PPC64 hardware platforms. |
502 | </note> |
517 | </note> |
503 | |
518 | |
504 | <p> |
519 | <p> |
505 | If you are running Gentoo in an LPAR or on a JS20 blade, you must uncomment |
520 | If you are running Gentoo on IBM PPC64 hardware and using a virtual console |
506 | the hvc line in /etc/inittab for the virtual console to spawn a login prompt. |
521 | you must uncomment the appropriate line in <path>/etc/inittab</path> for the |
|
|
522 | virtual console to spawn a login prompt. |
507 | </p> |
523 | </p> |
508 | |
524 | |
509 | <pre caption="Enabling hvc support in /etc/inittab"> |
525 | <pre caption="Enabling hvc or hvsi support in /etc/inittab"> |
510 | hvc:12345:respawn:/sbin/agetty -nl /bin/bashlogin 9600 hvc0 vt220 |
526 | hvc0:12345:respawn:/sbin/agetty -L 9600 hvc0 |
|
|
527 | hvsi:12345:respawn:/sbin/agetty -L 19200 hvsi0 |
|
|
528 | </pre> |
|
|
529 | |
|
|
530 | <p> |
|
|
531 | You should also take this time to verify that the appropriate console is |
|
|
532 | listed in <path>/etc/securetty</path>. |
511 | </pre> |
533 | </p> |
512 | |
534 | |
513 | <p> |
535 | <p> |
514 | You may now continue with <uri link="?part=1&chap=9">Installing Necessary |
536 | You may now continue with <uri link="?part=1&chap=9">Installing Necessary |
515 | System Tools</uri>. |
537 | System Tools</uri>. |
516 | </p> |
538 | </p> |