summaryrefslogtreecommitdiffstats
path: root/docs-xml/smbdotconf/misc/ctdbtimeout.xml
blob: b02b2c8a3c388257df55ba4b5f2903b69384cf0b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<samba:parameter name="ctdb timeout"
                 context="G"
                 type="integer"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
	<para>This parameter specifies a timeout in milliseconds 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 required.
	</para>
	<para>Setting <parameter>ctdb timeout</parameter> to n makes
	  any process waiting longer than n milliseconds 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>