/[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.108 Revision 1.116
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.108 2011/10/30 11:56:08 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.116 2012/10/06 20:16:10 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>15</version> 17<version>22</version>
18<date>2011-10-30</date> 18<date>2012-10-06</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>
96usually the <path><keyval id="/boot"/></path> partition, with <c>ext2</c> as 96usually the <path><keyval id="/boot"/></path> partition, with <c>ext2</c> as
97filesystem. It needs to be checked during boot, so we would write down: 97filesystem. It needs to be checked during boot, so we would write down:
98</p> 98</p>
99 99
100<pre caption="An example /boot line for /etc/fstab"> 100<pre caption="An example /boot line for /etc/fstab">
101<keyval id="/boot"/> /boot ext2 defaults 1 2 101<keyval id="/boot"/> /boot ext2 defaults 0 2
102</pre> 102</pre>
103 103
104<p> 104<p>
105Some users don't want their <path>/boot</path> partition to be mounted 105Some users don't want their <path>/boot</path> partition to be mounted
106automatically to improve their system's security. Those people should 106automatically to improve their system's security. Those people should
120<p> 120<p>
121Now use the <e>example</e> below to create your <path>/etc/fstab</path>: 121Now use the <e>example</e> below to create your <path>/etc/fstab</path>:
122</p> 122</p>
123 123
124<pre caption="A full /etc/fstab example" test="func:keyval('arch')='HPPA'"> 124<pre caption="A full /etc/fstab example" test="func:keyval('arch')='HPPA'">
125<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 125<keyval id="/boot"/> /boot ext2 defaults,noatime 0 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
131proc /proc proc defaults 0 0
132shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
133</pre> 130</pre>
134 131
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'"> 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'">
136<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2 133<keyval id="/boot"/> /boot ext2 defaults,noatime 0 2
137/dev/sda2 none swap sw 0 0 134/dev/sda2 none swap sw 0 0
138/dev/sda3 / ext3 noatime 0 1 135/dev/sda3 / ext3 noatime 0 1
139 136
140/dev/cdrom /mnt/cdrom auto noauto,user 0 0 137/dev/cdrom /mnt/cdrom auto noauto,user 0 0
141
142proc /proc proc defaults 0 0
143shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
144</pre> 138</pre>
145 139
146<pre caption="A full /etc/fstab example" test="func:keyval('arch')='SPARC'"> 140<pre caption="A full /etc/fstab example" test="func:keyval('arch')='SPARC'">
147/dev/sda1 / ext3 noatime 0 1 141/dev/sda1 / ext3 noatime 0 1
148/dev/sda2 none swap sw 0 0 142/dev/sda2 none swap sw 0 0
152 146
153<comment># You must add the rules for openprom</comment> 147<comment># You must add the rules for openprom</comment>
154openprom /proc/openprom openpromfs defaults 0 0 148openprom /proc/openprom openpromfs defaults 0 0
155 149
156/dev/cdrom /mnt/cdrom auto noauto,user 0 0 150/dev/cdrom /mnt/cdrom auto noauto,user 0 0
157
158proc /proc proc defaults 0 0
159shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
160</pre> 151</pre>
161 152
162<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC' or 153<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC' or
163func:keyval('arch')='PPC64'"> 154func:keyval('arch')='PPC64'">
164/dev/sda4 / ext3 noatime 0 1 155/dev/sda4 / ext3 noatime 0 1
165/dev/sda3 none swap sw 0 0 156/dev/sda3 none swap sw 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
169proc /proc proc defaults 0 0
170shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
171</pre> 159</pre>
172 160
173<p> 161<p>
174<c>auto</c> makes <c>mount</c> guess for the filesystem (recommended for 162<c>auto</c> makes <c>mount</c> guess for the filesystem (recommended for
175removable media as they can be created with one of many filesystems) and 163removable media as they can be created with one of many filesystems) and
436<subsection> 424<subsection>
437<title>System Information</title> 425<title>System Information</title>
438<body> 426<body>
439 427
440<p> 428<p>
441Gentoo uses <path>/etc/rc.conf</path> for general, system-wide configuration. 429Gentoo uses <path>/etc/rc.conf</path> to configure the services, startup,
442Open up <path>/etc/rc.conf</path> and enjoy all the comments in that file :) 430and shutdown of your system. Open up <path>/etc/rc.conf</path> and enjoy all
431the comments in the file.
443</p> 432</p>
444 433
445<pre caption="Opening /etc/rc.conf"> 434<pre caption="Configuring services">
446# <i>nano -w /etc/rc.conf</i> 435# <i>nano -w /etc/rc.conf</i>
447</pre> 436</pre>
448 437
449<p> 438<p>
450When you're finished configuring <path>/etc/rc.conf</path>, save and exit. 439When you're finished configuring these two files, save them and exit.
451</p>
452
453<p>
454As you can see, this file is well commented to help you set up the necessary
455configuration variables. You can configure your system to use unicode and
456define your default editor and your display manager (like gdm or kdm).
457</p> 440</p>
458 441
459<p> 442<p>
460Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration. 443Gentoo uses <path>/etc/conf.d/keymaps</path> to handle keyboard configuration.
461Edit it to configure your keyboard. 444Edit it to configure your keyboard.
500 483
501<p> 484<p>
502You should define the timezone that you previously copied to 485You should define the timezone that you previously copied to
503<path>/etc/localtime</path> in the <path>/etc/timezone</path> file so that 486<path>/etc/localtime</path> in the <path>/etc/timezone</path> file so that
504further upgrades of the <c>sys-libs/timezone-data</c> package can update 487further upgrades of the <c>sys-libs/timezone-data</c> package can update
505<path>/etc/localtime</path> automatically. For instance, if you used the GMT 488<path>/etc/localtime</path> automatically. For instance, if you used the
506timezone, you would write <c>GMT</c> in the <path>/etc/timezone</path> file. 489Europe/Brussels timezone, you would write <c>Europe/Brussels</c> in the
490<path>/etc/timezone</path> file.
491</p>
492
493</body>
494</subsection>
495
496<subsection>
497<title>Configure locales</title>
498<body>
499
500<p>
501You will probably only use one or maybe two locales on your system. You have to
502specify locales you will need in <path>/etc/locale.gen</path>.
503</p>
504
505<pre caption="Opening /etc/locale.gen">
506# <i>nano -w /etc/locale.gen</i>
507</pre>
508
509<p>
510The following locales are an example to get both English (United States) and
511German (Germany) with the accompanying character formats (like UTF-8).
512</p>
513
514<pre caption="Specify your locales">
515en_US ISO-8859-1
516en_US.UTF-8 UTF-8
517de_DE ISO-8859-1
518de_DE@euro ISO-8859-15
519</pre>
520
521<note>
522You can select your desired locales in the list given by running <c>locale -a</c>.
523</note>
524
525<warn>
526We strongly suggest that you should use at least one UTF-8 locale because some
527applications may require it.
528</warn>
529
530<p>
531The next step is to run <c>locale-gen</c>. It will generates all the locales you
532have specified in the <path>/etc/locale.gen</path> file.
533</p>
534
535<pre caption="Running locale-gen">
536# <i>locale-gen</i>
537</pre>
538
539<p>
540Once done, you now have the possibility to set the system-wide locale settings
541in the <path>/etc/env.d/02locale</path> file:
542</p>
543
544<pre caption="Setting the default system locale in /etc/env.d/02locale">
545LANG="de_DE.UTF-8"
546LC_COLLATE="C"
547</pre>
548
549<p>
550And reload your environment:
551</p>
552
553<pre caption="Reload shell environment">
554# env-update &amp;&amp; source /etc/profile
555</pre>
556
557<p>
558We made a full <uri link="../guide-localization.xml#doc_chap3">Localization
559Guide</uri> to help you through this process. You can also read our detailed
560<uri link="../utf-8.xml#doc_chap2">UTF-8 Guide</uri> for very specific
561informations to enable UTF-8 on your system.
507</p> 562</p>
508 563
509<p test="not(func:keyval('arch')='PPC64')"> 564<p test="not(func:keyval('arch')='PPC64')">
510Please continue with <uri link="?part=1&amp;chap=9">Installing Necessary System 565Please continue with <uri link="?part=1&amp;chap=9">Installing Necessary System
511Tools</uri>. 566Tools</uri>.

Legend:
Removed from v.1.108  
changed lines
  Added in v.1.116

  ViewVC Help
Powered by ViewVC 1.1.20