1CTDB-ETCD(7)             CTDB - clustered TDB database            CTDB-ETCD(7)
2
3
4

NAME

6       ctdb-etcd - CTDB etcd integration
7

SYNOPSIS

9       ctdb_etcd_lock
10

DESCRIPTION

12       ctdb_etcd_lock is intended to be run as a mutex helper for CTDB. It
13       will try to connect to an existing etcd cluster and grab a lock in that
14       cluster to function as CTDB's cluster lock. Please see
15       ctdb/doc/cluster_mutex_helper.txt for details on the mutex helper API.
16       To use this, include the following line in the [cluster] section of
17       ctdb.conf(5):
18
19           cluster lock = !/usr/local/usr/libexec/ctdb/ctdb_etcd_lock
20
21
22       You can also pass "-v", "-vv", or "-vvv" to include verbose output in
23       the CTDB log. Additional "v"s indicate increases in verbosity.
24
25       This mutex helper expects the system Python interpreter to have access
26       to the etcd Python module. It also expects an etcd cluster to be
27       configured and running. To integrate with this, there is an optional
28       config file of the following format:
29
30           key = value
31
32
33       The following configuration parameters (and their defaults) are defined
34       for use by ctdb_etcd_lock:
35
36           port      = 2379   # connecting port for the etcd cluster
37           lock_ttl  = 9      # seconds for TTL
38           refresh   = 2      # seconds between attempts to maintain lock
39           locks_dir = _ctdb  # where to store CTDB locks in etcd
40                              # The final etcd directory for any given lock looks like:
41                              #   /_locks/{locks_dir}/{netbios name}/
42
43
44       In addition, any keyword parameter that can be used to configure an
45       etcd client may be specified and modified here. For more documentation
46       on these parameters, see here: https://github.com/jplana/python-etcd/
47

SEE ALSO

49       ctdb(7), ctdbd(1), http://ctdb.samba.org/
50

AUTHOR

52       This documentation was written by Jose A. Rivera
53

55       Copyright © 2016 Jose A. Rivera
56
57       This program is free software; you can redistribute it and/or modify it
58       under the terms of the GNU General Public License as published by the
59       Free Software Foundation; either version 3 of the License, or (at your
60       option) any later version.
61
62       This program is distributed in the hope that it will be useful, but
63       WITHOUT ANY WARRANTY; without even the implied warranty of
64       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
65       General Public License for more details.
66
67       You should have received a copy of the GNU General Public License along
68       with this program; if not, see http://www.gnu.org/licenses.
69
70
71
72
73ctdb                              01/26/2023                      CTDB-ETCD(7)
Impressum