ctdb-web: Update manpages to current 4.6.5
authorAmitay Isaacs <amitay@gmail.com>
Mon, 26 Jun 2017 06:08:24 +0000 (16:08 +1000)
committerAmitay Isaacs <amitay@gmail.com>
Mon, 26 Jun 2017 06:08:24 +0000 (16:08 +1000)
Add links for new manpages.

Signed-off-by: Amitay Isaacs <amitay@gmail.com>
14 files changed:
web/documentation.html
web/manpages/ctdb-etcd.7.html [new file with mode: 0644]
web/manpages/ctdb-statistics.7.html
web/manpages/ctdb-tunables.7.html
web/manpages/ctdb.1.html
web/manpages/ctdb.7.html
web/manpages/ctdb_diagnostics.1.html
web/manpages/ctdb_mutex_ceph_rados_helper.7.html [new file with mode: 0644]
web/manpages/ctdbd.1.html
web/manpages/ctdbd.conf.5.html
web/manpages/ctdbd_wrapper.1.html
web/manpages/ltdbtool.1.html
web/manpages/onnode.1.html
web/manpages/ping_pong.1.html

index f485026..e14c723 100644 (file)
@@ -20,6 +20,8 @@
 <li><a href="/manpages/ctdbd_wrapper.1.html">ctdbd_wrapper (1)</a>
 <li><a href="/manpages/ctdbd.conf.5.html">ctdbd.conf (5)</a>
 <li><a href="/manpages/ctdb.7.html">ctdb (7)</a>
+<li><a href="/manpages/ctdb-etcd.7.html">ctdb-etcd (7)</a>
+<li><a href="/manpages/ctdb_mutex_ceph_rados_helper.7.html">ctdb_mutex_ceph_rados_helper (7)</a>
 <li><a href="/manpages/ctdb-statistics.7.html">ctdb-statistics (7)</a>
 <li><a href="/manpages/ctdb-tunables.7.html">ctdb-tunables (7)</a>
 <li><a href="/manpages/onnode.1.html">onnode (1)</a>
diff --git a/web/manpages/ctdb-etcd.7.html b/web/manpages/ctdb-etcd.7.html
new file mode 100644 (file)
index 0000000..f5c9ff0
--- /dev/null
@@ -0,0 +1,40 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb-etcd</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb-etcd.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb-etcd &#8212; CTDB etcd integration</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdb_etcd_lock</code> </p></div></div><div class="refsect1"><a name="idm139667986750976"></a><h2>DESCRIPTION</h2><p>
+      ctdb_etcd_lock is intended to be run as a mutex helper for CTDB. It
+      will try to connect to an existing etcd cluster and grab a lock in that
+      cluster to function as CTDB's recovery lock. Please see
+      <span class="emphasis"><em>ctdb/doc/cluster_mutex_helper.txt</em></span> for details on
+      the mutex helper API. To use this, include the following line in your
+      CTDB config file:
+    </p><pre class="screen">
+CTDB_RECOVERY_LOCK="!/usr/local/usr/libexec/ctdb/ctdb_etcd_lock"
+    </pre><p>
+      You can also pass "-v", "-vv", or "-vvv" to include verbose output in
+      the CTDB log. Additional "v"s indicate increases in verbosity.
+    </p><p>
+      This mutex helper expects the system Python interpreter to have access
+      to the etcd Python module. It also expects an etcd cluster to be
+      configured and running. To integrate with this, there is an optional
+      config file of the following format:
+    </p><pre class="screen">
+key = value
+    </pre><p>
+      The following configuration parameters (and their defaults) are defined
+      for use by ctdb_etcd_lock:
+    </p><pre class="screen">
+port      = 2379   # connecting port for the etcd cluster
+lock_ttl  = 9      # seconds for TTL
+refresh   = 2      # seconds between attempts to maintain lock
+locks_dir = _ctdb  # where to store CTDB locks in etcd
+                   # The final etcd directory for any given lock looks like:
+                   #   /_locks/{locks_dir}/{netbios name}/
+    </pre><p>
+      In addition, any keyword parameter that can be used to configure an
+      etcd client may be specified and modified here. For more documentation
+      on these parameters, see here: https://github.com/jplana/python-etcd/
+    </p></div><div class="refsect1"><a name="idm139667989962512"></a><h2>SEE ALSO</h2><p>
+      <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span>,
+
+      <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,
+
+      <a class="ulink" href="http://ctdb.samba.org/" target="_top">http://ctdb.samba.org/</a>
+    </p></div></div></body></html>
index 6807bc7..9eeda66 100644 (file)
@@ -1,10 +1,10 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb-statistics</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb-statistics.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb-statistics &#8212; CTDB statistics output</p></div><div class="refsect1"><a name="idm45666704138096"></a><h2>OVERALL STATISTICS</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb-statistics</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb-statistics.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb-statistics &#8212; CTDB statistics output</p></div><div class="refsect1"><a name="idm140621985748688"></a><h2>OVERALL STATISTICS</h2><p>
       CTDB maintains information about various messages communicated
       and some of the important operations per node.  See the
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span> commands
       <span class="command"><strong>statistics</strong></span> and <span class="command"><strong>statisticsreset</strong></span>
       for displaying statistics.
-    </p><div class="refsect2"><a name="idm45666707089168"></a><h3>Example: ctdb statistics</h3><pre class="screen">
+    </p><div class="refsect2"><a name="idm140621984041088"></a><h3>Example: ctdb statistics</h3><pre class="screen">
 CTDB version 1
 Current time of statistics  :                Fri Sep 12 13:32:32 2014
 Statistics collected since  : (000 01:49:20) Fri Sep 12 11:43:12 2014
@@ -55,151 +55,151 @@ Statistics collected since  : (000 01:49:20) Fri Sep 12 11:43:12 2014
  reclock_recd       MIN/AVG/MAX     0.000000/0.000000/0.000000 sec out of 0
  call_latency       MIN/AVG/MAX     0.000006/0.000719/4.562991 sec out of 126626
  childwrite_latency MIN/AVG/MAX     0.014527/0.014527/0.014527 sec out of 1
-       </pre></div><div class="refsect2"><a name="idm45666704399024"></a><h3>CTDB version</h3><p>
+       </pre></div><div class="refsect2"><a name="idm140621983581632"></a><h3>CTDB version</h3><p>
         Version of the ctdb protocol used by the node.
-      </p></div><div class="refsect2"><a name="idm45666706168112"></a><h3>Current time of statistics</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621984462224"></a><h3>Current time of statistics</h3><p>
         Time when the statistics are generated.
       </p><p>
         This is useful when collecting statistics output periodically
         for post-processing.
-      </p></div><div class="refsect2"><a name="idm45666705078144"></a><h3>Statistics collected since</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621985684512"></a><h3>Statistics collected since</h3><p>
        Time when ctdb was started or the last time statistics was reset.
        The output shows the duration and the timestamp.
-      </p></div><div class="refsect2"><a name="idm45666704201184"></a><h3>num_clients</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621986778784"></a><h3>num_clients</h3><p>
         Number of processes currently connected to CTDB's unix socket.
         This includes recovery daemon, ctdb tool and samba processes
         (smbd, winbindd).
-      </p></div><div class="refsect2"><a name="idm45666704697120"></a><h3>frozen</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621984947376"></a><h3>frozen</h3><p>
        1 if the the databases are currently frozen, 0 otherwise.
-      </p></div><div class="refsect2"><a name="idm45666706354160"></a><h3>recovering</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621983990928"></a><h3>recovering</h3><p>
        1 if recovery is active, 0 otherwise.
-      </p></div><div class="refsect2"><a name="idm45666707461312"></a><h3>num_recoveries</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621983338032"></a><h3>num_recoveries</h3><p>
        Number of recoveries since the start of ctdb or since the last
        statistics reset.
-      </p></div><div class="refsect2"><a name="idm45666706887904"></a><h3>client_packets_sent</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621983522336"></a><h3>client_packets_sent</h3><p>
        Number of packets sent to client processes via unix domain socket.
-      </p></div><div class="refsect2"><a name="idm45666706278896"></a><h3>client_packets_recv</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621985407040"></a><h3>client_packets_recv</h3><p>
        Number of packets received from client processes via unix domain socket.
-      </p></div><div class="refsect2"><a name="idm45666706962656"></a><h3>node_packets_sent</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987381056"></a><h3>node_packets_sent</h3><p>
        Number of packets sent to the other nodes in the cluster via TCP.
-      </p></div><div class="refsect2"><a name="idm45666704515184"></a><h3>node_packets_recv</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987379872"></a><h3>node_packets_recv</h3><p>
        Number of packets received from the other nodes in the cluster via TCP.
-      </p></div><div class="refsect2"><a name="idm45666705429360"></a><h3>keepalive_packets_sent</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987378592"></a><h3>keepalive_packets_sent</h3><p>
        Number of keepalive messages sent to other nodes.
       </p><p>
        CTDB periodically sends keepalive messages to other nodes.
        See <em class="citetitle">KeepaliveInterval</em> tunable in
        <span class="citerefentry"><span class="refentrytitle">ctdb-tunables</span>(7)</span> for more details.
-      </p></div><div class="refsect2"><a name="idm45666704475952"></a><h3>keepalive_packets_recv</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987863744"></a><h3>keepalive_packets_recv</h3><p>
        Number of keepalive messages received from other nodes.
-      </p></div><div class="refsect2"><a name="idm45666706198368"></a><h3>node</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987862560"></a><h3>node</h3><p>
        This section lists various types of messages processed which
        originated from other nodes via TCP.
-      </p><div class="refsect3"><a name="idm45666706312336"></a><h4>req_call</h4><p>
+      </p><div class="refsect3"><a name="idm140621987861376"></a><h4>req_call</h4><p>
         Number of REQ_CALL messages from the other nodes.
-      </p></div><div class="refsect3"><a name="idm45666706469664"></a><h4>reply_call</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987860192"></a><h4>reply_call</h4><p>
         Number of REPLY_CALL messages from the other nodes.
-      </p></div><div class="refsect3"><a name="idm45666704000096"></a><h4>req_dmaster</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987859008"></a><h4>req_dmaster</h4><p>
         Number of REQ_DMASTER messages from the other nodes.
-      </p></div><div class="refsect3"><a name="idm45666705750000"></a><h4>reply_dmaster</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987857824"></a><h4>reply_dmaster</h4><p>
         Number of REPLY_DMASTER messages from the other nodes.
-      </p></div><div class="refsect3"><a name="idm45666703982512"></a><h4>reply_error</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987856640"></a><h4>reply_error</h4><p>
         Number of REPLY_ERROR messages from the other nodes.
-      </p></div><div class="refsect3"><a name="idm45666704293456"></a><h4>req_message</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987855456"></a><h4>req_message</h4><p>
         Number of REQ_MESSAGE messages from the other nodes.
-      </p></div><div class="refsect3"><a name="idm45666706873728"></a><h4>req_control</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987854272"></a><h4>req_control</h4><p>
         Number of REQ_CONTROL messages from the other nodes.
-      </p></div><div class="refsect3"><a name="idm45666706590272"></a><h4>reply_control</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987853008"></a><h4>reply_control</h4><p>
         Number of REPLY_CONTROL messages from the other nodes.
-      </p></div></div><div class="refsect2"><a name="idm45666704913984"></a><h3>client</h3><p>
+      </p></div></div><div class="refsect2"><a name="idm140621987851616"></a><h3>client</h3><p>
        This section lists various types of messages processed which
        originated from clients via unix domain socket.
-      </p><div class="refsect3"><a name="idm45666706632368"></a><h4>req_call</h4><p>
+      </p><div class="refsect3"><a name="idm140621987850432"></a><h4>req_call</h4><p>
         Number of REQ_CALL messages from the clients.
-      </p></div><div class="refsect3"><a name="idm45666705538640"></a><h4>req_message</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987849168"></a><h4>req_message</h4><p>
         Number of REQ_MESSAGE messages from the clients.
-      </p></div><div class="refsect3"><a name="idm45666706260256"></a><h4>req_control</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987986720"></a><h4>req_control</h4><p>
         Number of REQ_CONTROL messages from the clients.
-      </p></div></div><div class="refsect2"><a name="idm45666705870080"></a><h3>timeouts</h3><p>
+      </p></div></div><div class="refsect2"><a name="idm140621987985328"></a><h3>timeouts</h3><p>
        This section lists timeouts occurred when sending various messages.
-      </p><div class="refsect3"><a name="idm45666705119472"></a><h4>call</h4><p>
+      </p><div class="refsect3"><a name="idm140621987984176"></a><h4>call</h4><p>
         Number of timeouts for REQ_CALL messages.
-      </p></div><div class="refsect3"><a name="idm45666704066976"></a><h4>control</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987982912"></a><h4>control</h4><p>
         Number of timeouts for REQ_CONTROL messages.
-      </p></div><div class="refsect3"><a name="idm45666706001328"></a><h4>traverse</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987981648"></a><h4>traverse</h4><p>
         Number of timeouts for database traverse operations.
-      </p></div></div><div class="refsect2"><a name="idm45666705806528"></a><h3>locks</h3><p>
+      </p></div></div><div class="refsect2"><a name="idm140621987980256"></a><h3>locks</h3><p>
        This section lists locking statistics.
-      </p><div class="refsect3"><a name="idm45666705919456"></a><h4>num_calls</h4><p>
+      </p><div class="refsect3"><a name="idm140621987979200"></a><h4>num_calls</h4><p>
         Number of completed lock calls.  This includes database locks
         and record locks.
-      </p></div><div class="refsect3"><a name="idm45666704200928"></a><h4>num_current</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987977904"></a><h4>num_current</h4><p>
         Number of scheduled lock calls.  This includes database locks
         and record locks.
-      </p></div><div class="refsect3"><a name="idm45666704894592"></a><h4>num_pending</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987976608"></a><h4>num_pending</h4><p>
         Number of queued lock calls.  This includes database locks and
         record locks.
-      </p></div><div class="refsect3"><a name="idm45666704625024"></a><h4>num_failed</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621987975312"></a><h4>num_failed</h4><p>
         Number of failed lock calls.  This includes database locks and
         record locks.
-      </p></div></div><div class="refsect2"><a name="idm45666705217824"></a><h3>total_calls</h3><p>
+      </p></div></div><div class="refsect2"><a name="idm140621987973888"></a><h3>total_calls</h3><p>
        Number of req_call messages processed from clients.  This number
        should be same as client --&gt; req_call.
-      </p></div><div class="refsect2"><a name="idm45666704771808"></a><h3>pending_calls</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987972576"></a><h3>pending_calls</h3><p>
        Number of req_call messages which are currenly being processed.
        This number indicates the number of record migrations in flight.
-      </p></div><div class="refsect2"><a name="idm45666705513152"></a><h3>childwrite_calls</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987971232"></a><h3>childwrite_calls</h3><p>
        Number of record update calls.  Record update calls are used to
        update a record under a transaction.
-      </p></div><div class="refsect2"><a name="idm45666706009424"></a><h3>pending_childwrite_calls</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987962288"></a><h3>pending_childwrite_calls</h3><p>
        Number of record update calls currently active.
-      </p></div><div class="refsect2"><a name="idm45666705362400"></a><h3>memory_used</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987961056"></a><h3>memory_used</h3><p>
        The amount of memory in bytes currently used by CTDB using
        talloc.  This includes all the memory used for CTDB's internal
        data structures.  This does not include the memory mapped TDB
        databases.
-      </p></div><div class="refsect2"><a name="idm45666705898528"></a><h3>max_hop_count</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987959648"></a><h3>max_hop_count</h3><p>
        The maximum number of hops required for a record migration request
        to obtain the record.  High numbers indicate record contention.
-      </p></div><div class="refsect2"><a name="idm45666705017760"></a><h3>total_ro_delegations</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987958304"></a><h3>total_ro_delegations</h3><p>
        Number of readonly delegations created.
-      </p></div><div class="refsect2"><a name="idm45666706125568"></a><h3>total_ro_revokes</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987957120"></a><h3>total_ro_revokes</h3><p>
        Number of readonly delegations that were revoked.  The difference
        between total_ro_revokes and total_ro_delegations gives the
        number of currently active readonly delegations.
-      </p></div><div class="refsect2"><a name="idm45666706454272"></a><h3>hop_count_buckets</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987955728"></a><h3>hop_count_buckets</h3><p>
        Distribution of migration requests based on hop counts values.
        Buckets are 1, &lt; 4, &lt; 8, &lt; 16, &lt; 32, &lt; 64, &lt;
        128, &lt; 256, &lt; 512, &#8805; 512.
-      </p></div><div class="refsect2"><a name="idm45666704925792"></a><h3>lock_buckets</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987940288"></a><h3>lock_buckets</h3><p>
        Distribution of record lock requests based on time required to
        obtain locks.  Buckets are &lt; 1ms, &lt; 10ms, &lt; 100ms,
        &lt; 1s, &lt; 2s, &lt; 4s, &lt; 8s, &lt; 16s, &lt; 32s, &lt;
        64s, &#8805; 64s.
-      </p></div><div class="refsect2"><a name="idm45666704747424"></a><h3>locks_latency</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987953456"></a><h3>locks_latency</h3><p>
        The minimum, the average and the maximum time (in seconds)
        required to obtain record locks.
-      </p></div><div class="refsect2"><a name="idm45666703876976"></a><h3>reclock_ctdbd</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987952304"></a><h3>reclock_ctdbd</h3><p>
        The minimum, the average and the maximum time (in seconds)
        required to check if recovery lock is still held by recovery
        daemon when recovery mode is changed.  This check is done in ctdb daemon.
-      </p></div><div class="refsect2"><a name="idm45666703934784"></a><h3>reclock_recd</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987950928"></a><h3>reclock_recd</h3><p>
         The minimum, the average and the maximum time (in seconds)
         required to check if recovery lock is still held by recovery
         daemon during recovery.  This check is done in recovery daemon.
-      </p></div><div class="refsect2"><a name="idm45666704968688"></a><h3>call_latency</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621987949552"></a><h3>call_latency</h3><p>
        The minimum, the average and the maximum time (in seconds) required
        to process a REQ_CALL message from client.  This includes the time
        required to migrate a record from remote node, if the record is
        not available on the local node.
-      </p></div><div class="refsect2"><a name="idm45666704700384"></a><h3>childwrite_latency</h3><p>Default: 0</p><p>
+      </p></div><div class="refsect2"><a name="idm140621987947664"></a><h3>childwrite_latency</h3><p>Default: 0</p><p>
        The minimum, the average and the maximum time (in seconds)
        required to update records under a transaction.
