diff options
| author | Volker Lendecke <vl@samba.org> | 2009-11-03 05:41:02 +0100 |
|---|---|---|
| committer | Karolin Seeger <kseeger@samba.org> | 2009-11-26 11:40:12 +0100 |
| commit | 68191ad0abbf55abd9b800878a0bc9584a01d72e (patch) | |
| tree | 68f87440a30d1dab37765ed8d01d27e7c413a401 /docs-xml | |
| parent | 9ddcdadc22784f78d9403b525c990dbb976bc6d6 (diff) | |
| download | samba-68191ad0abbf55abd9b800878a0bc9584a01d72e.tar.gz | |
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.
(cherry picked from commit 872f59be48e61b0dc874aef72f96a46e8936d86d)
Diffstat (limited to 'docs-xml')
| -rw-r--r-- | docs-xml/smbdotconf/misc/ctdbtimeout.xml | 37 |
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 00000000000..97d50390000 --- /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> |