/[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.123 Revision 1.127
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.123 2013/12/17 09:34:53 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.127 2013/12/17 11:52:05 swift 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>29</version> 17<version>33</version>
18<date>2013-12-17</date> 18<date>2013-12-17</date>
19 19
20<section> 20<section>
21<title>Filesystem Information</title> 21<title>Filesystem Information</title>
22<subsection> 22<subsection>
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>
84
85<p>
86In the remainder of the text, we use the default <path>/dev/sd*</path> block
87device files as partition. You can also opt to use the symbolic links in the
88<path>/dev/disk/byid</path> or <path>/dev/disk/by-uuid</path>. These names are
89not likely to change, whereas the default block device files naming depends on
90a number of factors (such as how and in what order the disks are attached to
91your system). However, if you do not intend to fiddle with the disk ordering,
92you can continue with the default block device files safely.
93</p>
84 94
85</body> 95</body>
86<body test="func:keyval('/boot')"> 96<body test="func:keyval('/boot')">
87 97
88<p> 98<p>
206You only need a domain if your ISP or network administrator says so, or if you 216You only need a domain if your ISP or network administrator says so, or if you
207have a DNS server but not a DHCP server. You don't need to worry about DNS or 217have a DNS server but not a DHCP server. You don't need to worry about DNS or
208domainnames if your networking is setup for DHCP. 218domainnames if your networking is setup for DHCP.
209</p> 219</p>
210 220
221<note>
222The <path>/etc/conf.d/net</path> file does not exist by default, so you might
223need to create it.
224</note>
225
211<pre caption="Setting the domainname"> 226<pre caption="Setting the domainname">
212# <i>nano -w /etc/conf.d/net</i> 227# <i>nano -w /etc/conf.d/net</i>
213 228
214<comment>(Set the dns_domain variable to your domain name)</comment> 229<comment>(Set the dns_domain variable to your domain name)</comment>
215dns_domain_lo="<i>homenetwork</i>" 230dns_domain_lo="<i>homenetwork</i>"
233nis_domain_lo="<i>my-nisdomain</i>" 248nis_domain_lo="<i>my-nisdomain</i>"
234</pre> 249</pre>
235 250
236<note> 251<note>
237For more information on configuring DNS and NIS, please read the examples 252For more information on configuring DNS and NIS, please read the examples
238provided in <path>/usr/share/doc/openrc-*/net.example.bz2</path> which 253provided in <path>/usr/share/doc/netifrc-*/net.example.bz2</path> which
239can be read using <c>bzless</c>. Also, you may want to emerge <c>openresolv</c> 254can be read using <c>bzless</c>. Also, you may want to emerge <c>openresolv</c>
240to help manage your DNS/NIS setup. 255to help manage your DNS/NIS setup.
241</note> 256</note>
242 257
243</body> 258</body>
262<p> 277<p>
263All networking information is gathered in <path>/etc/conf.d/net</path>. It uses 278All networking information is gathered in <path>/etc/conf.d/net</path>. It uses
264a straightforward yet not intuitive syntax if you don't know how to set up 279a straightforward yet not intuitive syntax if you don't know how to set up
265networking manually. But don't fear, we'll explain everything. A fully 280networking manually. But don't fear, we'll explain everything. A fully
266commented example that covers many different configurations is available in 281commented example that covers many different configurations is available in
267<path>/usr/share/doc/openrc-*/net.example.bz2</path>. 282<path>/usr/share/doc/netifrc-*/net.example.bz2</path>.
268</p> 283</p>
269 284
270<p> 285<p>
271DHCP is used by default. For DHCP to work, you will need to install a DHCP 286DHCP is used by default. For DHCP to work, you will need to install a DHCP
272client. This is described later in <uri 287client. This is described later in <uri
281this example): 296this example):
282</p> 297</p>
283 298
284<pre caption="Opening /etc/conf.d/net for editing"> 299<pre caption="Opening /etc/conf.d/net for editing">
285# <i>nano -w /etc/conf.d/net</i> 300# <i>nano -w /etc/conf.d/net</i>
286</pre>
287
288<p>
289You will see the following file:
290</p>
291
292<pre caption="Default /etc/conf.d/net">
293# This blank configuration will automatically use DHCP for any net.*
294# scripts in /etc/init.d. To create a more complete configuration,
295# please review /usr/share/doc/openrc-*/net.example.bz2 and save
296# your configuration in /etc/conf.d/net (this file :]!).
297</pre> 301</pre>
298 302
299<p> 303<p>
300To enter your own IP address, netmask and gateway, you need 304To enter your own IP address, netmask and gateway, you need
301to set both <c>config_eth0</c> and <c>routes_eth0</c>: 305to set both <c>config_eth0</c> and <c>routes_eth0</c>:
321<pre caption="Automatically obtaining an IP address for eth0"> 325<pre caption="Automatically obtaining an IP address for eth0">
322config_eth0="dhcp" 326config_eth0="dhcp"
323</pre> 327</pre>
324 328
325<p> 329<p>
326Please read <path>/usr/share/doc/openrc-*/net.example.bz2</path> for a 330Please read <path>/usr/share/doc/netifrc-*/net.example.bz2</path> for a
327list of all available options. Be sure to also read your DHCP client manpage if 331list of all available options. Be sure to also read your DHCP client manpage if
328you need to set specific DHCP options. 332you need to set specific DHCP options.
329</p> 333</p>
330 334
331<p> 335<p>
560<pre caption="Running locale-gen"> 564<pre caption="Running locale-gen">
561# <i>locale-gen</i> 565# <i>locale-gen</i>
562</pre> 566</pre>
563 567
564<p> 568<p>
569You can verify that your selected locales are available by running <c>locale -a</c>.
570</p>
571
572<p>
565Once done, you now have the possibility to set the system-wide locale settings 573Once done, you now have the possibility to set the system-wide locale settings.
574With <c>eselect locale list</c>, the available targets are displayed:
575</p>
576
577<pre caption="Displaying the available LANG settings">
578# <i>eselect locale list</i>
579Available targets for the LANG variable:
580 [1] C
581 [2] POSIX
582 [3] en_US
583 [4] en_US.iso88591
584 [5] en_US.utf8
585 [6] de_DE
586 [7] de_DE.iso88591
587 [8] de_DE.iso885915
588 [9] de_DE.utf8
589 [ ] (free form)
590</pre>
591
592<p>
593With <c>eselect locale set &lt;value&gt;</c> the correct locale can be set:
594</p>
595
596<pre caption="Setting the LANG variable">
597# <i>eselect locale set 9</i>
598</pre>
599
600<p>
601Manually, this can still be accomplished through the
566in the <path>/etc/env.d/02locale</path> file: 602<path>/etc/env.d/02locale</path> file:
567</p> 603</p>
568 604
569<pre caption="Setting the default system locale in /etc/env.d/02locale"> 605<pre caption="Setting the default system locale in /etc/env.d/02locale">
570LANG="de_DE.UTF-8" 606LANG="de_DE.UTF-8"
571LC_COLLATE="C" 607LC_COLLATE="C"
572</pre> 608</pre>
573 609
574<p> 610<p>
575And reload your environment: 611Don't forget to reload your environment:
576</p> 612</p>
577 613
578<pre caption="Reload shell environment"> 614<pre caption="Reload shell environment">
579# env-update &amp;&amp; source /etc/profile 615# <i>env-update &amp;&amp; source /etc/profile</i>
580</pre> 616</pre>
581 617
582<p> 618<p>
583We made a full <uri link="https://wiki.gentoo.org/wiki/Localization/HOWTO">Localization 619We made a full <uri link="https://wiki.gentoo.org/wiki/Localization/HOWTO">Localization
584Guide</uri> to help you through this process. You can also read the detailed 620Guide</uri> to help you through this process. You can also read the detailed

Legend:
Removed from v.1.123  
changed lines
  Added in v.1.127

  ViewVC Help
Powered by ViewVC 1.1.20