-      </p></div></div><div class="refsect1"><a name="idm45666704604208"></a><h2>DATABASE STATISTICS</h2><p>
+      </p></div></div><div class="refsect1"><a name="idm140621987945808"></a><h2>DATABASE STATISTICS</h2><p>
       CTDB maintains per database statistics about important operations.
       See the <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span> command
       <span class="command"><strong>dbstatistics</strong></span> for displaying database statistics.
-    </p><div class="refsect2"><a name="idm45666703819616"></a><h3>Example: ctdb dbstatistics notify_index.tdb</h3><pre class="screen">
+    </p><div class="refsect2"><a name="idm140621987942992"></a><h3>Example: ctdb dbstatistics notify_index.tdb</h3><pre class="screen">
 DB Statistics: notify_index.tdb
  ro_delegations                     0
  ro_revokes                         0
@@ -215,45 +215,45 @@ DB Statistics: notify_index.tdb
      Count:7 Key:2f636c75737465726673
      Count:18 Key:2f636c757374657266732f64617461
      Count:7 Key:2f636c757374657266732f646174612f636c69656e7473
-       </pre></div><div class="refsect2"><a name="idm45666706608144"></a><h3>DB Statistics</h3><p>
+       </pre></div><div class="refsect2"><a name="idm140621987940928"></a><h3>DB Statistics</h3><p>
        Name of the database.
-      </p></div><div class="refsect2"><a name="idm45666706503952"></a><h3>ro_delegations</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621982442256"></a><h3>ro_delegations</h3><p>
        Number of readonly delegations created in the database.
-      </p></div><div class="refsect2"><a name="idm45666703792800"></a><h3>ro_revokes</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621982441104"></a><h3>ro_revokes</h3><p>
        Number of readonly delegations revoked.  The difference in
        ro_delegations and ro_revokes indicates the currently active
        readonly delegations.
-      </p></div><div class="refsect2"><a name="idm45666704366832"></a><h3>locks</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621982439776"></a><h3>locks</h3><p>
        This section lists locking statistics.
-      </p><div class="refsect3"><a name="idm45666705473168"></a><h4>total</h4><p>
+      </p><div class="refsect3"><a name="idm140621982438752"></a><h4>total</h4><p>
         Number of completed lock calls.  This includes database locks
         and record locks.
-      </p></div><div class="refsect3"><a name="idm45666704277744"></a><h4>failed</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621982437488"></a><h4>failed</h4><p>
         Number of failed lock calls.  This includes database locks and
         record locks.
-      </p></div><div class="refsect3"><a name="idm45666705164528"></a><h4>current</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621982436224"></a><h4>current</h4><p>
         Number of scheduled lock calls.  This includes database locks
         and record locks.
-      </p></div><div class="refsect3"><a name="idm45666707562784"></a><h4>pending</h4><p>
+      </p></div><div class="refsect3"><a name="idm140621982434960"></a><h4>pending</h4><p>
         Number of queued lock calls.  This includes database locks and
         record locks.
-      </p></div></div><div class="refsect2"><a name="idm45666704716832"></a><h3>hop_count_buckets</h3><p>
+      </p></div></div><div class="refsect2"><a name="idm140621982433568"></a><h3>hop_count_buckets</h3><p>
        Distribution of migration requests based on hop counts values.
        Buckets are 1, &lt; 4, &lt; 8, &lt; 16, &lt; 32, &lt; 64, &lt;
        128, &lt; 256, &lt; 512, &#8805; 512.
-      </p></div><div class="refsect2"><a name="idm45666704548256"></a><h3>lock_buckets</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621982432208"></a><h3>lock_buckets</h3><p>
        Distribution of record lock requests based on time required to
        obtain locks.  Buckets are &lt; 1ms, &lt; 10ms, &lt; 100ms,
        &lt; 1s, &lt; 2s, &lt; 4s, &lt; 8s, &lt; 16s, &lt; 32s, &lt;
        64s, &#8805; 64s.
-      </p></div><div class="refsect2"><a name="idm45666705836992"></a><h3>locks_latency</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621982430784"></a><h3>locks_latency</h3><p>
        The minimum, the average and the maximum time (in seconds)
        required to obtain record locks.
-      </p></div><div class="refsect2"><a name="idm45666706809744"></a><h3>Num Hot Keys</h3><p>
+      </p></div><div class="refsect2"><a name="idm140621982429520"></a><h3>Num Hot Keys</h3><p>
         Number of contended records determined by hop count.  CTDB keeps
         track of top 10 hot records and the output shows hex encoded
         keys for the hot records.
-      </p></div></div><div class="refsect1"><a name="idm45666704640496"></a><h2>SEE ALSO</h2><p>
+      </p></div></div><div class="refsect1"><a name="idm140621982428048"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span>,
 
       <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,
index 0dd7879..488de71 100644 (file)
@@ -1,42 +1,48 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb-tunables</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb-tunables.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb-tunables &#8212; CTDB tunable configuration variables</p></div><div class="refsect1"><a name="idm10"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb-tunables</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb-tunables.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb-tunables &#8212; CTDB tunable configuration variables</p></div><div class="refsect1"><a name="idm140259278533088"></a><h2>DESCRIPTION</h2><p>
       CTDB's behaviour can be configured by setting run-time tunable
       variables.  This lists and describes all tunables.  See the
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span>
       <span class="command"><strong>listvars</strong></span>, <span class="command"><strong>setvar</strong></span> and
       <span class="command"><strong>getvar</strong></span> commands for more details.
+    </p><p>
+      Unless otherwise stated, tunables should be set to the same
+      value on all nodes.  Setting tunables to different values across
+      nodes may produce unexpected results.  Future releases may set
+      (some or most) tunables globally across the cluster but doing so
+      is currently a manual process.
     </p><p>
       The tunable variables are listed alphabetically.
-    </p><div class="refsect2"><a name="idm20"></a><h3>AllowClientDBAttach</h3><p>Default: 1</p><p>
+    </p><div class="refsect2"><a name="idm140259278393728"></a><h3>AllowClientDBAttach</h3><p>Default: 1</p><p>
        When set to 0, clients are not allowed to attach to any databases.
        This can be used to temporarily block any new processes from
        attaching to and accessing the databases.  This is mainly used
        for detaching a volatile database using 'ctdb detach'.
-      </p></div><div class="refsect2"><a name="idm24"></a><h3>AllowUnhealthyDBRead</h3><p>Default: 0</p><p>
+      </p></div><div class="refsect2"><a name="idm140259279350368"></a><h3>AllowUnhealthyDBRead</h3><p>Default: 0</p><p>
        When set to 1, ctdb allows database traverses to read unhealthy
        databases.  By default, ctdb does not allow reading records from
        unhealthy databases.
-      </p></div><div class="refsect2"><a name="idm28"></a><h3>ControlTimeout</h3><p>Default: 60</p><p>
+      </p></div><div class="refsect2"><a name="idm140259280015280"></a><h3>ControlTimeout</h3><p>Default: 60</p><p>
        This is the default setting for timeout for when sending a
        control message to either the local or a remote ctdb daemon.
-      </p></div><div class="refsect2"><a name="idm32"></a><h3>DatabaseHashSize</h3><p>Default: 100001</p><p>
+      </p></div><div class="refsect2"><a name="idm140259280961360"></a><h3>DatabaseHashSize</h3><p>Default: 100001</p><p>
        Number of the hash chains for the local store of the tdbs that
        ctdb manages.
-      </p></div><div class="refsect2"><a name="idm36"></a><h3>DatabaseMaxDead</h3><p>Default: 5</p><p>
+      </p></div><div class="refsect2"><a name="idm140259280959760"></a><h3>DatabaseMaxDead</h3><p>Default: 5</p><p>
        Maximum number of dead records per hash chain for the tdb databses
        managed by ctdb.
-      </p></div><div class="refsect2"><a name="idm40"></a><h3>DBRecordCountWarn</h3><p>Default: 100000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281728576"></a><h3>DBRecordCountWarn</h3><p>Default: 100000</p><p>
        When set to non-zero, ctdb will log a warning during recovery if
        a database has more than this many records. This will produce a
        warning if a database grows uncontrollably with orphaned records.
-      </p></div><div class="refsect2"><a name="idm44"></a><h3>DBRecordSizeWarn</h3><p>Default: 10000000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281726752"></a><h3>DBRecordSizeWarn</h3><p>Default: 10000000</p><p>
        When set to non-zero, ctdb will log a warning during recovery
        if a single record is bigger than this size. This will produce
        a warning if a database record grows uncontrollably.
-      </p></div><div class="refsect2"><a name="idm48"></a><h3>DBSizeWarn</h3><p>Default: 1000000000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281764192"></a><h3>DBSizeWarn</h3><p>Default: 1000000000</p><p>
        When set to non-zero, ctdb will log a warning during recovery if
        a database size is bigger than this. This will produce a warning
        if a database grows uncontrollably.
-      </p></div><div class="refsect2"><a name="idm52"></a><h3>DeferredAttachTO</h3><p>Default: 120</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281762400"></a><h3>DeferredAttachTO</h3><p>Default: 120</p><p>
        When databases are frozen we do not allow clients to attach to
        the databases. Instead of returning an error immediately to the
        client, the attach request from the client is deferred until
       </p><p>
        This timeout controls how long we will defer the request from the
        client before timing it out and returning an error to the client.
-      </p></div><div class="refsect2"><a name="idm57"></a><h3>DeterministicIPs</h3><p>Default: 0</p><p>
-       When set to 1, ctdb will try to keep public IP addresses locked
-       to specific nodes as far as possible. This makes it easier
-       for debugging since you can know that as long as all nodes are
-       healthy public IP X will always be hosted by node Y.
-      </p><p>
-       The cost of using deterministic IP address assignment is that it
-       disables part of the logic where ctdb tries to reduce the number
-       of public IP assignment changes in the cluster. This tunable may
-       increase the number of IP failover/failbacks that are performed
-       on the cluster by a small margin.
-      </p></div><div class="refsect2"><a name="idm62"></a><h3>DisableIPFailover</h3><p>Default: 0</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281759968"></a><h3>DisableIPFailover</h3><p>Default: 0</p><p>
        When set to non-zero, ctdb will not perform failover or
        failback. Even if a node fails while holding public IPs, ctdb
        will not recover the IPs or assign them to another node.
        nodes. This leads to a service outage until the administrator
        has manually performed IP failover to replacement nodes using the
        'ctdb moveip' command.
-      </p></div><div class="refsect2"><a name="idm67"></a><h3>ElectionTimeout</h3><p>Default: 3</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281757472"></a><h3>ElectionTimeout</h3><p>Default: 3</p><p>
        The number of seconds to wait for the election of recovery
        master to complete. If the election is not completed during this
        interval, then that round of election fails and ctdb starts a
        new election.
-      </p></div><div class="refsect2"><a name="idm71"></a><h3>EnableBans</h3><p>Default: 1</p><p>
-        This parameter allows ctdb to ban a node if the node is misbehaving.
+      </p></div><div class="refsect2"><a name="idm140259281755648"></a><h3>EnableBans</h3><p>Default: 1</p><p>
+       This parameter allows ctdb to ban a node if the node is misbehaving.
       </p><p>
        When set to 0, this disables banning completely in the cluster
        and thus nodes can not get banned, even it they break. Don't
-       set to 0 unless you know what you are doing.  You should set
-       this to the same value on all nodes to avoid unexpected behaviour.
-      </p></div><div class="refsect2"><a name="idm76"></a><h3>EventScriptTimeout</h3><p>Default: 30</p><p>
+       set to 0 unless you know what you are doing.
+      </p></div><div class="refsect2"><a name="idm140259281753472"></a><h3>EventScriptTimeout</h3><p>Default: 30</p><p>
        Maximum time in seconds to allow an event to run before timing
        out.  This is the total time for all enabled scripts that are
        run for an event, not just a single event script.
@@ -87,7 +81,7 @@
        "releaseip", "startrecovery", "recovered") and converted to
        success.  The logic here is that the callers of these events
        implement their own additional timeout.
-      </p></div><div class="refsect2"><a name="idm81"></a><h3>FetchCollapse</h3><p>Default: 1</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281751040"></a><h3>FetchCollapse</h3><p>Default: 1</p><p>
        This parameter is used to avoid multiple migration requests for
        the same record from a single node. All the record requests for
        the same record are queued up and processed when the record is
        bounce that record around very fast, and poor performance.
        This can improve performance and reduce CPU utilization for
        certain workloads.
-      </p></div><div class="refsect2"><a name="idm86"></a><h3>HopcountMakeSticky</h3><p>Default: 50</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281887088"></a><h3>HopcountMakeSticky</h3><p>Default: 50</p><p>
        For database(s) marked STICKY (using 'ctdb setdbsticky'),
        any record that is migrating so fast that hopcount
        exceeds this limit is marked as STICKY record for
        This will improve performance for certain workloads, such as
        locking.tdb if many clients are opening/closing the same file
        concurrently.
-      </p></div><div class="refsect2"><a name="idm93"></a><h3>KeepaliveInterval</h3><p>Default: 5</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281883888"></a><h3>IPAllocAlgorithm</h3><p>Default: 2</p><p>
+       Selects the algorithm that CTDB should use when doing public
+       IP address allocation.  Meaningful values are:
+      </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">0</span></dt><dd><p>
+             Deterministic IP address allocation.
+           </p><p>
+             This is a simple and fast option.  However, it can cause
+             unnecessary address movement during fail-over because
+             each address has a "home" node.  Works badly when some
+             nodes do not have any addresses defined.  Should be used
+             with care when addresses are defined across multiple
+             networks.
+           </p></dd><dt><span class="term">1</span></dt><dd><p>
+             Non-deterministic IP address allocation.
+           </p><p>
+             This is a relatively fast option that attempts to do a
+             minimise unnecessary address movements.  Addresses do
+             not have a "home" node.  Rebalancing is limited but it
+             usually adequate.  Works badly when addresses are
+             defined across multiple networks.
+           </p></dd><dt><span class="term">2</span></dt><dd><p>
+             LCP2 IP address allocation.
+           </p><p>
+             Uses a heuristic to assign addresses defined across
+             multiple networks, usually balancing addresses on each
+             network evenly across nodes.  Addresses do not have a
+             "home" node.  Minimises unnecessary address movements.
+             The algorithm is complex, so is slower than other
+             choices for a large number of addresses.  However, it
+             can calculate an optimal assignment of 900 addresses in
+             under 10 seconds on modern hardware.
+           </p></dd></dl></div><p>
+       If the specified value is not one of these then the default
+       will be used.
+      </p></div><div class="refsect2"><a name="idm140259281874384"></a><h3>KeepaliveInterval</h3><p>Default: 5</p><p>
        How often in seconds should the nodes send keep-alive packets to
        each other.
-      </p></div><div class="refsect2"><a name="idm97"></a><h3>KeepaliveLimit</h3><p>Default: 5</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281872784"></a><h3>KeepaliveLimit</h3><p>Default: 5</p><p>
        After how many keepalive intervals without any traffic should
        a node wait until marking the peer as DISCONNECTED.
        </p><p>
        a recovery. This limit should not be set too high to enable
        early detection and avoid any application timeouts (e.g. SMB1)
        to kick in before the fail over is completed.
-      </p></div><div class="refsect2"><a name="idm104"></a><h3>LCP2PublicIPs</h3><p>Default: 1</p><p>
-       When set to 1, ctdb uses the LCP2 ip allocation algorithm.
-      </p></div><div class="refsect2"><a name="idm108"></a><h3>LockProcessesPerDB</h3><p>Default: 200</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281862080"></a><h3>LockProcessesPerDB</h3><p>Default: 200</p><p>
        This is the maximum number of lock helper processes ctdb will
        create for obtaining record locks.  When ctdb cannot get a record
        lock without blocking, it creates a helper process that waits
        for the lock to be obtained.
-      </p></div><div class="refsect2"><a name="idm112"></a><h3>LogLatencyMs</h3><p>Default: 0</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281860240"></a><h3>LogLatencyMs</h3><p>Default: 0</p><p>
        When set to non-zero, ctdb will log if certains operations
        take longer than this value, in milliseconds, to complete.
        These operations include "process a record request from client",
        "take a record or database lock", "update a persistent database
        record" and "vaccum a database".
-      </p></div><div class="refsect2"><a name="idm116"></a><h3>MaxQueueDropMsg</h3><p>Default: 1000000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281858336"></a><h3>MaxQueueDropMsg</h3><p>Default: 1000000</p><p>
        This is the maximum number of messages to be queued up for
        a client before ctdb will treat the client as hung and will
        terminate the client connection.
-      </p></div><div class="refsect2"><a name="idm120"></a><h3>MonitorInterval</h3><p>Default: 15</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281856560"></a><h3>MonitorInterval</h3><p>Default: 15</p><p>
        How often should ctdb run the 'monitor' event in seconds to check
        for a node's health.
-      </p></div><div class="refsect2"><a name="idm124"></a><h3>MonitorTimeoutCount</h3><p>Default: 20</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281854848"></a><h3>MonitorTimeoutCount</h3><p>Default: 20</p><p>
        How many 'monitor' events in a row need to timeout before a node
        is flagged as UNHEALTHY.  This setting is useful if scripts can
        not be written so that they do not hang for benign reasons.
-      </p></div><div class="refsect2"><a name="idm128"></a><h3>NoIPFailback</h3><p>Default: 0</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281853040"></a><h3>NoIPFailback</h3><p>Default: 0</p><p>
        When set to 1, ctdb will not perform failback of IP addresses
        when a node becomes healthy. When a node becomes UNHEALTHY,
        ctdb WILL perform failover of public IP addresses, but when the
        until there is manual intervention from the administrator. When
        this parameter is set, you can manually fail public IP addresses
        over to the new node(s) using the 'ctdb moveip' command.
-      </p></div><div class="refsect2"><a name="idm134"></a><h3>NoIPHostOnAllDisabled</h3><p>Default: 0</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281849648"></a><h3>NoIPHostOnAllDisabled</h3><p>Default: 0</p><p>
        If no nodes are HEALTHY then by default ctdb will happily host
        public IPs on disabled (unhealthy or administratively disabled)
        nodes.  This can cause problems, for example if the underlying
