ctdb-doc: Document externally managed public IP addresses

For use with DisableIPFailover=1.

Pair-programmed-with: Amitay Isaacs <amitay@gmail.com>
Signed-off-by: Martin Schwenke <martin@meltin.net>
Reviewed-by: Amitay Isaacs <amitay@gmail.com>
Autobuild-User(master): Amitay Isaacs <amitay@samba.org>
Autobuild-Date(master): Wed May 13 09:27:36 CEST 2015 on sn-devel-104

diff --git a/ctdb/doc/examples/README b/ctdb/doc/examples/README
index 71337b7560b3c1f2f12bea89dc310181a2677590..7a2e964bffa8a0f8077e2747e32e633ab31cbff6 100644 (file)
--- a/ctdb/doc/examples/README
+++ b/ctdb/doc/examples/README
@@ -1,4 +1,5 @@
 This directory includes sample CTDB cluster configurations.
 
-  o cluster.conf - Basic cluster setup
-  o natgw.conf   - Basic cluster setup with NAT gateway feature
+  o cluster.conf  - Basic cluster setup
+  o natgw.conf    - Basic cluster setup with NAT gateway feature
+  o external.conf - Basic cluster setup with externally managed public IP addresses

diff --git a/ctdb/doc/examples/external.conf b/ctdb/doc/examples/external.conf
new file mode 100644 (file)
index 0000000..8354e5c
--- /dev/null
+++ b/ctdb/doc/examples/external.conf
@@ -0,0 +1,108 @@
+#
+# CTDB configuration for cluster with externally managed public IP addresses
+#
+# This is the sample configuration for a 3-node CTDB cluster providing file
+# services via Samba and NFS.
+#
+# Cluster details:
+#
+#                internal network (192.168.1.0/24)
+#   -------+----------------------+-----------------------+----------
+#          |                      |                       |
+#          |                      |                       |
+#     eth0 | 192.168.1.1     eth0 | 192.168.1.2      eth0 | 192.168.1.3
+#    +-----+-----+          +-----+-----+           +-----+-----+
+#    |           |          |           |           |           |
+#    |  Node 1   |          |  Node 2   |           |  Node 3   |
+#    |           |          |           |           |           |
+#    +-----+-----+          +-----+-----+           +-----+-----+
+#     eth1 | 10.1.1.1        eth1 | 10.1.1.2         eth1 | 10.1.1.3
+#          |                      |                       |
+#          |                      |                       |
+#   -------+----------------------+-----------------------+----------
+#                  public network (10.1.1.0/24)
+#
+#
+# Storage details:
+#
+#  Each node has a shared storage - /shared
+#
+#
+# Service details:
+#
+#  Cluster provides file services on following IP addresses
+#
+#     10.1.1.101 - 10.1.1.106
+#
+#  Each node also has a fixed IP address on public network.  This is used to
+#  communicate to network infrastructure (e.g. DNS, Active Directory, ...).
+#  Make sure that file services are not available on these fixed IP addresses
+#  (e.g. network filtering, using cluster hostname instead of IPs)
+
+
+CTDB_RECOVERY_LOCK=/shared/recovery.lock
+
+#
+# Nodes configuration
+#
+# ---------- /etc/ctdb/nodes ----------
+# 192.168.1.1
+# 192.168.1.2
+# 192.168.1.3
+# ---------- /etc/ctdb/nodes ----------
+#
+CTDB_NODES=/etc/ctdb/nodes
+
+#
+# Public addresses configuration
+#
+# ---------- /etc/ctdb/public_addresses ----------
+# 10.1.1.101/24 eth1
+# 10.1.1.102/24 eth1
+# 10.1.1.103/24 eth1
+# 10.1.1.104/24 eth1
+# 10.1.1.105/24 eth1
+# 10.1.1.106/24 eth1
+# ---------- /etc/ctdb/public_addresses ----------
+#
+CTDB_PUBLIC_ADDRESSES=/etc/ctdb/public_addresses
+
+#
+# Externally managed public IP addresses:
+#
+# This indicates that CTDB will not host/failover public IP addresses.
+# The addresses will need to be assigned/failed-over via some external
+# means.  Use "ctdb moveip" to inform CTDB of the IP
+# assignment/failover so that CTDB can do connection tracking/killing
+# correctly.
+#
+CTDB_SET_DisableIPFailover=1
+#
+# Also:
+#  ctdb disablescript 10.interface
+#  ctdb enablescript  10.external
+#
+
+# Enable logging to syslog
+CTDB_LOGGING=syslog
+
+# Default log level
+CTDB_DEBUGLEVEL=NOTICE
+
+# Auto start/stop managed services
+CTDB_AUTO_STARTSTOP=yes
+
+#
+# Samba configuration
+#
+CTDB_MANAGES_SAMBA=yes
+# CTDB_SAMBA_SKIP_SHARE_CHECK=yes
+
+CTDB_MANAGES_WINBIND=yes
+
+#
+# NFS configuration
+#
+CTDB_MANAGES_NFS=yes
+CTDB_RPCINFO_LOCALHOST="127.0.0.1"
+# CTDB_MONITOR_NFS_THREAD_COUNT=yes