/[gentoo]/xml/htdocs/doc/en/handbook/hb-install-config.xml

Diff of /xml/htdocs/doc/en/handbook/hb-install-config.xml

Parent Directory | Revision Log | View Patch Patch

Revision 1.92		Revision 1.103
…		…
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.92 2007/05/20 04:16:25 nightmorph Exp $ -->	7	<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.103 2011/08/02 17:43:17 jkt 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>8.2</version>	17	<version>10</version>
18	<date>2007-05-19</date>	18	<date>2011-08-02</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>
…		…
89	Let us take a look at how we write down the options for the <path>/boot</path>	89	Let us take a look at how we write down the options for the <path>/boot</path>
90	partition. This is just an example, if you didn't or couldn't create a	90	partition. This is just an example, if you didn't or couldn't create a
91	<path>/boot</path>, don't copy it.	91	<path>/boot</path>, don't copy it.
92	</p>	92	</p>
93		93
94	<p test="contains(func:keyval('/boot'), '/dev/hd')">
95	In our default <keyval id="arch"/> partitioning example, <path>/boot</path> is
96	usually the <path><keyval id="/boot"/></path> partition (or
97	<path>/dev/sda*</path> if you use SCSI or SATA drives), with <c>ext2</c> as
98	filesystem. It needs to be checked during boot, so we would write down:
99	</p>	94	<p>
100
101	<p test="contains(func:keyval('/boot'), '/dev/sd')">
102	In our default <keyval id="arch"/> partitioning example, <path>/boot</path> is	95	In our default <keyval id="arch"/> partitioning example, <path>/boot</path> is
103	usually the <path><keyval id="/boot"/></path> partition, with <c>ext2</c> as	96	usually the <path><keyval id="/boot"/></path> partition, with <c>ext2</c> as
104	filesystem. It needs to be checked during boot, so we would write down:	97	filesystem. It needs to be checked during boot, so we would write down:
105	</p>	98	</p>
106		99
…		…
116	</p>	109	</p>
117		110
118	</body>	111	</body>
119	<body>	112	<body>
120		113
121	<p test="not(func:keyval('arch')='SPARC')">	114	<p>
122	Add the rules that match your partitioning scheme and append rules for	115	Add the rules that match your partitioning scheme and append rules for
123	<path>/proc</path>, <c>tmpfs</c>, for your CD-ROM drive(s), and of course, if
124	you have other partitions or drives, for those too.
125	</p>
126
127	<p test="func:keyval('arch')='SPARC'">
128	Add the rules that match your partitioning schema and append rules for
129	<path>/proc/openprom</path>, <path>/proc</path>, <c>tmpfs</c> , for your CD-ROM
130	drive(s), and of course, if you have other partitions or drives, for those too.	116	your CD-ROM drive(s), and of course, if you have other partitions or drives,
		117	for those too.
131	</p>	118	</p>
132		119
133	<p>	120	<p>
134	Now use the <e>example</e> below to create your <path>/etc/fstab</path>:	121	Now use the <e>example</e> below to create your <path>/etc/fstab</path>:
135	</p>	122	</p>
136
137	<pre caption="A full /etc/fstab example" test="func:keyval('arch')='AMD64' or func:keyval('arch')='x86'">
138	<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2
139	/dev/hda2 none swap sw 0 0
140	/dev/hda3 / ext3 noatime 0 1
141
142	proc /proc proc nodev,nosuid,noexec 0 0
143	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
144
145	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
146	</pre>
147		123
148	<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'">
149	<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2	125	<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2
150	/dev/sda3 none swap sw 0 0	126	/dev/sda3 none swap sw 0 0
151	/dev/sda4 / ext3 noatime 0 1	127	/dev/sda4 / ext3 noatime 0 1
152		128
153	proc /proc proc nodev,nosuid,noexec 0 0	129	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
		130
		131	proc /proc proc defaults 0 0