-       cluster filesystem is not mounted.  When set to 1 on a node and
-       that node is disabled, any IPs hosted by this node will be
-       released and the node will not takeover any IPs until it is no
-       longer disabled.
-      </p></div><div class="refsect2"><a name="idm138"></a><h3>NoIPTakeover</h3><p>Default: 0</p><p>
+       cluster filesystem is not mounted.  When set to 1 and a node
+       is disabled, any IPs hosted by this node will be released and
+       the node will not takeover any IPs until it is no longer disabled.
+      </p></div><div class="refsect2"><a name="idm140259281847632"></a><h3>NoIPTakeover</h3><p>Default: 0</p><p>
        When set to 1, ctdb will not allow IP addresses to be failed
-       over onto this node. Any IP addresses that the node currently
-       hosts will remain on the node but no new IP addresses can be
-       failed over to the node.
-      </p></div><div class="refsect2"><a name="idm142"></a><h3>PullDBPreallocation</h3><p>Default: 10*1024*1024</p><p>
+       over to other nodes.  Any IP addresses already hosted on
+       healthy nodes will remain.  Usually IP addresses hosted on
+       unhealthy nodes will also remain, if NoIPHostOnAllDisabled is
+       0.  However, if NoIPHostOnAllDisabled is 1 then IP addresses
+       will be released by unhealthy nodes and will become un-hosted.
+      </p></div><div class="refsect2"><a name="idm140259281845632"></a><h3>PullDBPreallocation</h3><p>Default: 10*1024*1024</p><p>
        This is the size of a record buffer to pre-allocate for sending
        reply to PULLDB control. Usually record buffer starts with size
        of the first record and gets reallocated every time a new record
        is added to the record buffer. For a large number of records,
        this can be very inefficient to grow the record buffer one record
        at a time.
-      </p></div><div class="refsect2"><a name="idm146"></a><h3>QueueBufferSize</h3><p>Default: 1024</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281843664"></a><h3>QueueBufferSize</h3><p>Default: 1024</p><p>
        This is the maximum amount of data (in bytes) ctdb will read
        from a socket at a time.
       </p><p>
        then this tunable value should be increased.  However, large
        values can keep ctdb busy processing packets and prevent ctdb
        from handling other events.
-      </p></div><div class="refsect2"><a name="idm151"></a><h3>RecBufferSizeLimit</h3><p>Default: 1000000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259281841264"></a><h3>RecBufferSizeLimit</h3><p>Default: 1000000</p><p>
         This is the limit on the size of the record buffer to be sent
         in various controls.  This limit is used by new controls used
         for recovery and controls used in vacuuming.
-      </p></div><div class="refsect2"><a name="idm155"></a><h3>RecdFailCount</h3><p>Default: 10</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276337632"></a><h3>RecdFailCount</h3><p>Default: 10</p><p>
        If the recovery daemon has failed to ping the main dameon for
        this many consecutive intervals, the main daemon will consider
        the recovery daemon as hung and will try to restart it to recover.
-      </p></div><div class="refsect2"><a name="idm159"></a><h3>RecdPingTimeout</h3><p>Default: 60</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276335872"></a><h3>RecdPingTimeout</h3><p>Default: 60</p><p>
        If the main dameon has not heard a "ping" from the recovery dameon
        for this many seconds, the main dameon will log a message that
        the recovery daemon is potentially hung.  This also increments a
        counter which is checked against <code class="varname">RecdFailCount</code>
        for detection of hung recovery daemon.
-      </p></div><div class="refsect2"><a name="idm164"></a><h3>RecLockLatencyMs</h3><p>Default: 1000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276333696"></a><h3>RecLockLatencyMs</h3><p>Default: 1000</p><p>
        When using a reclock file for split brain prevention, if set
        to non-zero this tunable will make the recovery dameon log a
        message if the fcntl() call to lock/testlock the recovery file
        takes longer than this number of milliseconds.
-      </p></div><div class="refsect2"><a name="idm168"></a><h3>RecoverInterval</h3><p>Default: 1</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276331904"></a><h3>RecoverInterval</h3><p>Default: 1</p><p>
        How frequently in seconds should the recovery daemon perform the
        consistency checks to determine if it should perform a recovery.
-      </p></div><div class="refsect2"><a name="idm172"></a><h3>RecoverPDBBySeqNum</h3><p>Default: 1</p><p>
-       When set to zero, database recovery for persistent databases is
-       record-by-record and recovery process simply collects the most
-       recent version of every individual record.
-      </p><p>
-       When set to non-zero, persistent databases will instead be
-       recovered as a whole db and not by individual records. The
-       node that contains the highest value stored in the record
-       "__db_sequence_number__" is selected and the copy of that nodes
-       database is used as the recovered database.
-      </p><p>
-       By default, recovery of persistent databses is done using
-       __db_sequence_number__ record.
-      </p></div><div class="refsect2"><a name="idm178"></a><h3>RecoverTimeout</h3><p>Default: 120</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276330208"></a><h3>RecoverTimeout</h3><p>Default: 120</p><p>
        This is the default setting for timeouts for controls when sent
        from the recovery daemon. We allow longer control timeouts from
        the recovery daemon than from normal use since the recovery
        dameon often use controls that can take a lot longer than normal
        controls.
-      </p></div><div class="refsect2"><a name="idm182"></a><h3>RecoveryBanPeriod</h3><p>Default: 300</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276328384"></a><h3>RecoveryBanPeriod</h3><p>Default: 300</p><p>
        The duration in seconds for which a node is banned if the node
        fails during recovery.  After this time has elapsed the node will
        automatically get unbanned and will attempt to rejoin the cluster.
        A node usually gets banned due to real problems with the node.
        Don't set this value too small.  Otherwise, a problematic node
        will try to re-join cluster too soon causing unnecessary recoveries.
-      </p></div><div class="refsect2"><a name="idm187"></a><h3>RecoveryDropAllIPs</h3><p>Default: 120</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276325984"></a><h3>RecoveryDropAllIPs</h3><p>Default: 120</p><p>
        If a node is stuck in recovery, or stopped, or banned, for this
        many seconds, then ctdb will release all public addresses on
        that node.
-      </p></div><div class="refsect2"><a name="idm191"></a><h3>RecoveryGracePeriod</h3><p>Default: 120</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276324288"></a><h3>RecoveryGracePeriod</h3><p>Default: 120</p><p>
        During recoveries, if a node has not caused recovery failures
        during the last grace period in seconds, any records of
        transgressions that the node has caused recovery failures will be
        forgiven. This resets the ban-counter back to zero for that node.
-      </p></div><div class="refsect2"><a name="idm195"></a><h3>RepackLimit</h3><p>Default: 10000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276322448"></a><h3>RepackLimit</h3><p>Default: 10000</p><p>
         During vacuuming, if the number of freelist records are more than
         <code class="varname">RepackLimit</code>, then the database is repacked
         to get rid of the freelist records to avoid fragmentation.
       </p><p>
         Databases are repacked only if both <code class="varname">RepackLimit</code>
         and <code class="varname">VacuumLimit</code> are exceeded.
-      </p></div><div class="refsect2"><a name="idm203"></a><h3>RerecoveryTimeout</h3><p>Default: 10</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276319248"></a><h3>RerecoveryTimeout</h3><p>Default: 10</p><p>
        Once a recovery has completed, no additional recoveries are
        permitted until this timeout in seconds has expired.
-      </p></div><div class="refsect2"><a name="idm207"></a><h3>SeqnumInterval</h3><p>Default: 1000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276317568"></a><h3>SeqnumInterval</h3><p>Default: 1000</p><p>
        Some databases have seqnum tracking enabled, so that samba will
        be able to detect asynchronously when there has been updates
        to the database.  Everytime a database is updated its sequence
        This tunable is used to specify in milliseconds how frequently
        ctdb will send out updates to remote nodes to inform them that
        the sequence number is increased.
-      </p></div><div class="refsect2"><a name="idm212"></a><h3>StatHistoryInterval</h3><p>Default: 1</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276315216"></a><h3>StatHistoryInterval</h3><p>Default: 1</p><p>
        Granularity of the statistics collected in the statistics
        history. This is reported by 'ctdb stats' command.
-      </p></div><div class="refsect2"><a name="idm216"></a><h3>StickyDuration</h3><p>Default: 600</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276313552"></a><h3>StickyDuration</h3><p>Default: 600</p><p>
        Once a record has been marked STICKY, this is the duration in
        seconds, the record will be flagged as a STICKY record.
-      </p></div><div class="refsect2"><a name="idm220"></a><h3>StickyPindown</h3><p>Default: 200</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276311872"></a><h3>StickyPindown</h3><p>Default: 200</p><p>
        Once a STICKY record has been migrated onto a node, it will be
        pinned down on that node for this number of milliseconds. Any
        request from other nodes to migrate the record off the node will
        be deferred.
-      </p></div><div class="refsect2"><a name="idm224"></a><h3>TakeoverTimeout</h3><p>Default: 9</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276310112"></a><h3>TakeoverTimeout</h3><p>Default: 9</p><p>
        This is the duration in seconds in which ctdb tries to complete IP
        failover.
-      </p></div><div class="refsect2"><a name="idm228"></a><h3>TDBMutexEnabled</h3><p>Default: 0</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276308480"></a><h3>TDBMutexEnabled</h3><p>Default: 0</p><p>
        This paramter enables TDB_MUTEX_LOCKING feature on volatile
        databases if the robust mutexes are supported. This optimizes the
        record locking using robust mutexes and is much more efficient
        that using posix locks.
-      </p></div><div class="refsect2"><a name="idm232"></a><h3>TickleUpdateInterval</h3><p>Default: 20</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276306704"></a><h3>TickleUpdateInterval</h3><p>Default: 20</p><p>
        Every <code class="varname">TickleUpdateInterval</code> seconds, ctdb
        synchronizes the client connection information across nodes.
-      </p></div><div class="refsect2"><a name="idm237"></a><h3>TraverseTimeout</h3><p>Default: 20</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276304688"></a><h3>TraverseTimeout</h3><p>Default: 20</p><p>
        This is the duration in seconds for which a database traverse
        is allowed to run.  If the traverse does not complete during
        this interval, ctdb will abort the traverse.
-      </p></div><div class="refsect2"><a name="idm241"></a><h3>VacuumFastPathCount</h3><p>Default: 60</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276302960"></a><h3>VacuumFastPathCount</h3><p>Default: 60</p><p>
        During a vacuuming run, ctdb usually processes only the records
        marked for deletion also called the fast path vacuuming. After
        finishing <code class="varname">VacuumFastPathCount</code> number of fast
        path vacuuming runs, ctdb will trigger a scan of complete database
        for any empty records that need to be deleted.
-      </p></div><div class="refsect2"><a name="idm246"></a><h3>VacuumInterval</h3><p>Default: 10</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276300704"></a><h3>VacuumInterval</h3><p>Default: 10</p><p>
         Periodic interval in seconds when vacuuming is triggered for
         volatile databases.
-      </p></div><div class="refsect2"><a name="idm250"></a><h3>VacuumLimit</h3><p>Default: 5000</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276299040"></a><h3>VacuumLimit</h3><p>Default: 5000</p><p>
         During vacuuming, if the number of deleted records are more than
         <code class="varname">VacuumLimit</code>, then databases are repacked to
         avoid fragmentation.
       </p><p>
         Databases are repacked only if both <code class="varname">RepackLimit</code>
         and <code class="varname">VacuumLimit</code> are exceeded.
-      </p></div><div class="refsect2"><a name="idm258"></a><h3>VacuumMaxRunTime</h3><p>Default: 120</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276295872"></a><h3>VacuumMaxRunTime</h3><p>Default: 120</p><p>
         The maximum time in seconds for which the vacuuming process is
         allowed to run.  If vacuuming process takes longer than this
         value, then the vacuuming process is terminated.
-      </p></div><div class="refsect2"><a name="idm262"></a><h3>VerboseMemoryNames</h3><p>Default: 0</p><p>
+      </p></div><div class="refsect2"><a name="idm140259276294112"></a><h3>VerboseMemoryNames</h3><p>Default: 0</p><p>
        When set to non-zero, ctdb assigns verbose names for some of
        the talloc allocated memory objects.  These names are visible
        in the talloc memory report generated by 'ctdb dumpmemory'.
-      </p></div></div><div class="refsect1"><a name="idm266"></a><h2>SEE ALSO</h2><p>
+      </p></div></div><div class="refsect1"><a name="idm140259276292240"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span>,
 
       <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,
index 795570a..aaf29a7 100644 (file)
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb &#8212; CTDB management utility</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdb</code>  [<em class="replaceable"><code>OPTION</code></em>...] {<em class="replaceable"><code>COMMAND</code></em>} [<em class="replaceable"><code>COMMAND-ARGS</code></em>]</p></div></div><div class="refsect1"><a name="idm31"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb &#8212; CTDB management utility</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdb</code>  [<em class="replaceable"><code>OPTION</code></em>...] {<em class="replaceable"><code>COMMAND</code></em>} [<em class="replaceable"><code>COMMAND-ARGS</code></em>]</p></div></div><div class="refsect1"><a name="idm140317076399120"></a><h2>DESCRIPTION</h2><p>
       ctdb is a utility to view and manage a CTDB cluster.
     </p><p>
       The following terms are used when referring to nodes in a
@@ -21,8 +21,8 @@
              A space separated list of at least one
              <em class="parameter"><code>DB</code></em>.
            </p></dd></dl></div><p>
-    </p></div><div class="refsect1"><a name="idm56"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-n <em class="parameter"><code>PNN-LIST</code></em></span></dt><dd><p>
-         The nodes specified by PNN-LIST should be queried for the
+    </p></div><div class="refsect1"><a name="idm140317080330816"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-n <em class="parameter"><code>PNN</code></em></span></dt><dd><p>
+         The node specified by PNN should be queried for the
          requested information.  Default is to query the daemon
          running on the local host.
        </p></dd><dt><span class="term">-Y</span></dt><dd><p>
        </p></dd><dt><span class="term">--usage</span></dt><dd><p>
          Print useage information to the screen.
        </p></dd><dt><span class="term">-d --debug=<em class="parameter"><code>DEBUGLEVEL</code></em></span></dt><dd><p>
-         Change the debug level for the command. Default is NOTICE (2).
+         Change the debug level for the command. Default is NOTICE.
        </p></dd><dt><span class="term">--socket=<em class="parameter"><code>FILENAME</code></em></span></dt><dd><p>
          Specify that FILENAME is the name of the Unix domain
          socket to use when connecting to the local CTDB
          daemon. The default is
          <code class="filename">/usr/local/var/run/ctdb/ctdbd.socket</code>.
-       </p></dd></dl></div></div><div class="refsect1"><a name="idm107"></a><h2>ADMINISTRATIVE COMMANDS</h2><p>
+       </p></dd></dl></div></div><div class="refsect1"><a name="idm140317080470800"></a><h2>ADMINISTRATIVE COMMANDS</h2><p>
       These are commands used to monitor and administer a CTDB cluster.
-    </p><div class="refsect2"><a name="idm110"></a><h3>pnn</h3><p>
+    </p><div class="refsect2"><a name="idm140317080469648"></a><h3>pnn</h3><p>
        This command displays the PNN of the current node.
-      </p></div><div class="refsect2"><a name="idm113"></a><h3>status</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317080468448"></a><h3>status</h3><p>
        This command shows the current status of all CTDB nodes based
        on information from the queried node.
       </p><p>
        Note: If the the queried node is INACTIVE then the status
        might not be current.
-      </p><div class="refsect3"><a name="idm117"></a><h4>Node status</h4><p>
+      </p><div class="refsect3"><a name="idm140317080466768"></a><h4>Node status</h4><p>
          This includes the number of physical nodes and the status of
          each node.  See <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span> for information
          about node states.
-       </p></div><div class="refsect3"><a name="idm123"></a><h4>Generation</h4><p>
+       </p></div><div class="refsect3"><a name="idm140317080464560"></a><h4>Generation</h4><p>
          The generation id is a number that indicates the current generation 
          of a cluster instance. Each time a cluster goes through a 
          reconfiguration or a recovery its generation id will be changed.
          All nodes start with generation "INVALID" and are not assigned a real
          generation id until they have successfully been merged with a cluster
          through a recovery.
-       </p></div><div class="refsect3"><a name="idm128"></a><h4>Virtual Node Number (VNN) map</h4><p>
+       </p></div><div class="refsect3"><a name="idm140317080461056"></a><h4>Virtual Node Number (VNN) map</h4><p>
          Consists of the number of virtual nodes and mapping from
          virtual node numbers to physical node numbers.  Virtual
          nodes host CTDB databases.  Only nodes that are
          participating in the VNN map can become lmaster or dmaster
          for database records.
-       </p></div><div class="refsect3"><a name="idm131"></a><h4>Recovery mode</h4><p>
+       </p></div><div class="refsect3"><a name="idm140317080452032"></a><h4>Recovery mode</h4><p>
          This is the current recovery mode of the cluster. There are two possible modes:
        </p><p>
          NORMAL - The cluster is fully operational.
          databases have been recovered, the node mode will change into
          NORMAL mode and the databases will be "thawed", allowing samba
          to access the databases again.
-       </p></div><div class="refsect3"><a name="idm138"></a><h4>Recovery master</h4><p>
+       </p></div><div class="refsect3"><a name="idm140317080448128"></a><h4>Recovery master</h4><p>
          This is the cluster node that is currently designated as the recovery master. This node is responsible of monitoring the consistency of the cluster and to perform the actual recovery process when reqired.
        </p><p>
          Only one node at a time can be the designated recovery master. Which
          node is designated the recovery master is decided by an election
          process in the recovery daemons running on each node.
-       </p></div><div class="refsect3"><a name="idm142"></a><h4>Example</h4><pre class="screen">
+       </p></div><div class="refsect3"><a name="idm140317080446128"></a><h4>Example</h4><pre class="screen">
 # ctdb status
 Number of nodes:4
 pnn:0 192.168.2.200       OK (THIS NODE)
@@ -141,7 +141,7 @@ hash:2 lmaster:2
 hash:3 lmaster:3
 Recovery mode:NORMAL (0)
 Recovery master:0
-       </pre></div></div><div class="refsect2"><a name="idm145"></a><h3>nodestatus [<span class="optional"><em class="parameter"><code>PNN-LIST</code></em></span>]</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317080444224"></a><h3>nodestatus [<span class="optional"><em class="parameter"><code>PNN-LIST</code></em></span>]</h3><p>
        This command is similar to the <span class="command"><strong>status</strong></span>
        command.  It displays the "node status" subset of output.  The
        main differences are:
