summaryrefslogtreecommitdiff
path: root/docs-xml
diff options
context:
space:
mode:
authorVolker Lendecke <vl@samba.org>2009-11-03 05:41:02 +0100
committerVolker Lendecke <vl@samba.org>2009-11-05 12:05:36 +0100
commitd415d4d32f2e8e61de21abfdfce02e1b1ea1e1d3 (patch)
tree03469f109c8e19e15318e5fa4da6d7526b6a575f /docs-xml
parent49397a8b3e30b23a4723125986f306fff502a144 (diff)
downloadsamba-d415d4d32f2e8e61de21abfdfce02e1b1ea1e1d3.tar.gz
samba-d415d4d32f2e8e61de21abfdfce02e1b1ea1e1d3.tar.bz2
samba-d415d4d32f2e8e61de21abfdfce02e1b1ea1e1d3.zip
s3: Add parameter "ctdb timeout"
When something in the cluster blocks, it can happen that we wait indefinitely long for ctdb, just adding to the blocking condition. In theory, nothing should block, but as someone said "In practice the difference between theory and practice is larger than in theory". This adds a timeout parameter in seconds, after which we stop waiting for ctdb and panic.
Diffstat (limited to 'docs-xml')
-rw-r--r--docs-xml/smbdotconf/misc/ctdbtimeout.xml37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs-xml/smbdotconf/misc/ctdbtimeout.xml b/docs-xml/smbdotconf/misc/ctdbtimeout.xml
new file mode 100644
index 0000000000..97d5039000
--- /dev/null
+++ b/docs-xml/smbdotconf/misc/ctdbtimeout.xml
@@ -0,0 +1,37 @@
+<samba:parameter name="ctdb timeout"
+ context="G"
+ type="integer"
+ advanced="1"
+ xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+ <para>This parameter specifies a timeout in seconds for the
+ connection between Samba and ctdb. It is only valid if you
+ have compiled Samba with clustering and if you have
+ set <parameter>clustering=yes</parameter>.
+ </para>
+ <para>When something in the cluster blocks, it can happen that
+ we wait indefinitely long for ctdb, just adding to the
+ blocking condition. In a well-running cluster this should
+ never happen, but there are too many components in a cluster
+ that might have hickups. Choosing the right balance for this
+ value is very tricky, because on a busy cluster long service
+ times to transfer something across the cluster might be
+ valid. Setting it too short will degrade the service your
+ cluster presents, setting it too long might make the cluster
+ itself not recover from something severely broken for too
+ long.
+ </para>
+ <para>
+ Be aware that if you set this parameter, this needs to be in
+ the file smb.conf, it is not really helpful to put this into
+ a registry configuration (typical on a cluster), because to
+ access the registry contact to ctdb is requred.
+ </para>
+ <para>Setting <parameter>ctdb timeout</parameter> to n makes
+ any process waiting longer than n seconds for a reply by the
+ cluster panic. Setting it to 0 (the default) makes Samba
+ block forever, which is the highly recommended default.
+ </para>
+</description>
+<value type="default">0</value>
+</samba:parameter>