<para>
By default, the recovery lock is implemented using a file
- (specified by <parameter>CTDB_RECOVERY_LOCK</parameter>)
- residing in shared storage (usually) on a cluster filesystem.
- To support a recovery lock the cluster filesystem must support
- lock coherence. See
+ (specified by <parameter>recovery lock</parameter> in the
+ <literal>[cluster]</literal> section of
+ <citerefentry><refentrytitle>ctdb.conf</refentrytitle>
+ <manvolnum>5</manvolnum></citerefentry>) residing in shared
+ storage (usually) on a cluster filesystem. To support a
+ recovery lock the cluster filesystem must support lock
+ coherence. See
<citerefentry><refentrytitle>ping_pong</refentrytitle>
<manvolnum>1</manvolnum></citerefentry> for more details.
</para>
<para>
The recovery lock can also be implemented using an arbitrary
cluster mutex call-out by using an exclamation point ('!') as
- the first character of
- <parameter>CTDB_RECOVERY_LOCK</parameter>. For example, a value
- of <command>!/usr/local/bin/myhelper recovery</command> would
- run the given helper with the specified arguments. See the
- source code relating to cluster mutexes for clues about writing
- call-outs.
+ the first character of <parameter>recovery lock</parameter>.
+ For example, a value of <command>!/usr/local/bin/myhelper
+ recovery</command> would run the given helper with the specified
+ arguments. See the source code relating to cluster mutexes for
+ clues about writing call-outs.
</para>
<para>
the cluster and is the address that CTDB daemons will use to
communicate with the CTDB daemons on other nodes.
</para>
+
<para>
- Private addresses are listed in the file specified by the
- <varname>CTDB_NODES</varname> configuration variable (see
- <citerefentry><refentrytitle>ctdbd.conf</refentrytitle>
- <manvolnum>5</manvolnum></citerefentry>, default
- <filename>/usr/local/etc/ctdb/nodes</filename>). This file contains the
- list of private addresses for all nodes in the cluster, one
- per line. This file must be the same on all nodes in the
- cluster.
+ Private addresses are listed in the file
+ <filename>/usr/local/etc/ctdb/nodes</filename>). This file
+ contains the list of private addresses for all nodes in the
+ cluster, one per line. This file must be the same on all nodes
+ in the cluster.
</para>
+
+ <para>
+ Some users like to put this configuration file in their
+ cluster filesystem. A symbolic link should be used in this
+ case.
+ </para>
+
<para>
Private addresses should not be used by clients to connect to
services provided by the cluster.
clients, as long as there are nodes available capable of
hosting this address.
</para>
+
+ <para>
+ The public address configuration is stored in
+ <filename>/usr/local/etc/ctdb/public_addresses</filename> on
+ each node. This file contains a list of the public addresses
+ that the node is capable of hosting, one per line. Each entry
+ also contains the netmask and the interface to which the
+ address should be assigned. If this file is missing then no
+ public addresses are configured.
+ </para>
+
<para>
- The public address configuration is stored in a file on each
- node specified by the <varname>CTDB_PUBLIC_ADDRESSES</varname>
- configuration variable (see
- <citerefentry><refentrytitle>ctdbd.conf</refentrytitle>
- <manvolnum>5</manvolnum></citerefentry>, recommended
- <filename>/usr/local/etc/ctdb/public_addresses</filename>). This file
- contains a list of the public addresses that the node is
- capable of hosting, one per line. Each entry also contains
- the netmask and the interface to which the address should be
- assigned.
+ Some users who have the same public addresses on all nodes
+ like to put this configuration file in their cluster
+ filesystem. A symbolic link should be used in this case.
</para>
<para>
<para>
See the <citetitle>NAT GATEWAY</citetitle> section in
- <citerefentry><refentrytitle>ctdbd.conf</refentrytitle>
+ <citerefentry><refentrytitle>ctdb-script.options</refentrytitle>
<manvolnum>5</manvolnum></citerefentry> for more details of
NATGW configuration.
</para>
This is implemented in the <filename>11.natgw</filename>
eventscript. Please see the eventscript file and the
<citetitle>NAT GATEWAY</citetitle> section in
- <citerefentry><refentrytitle>ctdbd.conf</refentrytitle>
+ <citerefentry><refentrytitle>ctdb-script.options</refentrytitle>
<manvolnum>5</manvolnum></citerefentry> for more details.
</para>
<varname>CTDB_PER_IP_ROUTING_TABLE_ID_LOW</varname>,
<varname>CTDB_PER_IP_ROUTING_TABLE_ID_HIGH</varname>. See the
<citetitle>POLICY ROUTING</citetitle> section in
- <citerefentry><refentrytitle>ctdbd.conf</refentrytitle>
+ <citerefentry><refentrytitle>ctdb-script.options</refentrytitle>
<manvolnum>5</manvolnum></citerefentry> for more details.
</para>
</refsect2>
</refsect1>
<refsect1>
- <title>NOTIFICATION SCRIPT</title>
+ <title>NOTIFICATIONS</title>
<para>
When certain state changes occur in CTDB, it can be configured
- to perform arbitrary actions via a notification script. For
- example, sending SNMP traps or emails when a node becomes
- unhealthy or similar.
- </para>
- <para>
- This is activated by setting the
- <varname>CTDB_NOTIFY_SCRIPT</varname> configuration variable.
- The specified script must be executable.
+ to perform arbitrary actions via notifications. For example,
+ sending SNMP traps or emails when a node becomes unhealthy or
+ similar.
</para>
+
<para>
- Use of the provided <filename>/usr/local/etc/ctdb/notify.sh</filename>
- script is recommended. It executes files in
- <filename>/usr/local/etc/ctdb/notify.d/</filename>.
+ The notification mechanism runs all executable files in
+ <filename>/usr/local/etc/ctdb/notify.d/</filename>, ignoring any
+ failures and continuing to run all files.
</para>
+
<para>
CTDB currently generates notifications after CTDB changes to
these states:
</refsect1>
<refsect1>
- <title>DEBUG LEVELS</title>
+ <title>LOG LEVELS</title>
<para>
- Valid values for DEBUGLEVEL are:
+ Valid log levels, in increasing order of verbosity, are:
</para>
<simplelist>
- <member>ERR</member>
+ <member>ERROR</member>
<member>WARNING</member>
<member>NOTICE</member>
<member>INFO</member>
<citerefentry><refentrytitle>ping_pong</refentrytitle>
<manvolnum>1</manvolnum></citerefentry>,
- <citerefentry><refentrytitle>ctdbd.conf</refentrytitle>
+ <citerefentry><refentrytitle>ctdb.conf</refentrytitle>
+ <manvolnum>5</manvolnum></citerefentry>,
+
+ <citerefentry><refentrytitle>ctdb-script.options</refentrytitle>
+ <manvolnum>5</manvolnum></citerefentry>,
+
+ <citerefentry><refentrytitle>ctdb.sysconfig</refentrytitle>
<manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>ctdb-statistics</refentrytitle>