|
|
1 | <?xml version='1.0' encoding='UTF-8'?> |
|
|
2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
|
|
3 | |
| 1 | <!-- 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 --> |
| 2 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
5 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 3 | |
6 | |
| 4 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.14 2003/12/20 20:32:02 swift Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.78 2006/05/27 13:02:15 neysx Exp $ --> |
| 5 | |
8 | |
| 6 | <sections> |
9 | <sections> |
| 7 | <section> |
|
|
| 8 | <title>Timezone</title> |
|
|
| 9 | <body> |
|
|
| 10 | |
10 | |
| 11 | <p> |
11 | <version>2.19</version> |
| 12 | You now need to select your timezone so that your system knows where it is |
12 | <date>2006-05-27</date> |
| 13 | located. Look for your timezone in <path>/usr/share/zoneinfo</path>, then make a |
|
|
| 14 | symlink to <path>/etc/localtime</path> using <c>ln</c>: |
|
|
| 15 | </p> |
|
|
| 16 | |
13 | |
| 17 | <pre caption="Setting the timezone information"> |
|
|
| 18 | # <i>ls /usr/share/zoneinfo</i> |
|
|
| 19 | <comment>(Suppose you want to use GMT:)</comment> |
|
|
| 20 | # <i>ln -sf /usr/share/zoneinfo/GMT /etc/localtime</i> |
|
|
| 21 | </pre> |
|
|
| 22 | |
|
|
| 23 | </body> |
|
|
| 24 | </section> |
|
|
| 25 | <section> |
14 | <section> |
| 26 | <title>Filesystem Information</title> |
15 | <title>Filesystem Information</title> |
| 27 | <subsection> |
16 | <subsection> |
| 28 | <title>What is fstab?</title> |
17 | <title>What is fstab?</title> |
| 29 | <body> |
18 | <body> |
| 30 | |
19 | |
| 31 | <p> |
20 | <p> |
| 32 | Under Linux, all partitions used by the system must be listed in |
21 | Under Linux, all partitions used by the system must be listed in |
| 33 | <path>/etc/fstab</path>. This file contains the mountpoints of those partitions |
22 | <path>/etc/fstab</path>. This file contains the mountpoints of those partitions |
| 34 | (where they are seen in the file system structure), how they should be mounted |
23 | (where they are seen in the file system structure), how they should be mounted |
| 35 | (special options) and when (automatically or not, can users mount those or not, |
24 | and with what special options (automatically or not, whether users can mount |
| 36 | etc.). |
25 | them or not, etc.) |
| 37 | </p> |
26 | </p> |
| 38 | |
27 | |
| 39 | </body> |
28 | </body> |
| 40 | </subsection> |
29 | </subsection> |
| 41 | <subsection> |
30 | <subsection> |
| 42 | <title>Creating /etc/fstab</title> |
31 | <title>Creating /etc/fstab</title> |
| 43 | <body> |
32 | <body> |
| 44 | |
33 | |
| 45 | <p> |
34 | <p> |
| 46 | <path>/etc/fstab</path> uses a special syntaxis. Every line consists of six |
35 | <path>/etc/fstab</path> uses a special syntax. Every line consists of six |
| 47 | fields, separated by whitespace (space(s), tabs or a mixture). Each field has |
36 | fields, separated by whitespace (space(s), tabs or a mixture). Each field has |
| 48 | its own meaning: |
37 | its own meaning: |
| 49 | </p> |
38 | </p> |
| 50 | |
39 | |
| 51 | <ul> |
40 | <ul> |
| … | |
… | |
| 61 | The third field shows the <b>filesystem</b> used by the partition |
50 | The third field shows the <b>filesystem</b> used by the partition |
| 62 | </li> |
51 | </li> |
| 63 | <li> |
52 | <li> |
| 64 | The fourth field shows the <b>mountoptions</b> used by <c>mount</c> when it |
53 | The fourth field shows the <b>mountoptions</b> used by <c>mount</c> when it |
| 65 | wants to mount the partition. As every filesystem has its own mountoptions, |
54 | wants to mount the partition. As every filesystem has its own mountoptions, |
| 66 | you are encouraged to read the mount manpage (<c>man mount</c>) for a full |
55 | you are encouraged to read the mount man page (<c>man mount</c>) for a full |
| 67 | listing. Multiple mountoptions are comma-separated. |
56 | listing. Multiple mountoptions are comma-separated. |
| 68 | </li> |
57 | </li> |
| 69 | <li> |
58 | <li> |
| 70 | The fifth field is used by <c>dump</c> to determine if the partition needs to |
59 | The fifth field is used by <c>dump</c> to determine if the partition needs to |
| 71 | be <b>dump</b>ed or not. You can generally leave this as <c>0</c> (zero). |
60 | be <b>dump</b>ed or not. You can generally leave this as <c>0</c> (zero). |
| 72 | </li> |
61 | </li> |
| 73 | <li> |
62 | <li> |
| 74 | The sixth field is used by <c>fsck</c> the order in which filesystems should |
63 | The sixth field is used by <c>fsck</c> to determine the order in which |
| 75 | be <b>check</b>ed if the system wasn't shut down properly. The root filesystem |
64 | filesystems should be <b>check</b>ed if the system wasn't shut down properly. |
| 76 | should have <c>1</c> while the rest should have <c>2</c> (or <c>0</c> in case |
65 | The root filesystem should have <c>1</c> while the rest should have <c>2</c> |
| 77 | a filesystem check isn't necessary). |
66 | (or <c>0</c> if a filesystem check isn't necessary). |
| 78 | </li> |
67 | </li> |
| 79 | </ul> |
68 | </ul> |
| 80 | |
69 | |
| 81 | <p> |
70 | <p> |
|
|
71 | The default <path>/etc/fstab</path> file provided by Gentoo <e>is not a valid |
| 82 | So start <c>nano</c> (or your favorite editor) to create your |
72 | fstab file</e>, so start <c>nano</c> (or your favorite editor) to create your |
| 83 | <path>/etc/fstab</path>: |
73 | <path>/etc/fstab</path>: |
| 84 | </p> |
74 | </p> |
| 85 | |
75 | |
| 86 | <pre caption="Opening /etc/fstab"> |
76 | <pre caption="Opening /etc/fstab"> |
| 87 | # <i>nano -w /etc/fstab</i> |
77 | # <i>nano -w /etc/fstab</i> |
| 88 | </pre> |
78 | </pre> |
| 89 | |
79 | |
| 90 | <p> |
80 | <p> |
| 91 | Lets 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> |
| 92 | 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 |
| 93 | <path>/boot</path> partition, don't copy it verbatim. |
83 | <path>/boot</path> partition (such as Apple <b>PPC</b> machines), don't copy it |
|
|
84 | verbatim. |
| 94 | </p> |
85 | </p> |
| 95 | |
86 | |
| 96 | <p> |
87 | <p> |
| 97 | In our default x86 partitioning example <path>/boot</path> is the |
88 | In our default x86 partitioning example <path>/boot</path> is the |
| 98 | <path>/dev/hda1</path> partition, with <c>ext2</c> as filesystem. It shouldn't |
89 | <path>/dev/hda1</path> partition, with <c>ext2</c> as filesystem. |
| 99 | be mounted automatically (<c>noauto</c>) but does need to be checked. So we |
90 | It needs to be checked during boot, so we would write down: |
| 100 | would write down: |
|
|
| 101 | </p> |
91 | </p> |
| 102 | |
92 | |
| 103 | <pre caption="An example /boot line for /etc/fstab"> |
93 | <pre caption="An example /boot line for /etc/fstab"> |
| 104 | /dev/hda1 /boot ext2 noauto 1 2 |
94 | /dev/hda1 /boot ext2 defaults 1 2 |
|
|
95 | </pre> |
|
|
96 | |
|
|
97 | <p> |
|
|
98 | Some users don't want their <path>/boot</path> partition to be mounted |
|
|
99 | automatically to improve their system's security. Those people should |
|
|
100 | substitute <c>defaults</c> with <c>noauto</c>. This does mean that you need to |
|
|
101 | manually mount this partition every time you want to use it. |
| 105 | </pre> |
102 | </p> |
| 106 | |
103 | |
| 107 | <p> |
104 | <p> |
| 108 | Now, to improve performance, most users would want to add the <c>noatime</c> |
105 | Now, to improve performance, most users would want to add the <c>noatime</c> |
| 109 | option as mountoption, which results in a faster system since access times |
106 | option as mountoption, which results in a faster system since access times |
| 110 | aren't registered (you don't need those generally anyway): |
107 | aren't registered (you don't need those generally anyway): |
| 111 | </p> |
108 | </p> |
| 112 | |
109 | |
| 113 | <pre caption="An improved /boot line for /etc/fstab"> |
110 | <pre caption="An improved /boot line for /etc/fstab"> |
| 114 | /dev/hda1 /boot ext2 noauto,noatime 1 2 |
111 | /dev/hda1 /boot ext2 defaults,noatime 1 2 |
| 115 | </pre> |
112 | </pre> |
| 116 | |
113 | |
| 117 | <p> |
114 | <p> |
| 118 | If we continue with this, we would end up with the following three lines (for |
115 | If we continue with this, we would end up with the following three lines (for |
| 119 | <path>/boot</path>, <path>/</path> and the swap partition): |
116 | <path>/boot</path>, <path>/</path> and the swap partition): |
| 120 | </p> |
117 | </p> |
| 121 | |
118 | |
| 122 | <pre caption="Three /etc/fstab lines"> |
119 | <pre caption="Three /etc/fstab lines"> |
| 123 | /dev/hda1 /boot ext2 noauto,noatime 1 2 |
120 | /dev/hda1 /boot ext2 defaults,noatime 1 2 |
| 124 | /dev/hda2 none swap sw 0 0 |
121 | /dev/hda2 none swap sw 0 0 |
| 125 | /dev/hda3 / ext3 noatime 0 1 |
122 | /dev/hda3 / ext3 noatime 0 1 |
| 126 | </pre> |
123 | </pre> |
| 127 | |
124 | |
| 128 | <p> |
125 | <p> |
| … | |
… | |
| 130 | (required) and for your CD-ROM drive (and of course, if you have other |
127 | (required) and for your CD-ROM drive (and of course, if you have other |
| 131 | partitions or drives, for those too): |
128 | partitions or drives, for those too): |
| 132 | </p> |
129 | </p> |
| 133 | |
130 | |
| 134 | <pre caption="A full /etc/fstab example"> |
131 | <pre caption="A full /etc/fstab example"> |
| 135 | /dev/hda1 /boot ext2 noauto,noatime 1 2 |
132 | /dev/hda1 /boot ext2 defaults,noatime 1 2 |
| 136 | /dev/hda2 none swap sw 0 0 |
133 | /dev/hda2 none swap sw 0 0 |
| 137 | /dev/hda3 / ext3 noatime 0 1 |
134 | /dev/hda3 / ext3 noatime 0 1 |
| 138 | |
135 | |
| 139 | none /proc proc defaults 0 0 |
136 | none /proc proc defaults 0 0 |
| 140 | none /dev/shm tmpfs defaults 0 0 |
137 | none /dev/shm tmpfs nodev,nosuid,noexec 0 0 |
| 141 | |
138 | |
| 142 | /dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0 |
139 | /dev/cdroms/cdrom0 /mnt/cdrom auto noauto,user 0 0 |
| 143 | </pre> |
140 | </pre> |
| 144 | |
141 | |
| 145 | <p> |
142 | <p> |
| … | |
… | |
| 148 | <c>user</c> makes it possible for non-root users to mount the CD. |
145 | <c>user</c> makes it possible for non-root users to mount the CD. |
| 149 | </p> |
146 | </p> |
| 150 | |
147 | |
| 151 | <p> |
148 | <p> |
| 152 | Now use the above example to create your <path>/etc/fstab</path>. If you are a |
149 | Now use the above example to create your <path>/etc/fstab</path>. If you are a |
| 153 | SPARC-user, you should add the following line to your <path>/etc/fstab</path> |
150 | <b>SPARC</b>-user, you should add the following line to your |
|
|
151 | <path>/etc/fstab</path> |
| 154 | too: |
152 | too: |
| 155 | </p> |
153 | </p> |
| 156 | |
154 | |
| 157 | <pre caption="Adding openprom filesystem to /etc/fstab"> |
155 | <pre caption="Adding openprom filesystem to /etc/fstab"> |
| 158 | none /proc/openprom openpromfs defaults 0 0 |
156 | none /proc/openprom openpromfs defaults 0 0 |
| 159 | </pre> |
157 | </pre> |
| 160 | |
158 | |
| 161 | <p> |
159 | <p> |
| 162 | If you need <c>usbfs</c>, add the following line to <path>/etc/fstab</path>: |
|
|
| 163 | </p> |
|
|
| 164 | |
|
|
| 165 | <pre caption="Adding usbfs filesystem to /etc/fstab"> |
|
|
| 166 | none /proc/bus/usb usbfs defaults 0 0 |
|
|
| 167 | </pre> |
|
|
| 168 | |
|
|
| 169 | <p> |
|
|
| 170 | Reread your <path>/etc/fstab</path>, save and quit to continue. |
160 | Double-check your <path>/etc/fstab</path>, save and quit to continue. |
| 171 | </p> |
161 | </p> |
| 172 | |
162 | |
| 173 | </body> |
163 | </body> |
| 174 | </subsection> |
164 | </subsection> |
| 175 | </section> |
165 | </section> |
| … | |
… | |
| 178 | <subsection> |
168 | <subsection> |
| 179 | <title>Hostname, Domainname etc.</title> |
169 | <title>Hostname, Domainname etc.</title> |
| 180 | <body> |
170 | <body> |
| 181 | |
171 | |
| 182 | <p> |
172 | <p> |
| 183 | One of the choices the user has to make is name his PC. This seems to be quite |
173 | One of the choices the user has to make is name his/her PC. This seems to be |
| 184 | easy, but <e>lots</e> of users are having difficulties finding the appropriate |
174 | quite easy, but <e>lots</e> of users are having difficulties finding the |
| 185 | name for their Linux-pc. To speed things up, know that any name you choose can |
175 | appropriate name for their Linux-pc. To speed things up, know that any name you |
| 186 | be changed afterwards. For all we care, you can just call your system |
176 | choose can be changed afterwards. For all we care, you can just call your system |
| 187 | <c>tux</c> and domain <c>homenetwork</c>. |
177 | <c>tux</c> and domain <c>homenetwork</c>. |
| 188 | </p> |
178 | </p> |
| 189 | |
179 | |
| 190 | <p> |
180 | <p> |
| 191 | We use these values in the next examples. First we set the hostname: |
181 | We use these values in the next examples. First we set the hostname: |
| 192 | </p> |
182 | </p> |
| 193 | |
183 | |
| 194 | <pre caption="Setting the hostname"> |
184 | <pre caption="Setting the hostname"> |
| 195 | # <i>echo tux > /etc/hostname</i> |
185 | # <i>nano -w /etc/conf.d/hostname</i> |
|
|
186 | |
|
|
187 | <comment>(Set the HOSTNAME variable to your hostname)</comment> |
|
|
188 | HOSTNAME="<i>tux</i>" |
| 196 | </pre> |
189 | </pre> |
| 197 | |
190 | |
| 198 | <p> |
191 | <p> |
| 199 | Second we set the domainname: |
192 | Second we set the domainname: |
| 200 | </p> |
193 | </p> |
| 201 | |
194 | |
| 202 | <pre caption="Setting the domainname"> |
195 | <pre caption="Setting the domainname"> |
| 203 | # <i>echo homenetwork > /etc/dnsdomainname</i> |
196 | # <i>nano -w /etc/conf.d/domainname</i> |
|
|
197 | |
|
|
198 | <comment>(Set the DNSDOMAIN variable to your domain name)</comment> |
|
|
199 | DNSDOMAIN="<i>homenetwork</i>" |
| 204 | </pre> |
200 | </pre> |
| 205 | |
201 | |
| 206 | <p> |
202 | <p> |
| 207 | If you have a NIS domain (if you don't know what that is, then you don't have |
203 | If you have a NIS domain (if you don't know what that is, then you don't have |
| 208 | one), you need to define that one too: |
204 | one), you need to define that one too: |
| 209 | </p> |
205 | </p> |
| 210 | |
206 | |
| 211 | <pre caption="Setting the NIS domainname"> |
207 | <pre caption="Setting the NIS domainname"> |
| 212 | # <i>echo nis.homenetwork > /etc/nisdomainname</i> |
208 | # <i>nano -w /etc/conf.d/domainname</i> |
| 213 | </pre> |
|
|
| 214 | |
209 | |
| 215 | <p> |
210 | <comment>(Set the NISDOMAIN variable to your NIS domain name)</comment> |
| 216 | Now add the <c>domainname</c> script to the default runlevel: |
211 | NISDOMAIN="<i>my-nisdomain</i>" |
| 217 | </p> |
|
|
| 218 | |
|
|
| 219 | <pre caption="Adding domainname to the default runlevel"> |
|
|
| 220 | # <i>rc-update add domainname default</i> |
|
|
| 221 | </pre> |
212 | </pre> |
| 222 | |
213 | |
| 223 | </body> |
214 | </body> |
| 224 | </subsection> |
215 | </subsection> |
| 225 | <subsection> |
216 | <subsection> |
| 226 | <title>Configuring your Network</title> |
217 | <title>Configuring your Network</title> |
| 227 | <body> |
218 | <body> |
| 228 | |
219 | |
| 229 | <p> |
220 | <p> |
| 230 | Before you get that "Hey, we've had that already"-feeling, you should remember |
221 | Before you get that "Hey, we've had that already"-feeling, you should remember |
| 231 | that the networking you set up in the beginning of the gentoo installation was |
222 | that the networking you set up in the beginning of the Gentoo installation was |
| 232 | just for the installation. Right now you are going to configure networking for |
223 | just for the installation. Right now you are going to configure networking for |
| 233 | your Gentoo system permanently. |
224 | your Gentoo system permanently. |
| 234 | </p> |
225 | </p> |
| 235 | |
226 | |
|
|
227 | <note> |
|
|
228 | More detailed information about networking, including advanced topics like |
|
|
229 | bonding, bridging, 802.1Q VLANs or wireless networking is covered in the <uri |
|
|
230 | link="?part=4">Gentoo Network Configuration</uri> section. |
|
|
231 | </note> |
|
|
232 | |
| 236 | <p> |
233 | <p> |
| 237 | 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 |
| 238 | a straightforward yet not intuitive syntax if you don't know how to setup |
235 | a straightforward yet not intuitive syntax if you don't know how to set up |
| 239 | networking manually. But don't fear, we'll explain everything :) |
236 | networking manually. But don't fear, we'll explain everything. A fully |
| 240 | </p> |
237 | commented example that covers many different configurations is available in |
| 241 | |
238 | <path>/etc/conf.d/net.example</path>. |
| 242 | <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 |
| 243 | 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 |
| 244 | is used in this example): |
249 | this example): |
| 245 | </p> |
250 | </p> |
| 246 | |
251 | |
| 247 | <pre caption="Opening /etc/conf.d/net for editing"> |
252 | <pre caption="Opening /etc/conf.d/net for editing"> |
| 248 | # <i>nano -w /etc/conf.d/net</i> |
253 | # <i>nano -w /etc/conf.d/net</i> |
| 249 | </pre> |
254 | </pre> |
| 250 | |
255 | |
| 251 | <p> |
256 | <p> |
| 252 | The first variable you'll find is <c>iface_eth0</c>. It uses the following |
257 | You will see the following file: |
| 253 | syntax: |
|
|
| 254 | </p> |
|
|
| 255 | |
|
|
| 256 | <pre caption="iface_eth0 syntaxis"> |
|
|
| 257 | iface_eth0="<i><your ip address></i> broadcast <i><your broadcast address></i> netmask <i><your netmask></i>" |
|
|
| 258 | </pre> |
|
|
| 259 | |
|
|
| 260 | <p> |
258 | </p> |
| 261 | If you use DHCP (automatic IP retrieval), you should just set <c>iface_eth0</c> |
259 | |
| 262 | to <c>dhcp</c>. However, if you need to setup your network manually and you're |
260 | <pre caption="Default /etc/conf.d/net"> |
| 263 | not familiar with all the above terms, please read the section on <uri |
261 | # This blank configuration will automatically use DHCP for any net.* |
| 264 | link="?part=1&chap=3#doc_chap4_sect3">Understanding Network |
262 | # scripts in /etc/init.d. To create a more complete configuration, |
| 265 | Terminology</uri> if you haven't done so already. |
263 | # please review /etc/conf.d/net.example and save your configuration |
|
|
264 | # in /etc/conf.d/net (this file :]!). |
|
|
265 | </pre> |
|
|
266 | |
| 266 | </p> |
267 | <p> |
| 267 | |
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>: |
| 268 | <p> |
270 | </p> |
| 269 | So lets give two examples; the first one uses DHCP, the second one a static IP |
271 | |
| 270 | (192.168.0.2) with netmask 255.255.255.0, broadcast 192.168.0.255 and gateway |
272 | <pre caption="Manually setting IP information for eth0"> |
| 271 | 192.168.0.1: |
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 | |
| 272 | </p> |
277 | <p> |
| 273 | |
278 | To use DHCP and add specific DHCP options, define <c>config_eth0</c> and |
| 274 | <pre caption="Examples for /etc/conf.d/net"> |
279 | <c>dhcp_eth0</c>: |
| 275 | <comment>(For DHCP:)</comment> |
|
|
| 276 | iface_eth0="dhcp" |
|
|
| 277 | |
|
|
| 278 | <comment>(For static IP:)</comment> |
|
|
| 279 | iface_eth0="192.168.0.2 broadcast 192.168.0.255 netmask 255.255.255.0" |
|
|
| 280 | gateway="eth0/192.168.0.1" |
|
|
| 281 | </pre> |
|
|
| 282 | |
|
|
| 283 | <p> |
280 | </p> |
| 284 | If you have several network interfaces, create extra <c>iface_eth</c> variables, |
281 | |
| 285 | like <c>iface_eth1</c>, <c>iface_eth2</c> etc. The <c>gateway</c> variable |
282 | <pre caption="Automatically obtaining an IP address for eth0"> |
| 286 | shouldn't be reproduced as you can only set one gateway per computer. |
283 | config_eth0=( "dhcp" ) |
|
|
284 | dhcp_eth0="nodns nontp nonis" |
|
|
285 | </pre> |
|
|
286 | |
|
|
287 | <p> |
|
|
288 | Please read <path>/etc/conf.d/net.example</path> for a list of all available |
|
|
289 | options. |
|
|
290 | </p> |
|
|
291 | |
|
|
292 | <p> |
|
|
293 | If you have several network interfaces repeat the above steps for |
|
|
294 | <c>config_eth1</c>, <c>config_eth2</c>, etc. |
| 287 | </p> |
295 | </p> |
| 288 | |
296 | |
| 289 | <p> |
297 | <p> |
| 290 | Now save the configuration and exit to continue. |
298 | Now save the configuration and exit to continue. |
| 291 | </p> |
299 | </p> |
| … | |
… | |
| 295 | <subsection> |
303 | <subsection> |
| 296 | <title>Automatically Start Networking at Boot</title> |
304 | <title>Automatically Start Networking at Boot</title> |
| 297 | <body> |
305 | <body> |
| 298 | |
306 | |
| 299 | <p> |
307 | <p> |
| 300 | To have your network interfaces activated at boot, you need to add those to the |
308 | To have your network interfaces activated at boot, you need to add them to the |
| 301 | default runlevel. If you have PCMCIA interfaces you should skip this action as |
309 | default runlevel. If you have PCMCIA interfaces you should skip this action as |
| 302 | the PCMCIA interfaces are started by the PCMCIA init script. |
310 | the PCMCIA interfaces are started by the PCMCIA init script. |
| 303 | </p> |
311 | </p> |
| 304 | |
312 | |
| 305 | <pre caption="Adding net.eth0 to the default runlevel"> |
313 | <pre caption="Adding net.eth0 to the default runlevel"> |
| … | |
… | |
| 324 | <title>Writing Down Network Information</title> |
332 | <title>Writing Down Network Information</title> |
| 325 | <body> |
333 | <body> |
| 326 | |
334 | |
| 327 | <p> |
335 | <p> |
| 328 | You now need to inform Linux about your network. This is defined in |
336 | You now need to inform Linux about your network. This is defined in |
| 329 | <path>/etc/hosts</path> and helps in resolving hostnames to IP addresses |
337 | <path>/etc/hosts</path> and helps in resolving hostnames to IP addresses for |
| 330 | for hosts that aren't resolved by your nameserver. For instance, if your |
338 | hosts that aren't resolved by your nameserver. You need to define your system. |
| 331 | internal network consists of three PCs called <c>jenny</c> (192.168.0.5), |
339 | You may also want to define other systems on your network if you don't want to |
| 332 | <c>benny</c> (192.168.0.6) and <c>tux</c> (192.168.0.7 - this system) you would |
340 | set up your own internal DNS system. |
| 333 | open <path>/etc/hosts</path> and fill in the values: |
|
|
| 334 | </p> |
341 | </p> |
| 335 | |
342 | |
| 336 | <pre caption="Opening /etc/hosts"> |
343 | <pre caption="Opening /etc/hosts"> |
| 337 | # <i>nano -w /etc/hosts</i> |
344 | # <i>nano -w /etc/hosts</i> |
| 338 | </pre> |
345 | </pre> |
| 339 | |
346 | |
| 340 | <pre caption="Filling in the networking information"> |
347 | <pre caption="Filling in the networking information"> |
| 341 | 127.0.0.1 localhost |
348 | <comment>(This defines the current system)</comment> |
| 342 | 192.168.0.5 jenny |
349 | 127.0.0.1 tux.homenetwork tux localhost |
| 343 | 192.168.0.6 benny |
|
|
| 344 | 192.168.0.7 tux |
|
|
| 345 | </pre> |
|
|
| 346 | |
350 | |
| 347 | <p> |
351 | <comment>(Define extra systems on your network, |
| 348 | If your system is the only system (or the nameservers handle all name |
352 | they need to have a static IP to be defined this way.)</comment> |
| 349 | resolution) a single line is sufficient: |
353 | 192.168.0.5 jenny.homenetwork jenny |
| 350 | </p> |
354 | 192.168.0.6 benny.homenetwork benny |
| 351 | |
|
|
| 352 | <pre caption="/etc/hosts for lonely or fully integrated PCs"> |
|
|
| 353 | 127.0.0.1 localhost tux |
|
|
| 354 | </pre> |
355 | </pre> |
| 355 | |
356 | |
| 356 | <p> |
357 | <p> |
| 357 | Save and exit the editor to continue. |
358 | Save and exit the editor to continue. |
| 358 | </p> |
359 | </p> |
| 359 | |
360 | |
| 360 | <p> |
361 | <p> |
| 361 | If you don't have PCMCIA, you can now continue with <uri |
362 | If you don't have PCMCIA, you can now continue with <uri |
| 362 | link="#doc_chap4">System Information</uri>. PCMCIA-users should read the |
363 | link="#doc_chap3">System Information</uri>. PCMCIA-users should read the |
| 363 | following topic on PCMCIA. |
364 | following topic on PCMCIA. |
| 364 | </p> |
365 | </p> |
| 365 | |
366 | |
| 366 | </body> |
367 | </body> |
| 367 | </subsection> |
368 | </subsection> |
| 368 | <subsection> |
369 | <subsection> |
| 369 | <title>Optional: Get PCMCIA Working</title> |
370 | <title>Optional: Get PCMCIA Working</title> |
| 370 | <body> |
371 | <body> |
| 371 | |
372 | |
|
|
373 | <note> |
|
|
374 | pcmcia-cs is only available for x86, amd64 and ppc platforms. |
|
|
375 | </note> |
|
|
376 | |
| 372 | <p> |
377 | <p> |
| 373 | PCMCIA-users should first install the <c>pcmcia-cs</c> package: |
378 | PCMCIA-users should first install the <c>pcmcia-cs</c> package. This also |
|
|
379 | includes users who will be working with a 2.6 kernel (even though they won't be |
|
|
380 | using the PCMCIA drivers from this package). The <c>USE="-X"</c> is necessary |
|
|
381 | to avoid installing xorg-x11 at this moment: |
| 374 | </p> |
382 | </p> |
| 375 | |
383 | |
| 376 | <pre caption="Installing pcmcia-cs"> |
384 | <pre caption="Installing pcmcia-cs"> |
| 377 | # <i>emerge --usepkg pcmcia-cs</i> |
385 | # <i>USE="-X" emerge pcmcia-cs</i> |
| 378 | </pre> |
386 | </pre> |
| 379 | |
387 | |
| 380 | <p> |
388 | <p> |
| 381 | When <c>pcmcia-cs</c> is installed, add <c>pcmcia</c> to the <e>boot</e> |
389 | When <c>pcmcia-cs</c> is installed, add <c>pcmcia</c> to the <e>default</e> |
| 382 | runlevel: |
390 | runlevel: |
| 383 | </p> |
391 | </p> |
| 384 | |
392 | |
| 385 | <pre caption="Adding pcmcia to the boot runlevel"> |
393 | <pre caption="Adding pcmcia to the default runlevel"> |
| 386 | # <i>rc-update add pcmcia boot</i> |
394 | # <i>rc-update add pcmcia default</i> |
| 387 | </pre> |
395 | </pre> |
| 388 | |
396 | |
| 389 | </body> |
397 | </body> |
| 390 | </subsection> |
398 | </subsection> |
| 391 | </section> |
399 | </section> |
| 392 | <section> |
400 | <section> |
| 393 | <title>System Information</title> |
401 | <title>System Information</title> |
|
|
402 | <subsection> |
|
|
403 | <title>Root Password</title> |
|
|
404 | <body> |
|
|
405 | |
|
|
406 | <p> |
|
|
407 | First we set the root password by typing: |
|
|
408 | </p> |
|
|
409 | |
|
|
410 | <pre caption="Setting the root password"> |
|
|
411 | # <i>passwd</i> |
|
|
412 | </pre> |
|
|
413 | |
|
|
414 | <p> |
|
|
415 | If you want root to be able to log on through the serial console, add |
|
|
416 | <c>tts/0</c> to <path>/etc/securetty</path>: |
|
|
417 | </p> |
|
|
418 | |
|
|
419 | <pre caption="Adding tts/0 to /etc/securetty"> |
|
|
420 | # <i>echo "tts/0" >> /etc/securetty</i> |
|
|
421 | </pre> |
|
|
422 | |
|
|
423 | </body> |
|
|
424 | </subsection> |
|
|
425 | <subsection> |
|
|
426 | <title>System Information</title> |
| 394 | <body> |
427 | <body> |
| 395 | |
428 | |
| 396 | <p> |
429 | <p> |
| 397 | Gentoo uses <path>/etc/rc.conf</path> for general, system-wide configuration. |
430 | Gentoo uses <path>/etc/rc.conf</path> for general, system-wide configuration. |
| 398 | Open up <path>/etc/rc.conf</path> and enjoy all the comments in that file :) |
431 | Open up <path>/etc/rc.conf</path> and enjoy all the comments in that file :) |
| … | |
… | |
| 401 | <pre caption="Opening /etc/rc.conf"> |
434 | <pre caption="Opening /etc/rc.conf"> |
| 402 | # <i>nano -w /etc/rc.conf</i> |
435 | # <i>nano -w /etc/rc.conf</i> |
| 403 | </pre> |
436 | </pre> |
| 404 | |
437 | |
| 405 | <p> |
438 | <p> |
|
|
439 | When you're finished configuring <path>/etc/rc.conf</path>, save and exit. |
|
|
440 | </p> |
|
|
441 | |
|
|
442 | <p> |
| 406 | As you can see, this file is well commented to help you set up the necessary |
443 | As you can see, this file is well commented to help you set up the necessary |
| 407 | configuration variables. When you're finished configuring |
444 | configuration variables. You can configure your system to use unicode and |
| 408 | <path>/etc/rc.conf</path>, save and exit to continue. |
445 | define your default editor and your display manager (like gdm or kdm). |
|
|
446 | </p> |
|
|
447 | |
| 409 | </p> |
448 | <p> |
|
|
449 | Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration. |
|
|
450 | Edit it to configure your keyboard. |
|
|
451 | </p> |
| 410 | |
452 | |
|
|
453 | <pre caption="Opening /etc/conf.d/keymaps"> |
|
|
454 | # <i>nano -w /etc/conf.d/keymaps</i> |
|
|
455 | </pre> |
|
|
456 | |
|
|
457 | <p> |
|
|
458 | Take special care with the <c>KEYMAP</c> variable. If you select the wrong |
|
|
459 | <c>KEYMAP</c>, you will get weird results when typing on your keyboard. |
|
|
460 | </p> |
|
|
461 | |
|
|
462 | <note> |
|
|
463 | Users of USB-based <b>SPARC</b> systems and <b>SPARC</b> clones might need to |
|
|
464 | select an i386 keymap (such as "us") instead of "sunkeymap". <b>PPC</b> uses x86 |
|
|
465 | keymaps on most systems. Users who want to be able to use ADB keymaps on boot |
|
|
466 | have to enable ADB keycode sendings in their kernel and have to set a mac/ppc |
|
|
467 | keymap in <path>/etc/conf.d/keymaps</path>. |
|
|
468 | </note> |
|
|
469 | |
|
|
470 | <p> |
|
|
471 | When you're finished configuring <path>/etc/conf.d/keymaps</path>, save and |
|
|
472 | exit. |
|
|
473 | </p> |
|
|
474 | |
|
|
475 | <p> |
|
|
476 | Gentoo uses <path>/etc/conf.d/clock</path> to set clock options. Edit it |
|
|
477 | according to your needs. |
|
|
478 | </p> |
|
|
479 | |
|
|
480 | <pre caption="Opening /etc/conf.d/clock"> |
|
|
481 | # <i>nano -w /etc/conf.d/clock</i> |
|
|
482 | </pre> |
|
|
483 | |
|
|
484 | <p> |
|
|
485 | If your hardware clock is not using UTC, you need to add <c>CLOCK="local"</c> to |
|
|
486 | the file. Otherwise you will notice some clock skew. Furthermore, Windows |
|
|
487 | assumes that your hardware clock uses local time, so if you want to dualboot, |
|
|
488 | you should set this variable appropriately, otherwise your clock will go crazy. |
|
|
489 | </p> |
|
|
490 | |
|
|
491 | <p> |
|
|
492 | When you're finished configuring <path>/etc/conf.d/clock</path>, save and |
|
|
493 | exit. |
|
|
494 | </p> |
|
|
495 | |
|
|
496 | <p> |
|
|
497 | If you are not installing Gentoo on IBM PPC64 hardware, continue with |
|
|
498 | <uri link="?part=1&chap=9">Installing Necessary System Tools</uri>. |
|
|
499 | </p> |
|
|
500 | |
|
|
501 | </body> |
|
|
502 | </subsection> |
|
|
503 | <subsection> |
|
|
504 | <title>Configuring the Console</title> |
| 411 | </body> |
505 | <body> |
|
|
506 | |
|
|
507 | <note> |
|
|
508 | The following section applies to the IBM PPC64 hardware platforms. |
|
|
509 | </note> |
|
|
510 | |
|
|
511 | <p> |
|
|
512 | If you are running Gentoo on IBM PPC64 hardware and using a virtual console |
|
|
513 | you must uncomment the appropriate line in <path>/etc/inittab</path> for the |
|
|
514 | virtual console to spawn a login prompt. |
|
|
515 | </p> |
|
|
516 | |
|
|
517 | <pre caption="Enabling hvc or hvsi support in /etc/inittab"> |
|
|
518 | hvc0:12345:respawn:/sbin/agetty -L 9600 hvc0 |
|
|
519 | hvsi:12345:respawn:/sbin/agetty -L 19200 hvsi0 |
|
|
520 | </pre> |
|
|
521 | |
|
|
522 | <p> |
|
|
523 | You should also take this time to verify that the appropriate console is |
|
|
524 | listed in <path>/etc/securetty</path>. |
|
|
525 | </p> |
|
|
526 | |
|
|
527 | <p> |
|
|
528 | You may now continue with <uri link="?part=1&chap=9">Installing Necessary |
|
|
529 | System Tools</uri>. |
|
|
530 | </p> |
|
|
531 | |
|
|
532 | </body> |
|
|
533 | </subsection> |
| 412 | </section> |
534 | </section> |
| 413 | </sections> |
535 | </sections> |