154	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0	132	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
155
156	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
157	</pre>	133	</pre>
158		134
159	<pre caption="A full /etc/fstab example" test="func:keyval('arch')='Alpha' or func:keyval('arch')='MIPS'">	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'">
160	<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2	136	<keyval id="/boot"/> /boot ext2 defaults,noatime 1 2
161	/dev/sda2 none swap sw 0 0	137	/dev/sda2 none swap sw 0 0
162	/dev/sda3 / ext3 noatime 0 1	138	/dev/sda3 / ext3 noatime 0 1
163		139
164	proc /proc proc nodev,nosuid,noexec 0 0	140	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
		141
		142	proc /proc proc defaults 0 0
165	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0	143	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
166
167	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
168	</pre>	144	</pre>
169		145
170	<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'">
171	/dev/sda1 / ext3 noatime 0 1	147	/dev/sda1 / ext3 noatime 0 1
172	/dev/sda2 none swap sw 0 0	148	/dev/sda2 none swap sw 0 0
173	/dev/sda4 /usr ext3 noatime 0 2	149	/dev/sda4 /usr ext3 noatime 0 2
174	/dev/sda5 /var ext3 noatime 0 2	150	/dev/sda5 /var ext3 noatime 0 2
175	/dev/sda6 /home ext3 noatime 0 2	151	/dev/sda6 /home ext3 noatime 0 2
176		152
		153	<comment># You must add the rules for openprom</comment>
177	openprom /proc/openprom openpromfs defaults 0 0	154	openprom /proc/openprom openpromfs defaults 0 0
178	proc /proc proc nodev,nosuid,noexec 0 0
179	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
180		155
181	/dev/cdrom /mnt/cdrom auto noauto,user 0 0	156	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
182	</pre>
183		157
184	<note test="func:keyval('arch')='PPC'">	158	proc /proc proc defaults 0 0
185	There are important variations between PPC machine types. Please make sure you
186	adapt the following example to your system.
187	</note>
188
189	<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC'">
190	/dev/hda4 / ext3 noatime 0 1
191	/dev/hda3 none swap sw 0 0
192
193	proc /proc proc nodev,nosuid,noexec 0 0
194	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0	159	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
195
196	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
197	</pre>	160	</pre>
198		161
199	<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC64'">	162	<pre caption="A full /etc/fstab example" test="func:keyval('arch')='PPC' or
		163	func:keyval('arch')='PPC64'">
200	/dev/sda4 / ext3 noatime 0 1	164	/dev/sda4 / ext3 noatime 0 1
201	/dev/sda3 none swap sw 0 0	165	/dev/sda3 none swap sw 0 0
202		166
203	proc /proc proc nodev,nosuid,noexec 0 0	167	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
		168
		169	proc /proc proc defaults 0 0
204	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0	170	shm /dev/shm tmpfs nodev,nosuid,noexec 0 0
205
206	/dev/cdrom /mnt/cdrom auto noauto,user 0 0
207	</pre>	171	</pre>
208		172
209	<p>	173	<p>
210	<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
211	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
…		…
279	</pre>	243	</pre>
280		244
281	<note>	245	<note>
282	For more information on configuring DNS and NIS, please read the examples	246	For more information on configuring DNS and NIS, please read the examples
283	provided in <path>/etc/conf.d/net.example</path>. Also, you may want to emerge	247	provided in <path>/etc/conf.d/net.example</path>. Also, you may want to emerge
284	<c>resolvconf-gentoo</c> to help manage your DNS/NIS setup.	248	<c>openresolv</c> to help manage your DNS/NIS setup.
285	</note>	249	</note>
286		250
287	</body>	251	</body>
288	</subsection>	252	</subsection>
289	<subsection>	253	<subsection>
…		…
349	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" )
350	routes_eth0=( "default via 192.168.0.1" )	314	routes_eth0=( "default via 192.168.0.1" )
351	</pre>	315	</pre>
352		316
353	<p>	317	<p>
354	To use DHCP and add specific DHCP options, define <c>config_eth0</c> and	318	To use DHCP, define <c>config_eth0</c>:
355	<c>dhcp_eth0</c>:
356	</p>	319	</p>
357		320
358	<pre caption="Automatically obtaining an IP address for eth0">	321	<pre caption="Automatically obtaining an IP address for eth0">
359	config_eth0=( "dhcp" )	322	config_eth0=( "dhcp" )
360	dhcp_eth0="nodns nontp nonis"
361	</pre>	323	</pre>
362		324
363	<p>	325	<p>
364	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
365	options.	327	options. Be sure to also read your DHCP client manpage if you need to set
		328	specific DHCP options.