@@ -159,7 +159,7 @@ Recovery master:0
        A common invocation in scripts is <span class="command"><strong>ctdb nodestatus
        all</strong></span> to check whether all nodes in a cluster are
        healthy.
-      </p><div class="refsect3"><a name="idm161"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317080436272"></a><h4>Example</h4><pre class="screen">
 # ctdb nodestatus
 pnn:0 10.0.0.30        OK (THIS NODE)
 
@@ -167,28 +167,28 @@ pnn:0 10.0.0.30        OK (THIS NODE)
 Number of nodes:2
 pnn:0 10.0.0.30        OK (THIS NODE)
 pnn:1 10.0.0.31        OK
-       </pre></div></div><div class="refsect2"><a name="idm164"></a><h3>recmaster</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317080434512"></a><h3>recmaster</h3><p>
        This command shows the pnn of the node which is currently the recmaster.
       </p><p>
        Note: If the the queried node is INACTIVE then the status
        might not be current.
-      </p></div><div class="refsect2"><a name="idm168"></a><h3>uptime</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317080432736"></a><h3>uptime</h3><p>
        This command shows the uptime for the ctdb daemon. When the last recovery or ip-failover completed and how long it took. If the "duration" is shown as a negative number, this indicates that there is a recovery/failover in progress and it started that many seconds ago.
-      </p><div class="refsect3"><a name="idm171"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317080431392"></a><h4>Example</h4><pre class="screen">
 # ctdb uptime
 Current time of node          :                Thu Oct 29 10:38:54 2009
 Ctdbd start time              : (000 16:54:28) Wed Oct 28 17:44:26 2009
 Time of last recovery/failover: (000 16:53:31) Wed Oct 28 17:45:23 2009
 Duration of last recovery/failover: 2.248552 seconds
-       </pre></div></div><div class="refsect2"><a name="idm174"></a><h3>listnodes</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317080429504"></a><h3>listnodes</h3><p>
        This command shows lists the ip addresses of all the nodes in the cluster.
-      </p><div class="refsect3"><a name="idm177"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074930736"></a><h4>Example</h4><pre class="screen">
 # ctdb listnodes
 192.168.2.200
 192.168.2.201
 192.168.2.202
 192.168.2.203
-       </pre></div></div><div class="refsect2"><a name="idm180"></a><h3>natgw {master|list|status}</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074929120"></a><h3>natgw {master|list|status}</h3><p>
        This command shows different aspects of NAT gateway status.
        For an overview of CTDB's NAT gateway functionality please see
        the <em class="citetitle">NAT GATEWAY</em> section in
@@ -220,16 +220,16 @@ pnn:0 192.168.2.200       UNHEALTHY (THIS NODE)
 pnn:1 192.168.2.201       OK
 pnn:2 192.168.2.202       OK
 pnn:3 192.168.2.203       OK
-           </pre></dd></dl></div></div><div class="refsect2"><a name="idm206"></a><h3>ping</h3><p>
+           </pre></dd></dl></div></div><div class="refsect2"><a name="idm140317074918016"></a><h3>ping</h3><p>
        This command will "ping" specified CTDB nodes in the cluster
        to verify that they are running.
-      </p><div class="refsect3"><a name="idm209"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074916880"></a><h4>Example</h4><pre class="screen">
 # ctdb ping
 response from 0 time=0.000054 sec  (3 clients)
-       </pre></div></div><div class="refsect2"><a name="idm212"></a><h3>ifaces</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074915360"></a><h3>ifaces</h3><p>
        This command will display the list of network interfaces, which could
        host public addresses, along with their status.
-      </p><div class="refsect3"><a name="idm215"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074914192"></a><h4>Example</h4><pre class="screen">
 # ctdb ifaces
 Interfaces on node 0
 name:eth5 link:up references:2
@@ -243,9 +243,9 @@ name:eth2 link:up references:1
 |eth4|0|0|
 |eth3|1|1|
 |eth2|1|1|
-       </pre></div></div><div class="refsect2"><a name="idm218"></a><h3>ip</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074912400"></a><h3>ip</h3><p>
        This command will display the list of public addresses that are provided by the cluster and which physical node is currently serving this ip. By default this command will ONLY show those public addresses that are known to the node itself. To see the full list of all public ips across the cluster you must use "ctdb ip all".
-      </p><div class="refsect3"><a name="idm221"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074911024"></a><h4>Example</h4><pre class="screen">
 # ctdb ip -v
 Public IPs on node 0
 172.31.91.82 node[1] active[] available[eth2,eth3] configured[eth2,eth3]
@@ -267,9 +267,9 @@ Public IPs on node 0
 |172.31.92.83|0|eth5|eth5|eth4,eth5|
 |172.31.92.84|1||eth5|eth4,eth5|
 |172.31.92.85|0|eth5|eth5|eth4,eth5|
-       </pre></div></div><div class="refsect2"><a name="idm224"></a><h3>ipinfo <em class="parameter"><code>IP</code></em></h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074908480"></a><h3>ipinfo <em class="parameter"><code>IP</code></em></h3><p>
        This command will display details about the specified public addresses.
-      </p><div class="refsect3"><a name="idm228"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074906864"></a><h4>Example</h4><pre class="screen">
 # ctdb ipinfo 172.31.92.85
 Public IP[172.31.92.85] info on node 0
 IP:172.31.92.85
@@ -277,33 +277,121 @@ CurrentNode:0
 NumInterfaces:2
 Interface[1]: Name:eth4 Link:down References:0
 Interface[2]: Name:eth5 Link:up References:2 (active)
-       </pre></div></div><div class="refsect2"><a name="idm231"></a><h3>scriptstatus</h3><p>
-       This command displays which scripts where run in the previous monitoring cycle and the result of each script. If a script failed with an error, causing the node to become unhealthy, the output from that script is also shown.
-      </p><div class="refsect3"><a name="idm234"></a><h4>Example</h4><pre class="screen">
+       </pre></div></div><div class="refsect2"><a name="idm140317074905120"></a><h3>event run|status|script list|script enable|script disable</h3><p>
+       This command is used to control event daemon and to inspect
+       status of various events.
+      </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">run <em class="parameter"><code>EVENT</code></em> <em class="parameter"><code>TIMEOUT</code></em> [<span class="optional"><em class="parameter"><code>ARGUMENTS</code></em></span>] </span></dt><dd><p>
+            This command can be used to manually run specified EVENT
+            with optional ARGUMENTS.  The event will be allowed to run
+            a maximum of TIMEOUT seconds.  If TIMEOUT is 0, then there
+            is no time limit for running the event.
+           </p></dd><dt><span class="term">status [<span class="optional"><em class="parameter"><code>EVENT</code></em></span>] [<span class="optional">lastrun|lastpass|lastfail</span>]</span></dt><dd><p>
+             This command displays the last execution status of the
+             specified EVENT.  If no event is specified, then the status
+             of last executed monitor event will be displayed.
+           </p><p>
+             To see the last successful execution of the event, lastpass
+             can be specified. Similarly lastfail can be specified
+             to see the last unsuccessful execution of the event.
+             The optional lastrun can be specified to query the last
+             execution of the event.
+           </p><p>
+             The command will terminate with the exit status
+             corresponding to the overall status of event that is
+             displayed.  If lastpass is specified, then the command will
+             always terminate with 0.  If lastfail is specified then the
+             command will always terminate with non-zero exit status.
+             If lastrun is specified, then the command will terminate
+             with 0 or not depending on if the last execution of the
+             event was successful or not.
+           </p><p>
+             The output is the list of event scripts executed.
+             Each line shows the name, status, duration and start time
+             for each script.
+           </p><p>
+             Example output:
+           </p><pre class="screen">
+00.ctdb              OK         0.014 Sat Dec 17 19:39:11 2016
+01.reclock           OK         0.013 Sat Dec 17 19:39:11 2016
+05.system            OK         0.029 Sat Dec 17 19:39:11 2016
+06.nfs               OK         0.014 Sat Dec 17 19:39:11 2016
+10.external          DISABLED  
+10.interface         OK         0.037 Sat Dec 17 19:39:11 2016
+11.natgw             OK         0.011 Sat Dec 17 19:39:11 2016
+11.routing           OK         0.007 Sat Dec 17 19:39:11 2016
+13.per_ip_routing    OK         0.007 Sat Dec 17 19:39:11 2016
+20.multipathd        OK         0.007 Sat Dec 17 19:39:11 2016
+31.clamd             OK         0.007 Sat Dec 17 19:39:11 2016
+40.vsftpd            OK         0.013 Sat Dec 17 19:39:11 2016
+41.httpd             OK         0.018 Sat Dec 17 19:39:11 2016
+49.winbind           OK         0.023 Sat Dec 17 19:39:11 2016
+50.samba             OK         0.100 Sat Dec 17 19:39:12 2016
+60.nfs               OK         0.376 Sat Dec 17 19:39:12 2016
+70.iscsi             OK         0.009 Sat Dec 17 19:39:12 2016
+91.lvs               OK         0.007 Sat Dec 17 19:39:12 2016
+99.timeout           OK         0.007 Sat Dec 17 19:39:12 2016
+           </pre></dd><dt><span class="term">script list</span></dt><dd><p>
+             List the available event scripts.
+           </p><p>
+             Example output:
+           </p><pre class="screen">
+00.ctdb             
+01.reclock          
+05.system           
+06.nfs              
+10.external          DISABLED
+10.interface        
+11.natgw            
+11.routing          
+13.per_ip_routing   
+20.multipathd       
+31.clamd            
+40.vsftpd           
+41.httpd            
+49.winbind          
+50.samba            
+60.nfs              
+70.iscsi            
+91.lvs              
+99.timeout          
+           </pre></dd><dt><span class="term">script enable <em class="parameter"><code>SCRIPT</code></em></span></dt><dd><p>
+             Enable the specified event SCRIPT.  Only enabled scripts will be
+             executed when running any event.
+           </p></dd><dt><span class="term">script disable <em class="parameter"><code>SCRIPT</code></em></span></dt><dd><p>
+             Disable the specified event SCRIPT.  This will prevent the script
+             from executing when running any event.
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140317074884112"></a><h3>scriptstatus</h3><p>
+       This command displays which event scripts where run in the previous
+       monitoring cycle and the result of each script. If a script
+       failed with an error, causing the node to become unhealthy,
+       the output from that script is also shown.
+      </p><p>
+       This command is deprecated.  It's provided for backward
+       compatibility.  In place of <span class="command"><strong>ctdb scriptstatus</strong></span>,
+       use <span class="command"><strong>ctdb event status</strong></span>.
+      </p><div class="refsect3"><a name="idm140317074881104"></a><h4>Example</h4><pre class="screen">
 # ctdb scriptstatus
-7 scripts were executed last monitoring cycle
-00.ctdb              Status:OK    Duration:0.056 Tue Mar 24 18:56:57 2009
-10.interface         Status:OK    Duration:0.077 Tue Mar 24 18:56:57 2009
-11.natgw             Status:OK    Duration:0.039 Tue Mar 24 18:56:57 2009
-20.multipathd        Status:OK    Duration:0.038 Tue Mar 24 18:56:57 2009
-31.clamd             Status:DISABLED
-40.vsftpd            Status:OK    Duration:0.045 Tue Mar 24 18:56:57 2009
-41.httpd             Status:OK    Duration:0.039 Tue Mar 24 18:56:57 2009
-50.samba             Status:ERROR    Duration:0.082 Tue Mar 24 18:56:57 2009
-OUTPUT:ERROR: Samba tcp port 445 is not responding
-      </pre></div></div><div class="refsect2"><a name="idm237"></a><h3>disablescript <em class="parameter"><code>SCRIPT</code></em></h3><p>
-       This command is used to disable an eventscript.
-      </p><p>
-       This will take effect the next time the eventscripts are being executed so it can take a short while until this is reflected in 'scriptstatus'.
-      </p></div><div class="refsect2"><a name="idm242"></a><h3>enablescript <em class="parameter"><code>SCRIPT</code></em></h3><p>
-       This command is used to enable an eventscript.
-      </p><p>
-       This will take effect the next time the eventscripts are being executed so it can take a short while until this is reflected in 'scriptstatus'.
-      </p></div><div class="refsect2"><a name="idm247"></a><h3>listvars</h3><p>
+00.ctdb              OK         0.011 Sat Dec 17 19:40:46 2016
+01.reclock           OK         0.010 Sat Dec 17 19:40:46 2016
+05.system            OK         0.030 Sat Dec 17 19:40:46 2016
+06.nfs               OK         0.014 Sat Dec 17 19:40:46 2016
+10.external          DISABLED  
+10.interface         OK         0.041 Sat Dec 17 19:40:46 2016
+11.natgw             OK         0.008 Sat Dec 17 19:40:46 2016
+11.routing           OK         0.007 Sat Dec 17 19:40:46 2016
+13.per_ip_routing    OK         0.007 Sat Dec 17 19:40:46 2016
+20.multipathd        OK         0.007 Sat Dec 17 19:40:46 2016
+31.clamd             OK         0.007 Sat Dec 17 19:40:46 2016
+40.vsftpd            OK         0.013 Sat Dec 17 19:40:46 2016
+41.httpd             OK         0.015 Sat Dec 17 19:40:46 2016
+49.winbind           OK         0.022 Sat Dec 17 19:40:46 2016
+50.samba             ERROR      0.077 Sat Dec 17 19:40:46 2016
+  OUTPUT: ERROR: samba tcp port 445 is not responding
+      </pre></div></div><div class="refsect2"><a name="idm140317074878576"></a><h3>listvars</h3><p>
        List all tuneable variables, except the values of the obsolete tunables
        like VacuumMinInterval. The obsolete tunables can be retrieved only
        explicitly with the "ctdb getvar" command.
-      </p><div class="refsect3"><a name="idm250"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074877344"></a><h4>Example</h4><pre class="screen">
 # ctdb listvars
 SeqnumInterval          = 1000
 ControlTimeout          = 60
@@ -324,8 +412,6 @@ DatabaseHashSize        = 100001
 DatabaseMaxDead         = 5
 RerecoveryTimeout       = 10
 EnableBans              = 1
-DeterministicIPs        = 0
-LCP2PublicIPs           = 1
 NoIPFailback            = 0
 DisableIPFailover       = 0
 VerboseMemoryNames      = 0
@@ -356,19 +442,21 @@ DBRecordSizeWarn        = 10000000
 DBSizeWarn              = 100000000
 PullDBPreallocation     = 10485760
 NoIPHostOnAllDisabled   = 0
-Samba3AvoidDeadlocks    = 0
 TDBMutexEnabled         = 0
 LockProcessesPerDB      = 200
-       </pre></div></div><div class="refsect2"><a name="idm253"></a><h3>getvar <em class="parameter"><code>NAME</code></em></h3><p>
+RecBufferSizeLimit      = 1000000
+QueueBufferSize         = 1024
+IPAllocAlgorithm        = 2
+       </pre></div></div><div class="refsect2"><a name="idm140317074874176"></a><h3>getvar <em class="parameter"><code>NAME</code></em></h3><p>
        Get the runtime value of a tuneable variable.
-      </p><div class="refsect3"><a name="idm257"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074872656"></a><h4>Example</h4><pre class="screen">
 # ctdb getvar MonitorInterval
 MonitorInterval         = 15
-       </pre></div></div><div class="refsect2"><a name="idm260"></a><h3>setvar <em class="parameter"><code>NAME</code></em> <em class="parameter"><code>VALUE</code></em></h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074871136"></a><h3>setvar <em class="parameter"><code>NAME</code></em> <em class="parameter"><code>VALUE</code></em></h3><p>
        Set the runtime value of a tuneable variable.
-      </p><div class="refsect3"><a name="idm265"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074868992"></a><h4>Example</h4><pre class="screen">
 # ctdb setvar MonitorInterval 20
-       </pre></div></div><div class="refsect2"><a name="idm268"></a><h3>lvs {master|list|status}</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074867472"></a><h3>lvs {master|list|status}</h3><p>
        This command shows different aspects of LVS status.  For an
        overview of CTDB's LVS functionality please see the
        <em class="citetitle">LVS</em> section in
@@ -395,7 +483,7 @@ pnn:0 10.0.0.11        UNHEALTHY (THIS NODE)
 pnn:1 10.0.0.12        UNHEALTHY
 pnn:2 10.0.0.13        OK
 pnn:3 10.0.0.14        OK
-      </pre></dd></dl></div></div><div class="refsect2"><a name="idm294"></a><h3>getcapabilities</h3><p>
+      </pre></dd></dl></div></div><div class="refsect2"><a name="idm140317074856736"></a><h3>getcapabilities</h3><p>
        This command shows the capabilities of the current node.  See
        the <em class="citetitle">CAPABILITIES</em> section in
        <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span> for more details.
@@ -404,12 +492,12 @@ pnn:3 10.0.0.14        OK
       </p><pre class="screen">
 RECMASTER: YES
 LMASTER: YES
-      </pre></div><div class="refsect2"><a name="idm303"></a><h3>statistics</h3><p>
+      </pre></div><div class="refsect2"><a name="idm140317074853216"></a><h3>statistics</h3><p>
         Collect statistics from the CTDB daemon about
         how many calls it has served.  Information about
         various fields in statistics can be found in
        <span class="citerefentry"><span class="refentrytitle">ctdb-statistics</span>(7)</span>.
-      </p><div class="refsect3"><a name="idm309"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074851120"></a><h4>Example</h4><pre class="screen">
 # ctdb statistics
 CTDB version 1
 Current time of statistics  :                Tue Mar  8 15:18:51 2016
@@ -461,15 +549,15 @@ Statistics collected since  : (003 21:31:32) Fri Mar  4 17:47:19 2016
  reclock_recd       MIN/AVG/MAX     0.000000/0.000000/0.000000 sec out of 0
  call_latency       MIN/AVG/MAX     0.000044/0.002142/0.011702 sec out of 15
  childwrite_latency MIN/AVG/MAX     0.000000/0.000000/0.000000 sec out of 0
-       </pre></div></div><div class="refsect2"><a name="idm312"></a><h3>statisticsreset</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074847520"></a><h3>statisticsreset</h3><p>
        This command is used to clear all statistics counters in a node.
       </p><p>
        Example: ctdb statisticsreset
