"Configuration and Tuning" handbook update
Victor Balada Diaz
victor at bsdes.net
Sun Aug 20 12:58:28 PDT 2006
Hi,
this is an update of the "Configuration and Tuning" chapter of
the handbook. These are mainly updates related to pkgsrc, but
there is also fix for a typo and i deleted the part about
vfs.vmiodirenable because we no longer have that sysctl.
--
La prueba más fehaciente de que existe vida inteligente en otros
planetas, es que no han intentado contactar con nosotros.
Index: chapter.sgml
===================================================================
RCS file: /dcvs/doc/en/books/handbook/config/chapter.sgml,v
retrieving revision 1.12
diff -u -r1.12 chapter.sgml
--- chapter.sgml 18 Jul 2006 02:02:17 -0000 1.12
+++ chapter.sgml 20 Aug 2006 19:42:13 -0000
@@ -289,36 +289,29 @@
system, so that they may be easily located and managed by the
package management tools.</para>
- <indexterm><primary>/usr/local/etc</primary></indexterm>
+ <indexterm><primary>/usr/pkg/etc</primary></indexterm>
<para>Typically, these files are installed in
- <filename>/usr/local/etc</filename>. In the case where an
+ <filename>/usr/pkg/etc</filename>. In the case where an
application has a large number of configuration files, a
subdirectory will be created to hold them.</para>
<para>Normally, when a port or package is installed, sample
- configuration files are also installed. These are usually
- identified with a <filename>.default</filename> suffix. If there
- are no existing
- configuration files for the application, they will be created by
- copying the <filename>.default</filename> files.</para>
+ configuration files are also installed. These are usually in
+ /usr/pkg/share/examples/<replaceable>PACKAGENAME</replaceable>. If
+ there are no existing configuration files for the application,
+ they will be created by copying the <filename>.default</filename>
+ files.</para>
<para>For example, consider the contents of the directory
- <filename>/usr/local/etc/apache</filename>:</para>
+ <filename>/usr/pkg/etc/httpd</filename>:</para>
-<literallayout class="monospaced">-rw-r--r-- 1 root wheel 2184 May 20 1998 access.conf
--rw-r--r-- 1 root wheel 2184 May 20 1998 access.conf.default
--rw-r--r-- 1 root wheel 9555 May 20 1998 httpd.conf
--rw-r--r-- 1 root wheel 9555 May 20 1998 httpd.conf.default
--rw-r--r-- 1 root wheel 12205 May 20 1998 magic
--rw-r--r-- 1 root wheel 12205 May 20 1998 magic.default
--rw-r--r-- 1 root wheel 2700 May 20 1998 mime.types
--rw-r--r-- 1 root wheel 2700 May 20 1998 mime.types.default
--rw-r--r-- 1 root wheel 7980 May 20 1998 srm.conf
--rw-r--r-- 1 root wheel 7933 May 20 1998 srm.conf.default</literallayout>
+<literallayout class="monospaced">-rw-r--r-- 1 root wheel 43570 Aug 20 15:26 httpd.conf
+-rw-r--r-- 1 root wheel 12965 Aug 20 15:26 magic
+-rw-r--r-- 1 root wheel 15020 Aug 20 15:26 mime.types</literallayout>
- <para>The file sizes show that only the <filename>srm.conf</filename>
- file has been changed. A later update of the <application>Apache</application> port would not
+ <para>If you modify any file, for example <filename>httpd.conf</filename>
+ a later update of the <application>Apache</application> port would not
overwrite this changed file.</para>
</sect1>
@@ -332,11 +325,11 @@
These may be started in several different fashions, each having
different advantages.</para>
- <indexterm><primary>/usr/local/etc/rc.d</primary></indexterm>
+ <indexterm><primary>/usr/pkg/etc/rc.d</primary></indexterm>
<para>Software installed from a port or the packages collection
will often place a script in
- <filename>/usr/local/etc/rc.d</filename> which is invoked at
+ <filename>/usr/pkg/etc/rc.d</filename> which is invoked at
system startup with a <option>start</option> argument, and at
system shutdown with a <option>stop</option> argument.
This is the recommended way for
@@ -348,14 +341,14 @@
when the package is removed.</para>
<para>A generic startup script in
- <filename>/usr/local/etc/rc.d</filename> looks like:</para>
+ <filename>/usr/pkg/etc/rc.d</filename> looks like:</para>
<programlisting>#!/bin/sh
echo -n ' FooBar'
case "$1" in
start)
- /usr/local/bin/foobar
+ /usr/pkg/bin/foobar
;;
stop)
kill -9 `cat /var/run/foobar.pid`
@@ -370,7 +363,7 @@
</programlisting>
<para>The startup scripts of &os; will look in
- <filename>/usr/local/etc/rc.d</filename> for scripts that have an
+ <filename>/usr/pkg/etc/rc.d</filename> for scripts that have an
<literal>.sh</literal> extension and are executable by
<username>root</username>. Those scripts that are found are called with
an option <option>start</option> at startup, and <option>stop</option>
@@ -378,7 +371,7 @@
the above sample script to be picked up and run at the proper time during
system startup, you should save it to a file called
<filename>FooBar.sh</filename> in
- <filename>/usr/local/etc/rc.d</filename> and make sure it is
+ <filename>/usr/pkg/etc/rc.d</filename> and make sure it is
executable. You can make a shell script executable with &man.chmod.1;
as shown below:</para>
@@ -401,7 +394,7 @@
<note><para>Do <emphasis>not</emphasis> place any commands in
<filename>/etc/rc.conf</filename>. To start daemons, or
run any commands at boot time, place a script in
- <filename>/usr/local/etc/rc.d</filename> instead.</para>
+ <filename>/usr/pkg/etc/rc.d</filename> instead.</para>
</note>
<para>It is also possible to use the &man.cron.8; daemon to start
@@ -967,7 +960,7 @@
</screen>
- <para>Manually configuring the care has the disadvantage that you
+ <para>Manually configuring the card has the disadvantage that you
would have to do it after each reboot of the system. The file
<filename>/etc/rc.conf</filename> is where to add the network
card's configuration.</para>
@@ -1231,12 +1224,12 @@
here.</entry>
</row>
<row>
- <entry><filename>/usr/local/etc</filename></entry>
+ <entry><filename>/usr/pkg/etc</filename></entry>
<entry>Configuration files for installed applications.
May contain per-application subdirectories.</entry>
</row>
<row>
- <entry><filename>/usr/local/etc/rc.d</filename></entry>
+ <entry><filename>/usr/pkg/etc/rc.d</filename></entry>
<entry>Start/stop scripts for installed applications.</entry>
</row>
<row>
@@ -1484,9 +1477,8 @@
running under &os;:</para>
<programlisting>kern.logsigexit=0 # Do not log fatal signal exits (e.g. sig 11)
-compat.linux.osname=&os;
-<!-- todo: reed: check this -->
-compat.linux.osrelease=4.3-STABLE</programlisting>
+compat.linux.osname: Linux
+compat.linux.osrelease: 2.4.2</programlisting>
</sect2>
</sect1>
@@ -1578,35 +1570,6 @@
<sect2>
<title>Sysctl Variables</title>
- <sect3>
- <title><varname>vfs.vmiodirenable</varname></title>
-
- <indexterm>
- <primary><varname>vfs.vmiodirenable</varname></primary>
- </indexterm>
-
- <para>The <varname>vfs.vmiodirenable</varname> sysctl variable
- may be set to either 0 (off) or 1 (on); it is 1 by default.
- This variable controls how directories are cached by the
- system. Most directories are small, using just a single
- fragment (typically 1 K) in the file system and less
- (typically 512 bytes) in the buffer cache.
- With this variable turned off (to 0), the buffer
- cache will only cache a fixed number of directories even if
- ou have a huge amount of memory. When turned on (to 1), this sysctl
- allows the buffer cache to use the VM Page Cache to cache the
- directories, making all the memory available for caching
- directories. However,
- the minimum in-core memory used to cache a directory is the
- physical page size (typically 4 K) rather than 512
- bytes. We recommend keeping this option on if you are running
- any services which manipulate large numbers of files. Such
- services can include web caches, large mail systems, and news
- systems. Keeping this option on will generally not reduce
- performance even with the wasted memory but you should
- experiment to find out.</para>
- </sect3>
-
<sect3>
<title><varname>vfs.write_behind</varname></title>
@@ -1724,7 +1687,8 @@
<para>Soft Updates drastically improves meta-data performance, mainly
file creation and deletion, through the use of a memory cache. We
- recommend to use Soft Updates on all of your file systems. There
+ recommend to use Soft Updates on all of your file systems but
+ <filename>/</filename>. There
are two downsides to Soft Updates that you should be aware of: First,
Soft Updates guarantees filesystem consistency in the case of a crash
but could very easily be several seconds (even a minute!) behind
More information about the Submit
mailing list