366	</p>	329	</p>
367		330
368	<p>	331	<p>
369	If you have several network interfaces repeat the above steps for	332	If you have several network interfaces repeat the above steps for
370	<c>config_eth1</c>, <c>config_eth2</c>, etc.	333	<c>config_eth1</c>, <c>config_eth2</c>, etc.
…		…
384	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
385	default runlevel.	348	default runlevel.
386	</p>	349	</p>
387		350
388	<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>
389	# <i>rc-update add net.eth0 default</i>	354	# <i>rc-update add net.eth0 default</i>
390	</pre>	355	</pre>
391		356
392	<p>	357	<p>
393	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
394	<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
395	use <c>ln</c> to do this:	360	<path>net.eth0</path>.
396	</p>
397
398	<pre caption="Creating extra initscripts">
399	# <i>cd /etc/init.d</i>
400	# <i>ln -s net.lo net.eth1</i>
401	# <i>rc-update add net.eth1 default</i>
402	</pre>	361	</p>
403		362
404	</body>	363	</body>
405	</subsection>	364	</subsection>
406	<subsection>	365	<subsection>
407	<title>Writing Down Network Information</title>	366	<title>Writing Down Network Information</title>
…		…
469		428
470	<pre caption="Setting the root password">	429	<pre caption="Setting the root password">
471	# <i>passwd</i>	430	# <i>passwd</i>
472	</pre>	431	</pre>
473		432
474	<p>
475	If you want root to be able to log on through the serial console, add
476	<c>tts/0</c> to <path>/etc/securetty</path>:
477	</p>
478
479	<pre caption="Adding tts/0 to /etc/securetty">
480	# <i>echo "tts/0" >> /etc/securetty</i>
481	</pre>
482
483	</body>	433	</body>
484	</subsection>	434	</subsection>
485	<subsection>	435	<subsection>
486	<title>System Information</title>	436	<title>System Information</title>
487	<body>	437	<body>
…		…
518	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
519	<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.
520	</p>	470	</p>
521		471
522	<note test="substring(func:keyval('arch'),1,3)='PPC'">	472	<note test="substring(func:keyval('arch'),1,3)='PPC'">
523	PPC uses x86 keymaps on most systems. Users who want to be able to use ADB	473	PPC uses x86 keymaps on most systems.
524	keymaps on boot have to enable ADB keycode sendings in their kernel and have to
525	set a mac/ppc keymap in <path>/etc/conf.d/keymaps</path>.
526	</note>	474	</note>
527		475
528	<p>	476	<p>
529	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
530	exit.	478	exit.
…		…
540	</pre>	488	</pre>
541		489
542	<p>	490	<p>
543	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>
544	to the file. Otherwise you will notice some clock skew.	492	to the file. Otherwise you will notice some clock skew.
		493	</p>
		494
		495	<p>
		496	You should define the timezone that you previously copied to
		497	<path>/etc/localtime</path> so that further upgrades of the
		498	<c>sys-libs/timezone-data</c> package can update <path>/etc/localtime</path>
		499	automatically. For instance, if you used the GMT timezone, you would add
		500	<c>TIMEZONE="GMT"</c>
545	</p>	501	</p>
546		502
547	<p>	503	<p>
548	When you're finished configuring <path>/etc/conf.d/clock</path>, save and	504	When you're finished configuring <path>/etc/conf.d/clock</path>, save and
549	exit.	505	exit.

 Legend:



Removed from v.1.92
 


changed lines


 
Added in v.1.103
 Legend:



Removed from v.1.92
 


changed lines


 
Added in v.1.103
-Removed from v.1.92
+Added in v.1.103

	ViewVC Help
Powered by ViewVC 1.1.13