-      </p></div><div class="refsect2"><a name="idm316"></a><h3>dbstatistics <em class="parameter"><code>DB</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074845888"></a><h3>dbstatistics <em class="parameter"><code>DB</code></em></h3><p>
        Display statistics about the database DB.  Information
        about various fields in dbstatistics can be found in
        <span class="citerefentry"><span class="refentrytitle">ctdb-statistics</span>(7)</span>.
-      </p><div class="refsect3"><a name="idm323"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074843344"></a><h4>Example</h4><pre class="screen">
 # ctdb dbstatistics locking.tdb
 DB Statistics: locking.tdb
  ro_delegations                     0
@@ -485,13 +573,13 @@ DB Statistics: locking.tdb
  vacuum_latency     MIN/AVG/MAX     0.000472/0.002207/15.243570 sec out of 224530
  Num Hot Keys:     1
      Count:8 Key:ff5bd7cb3ee3822edc1f0000000000000000000000000000
-       </pre></div></div><div class="refsect2"><a name="idm326"></a><h3>getreclock</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074841152"></a><h3>getreclock</h3><p>
        Show details of the recovery lock, if any.
       </p><p>
        Example output:
       </p><pre class="screen">
        /clusterfs/.ctdb/recovery.lock
-      </pre></div><div class="refsect2"><a name="idm331"></a><h3>getdebug</h3><p>
+      </pre></div><div class="refsect2"><a name="idm140317074838992"></a><h3>getdebug</h3><p>
        Get the current debug level for the node. the debug level controls what information is written to the log file.
       </p><p>
        The debug levels are mapped to the corresponding syslog levels.
@@ -501,29 +589,29 @@ DB Statistics: locking.tdb
        The list of debug levels from highest to lowest are :
       </p><p>
        ERROR WARNING NOTICE INFO DEBUG
-      </p></div><div class="refsect2"><a name="idm337"></a><h3>setdebug <em class="parameter"><code>DEBUGLEVEL</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074836272"></a><h3>setdebug <em class="parameter"><code>DEBUGLEVEL</code></em></h3><p>
        Set the debug level of a node. This controls what information will be logged.
       </p><p>
        The debuglevel is one of ERROR WARNING NOTICE INFO DEBUG
-      </p></div><div class="refsect2"><a name="idm342"></a><h3>getpid</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074834064"></a><h3>getpid</h3><p>
        This command will return the process id of the ctdb daemon.
-      </p></div><div class="refsect2"><a name="idm345"></a><h3>disable</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074832832"></a><h3>disable</h3><p>
        This command is used to administratively disable a node in the cluster.
        A disabled node will still participate in the cluster and host
        clustered TDB records but its public ip address has been taken over by
        a different node and it no longer hosts any services.
-      </p></div><div class="refsect2"><a name="idm348"></a><h3>enable</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074831392"></a><h3>enable</h3><p>
        Re-enable a node that has been administratively disabled.
-      </p></div><div class="refsect2"><a name="idm351"></a><h3>stop</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074830160"></a><h3>stop</h3><p>
        This command is used to administratively STOP a node in the cluster.
        A STOPPED node is connected to the cluster but will not host any
        public ip addresse, nor does it participate in the VNNMAP.
        The difference between a DISABLED node and a STOPPED node is that
        a STOPPED node does not host any parts of the database which means
        that a recovery is required to stop/continue nodes.
-      </p></div><div class="refsect2"><a name="idm354"></a><h3>continue</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074828608"></a><h3>continue</h3><p>
        Re-start a node that has been administratively stopped.
-      </p></div><div class="refsect2"><a name="idm357"></a><h3>addip <em class="parameter"><code>IPADDR</code></em>/<em class="parameter"><code>mask</code></em> <em class="parameter"><code>IFACE</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074827376"></a><h3>addip <em class="parameter"><code>IPADDR</code></em>/<em class="parameter"><code>mask</code></em> <em class="parameter"><code>IFACE</code></em></h3><p>
        This command is used to add a new public ip to a node
        during runtime.  It should be followed by a <span class="command"><strong>ctdb
        ipreallocate</strong></span>.  This allows public addresses to be
@@ -533,7 +621,7 @@ DB Statistics: locking.tdb
        changes will be lost next time ctdb is restarted and the public
        addresses file is re-read.  If you want this change to be
        permanent you must also update the public addresses file manually.
-      </p></div><div class="refsect2"><a name="idm365"></a><h3>delip <em class="parameter"><code>IPADDR</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074822960"></a><h3>delip <em class="parameter"><code>IPADDR</code></em></h3><p>
        This command flags IPADDR for deletion from a node at runtime.
        It should be followed by a <span class="command"><strong>ctdb
        ipreallocate</strong></span>.  If IPADDR is currently hosted by the
@@ -546,7 +634,7 @@ DB Statistics: locking.tdb
        public addresses file is re-read.  If you want this change to
        be permanent you must also update the public addresses file
        manually.
-      </p></div><div class="refsect2"><a name="idm371"></a><h3>moveip <em class="parameter"><code>IPADDR</code></em> <em class="parameter"><code>PNN</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074819696"></a><h3>moveip <em class="parameter"><code>IPADDR</code></em> <em class="parameter"><code>PNN</code></em></h3><p>
        This command can be used to manually fail a public ip address to a
        specific node.
       </p><p>
@@ -554,12 +642,12 @@ DB Statistics: locking.tdb
        ip addresses that ctdb normally provides, this command only works
        when you have changed the tunables for the daemon to:
       </p><p>
-       DeterministicIPs = 0
+       IPAllocAlgorithm != 0
       </p><p>
        NoIPFailback = 1
-      </p></div><div class="refsect2"><a name="idm379"></a><h3>shutdown</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074815936"></a><h3>shutdown</h3><p>
        This command will shutdown a specific CTDB daemon.
-      </p></div><div class="refsect2"><a name="idm382"></a><h3>setlmasterrole on|off</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074814704"></a><h3>setlmasterrole on|off</h3><p>
        This command is used ot enable/disable the LMASTER capability for a node at runtime. This capability determines whether or not a node can be used as an LMASTER for records in the database. A node that does not have the LMASTER capability will not show up in the vnnmap.
       </p><p>
        Nodes will by default have this capability, but it can be stripped off nodes by the setting in the sysconfig file or by using this command.
@@ -567,13 +655,13 @@ DB Statistics: locking.tdb
        Once this setting has been enabled/disabled, you need to perform a recovery for it to take effect.
       </p><p>
        See also "ctdb getcapabilities"
-      </p></div><div class="refsect2"><a name="idm388"></a><h3>setrecmasterrole on|off</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074811824"></a><h3>setrecmasterrole on|off</h3><p>
        This command is used ot enable/disable the RECMASTER capability for a node at runtime. This capability determines whether or not a node can be used as an RECMASTER for the cluster. A node that does not have the RECMASTER capability can not win a recmaster election. A node that already is the recmaster for the cluster when the capability is stripped off the node will remain the recmaster until the next cluster election.
       </p><p>
        Nodes will by default have this capability, but it can be stripped off nodes by the setting in the sysconfig file or by using this command.
       </p><p>
        See also "ctdb getcapabilities"
-      </p></div><div class="refsect2"><a name="idm393"></a><h3>reloadnodes</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074809296"></a><h3>reloadnodes</h3><p>
        This command is used when adding new nodes, or removing
        existing nodes from an existing cluster.
       </p><p>
@@ -622,7 +710,7 @@ DB Statistics: locking.tdb
          </p></li><li class="listitem"><p>
            Use <span class="command"><strong>ctdb status</strong></span> on all nodes and verify
            that the deleted nodes are no longer listed.
-         </p></li></ol></div></div><div class="refsect2"><a name="idm434"></a><h3>
+         </p></li></ol></div></div><div class="refsect2"><a name="idm140317074789312"></a><h3>
        reloadips
        [<span class="optional"><em class="parameter"><code>PNN-LIST</code></em></span>]
       </h3><p>
@@ -635,7 +723,7 @@ DB Statistics: locking.tdb
        Such changes must be made in 2 steps by deleting addresses in
        question and re-adding then.  Unfortunately this will disrupt
        connections to the changed addresses.
-      </p></div><div class="refsect2"><a name="idm440"></a><h3>getdbmap</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074786512"></a><h3>getdbmap</h3><p>
        This command lists all clustered TDB databases that the CTDB daemon has attached to. Some databases are flagged as PERSISTENT, this means that the database stores data persistently and the data will remain across reboots. One example of such a database is secrets.tdb where information about how the cluster was joined to the domain is stored.
       </p><p>
        If a PERSISTENT database is not in a healthy state the database is
@@ -649,7 +737,7 @@ DB Statistics: locking.tdb
        and (if samba or tdb-utils are installed) "tdbtool check".
       </p><p>
        Most databases are not persistent and only store the state information that the currently running samba daemons need. These databases are always wiped when ctdb/samba starts and when a node is rebooted.
-      </p><div class="refsect3"><a name="idm446"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074783200"></a><h4>Example</h4><pre class="screen">
 # ctdb getdbmap
 Number of databases:10
 dbid:0x435d3410 name:notify.tdb path:/usr/local/var/lib/ctdb/notify.tdb.0
@@ -670,7 +758,7 @@ dbid:0xb775fff6 name:secrets.tdb path:/usr/local/var/lib/ctdb/persistent/secrets
 # ctdb -X getdbmap
 |ID|Name|Path|Persistent|Unhealthy|
 |0x7bbbd26c|passdb.tdb|/usr/local/var/lib/ctdb/persistent/passdb.tdb.0|1|0|
-       </pre></div></div><div class="refsect2"><a name="idm449"></a><h3>
+       </pre></div></div><div class="refsect2"><a name="idm140317074780448"></a><h3>
        backupdb
        <em class="parameter"><code>DB</code></em>
        <em class="parameter"><code>FILE</code></em>
@@ -679,7 +767,7 @@ dbid:0xb775fff6 name:secrets.tdb path:/usr/local/var/lib/ctdb/persistent/secrets
        read back using <span class="command"><strong>restoredb</strong></span>.  This is mainly
        useful for backing up persistent databases such as
        <code class="filename">secrets.tdb</code> and similar.
-      </p></div><div class="refsect2"><a name="idm456"></a><h3>
+      </p></div><div class="refsect2"><a name="idm140317074776624"></a><h3>
        restoredb
        <em class="parameter"><code>FILE</code></em>
        [<span class="optional"><em class="parameter"><code>DB</code></em></span>]
@@ -689,45 +777,45 @@ dbid:0xb775fff6 name:secrets.tdb path:/usr/local/var/lib/ctdb/persistent/secrets
        be restored back into the same database as it was created
        from. By specifying dbname you can restore the data into a
        different database.
-      </p></div><div class="refsect2"><a name="idm462"></a><h3>setdbreadonly <em class="parameter"><code>DB</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074773808"></a><h3>setdbreadonly <em class="parameter"><code>DB</code></em></h3><p>
        This command will enable the read-only record support for a
        database.  This is an experimental feature to improve
        performance for contended records primarily in locking.tdb and
        brlock.tdb.  When enabling this feature you must set it on all
        nodes in the cluster.
-      </p></div><div class="refsect2"><a name="idm466"></a><h3>setdbsticky <em class="parameter"><code>DB</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074771872"></a><h3>setdbsticky <em class="parameter"><code>DB</code></em></h3><p>
        This command will enable the sticky record support for the
        specified database.  This is an experimental feature to
        improve performance for contended records primarily in
        locking.tdb and brlock.tdb.  When enabling this feature you
        must set it on all nodes in the cluster.
-      </p></div></div><div class="refsect1"><a name="idm470"></a><h2>INTERNAL COMMANDS</h2><p>
+      </p></div></div><div class="refsect1"><a name="idm140317074769792"></a><h2>INTERNAL COMMANDS</h2><p>
       Internal commands are used by CTDB's scripts and are not
       required for managing a CTDB cluster.  Their parameters and
       behaviour are subject to change.
-    </p><div class="refsect2"><a name="idm473"></a><h3>gettickles <em class="parameter"><code>IPADDR</code></em></h3><p>
+    </p><div class="refsect2"><a name="idm140317074768576"></a><h3>gettickles <em class="parameter"><code>IPADDR</code></em></h3><p>
        Show TCP connections that are registered with CTDB to be
        "tickled" if there is a failover.
-      </p></div><div class="refsect2"><a name="idm477"></a><h3>gratarp <em class="parameter"><code>IPADDR</code></em> <em class="parameter"><code>INTERFACE</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074766816"></a><h3>gratarp <em class="parameter"><code>IPADDR</code></em> <em class="parameter"><code>INTERFACE</code></em></h3><p>
        Send out a gratuitous ARP for the specified interface through
        the specified interface. This command is mainly used by the
        ctdb eventscripts.
-      </p></div><div class="refsect2"><a name="idm482"></a><h3>
+      </p></div><div class="refsect2"><a name="idm140317074764384"></a><h3>
        pdelete <em class="parameter"><code>DB</code></em> <em class="parameter"><code>KEY</code></em>
       </h3><p>
        Delete KEY from DB.
-      </p></div><div class="refsect2"><a name="idm487"></a><h3>
+      </p></div><div class="refsect2"><a name="idm140317074761984"></a><h3>
        pfetch <em class="parameter"><code>DB</code></em> <em class="parameter"><code>KEY</code></em>
       </h3><p>
        Print the value associated with KEY in DB.
-      </p></div><div class="refsect2"><a name="idm492"></a><h3>
+      </p></div><div class="refsect2"><a name="idm140317074759584"></a><h3>
        pstore
        <em class="parameter"><code>DB</code></em>
        <em class="parameter"><code>KEY</code></em>
        <em class="parameter"><code>FILE</code></em>
       </h3><p>
        Store KEY in DB with contents of FILE as the associated value.
-      </p></div><div class="refsect2"><a name="idm498"></a><h3>
+      </p></div><div class="refsect2"><a name="idm140317074756480"></a><h3>
        ptrans
        <em class="parameter"><code>DB</code></em>
        [<span class="optional"><em class="parameter"><code>FILE</code></em></span>]
@@ -739,7 +827,7 @@ dbid:0xb775fff6 name:secrets.tdb path:/usr/local/var/lib/ctdb/persistent/secrets
        The key and value should be separated by spaces or tabs. Each
        key/value should be a printable string enclosed in
        double-quotes.
-      </p></div><div class="refsect2"><a name="idm505"></a><h3>runstate [setup|first_recovery|startup|running]</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074753216"></a><h3>runstate [setup|first_recovery|startup|running]</h3><p>
        Print the runstate of the specified node.  Runstates are used
        to serialise important state transitions in CTDB, particularly
        during startup.
@@ -747,16 +835,16 @@ dbid:0xb775fff6 name:secrets.tdb path:/usr/local/var/lib/ctdb/persistent/secrets
        If one or more optional runstate arguments are specified then
        the node must be in one of these runstates for the command to
        succeed.
-      </p><div class="refsect3"><a name="idm509"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074751488"></a><h4>Example</h4><pre class="screen">
 # ctdb runstate
 RUNNING
-       </pre></div></div><div class="refsect2"><a name="idm512"></a><h3>setifacelink <em class="parameter"><code>IFACE</code></em> up|down</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074749968"></a><h3>setifacelink <em class="parameter"><code>IFACE</code></em> up|down</h3><p>
        Set the internal state of network interface IFACE.  This is
        typically used in the <code class="filename">10.interface</code> script
        in the "monitor" event.
       </p><p>
        Example: ctdb setifacelink eth0 up
-      </p></div><div class="refsect2"><a name="idm518"></a><h3>tickle</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074747088"></a><h3>tickle</h3><p>
        Read a list of TCP connections, one per line, from standard
        input and send a TCP tickle to the source host for each
        connection.  A connection is specified as:
@@ -776,12 +864,12 @@ RUNNING
        TCP connection has been disrupted and that the client will need
        to reestablish. This greatly speeds up the time it takes for a client
        to detect and reestablish after an IP failover in the ctdb cluster.
-      </p></div><div class="refsect2"><a name="idm529"></a><h3>version</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074740768"></a><h3>version</h3><p>
        Display the CTDB version.
-      </p></div></div><div class="refsect1"><a name="idm532"></a><h2>DEBUGGING COMMANDS</h2><p>
+      </p></div></div><div class="refsect1"><a name="idm140317074739488"></a><h2>DEBUGGING COMMANDS</h2><p>
       These commands are primarily used for CTDB development and testing and
       should not be used for normal administration.
-    </p><div class="refsect2"><a name="idm535"></a><h3>OPTIONS</h3><div class="variablelist"><dl class="variablelist"><dt><span class="term">--print-emptyrecords</span></dt><dd><p>
+    </p><div class="refsect2"><a name="idm140317074738320"></a><h3>OPTIONS</h3><div class="variablelist"><dl class="variablelist"><dt><span class="term">--print-emptyrecords</span></dt><dd><p>
            This enables printing of empty records when dumping databases
            with the catdb, cattbd and dumpdbbackup commands. Records with
            empty data segment are considered deleted by ctdb and cleaned
@@ -799,11 +887,11 @@ RUNNING
            This lets catdb and dumpdbbackup print the
            record flags for each record. Note that cattdb always
            prints the flags.
-         </p></dd></dl></div></div><div class="refsect2"><a name="idm558"></a><h3>process-exists <em class="parameter"><code>PID</code></em></h3><p>
+         </p></dd></dl></div></div><div class="refsect2"><a name="idm140317074729296"></a><h3>process-exists <em class="parameter"><code>PID</code></em></h3><p>
        This command checks if a specific process exists on the CTDB host. This is mainly used by Samba to check if remote instances of samba are still running or not.
-      </p></div><div class="refsect2"><a name="idm562"></a><h3>getdbstatus <em class="parameter"><code>DB</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074727456"></a><h3>getdbstatus <em class="parameter"><code>DB</code></em></h3><p>
        This command displays more details about a database.
-      </p><div class="refsect3"><a name="idm566"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074725856"></a><h4>Example</h4><pre class="screen">
 # ctdb getdbstatus test.tdb.0
 dbid: 0x122224da
 name: test.tdb
@@ -817,28 +905,28 @@ name: registry.tdb
 path: /usr/local/var/lib/ctdb/persistent/registry.tdb.0
 PERSISTENT: yes
 HEALTH: NO-HEALTHY-NODES - ERROR - Backup of corrupted TDB in '/usr/local/var/lib/ctdb/persistent/registry.tdb.0.corrupted.20091208091949.0Z'
