mirror of
https://github.com/samba-team/samba.git
synced 2024-12-23 17:34:34 +03:00
74230c59b6
The existing configuration file is disappearing so these configuration options need a new home that is not handled by ctdbd_wrapper. Signed-off-by: Martin Schwenke <martin@meltin.net> Reviewed-by: Amitay Isaacs <amitay@gmail.com>
259 lines
6.9 KiB
XML
259 lines
6.9 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!DOCTYPE refentry
|
|
PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
|
|
|
<refentry id="ctdb.sysconfig.5">
|
|
|
|
<refmeta>
|
|
<refentrytitle>ctdb.sysconfig</refentrytitle>
|
|
<manvolnum>5</manvolnum>
|
|
<refmiscinfo class="source">ctdb</refmiscinfo>
|
|
<refmiscinfo class="manual">CTDB - clustered TDB database</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>ctdb.sysconfig</refname>
|
|
<refpurpose>CTDB daemon configuration file</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsect1>
|
|
<title>DESCRIPTION</title>
|
|
|
|
<para>
|
|
This file contains configuration that affects the operation of
|
|
CTDB. This is a distribution-specific service configuration
|
|
file such as <filename>/etc/sysconfig/ctdb</filename> (Red Hat)
|
|
or <filename>/etc/default/ctdb</filename> (Debian) and is a
|
|
shell script (see
|
|
<citerefentry><refentrytitle>sh</refentrytitle>
|
|
<manvolnum>1</manvolnum></citerefentry>).
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>
|
|
GLOBAL CONFIGURATION
|
|
</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term>CTDB_INIT_STYLE=debian|redhat|suse</term>
|
|
<listitem>
|
|
<para>
|
|
This is the init style used by the Linux distribution (or
|
|
other operating system) being used. This is usually
|
|
determined dynamically by checking the system. This
|
|
variable is used by the initscript to determine which init
|
|
system primitives to use. It is also used by some
|
|
eventscripts to choose the name of initscripts for certain
|
|
services, since these can vary between distributions.
|
|
</para>
|
|
<para>
|
|
If using CTDB's event scripts are unable to determine an
|
|
appropriate default then this option can also be placed in
|
|
a relevant
|
|
<citerefentry><refentrytitle>ctdb-script.options</refentrytitle>
|
|
<manvolnum>5</manvolnum></citerefentry> file.
|
|
</para>
|
|
<para>
|
|
Default: NONE. Guessed, based on features of
|
|
distribution.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>CTDB_STARTUP_TIMEOUT=<parameter>NUM</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
NUM is the number of seconds to wait for
|
|
<citerefentry><refentrytitle>ctdbd</refentrytitle>
|
|
<manvolnum>1</manvolnum></citerefentry> complete early
|
|
initialisation up to a point where it is unlikely to
|
|
abort. If <command>ctdbd</command> doesn't complete the
|
|
"setup" event before this timeout then it is killed.
|
|
</para>
|
|
|
|
<para>
|
|
Defaults: 10
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>
|
|
RESOURCE LIMITS
|
|
</title>
|
|
|
|
<refsect2>
|
|
<title>
|
|
Maximum number of open files
|
|
</title>
|
|
|
|
<para>
|
|
CTDB can use a lot of file descriptors, especially when used
|
|
with Samba. If there are thousands of smbd processes
|
|
connected to CTDB when this can mean that thousands of file
|
|
descriptors are used. For CTDB, it is often necessary to
|
|
increase limit on the maximum number of open files.
|
|
</para>
|
|
|
|
<para>
|
|
The maximum number of open files should be configured using an
|
|
operating system mechanism.
|
|
</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
systemd
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
The
|
|
<literal>LimitNOFILE=<option>LIMIT</option></literal>
|
|
option can be used in a unit/service file increase the
|
|
maximum number of open files. See
|
|
<citerefentry><refentrytitle>systemd.exec</refentrytitle>
|
|
<manvolnum>5</manvolnum></citerefentry> for details.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
SYSV init
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Use a command like <command>ulimit -n
|
|
<option>LIMIT</option></command> to increase the maximum
|
|
number of open files. This command can be put in the
|
|
relevant distribution-specific service configuration file.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</refsect2>
|
|
|
|
<refsect2>
|
|
<title>
|
|
Allowing core dumps
|
|
</title>
|
|
|
|
<para>
|
|
Many distributions do not allow core dump files to be
|
|
generated by default. To assist with debugging, core files
|
|
can be enabled. This should be configured using an operating
|
|
system mechanism.
|
|
</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
systemd
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
The <literal>LimitCORE=0|unlimited</literal> option can
|
|
be used in a unit/service file. <literal>0</literal>
|
|
disallows core files, <literal>unlimited</literal>
|
|
allows them. maximum number of open files. See
|
|
<citerefentry><refentrytitle>systemd.exec</refentrytitle>
|
|
<manvolnum>5</manvolnum></citerefentry> for details.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>
|
|
SYSV init
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Use a command like <command>ulimit -c 0|unlimited</command>
|
|
to disable or enable core files as required. This
|
|
command can be put in the relevant distribution-specific
|
|
service configuration file.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</refsect2>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>FILES</title>
|
|
|
|
<simplelist>
|
|
<member><filename>/etc/sysconfig/ctdb</filename></member>
|
|
<member><filename>/etc/default/ctdb</filename></member>
|
|
<member><filename>/usr/local/etc/ctdb/script.options</filename></member>
|
|
</simplelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>SEE ALSO</title>
|
|
<para>
|
|
<citerefentry><refentrytitle>ctdbd</refentrytitle>
|
|
<manvolnum>1</manvolnum></citerefentry>,
|
|
|
|
<citerefentry><refentrytitle>ctdb-script.options</refentrytitle>
|
|
<manvolnum>5</manvolnum></citerefentry>,
|
|
|
|
<citerefentry><refentrytitle>ctdb</refentrytitle>
|
|
<manvolnum>7</manvolnum></citerefentry>,
|
|
|
|
<ulink url="http://ctdb.samba.org/"/>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refentryinfo>
|
|
<author>
|
|
<contrib>
|
|
This documentation was written by
|
|
Martin Schwenke
|
|
</contrib>
|
|
</author>
|
|
|
|
<copyright>
|
|
<year>2007</year>
|
|
<holder>Andrew Tridgell</holder>
|
|
<holder>Ronnie Sahlberg</holder>
|
|
</copyright>
|
|
<legalnotice>
|
|
<para>
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation; either version 3 of
|
|
the License, or (at your option) any later version.
|
|
</para>
|
|
<para>
|
|
This program is distributed in the hope that it will be
|
|
useful, but WITHOUT ANY WARRANTY; without even the implied
|
|
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
PURPOSE. See the GNU General Public License for more details.
|
|
</para>
|
|
<para>
|
|
You should have received a copy of the GNU General Public
|
|
License along with this program; if not, see
|
|
<ulink url="http://www.gnu.org/licenses"/>.
|
|
</para>
|
|
</legalnotice>
|
|
</refentryinfo>
|
|
|
|
</refentry>
|