docs-xml/smbdotconf/misc/ctdbtimeout.xml

   1 <samba:parameter name="ctdb timeout"
   2                  context="G"
   3                  type="integer"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6         <para>This parameter specifies a timeout in milliseconds for the
   7           connection between Samba and ctdb. It is only valid if you
   8           have compiled Samba with clustering and if you have
   9           set <parameter>clustering=yes</parameter>.
  10         </para>
  11         <para>When something in the cluster blocks, it can happen that
  12           we wait indefinitely long for ctdb, just adding to the
  13           blocking condition. In a well-running cluster this should
  14           never happen, but there are too many components in a cluster
  15           that might have hickups. Choosing the right balance for this
  16           value is very tricky, because on a busy cluster long service
  17           times to transfer something across the cluster might be
  18           valid. Setting it too short will degrade the service your
  19           cluster presents, setting it too long might make the cluster
  20           itself not recover from something severely broken for too
  21           long.
  22         </para>
  23         <para>
  24           Be aware that if you set this parameter, this needs to be in
  25           the file smb.conf, it is not really helpful to put this into
  26           a registry configuration (typical on a cluster), because to
  27           access the registry contact to ctdb is required.
  28         </para>
  29         <para>Setting <parameter>ctdb timeout</parameter> to n makes
  30           any process waiting longer than n milliseconds for a reply by the
  31           cluster panic. Setting it to 0 (the default) makes Samba
  32           block forever, which is the highly recommended default.
  33         </para>
  34 </description>
  35 <value type="default">0</value>
  36 </samba:parameter>