-       </pre></div></div><div class="refsect2"><a name="idm569"></a><h3>catdb <em class="parameter"><code>DB</code></em></h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140317074723888"></a><h3>catdb <em class="parameter"><code>DB</code></em></h3><p>
        Print a dump of the clustered TDB database DB.
-      </p></div><div class="refsect2"><a name="idm573"></a><h3>cattdb <em class="parameter"><code>DB</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074722240"></a><h3>cattdb <em class="parameter"><code>DB</code></em></h3><p>
        Print a dump of the contents of the local TDB database DB.
-      </p></div><div class="refsect2"><a name="idm577"></a><h3>dumpdbbackup <em class="parameter"><code>FILE</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074720512"></a><h3>dumpdbbackup <em class="parameter"><code>FILE</code></em></h3><p>
        Print a dump of the contents from database backup FILE,
        similar to <span class="command"><strong>catdb</strong></span>.
-      </p></div><div class="refsect2"><a name="idm582"></a><h3>wipedb <em class="parameter"><code>DB</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074718160"></a><h3>wipedb <em class="parameter"><code>DB</code></em></h3><p>
        Remove all contents of database DB.
-      </p></div><div class="refsect2"><a name="idm586"></a><h3>recover</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074716512"></a><h3>recover</h3><p>
        This command will trigger the recovery daemon to do a cluster
        recovery.
-      </p></div><div class="refsect2"><a name="idm589"></a><h3>ipreallocate, sync</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074715264"></a><h3>ipreallocate, sync</h3><p>
        This command will force the recovery master to perform a full ip reallocation process and redistribute all ip addresses. This is useful to "reset" the allocations back to its default state if they have been changed using the "moveip" command. While a "recover" will also perform this reallocation, a recovery is much more hevyweight since it will also rebuild all the databases.
-      </p></div><div class="refsect2"><a name="idm592"></a><h3>getmonmode</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074713712"></a><h3>getmonmode</h3><p>
        This command prints the monitoring mode of a node.  This
        indicates when CTDB is monitoring services on the node. The
        monitoring mode is either ENABLED or DISABLED.
-      </p></div><div class="refsect2"><a name="idm595"></a><h3>attach <em class="parameter"><code>DBNAME</code></em> [persistent]</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074712368"></a><h3>attach <em class="parameter"><code>DBNAME</code></em> [persistent]</h3><p>
        Create a new CTDB database called DBNAME and attach to it on
        all nodes.
-      </p></div><div class="refsect2"><a name="idm599"></a><h3>detach <em class="parameter"><code>DB-LIST</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074710496"></a><h3>detach <em class="parameter"><code>DB-LIST</code></em></h3><p>
        Detach specified non-persistent database(s) from the cluster. This
        command will disconnect specified database(s) on all nodes in
        the cluster.  This command should only be used when none of the
@@ -846,16 +934,13 @@ HEALTH: NO-HEALTHY-NODES - ERROR - Backup of corrupted TDB in '/usr/local/var/li
       </p><p>
        All nodes should be active and tunable AllowClientDBAccess should
        be disabled on all nodes before detaching databases.
-      </p></div><div class="refsect2"><a name="idm604"></a><h3>dumpmemory</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074708064"></a><h3>dumpmemory</h3><p>
        This is a debugging command. This command will make the ctdb
        daemon to write a fill memory allocation map to standard output.
-      </p></div><div class="refsect2"><a name="idm607"></a><h3>rddumpmemory</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074706768"></a><h3>rddumpmemory</h3><p>
        This is a debugging command. This command will dump the talloc memory
        allocation tree for the recovery daemon to standard output.
-      </p></div><div class="refsect2"><a name="idm610"></a><h3>eventscript <em class="parameter"><code>ARGUMENTS</code></em></h3><p>
-       This is a debugging command. This command can be used to manually
-       invoke and run the eventscritps with arbitrary arguments.
-      </p></div><div class="refsect2"><a name="idm614"></a><h3>ban <em class="parameter"><code>BANTIME</code></em></h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074705456"></a><h3>ban <em class="parameter"><code>BANTIME</code></em></h3><p>
        Administratively ban a node for BANTIME seconds.  The node
        will be unbanned after BANTIME seconds have elapsed.
       </p><p>
@@ -869,21 +954,21 @@ HEALTH: NO-HEALTHY-NODES - ERROR - Backup of corrupted TDB in '/usr/local/var/li
       </p><p>
        To administratively exclude a node from a cluster use the
        <span class="command"><strong>stop</strong></span> command.
-      </p></div><div class="refsect2"><a name="idm622"></a><h3>unban</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074701472"></a><h3>unban</h3><p>
        This command is used to unban a node that has either been
        administratively banned using the ban command or has been
        automatically banned.
-      </p></div><div class="refsect2"><a name="idm625"></a><h3>check_srvids <em class="parameter"><code>SRVID</code></em> ...</h3><p>
+      </p></div><div class="refsect2"><a name="idm140317074700160"></a><h3>check_srvids <em class="parameter"><code>SRVID</code></em> ...</h3><p>
        This command checks whether a set of srvid message ports are
        registered on the node or not. The command takes a list of
        values to check.
-      </p><div class="refsect3"><a name="idm629"></a><h4>Example</h4><pre class="screen">
+      </p><div class="refsect3"><a name="idm140317074698352"></a><h4>Example</h4><pre class="screen">
 # ctdb check_srvids 1 2 3 14765
 Server id 0:1 does not exist
 Server id 0:2 does not exist
 Server id 0:3 does not exist
 Server id 0:14765 exists
-       </pre></div></div></div><div class="refsect1"><a name="idm632"></a><h2>SEE ALSO</h2><p>
+       </pre></div></div></div><div class="refsect1"><a name="idm140317074695968"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,
 
       <span class="citerefentry"><span class="refentrytitle">onnode</span>(1)</span>,
index 8b6a36a..32c7d58 100644 (file)
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb &#8212; Clustered TDB</p></div><div class="refsect1"><a name="idm10"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb &#8212; Clustered TDB</p></div><div class="refsect1"><a name="idm139628772730512"></a><h2>DESCRIPTION</h2><p>
     CTDB is a clustered database component in clustered Samba that
     provides a high-availability load-sharing CIFS server cluster.
   </p><p>
@@ -16,7 +16,7 @@
     Combined with a cluster filesystem CTDB provides a full
     high-availablity (HA) environment for services such as clustered
     Samba, NFS and other services.
-  </p></div><div class="refsect1"><a name="idm22"></a><h2>ANATOMY OF A CTDB CLUSTER</h2><p>
+  </p></div><div class="refsect1"><a name="idm139628772159680"></a><h2>ANATOMY OF A CTDB CLUSTER</h2><p>
     A CTDB cluster is a collection of nodes with 2 or more network
     interfaces.  All nodes provide network (usually file/NAS) services
     to clients.  Data served by file services is stored on shared
@@ -25,7 +25,7 @@
   </p><p>
     CTDB provides an "all active" cluster, where services are load
     balanced across all nodes.
-  </p></div><div class="refsect1"><a name="idm26"></a><h2>Recovery Lock</h2><p>
+  </p></div><div class="refsect1"><a name="idm139628770890960"></a><h2>Recovery Lock</h2><p>
       CTDB uses a <span class="emphasis"><em>recovery lock</em></span> to avoid a
       <span class="emphasis"><em>split brain</em></span>, where a cluster becomes
       partitioned and each partition attempts to operate
@@ -72,7 +72,7 @@
     </p><p>
       CTDB can run without a recovery lock but this is not recommended
       as there will be no protection from split brains.
-    </p></div><div class="refsect1"><a name="idm45"></a><h2>Private vs Public addresses</h2><p>
+    </p></div><div class="refsect1"><a name="idm139628773418304"></a><h2>Private vs Public addresses</h2><p>
       Each node in a CTDB cluster has multiple IP addresses assigned
       to it:
 
@@ -83,7 +83,7 @@
            One or more public IP addresses that are used to provide
            NAS or other services.
          </p></li></ul></div><p>
-    </p><div class="refsect2"><a name="idm53"></a><h3>Private address</h3><p>
+    </p><div class="refsect2"><a name="idm139628775259760"></a><h3>Private address</h3><p>
         Each node is configured with a unique, permanently assigned
         private address.  This address is configured by the operating
         system.  This address uniquely identifies a physical node in
 192.168.1.2
 192.168.1.3
 192.168.1.4
-      </pre></div><div class="refsect2"><a name="idm67"></a><h3>Public addresses</h3><p>
+      </pre></div><div class="refsect2"><a name="idm139628775740336"></a><h3>Public addresses</h3><p>
        Public addresses are used to provide services to clients.
        Public addresses are not configured at the operating system
        level and are not permanently associated with a particular
@@ -188,7 +188,7 @@ Node 3:/usr/local/etc/ctdb/public_addresses
       </p><p>
         The <span class="command"><strong>ctdb ip</strong></span> command can be used to view the
         current assignment of public addresses to physical nodes.
-      </p></div></div><div class="refsect1"><a name="idm88"></a><h2>Node status</h2><p>
+      </p></div></div><div class="refsect1"><a name="idm139628775904560"></a><h2>Node status</h2><p>
       The current status of each node in the cluster can be viewed by the 
       <span class="command"><strong>ctdb status</strong></span> command.
     </p><p>
@@ -233,7 +233,7 @@ Node 3:/usr/local/etc/ctdb/public_addresses
            like a healthy (OK) node.  Some interfaces to serve public
            addresses are down, but at least one interface is up.  See
            also <span class="command"><strong>ctdb ifaces</strong></span>.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm128"></a><h2>CAPABILITIES</h2><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm139628775864032"></a><h2>CAPABILITIES</h2><p>
       Cluster nodes can have several different capabilities enabled.
       These are listed below.
     </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">RECMASTER</span></dt><dd><p>
@@ -252,7 +252,7 @@ Node 3:/usr/local/etc/ctdb/public_addresses
       The RECMASTER and LMASTER capabilities can be disabled when CTDB
       is used to create a cluster spanning across WAN links. In this
       case CTDB acts as a WAN accelerator.
-    </p></div><div class="refsect1"><a name="idm143"></a><h2>LVS</h2><p>
+    </p></div><div class="refsect1"><a name="idm139628775857328"></a><h2>LVS</h2><p>
       LVS is a mode where CTDB presents one single IP address for the
       entire cluster. This is an alternative to using public IP
       addresses and round-robin DNS to loadbalance clients across the
@@ -326,7 +326,7 @@ Node 3:/usr/local/etc/ctdb/public_addresses
       reachable from a node <span class="emphasis"><em>before</em></span> you enable
       LVS.  Also ensure that outgoing traffic to these hosts is routed
       out through the configured public interface.
-    </p><div class="refsect2"><a name="idm167"></a><h3>Configuration</h3><p>
+    </p><div class="refsect2"><a name="idm139628775835584"></a><h3>Configuration</h3><p>
        To activate LVS on a CTDB node you must specify the
        <code class="varname">CTDB_LVS_PUBLIC_IFACE</code>,
        <code class="varname">CTDB_LVS_PUBLIC_IP</code> and
@@ -360,7 +360,7 @@ CTDB_LVS_NODES=/usr/local/etc/ctdb/lvs_nodes
 192.168.1.2
 192.168.1.3
 192.168.1.4 slave-only
-      </pre></div></div><div class="refsect1"><a name="idm183"></a><h2>TRACKING AND RESETTING TCP CONNECTIONS</h2><p>
+      </pre></div></div><div class="refsect1"><a name="idm139628775827248"></a><h2>TRACKING AND RESETTING TCP CONNECTIONS</h2><p>
       CTDB tracks TCP connections from clients to public IP addresses,
       on known ports.  When an IP address moves from one node to
       another, all existing TCP connections to that IP address are
@@ -373,7 +373,7 @@ CTDB_LVS_NODES=/usr/local/etc/ctdb/lvs_nodes
       a release and take of a public IP address on the same node.
       Such connections can get out of sync with sequence and ACK
       numbers, potentially causing a disruptive ACK storm.
-    </p></div><div class="refsect1"><a name="idm187"></a><h2>NAT GATEWAY</h2><p>
+    </p></div><div class="refsect1"><a name="idm139628775824432"></a><h2>NAT GATEWAY</h2><p>
       NAT gateway (NATGW) is an optional feature that is used to
       configure fallback routing for nodes.  This allows cluster nodes
       to connect to external services (e.g. DNS, AD, NIS and LDAP)
@@ -390,7 +390,7 @@ CTDB_LVS_NODES=/usr/local/etc/ctdb/lvs_nodes
       extra static IP address to a public interface on every node.
       This is simpler but it uses an extra IP address per node, while
       NAT gateway generally uses only one extra IP address.
-    </p><div class="refsect2"><a name="idm192"></a><h3>Operation</h3><p>
+    </p><div class="refsect2"><a name="idm139628770293920"></a><h3>Operation</h3><p>
        One extra NATGW public address is assigned on the public
        network to each NATGW group.  Each NATGW group is a set of
        nodes in the cluster that shares the same NATGW address to
@@ -411,7 +411,7 @@ CTDB_LVS_NODES=/usr/local/etc/ctdb/lvs_nodes
        public IP address and routes outgoing connections from
        slave nodes via this IP address.  It also establishes a
        fallback default route.
-      </p></div><div class="refsect2"><a name="idm197"></a><h3>Configuration</h3><p>
+      </p></div><div class="refsect2"><a name="idm139628770290912"></a><h3>Configuration</h3><p>
        NATGW is usually configured similar to the following example configuration:
       </p><pre class="screen">
 CTDB_NATGW_NODES=/usr/local/etc/ctdb/natgw_nodes
@@ -430,7 +430,7 @@ CTDB_NATGW_DEFAULT_GATEWAY=10.0.0.1
        See the <em class="citetitle">NAT GATEWAY</em> section in
        <span class="citerefentry"><span class="refentrytitle">ctdbd.conf</span>(5)</span> for more details of
        NATGW configuration.
-      </p></div><div class="refsect2"><a name="idm208"></a><h3>Implementation details</h3><p>
+      </p></div><div class="refsect2"><a name="idm139628770286144"></a><h3>Implementation details</h3><p>
        When the NATGW functionality is used, one of the nodes is
        selected to act as a NAT gateway for all the other nodes in
        the group when they need to communicate with the external
@@ -465,7 +465,7 @@ CTDB_NATGW_DEFAULT_GATEWAY=10.0.0.1
        eventscript.  Please see the eventscript file and the
        <em class="citetitle">NAT GATEWAY</em> section in
        <span class="citerefentry"><span class="refentrytitle">ctdbd.conf</span>(5)</span> for more details.
-      </p></div></div><div class="refsect1"><a name="idm225"></a><h2>POLICY ROUTING</h2><p>
+      </p></div></div><div class="refsect1"><a name="idm139628770278320"></a><h2>POLICY ROUTING</h2><p>
       Policy routing is an optional CTDB feature to support complex
       network topologies.  Public addresses may be spread across
       several different networks (or VLANs) and it may not be possible
@@ -475,7 +475,7 @@ CTDB_NATGW_DEFAULT_GATEWAY=10.0.0.1
       This allows routing to be specified for packets sourced from
       each public address.  The routes are added and removed as CTDB
       moves public addresses between nodes.
-    </p><div class="refsect2"><a name="idm229"></a><h3>Configuration variables</h3><p>
+    </p><div class="refsect2"><a name="idm139628770276096"></a><h3>Configuration variables</h3><p>
        There are 4 configuration variables related to policy routing:
        <code class="varname">CTDB_PER_IP_ROUTING_CONF</code>,
        <code class="varname">CTDB_PER_IP_ROUTING_RULE_PREF</code>,
@@ -483,7 +483,7 @@ CTDB_NATGW_DEFAULT_GATEWAY=10.0.0.1
        <code class="varname">CTDB_PER_IP_ROUTING_TABLE_ID_HIGH</code>.  See the
        <em class="citetitle">POLICY ROUTING</em> section in
        <span class="citerefentry"><span class="refentrytitle">ctdbd.conf</span>(5)</span> for more details.
-      </p></div><div class="refsect2"><a name="idm240"></a><h3>Configuration</h3><p>
+      </p></div><div class="refsect2"><a name="idm139628770272128"></a><h3>Configuration</h3><p>
        The format of each line of
        <code class="varname">CTDB_PER_IP_ROUTING_CONF</code> is:
       </p><pre class="screen">
@@ -545,7 +545,7 @@ CTDB_NATGW_DEFAULT_GATEWAY=10.0.0.1
       </p><pre class="screen">
   192.168.1.0/24 dev eth2 scope link 
   default via 192.168.1.1 dev eth2 
-      </pre></div><div class="refsect2"><a name="idm268"></a><h3>Sample configuration</h3><p>
+      </pre></div><div class="refsect2"><a name="idm139628770256912"></a><h3>Sample configuration</h3><p>
        Here is a more complete example configuration.
       </p><pre class="screen">
 /usr/local/etc/ctdb/public_addresses:
@@ -565,7 +565,7 @@ CTDB_NATGW_DEFAULT_GATEWAY=10.0.0.1
        The routes local packets as expected, the default route is as
        previously discussed, but packets to 192.168.200.0/24 are
        routed via the alternate gateway 192.168.1.254.
-      </p></div></div><div class="refsect1"><a name="idm273"></a><h2>NOTIFICATION SCRIPT</h2><p>
+      </p></div></div><div class="refsect1"><a name="idm139628770254048"></a><h2>NOTIFICATION SCRIPT</h2><p>
       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
@@ -581,9 +581,9 @@ CTDB_NATGW_DEFAULT_GATEWAY=10.0.0.1
     </p><p>
       CTDB currently generates notifications after CTDB changes to
       these states:
-    </p><table border="0" summary="Simple list" class="simplelist"><tr><td>init</td></tr><tr><td>setup</td></tr><tr><td>startup</td></tr><tr><td>healthy</td></tr><tr><td>unhealthy</td></tr></table></div><div class="refsect1"><a name="idm288"></a><h2>DEBUG LEVELS</h2><p>
+    </p><table border="0" summary="Simple list" class="simplelist"><tr><td>init</td></tr><tr><td>setup</td></tr><tr><td>startup</td></tr><tr><td>healthy</td></tr><tr><td>unhealthy</td></tr></table></div><div class="refsect1"><a name="idm139628770247104"></a><h2>DEBUG LEVELS</h2><p>
       Valid values for DEBUGLEVEL are:
