docs-xml/smbdotconf/misc/ctdbtimeout.xml

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