-    </p><table border="0" summary="Simple list" class="simplelist"><tr><td>ERR (0)</td></tr><tr><td>WARNING (1)</td></tr><tr><td>NOTICE (2)</td></tr><tr><td>INFO (3)</td></tr><tr><td>DEBUG (4)</td></tr></table></div><div class="refsect1"><a name="idm297"></a><h2>REMOTE CLUSTER NODES</h2><p>
+    </p><table border="0" summary="Simple list" class="simplelist"><tr><td>ERR</td></tr><tr><td>WARNING</td></tr><tr><td>NOTICE</td></tr><tr><td>INFO</td></tr><tr><td>DEBUG</td></tr></table></div><div class="refsect1"><a name="idm139628770243408"></a><h2>REMOTE CLUSTER NODES</h2><p>
 It is possible to have a CTDB cluster that spans across a WAN link. 
 For example where you have a CTDB cluster in your datacentre but you also
 want to have one additional CTDB node located at a remote branch site.
@@ -612,7 +612,7 @@ CTDB_CAPABILITY_RECMASTER=no
     </p><p>
        Verify with the command "ctdb getcapabilities" that that node no longer
        has the recmaster or the lmaster capabilities.
-    </p></div><div class="refsect1"><a name="idm305"></a><h2>SEE ALSO</h2><p>
+    </p></div><div class="refsect1"><a name="idm139628770238704"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span>,
 
       <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,
index 4831468..059a635 100644 (file)
@@ -1,10 +1,10 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb_diagnostics</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb_diagnostics.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb_diagnostics &#8212; dump diagnostic information about CTDB/Samba installation</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdb_diagnostics</code>  [OPTIONS]  ... </p></div></div><div class="refsect1"><a name="idm15"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdb_diagnostics</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb_diagnostics.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb_diagnostics &#8212; dump diagnostic information about CTDB/Samba installation</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdb_diagnostics</code>  [OPTIONS]  ... </p></div></div><div class="refsect1"><a name="idm140531806876352"></a><h2>DESCRIPTION</h2><p>
       ctdb_diagnostics is used to dump diagnostic information about a
       clustered Samba installation.  This includes configuration
       files, output of relevant commands and logs.  This information
       can be used to check the correctness of the configuration and to
       diagnose problems.
-    </p></div><div class="refsect1"><a name="idm18"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-n &lt;nodes&gt;</span></dt><dd><p>
+    </p></div><div class="refsect1"><a name="idm140531809082304"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-n &lt;nodes&gt;</span></dt><dd><p>
              Comma separated list of nodes to operate on
            </p></dd><dt><span class="term">-c</span></dt><dd><p>
              Ignore comment lines (starting with '#') in file comparisons
@@ -12,7 +12,7 @@
              Ignore whitespace in file comparisons
              </p></dd><dt><span class="term">--no-ads</span></dt><dd><p>
              Do not use commands that assume an Active Directory Server
-             </p></dd></dl></div></div><div class="refsect1"><a name="idm37"></a><h2>SEE ALSO</h2><p>
+             </p></dd></dl></div></div><div class="refsect1"><a name="idm140531810815072"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span>,
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span>,
       <a class="ulink" href="https://ctdb.samba.org/" target="_top">https://ctdb.samba.org/</a>
diff --git a/web/manpages/ctdb_mutex_ceph_rados_helper.7.html b/web/manpages/ctdb_mutex_ceph_rados_helper.7.html
new file mode 100644 (file)
index 0000000..dd70d3a
--- /dev/null
@@ -0,0 +1,26 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Ceph RADOS Mutex</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdb_mutex_ceph_rados_helper.7"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdb_mutex_ceph_rados_helper &#8212; Ceph RADOS cluster mutex helper</p></div><div class="refsect1"><a name="idm140124588809200"></a><h2>DESCRIPTION</h2><p>
+      ctdb_mutex_ceph_rados_helper can be used as a recovery lock provider
+      for CTDB.  When configured, split brain avoidance during CTDB recovery
+      will be handled using locks against an object located in a Ceph RADOS
+      pool.
+      To enable this functionality, include the following line in your CTDB
+      config file:
+    </p><pre class="screen">
+CTDB_RECOVERY_LOCK="!ctdb_mutex_ceph_rados_helper [Cluster] [User] [Pool] [Object]"
+
+Cluster: Ceph cluster name (e.g. ceph)
+User: Ceph cluster user name (e.g. client.admin)
+Pool: Ceph RADOS pool name
+Object: Ceph RADOS object name
+    </pre><p>
+      The Ceph cluster <em class="parameter"><code>Cluster</code></em> must be up and running,
+      with a configuration, and keyring file for <em class="parameter"><code>User</code></em>
+      located in a librados default search path (e.g. /etc/ceph/).
+      <em class="parameter"><code>Pool</code></em> must already exist.
+    </p></div><div class="refsect1"><a name="idm140124588179520"></a><h2>SEE ALSO</h2><p>
+      <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span>,
+
+      <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,
+
+      <a class="ulink" href="http://ctdb.samba.org/" target="_top">http://ctdb.samba.org/</a>
+    </p></div></div></body></html>
index ca6d0b7..8c37e76 100644 (file)
@@ -1,11 +1,11 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdbd</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdbd.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdbd &#8212; The CTDB cluster daemon</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdbd</code>  [<em class="replaceable"><code>OPTION</code></em>...]</p></div></div><div class="refsect1"><a name="idm15"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdbd</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdbd.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdbd &#8212; The CTDB cluster daemon</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdbd</code>  [<em class="replaceable"><code>OPTION</code></em>...]</p></div></div><div class="refsect1"><a name="idm140225363724176"></a><h2>DESCRIPTION</h2><p>
       ctdbd is the main CTDB daemon.
     </p><p>
       Note that ctdbd is not usually invoked directly.  It is invoked
       via <span class="citerefentry"><span class="refentrytitle">ctdbd_wrapper</span>(1)</span> or via the initscript.
     </p><p>
       See <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span> for an overview of CTDB.
-    </p></div><div class="refsect1"><a name="idm26"></a><h2>GENERAL OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-d, --debug=<em class="parameter"><code>DEBUGLEVEL</code></em></span></dt><dd><p>
+    </p></div><div class="refsect1"><a name="idm140225366272208"></a><h2>GENERAL OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-d, --debug=<em class="parameter"><code>DEBUGLEVEL</code></em></span></dt><dd><p>
            This option sets the debug level to DEBUGLEVEL, which
            controls what will be written by the logging
            subsystem.  The default is 2.
            The "infiniband" support is not regularly tested.
          </p></dd><dt><span class="term">-?, --help</span></dt><dd><p>
            Display a summary of options.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm223"></a><h2>DEBUGGING OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-i, --interactive</span></dt><dd><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140225362389168"></a><h2>DEBUGGING OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-i, --interactive</span></dt><dd><p>
            Enable interactive mode.  This will make ctdbd run in the
            foreground and not detach from the terminal.  By default
            ctdbd will detach itself and run in the background as a
            for testing.
          </p></dd><dt><span class="term">--script-log-level=<em class="parameter"><code>DEBUGLEVEL</code></em></span></dt><dd><p>
            This option sets the debug level of event script output to
-           DEBUGLEVEL.  The default is ERR (0).
+           DEBUGLEVEL.  The default is ERR.
          </p><p>
            See the <em class="citetitle">DEBUG LEVELS</em> section in
            <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span> for more
            This is a debugging option. This option is only used when
            debugging ctdbd.  This enables additional debugging
            capabilities and implies --nosetsched.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm273"></a><h2>SEE ALSO</h2><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140225362367680"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span>,
 
       <span class="citerefentry"><span class="refentrytitle">ctdbd_wrapper</span>(1)</span>,
index 458ef52..e9e7c02 100644 (file)
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdbd.conf</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdbd.conf.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdbd.conf &#8212; CTDB daemon configuration file</p></div><div class="refsect1"><a name="idm10"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdbd.conf</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdbd.conf.5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdbd.conf &#8212; CTDB daemon configuration file</p></div><div class="refsect1"><a name="idm140600397309584"></a><h2>DESCRIPTION</h2><p>
       This file contains CTDB configuration variables that are affect
       the operation of CTDB.  The default location of this file is
       <code class="filename">/usr/local/etc/ctdb/ctdbd.conf</code>.
@@ -17,7 +17,7 @@
       A historical alternative is
       <code class="filename">/usr/local/etc/ctdb/sysconfig/ctdb</code> - this is
       deprecated.
-    </p></div><div class="refsect1"><a name="idm23"></a><h2>
+    </p></div><div class="refsect1"><a name="idm140600395872352"></a><h2>
       INITSCRIPT CONFIGURATION
     </h2><p>
       Some options must be available to the initscript so they need to
          </p><p>
            Default is <code class="filename">/usr/local/var/run/ctdb/ctdbd.pid</code>.
            Corresponds to <code class="option">--pidfile</code>.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm40"></a><h2>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140600398014368"></a><h2>
       GLOBAL CONFIGURATION
     </h2><p>
       These options may be used in the initscripts, daemon and
       scripts.
     </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_BASE=<em class="parameter"><code>DIRECTORY</code></em></span></dt><dd><p>
            DIRECTORY containing CTDB scripts and configuration files.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm49"></a><h2>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140600399841344"></a><h2>
       DAEMON CONFIGURATION
     </h2><p>
       Variables in this section are processed by
@@ -79,7 +79,7 @@
          </p><p>
            Corresponds to <code class="option">--dbdir-state</code>.
          </p></dd><dt><span class="term">CTDB_DEBUGLEVEL=<em class="parameter"><code>DEBUGLEVEL</code></em></span></dt><dd><p>
-           Default is NOTICE (2).  Corresponds to <code class="option">-d</code> or
+           Default is NOTICE.  Corresponds to <code class="option">-d</code> or
            <code class="option">--debug</code>.
          </p></dd><dt><span class="term">CTDB_EVENT_SCRIPT_DIR=<em class="parameter"><code>DIRECTORY</code></em></span></dt><dd><p>
            Default is <code class="varname">CTDB_BASE</code>/events.d, so usually
            <em class="citetitle">RECOVERY LOCK</em> section in
            <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span>.
          </p></dd><dt><span class="term">CTDB_SCRIPT_LOG_LEVEL=<em class="parameter"><code>DEBUGLEVEL</code></em></span></dt><dd><p>
-           Defaults to ERR (0).  Corresponds to
+           Defaults to ERR.  Corresponds to
            <code class="option">--script-log-level</code>.
          </p></dd><dt><span class="term">CTDB_SOCKET=<em class="parameter"><code>FILENAME</code></em></span></dt><dd><p>
            Defaults to <code class="filename">/usr/local/var/run/ctdb/ctdbd.socket</code>.
            "setup" event before this timeout then it is killed.
          </p><p>
            Defaults is 10.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm277"></a><h2>NETWORK CONFIGURATION</h2><div class="refsect2"><a name="idm279"></a><h3>NAT GATEWAY</h3><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140600394866464"></a><h2>NETWORK CONFIGURATION</h2><div class="refsect2"><a name="idm140600394865824"></a><h3>NAT GATEWAY</h3><p>
        NAT gateway is used to configure fallback routing for nodes
        when they do not host any public IP addresses.  For example,
        it allows unhealthy nodes to reliably communicate with
              route to avoid this.
            </p><p>
              No default.
-           </p></dd></dl></div><div class="refsect3"><a name="idm337"></a><h4>Example</h4><pre class="screen">
+           </p></dd></dl></div><div class="refsect3"><a name="idm140600394839600"></a><h4>Example</h4><pre class="screen">
 CTDB_NATGW_NODES=/usr/local/etc/ctdb/natgw_nodes
 CTDB_NATGW_PRIVATE_NETWORK=192.168.1.0/24
 CTDB_NATGW_DEFAULT_GATEWAY=10.0.0.1
@@ -317,7 +317,7 @@ CTDB_NATGW_STATIC_ROUTES=10.0.0.0/24
        </pre><p>
          Note that <code class="varname">CTDB_NATGW_DEFAULT_GATEWAY</code> is
          not specified.
-       </p></div></div><div class="refsect2"><a name="idm344"></a><h3>POLICY ROUTING</h3><p>
+       </p></div></div><div class="refsect2"><a name="idm140600394835696"></a><h3>POLICY ROUTING</h3><p>
        A node running CTDB may be a component of a complex network
        topology.  In particular, public addresses may be spread
        across several different networks (or VLANs) and it may not be
@@ -381,15 +381,15 @@ CTDB_NATGW_STATIC_ROUTES=10.0.0.0/24
              manipulate).
            </p><p>
              No default, usually 1000 and 9000.
-           </p></dd></dl></div><div class="refsect3"><a name="idm393"></a><h4>Example</h4><pre class="screen">
+           </p></dd></dl></div><div class="refsect3"><a name="idm140600394813760"></a><h4>Example</h4><pre class="screen">
 CTDB_PER_IP_ROUTING_CONF=/usr/local/etc/ctdb/policy_routing
 CTDB_PER_IP_ROUTING_RULE_PREF=100
 CTDB_PER_IP_ROUTING_TABLE_ID_LOW=1000
 CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
-       </pre></div></div><div class="refsect2"><a name="idm396"></a><h3>LVS</h3><p>
+       </pre></div></div><div class="refsect2"><a name="idm140600394812048"></a><h3>LVS</h3><p>
        For a general description see the <em class="citetitle">LVS</em>
        section in <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span>.
-      </p><div class="refsect3"><a name="idm403"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">91.lvs</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_LVS_NODES=<em class="parameter"><code>FILENAME</code></em></span></dt><dd><p>
+      </p><div class="refsect3"><a name="idm140600394809744"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">91.lvs</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_LVS_NODES=<em class="parameter"><code>FILENAME</code></em></span></dt><dd><p>
              FILENAME contains the list of nodes that belong to the
              same LVS group.
            </p><p>
@@ -417,7 +417,7 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
            </p></dd><dt><span class="term">CTDB_LVS_PUBLIC_IP=<em class="parameter"><code>IPADDR</code></em></span></dt><dd><p>
              CTDB_LVS_PUBLIC_IP is the LVS public address.  No
              default.
-         </p></dd></dl></div></div><div class="refsect2"><a name="idm435"></a><h3>MISCELLANEOUS NETWORK CONFIGURATION</h3><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_PARTIALLY_ONLINE_INTERFACES=yes|no</span></dt><dd><p>
+         </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394795392"></a><h3>MISCELLANEOUS NETWORK CONFIGURATION</h3><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_PARTIALLY_ONLINE_INTERFACES=yes|no</span></dt><dd><p>
              Whether one or more offline interfaces should cause a
              monitor event to fail if there are other interfaces that
              are up.  If this is "yes" and a node has some interfaces
@@ -430,7 +430,7 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
              to be up.
            </p><p>
              Default is "no".
-           </p></dd></dl></div></div></div><div class="refsect1"><a name="idm445"></a><h2>SERVICE CONFIGURATION</h2><p>
+           </p></dd></dl></div></div></div><div class="refsect1"><a name="idm140600394790720"></a><h2>SERVICE CONFIGURATION</h2><p>
       CTDB can be configured to manage and/or monitor various NAS (and
       other) services via its eventscripts.
     </p><p>
@@ -439,7 +439,7 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
       monitor the service and CTDB will do any required
       reconfiguration of the service when public IP addresses are
       failed over.
-    </p><div class="refsect2"><a name="idm449"></a><h3>SAMBA</h3><div class="refsect3"><a name="idm451"></a><h4>Eventscripts</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">49.winbind</code></td></tr><tr><td><code class="filename">50.samba</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_SAMBA=yes|no</span></dt><dd><p>
+    </p><div class="refsect2"><a name="idm140600394788864"></a><h3>SAMBA</h3><div class="refsect3"><a name="idm140600394788224"></a><h4>Eventscripts</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">49.winbind</code></td></tr><tr><td><code class="filename">50.samba</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_SAMBA=yes|no</span></dt><dd><p>
              Should CTDB manage Samba?
            </p><p>
              Default is no.
@@ -471,11 +471,11 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
              Distribution specific SERVICE for managing winbindd.
            </p><p>
              Default is "winbind".
-           </p></dd></dl></div></div><div class="refsect2"><a name="idm498"></a><h3>NFS</h3><p>
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394768960"></a><h3>NFS</h3><p>
        This includes parameters for the kernel NFS server.
        Alternative NFS subsystems (such as <a class="ulink" href="https://github.com/nfs-ganesha/nfs-ganesha/wiki" target="_top">NFS-Ganesha</a>)
        can be integrated using <code class="varname">CTDB_NFS_CALLOUT</code>.
-      </p><div class="refsect3"><a name="idm503"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">60.nfs</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_NFS=yes|no</span></dt><dd><p>
+      </p><div class="refsect3"><a name="idm140600394766816"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">60.nfs</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_NFS=yes|no</span></dt><dd><p>
              Should CTDB manage NFS?
            </p><p>
              Default is no.
@@ -515,16 +515,16 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
            </p></dd><dt><span class="term">CTDB_NFS_STATE_MNT=<em class="parameter"><code>DIR</code></em></span></dt><dd><p>
              The directory where a clustered NFS' shared state will be
              located. No default.
-           </p></dd></dl></div></div><div class="refsect2"><a name="idm554"></a><h3>APACHE HTTPD</h3><p>
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394743504"></a><h3>APACHE HTTPD</h3><p>
        CTDB can manage the Apache web server.
-      </p><div class="refsect3"><a name="idm557"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">41.httpd</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_HTTPD=yes|no</span></dt><dd><p>
+      </p><div class="refsect3"><a name="idm140600394742480"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">41.httpd</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_HTTPD=yes|no</span></dt><dd><p>
              Should CTDB manage the Apache web server?
            </p><p>
              Default is no.
-           </p></dd></dl></div></div><div class="refsect2"><a name="idm568"></a><h3>CLAMAV</h3><p>
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394737904"></a><h3>CLAMAV</h3><p>
        CTDB has support to manage the popular anti-virus daemon
        ClamAV.
-      </p><div class="refsect3"><a name="idm571"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">31.clamd</code></td></tr></table><p>
+      </p><div class="refsect3"><a name="idm140600394736784"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">31.clamd</code></td></tr></table><p>
          This eventscript is not enabled by default.  Use
          <span class="command"><strong>ctdb enablescript</strong></span> to enable it.
        </p></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_CLAMD=yes|no</span></dt><dd><p>
@@ -535,9 +535,9 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
              FILENAME is the socket to monitor ClamAV.
            </p><p>
              No default.
-           </p></dd></dl></div></div><div class="refsect2"><a name="idm590"></a><h3>ISCSI</h3><p>
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394728704"></a><h3>ISCSI</h3><p>
        CTDB has support for managing the Linux iSCSI tgtd service.
-      </p><div class="refsect3"><a name="idm593"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">70.iscsi</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_ISCSI=yes|no</span></dt><dd><p>
+      </p><div class="refsect3"><a name="idm140600394727600"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">70.iscsi</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_ISCSI=yes|no</span></dt><dd><p>
              Should CTDB manage iSCSI tgtd?
            </p><p>
              Default is no.
@@ -546,23 +546,23 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
              tgtd for each public IP address.
            </p><p>
              No default.
-           </p></dd></dl></div></div><div class="refsect2"><a name="idm610"></a><h3>MULTIPATHD</h3><p>
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394720480"></a><h3>MULTIPATHD</h3><p>
        CTDB can monitor multipath devices to ensure that active paths
        are available.
-      </p><div class="refsect3"><a name="idm613"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">20.multipathd</code></td></tr></table><p>
+      </p><div class="refsect3"><a name="idm140600394719360"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">20.multipathd</code></td></tr></table><p>
          This eventscript is not enabled by default.  Use
          <span class="command"><strong>ctdb enablescript</strong></span> to enable it.
        </p></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MONITOR_MPDEVICES=<em class="parameter"><code>MP-DEVICE-LIST</code></em></span></dt><dd><p>
              MP-DEVICE-LIST is a list of multipath devices for CTDB to monitor?
            </p><p>
              No default.
-           </p></dd></dl></div></div><div class="refsect2"><a name="idm627"></a><h3>VSFTPD</h3><p>
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394713104"></a><h3>VSFTPD</h3><p>
        CTDB can manage the vsftpd FTP server.
-      </p><div class="refsect3"><a name="idm630"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">40.vsftpd</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_VSFTPD=yes|no</span></dt><dd><p>
+      </p><div class="refsect3"><a name="idm140600394712080"></a><h4>Eventscript</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">40.vsftpd</code></td></tr></table></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGES_VSFTPD=yes|no</span></dt><dd><p>
              Should CTDB manage the vsftpd FTP server?
            </p><p>
              Default is no.
-           </p></dd></dl></div></div><div class="refsect2"><a name="idm641"></a><h3>
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394707504"></a><h3>
        SYSTEM RESOURCE MONITORING CONFIGURATION
       </h3><p>
        CTDB can experience seemingly random (performance and other)
@@ -575,7 +575,7 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
        Some checks are enabled by default.  It is recommended that
        these checks remain enabled or are augmented by extra checks.
        There is no supported way of completely disabling the checks.
-      </p><div class="refsect3"><a name="idm645"></a><h4>Eventscripts</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">05.system</code></td></tr></table><p>
+      </p><div class="refsect3"><a name="idm140600394705520"></a><h4>Eventscripts</h4><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">05.system</code></td></tr></table><p>
          Filesystem and memory usage monitoring is in
          <code class="filename">05.system</code>.
        </p></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MONITOR_FILESYSTEM_USAGE=<em class="parameter"><code>FS-LIMIT-LIST</code></em></span></dt><dd><p>
@@ -614,7 +614,7 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
            </p><p>
              Default is 25, so warnings will be logged when swap
              usage reaches 25%.
-           </p></dd></dl></div></div><div class="refsect2"><a name="idm684"></a><h3>MISCELLANEOUS SERVICE-RELATED CONFIGURATION</h3><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGED_SERVICES=<em class="parameter"><code>SERVICE-LIST</code></em></span></dt><dd><p>
+           </p></dd></dl></div></div><div class="refsect2"><a name="idm140600394687360"></a><h3>MISCELLANEOUS SERVICE-RELATED CONFIGURATION</h3><div class="variablelist"><dl class="variablelist"><dt><span class="term">CTDB_MANAGED_SERVICES=<em class="parameter"><code>SERVICE-LIST</code></em></span></dt><dd><p>
              SERVICE-LIST is a space-separated list of SERVICEs that
              CTDB should manage.  This can be used as an alternative
              to the
@@ -627,7 +627,7 @@ CTDB_PER_IP_ROUTING_TABLE_ID_HIGH=9000
              managed or unmanaged.
            </p><p>
              Default is no.
-           </p></dd></dl></div></div></div><div class="refsect1"><a name="idm700"></a><h2>
+           </p></dd></dl></div></div></div><div class="refsect1"><a name="idm140600394680832"></a><h2>
       TUNABLES CONFIGURATION
     </h2><p>
       CTDB tunables (see
@@ -643,7 +643,7 @@ CTDB_SET_<em class="replaceable"><code>TUNABLE</code></em>=<em class="replaceabl
       </p><pre class="screen">
 CTDB_SET_MonitorInterval=20
       </pre><p>
-    </p></div><div class="refsect1"><a name="idm711"></a><h2>
+    </p></div><div class="refsect1"><a name="idm140600394676048"></a><h2>
       DEBUG AND TEST
     </h2><p>
       Variable in this section are for debugging and testing CTDB.
@@ -722,12 +722,12 @@ CTDB_SET_MonitorInterval=20
            This uses the <code class="filename">99.timeout</code> eventscript.
          </p><p>
            Default is no.
-         </p></dd><dt><span class="term">CTDB_SCRIPT_DEBUGLEVEL=<em class="parameter"><code>NUM</code></em></span></dt><dd><p>
-           NUM is the level debugging messages printed by CTDB
-           scripts.  Setting this to a higher number (e.g. 4) will
+         </p></dd><dt><span class="term">CTDB_SCRIPT_DEBUGLEVEL=<em class="parameter"><code>DEBUGLEVEL</code></em></span></dt><dd><p>
+           DEBUGLEVEL is the level debugging messages printed by CTDB
+           scripts.  Setting this to a higher level (e.g. DEBUG) will
            cause some scripts to log more messages.
          </p><p>
-           Default is 2.
+           Default is NOTICE.
          </p></dd><dt><span class="term">CTDB_SUPPRESS_COREFILE=yes|no</span></dt><dd><p>
            Whether CTDB core files should be suppressed.
          </p><p>
@@ -750,7 +750,7 @@ CTDB_SET_MonitorInterval=20
            runtime.
          </p><p>
            Defaults to <code class="filename">/usr/local/var/lib/ctdb</code>.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm822"></a><h2>FILES</h2><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">/usr/local/etc/ctdb/ctdbd.conf</code></td></tr><tr><td><code class="filename">/etc/sysconfig/ctdb</code></td></tr><tr><td><code class="filename">/etc/default/ctdb</code></td></tr><tr><td><code class="filename">/usr/local/etc/ctdb/sysconfig/ctdb</code></td></tr></table></div><div class="refsect1"><a name="idm833"></a><h2>SEE ALSO</h2><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140600394627632"></a><h2>FILES</h2><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">/usr/local/etc/ctdb/ctdbd.conf</code></td></tr><tr><td><code class="filename">/etc/sysconfig/ctdb</code></td></tr><tr><td><code class="filename">/etc/default/ctdb</code></td></tr><tr><td><code class="filename">/usr/local/etc/ctdb/sysconfig/ctdb</code></td></tr></table></div><div class="refsect1"><a name="idm140600394623232"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,
 
       <span class="citerefentry"><span class="refentrytitle">ctdbd_wrapper</span>(1)</span>,
index 45d9629..052fc92 100644 (file)
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdbd_wrapper</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdbd_wrapper.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdbd_wrapper &#8212; Wrapper for ctdbd</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdbd_wrapper</code>  {<em class="replaceable"><code>PIDFILE</code></em>} { start  |   stop }</p></div></div><div class="refsect1"><a name="idm46088121867040"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ctdbd_wrapper</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ctdbd_wrapper.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ctdbd_wrapper &#8212; Wrapper for ctdbd</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ctdbd_wrapper</code>  {<em class="replaceable"><code>PIDFILE</code></em>} { start  |   stop }</p></div></div><div class="refsect1"><a name="idm140468450932320"></a><h2>DESCRIPTION</h2><p>
       ctdbd_wrapper is used to start or stop the main CTDB daemon.
     </p><p>
       <em class="replaceable"><code>PIDFILE</code></em> specifies the location of the
@@ -9,7 +9,7 @@
       <span class="citerefentry"><span class="refentrytitle">ctdbd.conf</span>(5)</span>.
     </p><p>
       See <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span> for an overview of CTDB.
-    </p></div><div class="refsect1"><a name="idm46088123065984"></a><h2>SEE ALSO</h2><p>
+    </p></div><div class="refsect1"><a name="idm140468451652336"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdbd</span>(1)</span>,
 
       <span class="citerefentry"><span class="refentrytitle">ctdbd.conf</span>(5)</span>,
index 9b2262e..843faa4 100644 (file)
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ltdbtool</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ltdbtool.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ltdbtool &#8212; manipulate CTDB's local TDB files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ltdbtool</code>  [<em class="replaceable"><code>OPTION</code></em>...] {<em class="replaceable"><code>COMMAND</code></em>} [<em class="replaceable"><code>COMMAND-ARGS</code></em>]</p></div></div><div class="refsect1"><a name="idm46526557164304"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ltdbtool</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ltdbtool.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ltdbtool &#8212; manipulate CTDB's local TDB files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ltdbtool</code>  [<em class="replaceable"><code>OPTION</code></em>...] {<em class="replaceable"><code>COMMAND</code></em>} [<em class="replaceable"><code>COMMAND-ARGS</code></em>]</p></div></div><div class="refsect1"><a name="idm140620543656272"></a><h2>DESCRIPTION</h2><p>
       ltdbtool is a utility to manipulate CTDB's local TDB databases
       (LTDBs) without connecting to a CTDB daemon.
     </p><p>
@@ -11,7 +11,7 @@
          by adding or removing CTDB headers and
        </p></li><li class="listitem"><p>convert between 64 and 32 bit LTDBs where the CTDB record
          headers differ by 4 bytes of padding.
-         </p></li></ul></div></div><div class="refsect1"><a name="idm46526557607696"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-e</span></dt><dd><p>
+         </p></li></ul></div></div><div class="refsect1"><a name="idm140620542156608"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-e</span></dt><dd><p>
            Dump empty records.  These are normally excluded.
          </p></dd><dt><span class="term">-p</span></dt><dd><p>
            Dump with header information, similar to "ctdb catdb".
@@ -37,7 +37,7 @@
            output database in bytes.
          </p></dd><dt><span class="term">-h</span></dt><dd><p>
             Print help text.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm46526561410160"></a><h2>COMMANDS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">help</span></dt><dd><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140620545945584"></a><h2>COMMANDS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">help</span></dt><dd><p>
            Print help text.
          </p></dd><dt><span class="term">dump <em class="parameter"><code>IDB</code></em></span></dt><dd><p>
            Dump the contents of an LTDB input file IDB to standard
@@ -47,7 +47,7 @@
        </span></dt><dd><p>
            Copy an LTDB input file IDB to output file ODB, optionally
            adding or removing CTDB headers.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm46526561595136"></a><h2>EXAMPLES</h2><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140620546040048"></a><h2>EXAMPLES</h2><p>
       Print a local tdb in "tdbdump" style:
     </p><pre class="screen">
       ltdbtool dump idmap2.tdb.0
@@ -75,7 +75,7 @@
       Add a default header:
     </p><pre class="screen">
       ltdbtool convert -s0 idmap.tdb idmap2.tdb.0
-    </pre></div><div class="refsect1"><a name="idm46526561586960"></a><h2>SEE ALSO</h2><p>
+    </pre></div><div class="refsect1"><a name="idm140620546031872"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(1)</span>,
 
       <span class="citerefentry"><span class="refentrytitle">tdbdump</span>(1)</span>,
index 9bb6590..bcb9827 100644 (file)
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>onnode</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="onnode.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>onnode &#8212; run commands on CTDB cluster nodes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">onnode</code>  [<em class="replaceable"><code>OPTION</code></em>...] {<em class="replaceable"><code>NODES</code></em>} {<em class="replaceable"><code>COMMAND</code></em>}</p></div></div><div class="refsect1"><a name="idm19"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>onnode</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="onnode.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>onnode &#8212; run commands on CTDB cluster nodes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">onnode</code>  [<em class="replaceable"><code>OPTION</code></em>...] {<em class="replaceable"><code>NODES</code></em>} {<em class="replaceable"><code>COMMAND</code></em>}</p></div></div><div class="refsect1"><a name="idm140363734428880"></a><h2>DESCRIPTION</h2><p>
       onnode is a utility to run commands on a specific node of a CTDB
       cluster, or on all nodes.
     </p><p>
@@ -9,7 +9,7 @@
       <em class="replaceable"><code>COMMAND</code></em> can be any shell command. The
       onnode utility uses ssh or rsh to connect to the remote nodes
       and run the command.
-    </p></div><div class="refsect1"><a name="idm27"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-c</span></dt><dd><p>
+    </p></div><div class="refsect1"><a name="idm140363734424336"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-c</span></dt><dd><p>
             Execute COMMAND in the current working directory on the
             specified nodes.
          </p></dd><dt><span class="term">-f <em class="parameter"><code>FILENAME</code></em></span></dt><dd><p>
@@ -49,7 +49,7 @@
             more than one node is specified.
          </p></dd><dt><span class="term">-h, --help</span></dt><dd><p>
             Show a short usage guide.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm77"></a><h2>NODES SPECIFICATION</h2><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140363730185584"></a><h2>NODES SPECIFICATION</h2><p>
       Nodes can be specified via numeric node numbers (from 0 to N-1)
       or mnemonics.  Multiple nodes are specified using lists of
       nodes, separated by commas, and ranges of numeric node numbers,
@@ -68,7 +68,7 @@
             unhealthy.
          </p></dd><dt><span class="term">con | connected</span></dt><dd><p>
             All nodes that are not disconnected.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm98"></a><h2>EXAMPLES</h2><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140363730177152"></a><h2>EXAMPLES</h2><p>
       The following command would show the process ID of ctdbd on all nodes
     </p><pre class="screen">
       onnode all ctdb getpid
       directory, in parallel, on nodes 0, 2, 3 and 4.
     </p><pre class="screen">
       onnode -c -p 0,2-4 ./foo
-    </pre></div><div class="refsect1"><a name="idm108"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="envar">CTDB_BASE</code></span></dt><dd><p>
+    </pre></div><div class="refsect1"><a name="idm140363730171696"></a><h2>ENVIRONMENT</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="envar">CTDB_BASE</code></span></dt><dd><p>
            Directory containing CTDB configuration files.  The
            default is <code class="filename">/usr/local/etc/ctdb</code>.
          </p></dd><dt><span class="term"><code class="envar">CTDB_NODES_FILE</code></span></dt><dd><p>
            Name of alternative nodes file to use instead of the
            default.  See the <em class="citetitle">FILES</em> section for
            more details.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm123"></a><h2>FILES</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="filename">/usr/local/etc/ctdb/nodes</code></span></dt><dd><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140363734539344"></a><h2>FILES</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="filename">/usr/local/etc/ctdb/nodes</code></span></dt><dd><p>
             Default file containing a list of each node's IP address
             or hostname.
          </p><p>
             <code class="envar">SSH</code> to something other than "ssh".  In this
             case the -t option is ignored.  For example, the
             administrator may choose to use use rsh instead of ssh.
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm149"></a><h2>SEE ALSO</h2><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm140363734527376"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span>,
 
       <a class="ulink" href="http://ctdb.samba.org/" target="_top">http://ctdb.samba.org/</a>
index 06bba9b..8ecef09 100644 (file)
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ping_pong</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ping_pong.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ping_pong &#8212; measures the ping-pong byte range lock latency</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ping_pong</code>  { -r  |   -w  |   -rw } [-m] [-c] {<em class="replaceable"><code>FILENAME</code></em>} {<em class="replaceable"><code>NUM-LOCKS</code></em>}</p></div></div><div class="refsect1"><a name="idm45847900673440"></a><h2>DESCRIPTION</h2><p>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>ping_pong</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry"><a name="ping_pong.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ping_pong &#8212; measures the ping-pong byte range lock latency</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">ping_pong</code>  { -r  |   -w  |   -rw } [-m] [-c] {<em class="replaceable"><code>FILENAME</code></em>} {<em class="replaceable"><code>NUM-LOCKS</code></em>}</p></div></div><div class="refsect1"><a name="idm139761892137744"></a><h2>DESCRIPTION</h2><p>
       ping_pong measures the byte range lock latency. It is especially
       useful on a cluster of nodes sharing a common lock manager as it
       will give some indication of the lock manager's performance
@@ -9,7 +9,7 @@
     </p><p>
       NUM-LOCKS is the number of byte range locks, so needs to be
       (strictly) greater than the number of nodes in the cluster.
-    </p></div><div class="refsect1"><a name="idm45847899428656"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-r</span></dt><dd><p>
+    </p></div><div class="refsect1"><a name="idm139761893803232"></a><h2>OPTIONS</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">-r</span></dt><dd><p>
            test read performance
          </p></dd><dt><span class="term">-w</span></dt><dd><p>
            test write performance
@@ -17,7 +17,7 @@
            use mmap
          </p></dd><dt><span class="term">-c</span></dt><dd><p>
            validate the locks
-         </p></dd></dl></div></div><div class="refsect1"><a name="idm45847903379600"></a><h2>EXAMPLES</h2><p>
+         </p></dd></dl></div></div><div class="refsect1"><a name="idm139761895894768"></a><h2>EXAMPLES</h2><p>
       Testing lock coherence
     </p><pre class="screen">
       ping_pong test.dat N
@@ -29,7 +29,7 @@
       Testing IO coherence
     </p><pre class="screen">
       ping_pong -rw test.dat N
-    </pre></div><div class="refsect1"><a name="idm45847903438176"></a><h2>SEE ALSO</h2><p>
+    </pre></div><div class="refsect1"><a name="idm139761895936448"></a><h2>SEE ALSO</h2><p>
       <span class="citerefentry"><span class="refentrytitle">ctdb</span>(7)</span>,
 
       <a class="ulink" href="https://wiki.samba.org/index.php/Ping_pong" target="_top">https://wiki.samba.org/index.php/Ping_pong</a>