From 775f1ed045666f30e2b45512b30ed8e9a0df322a Mon Sep 17 00:00:00 2001 From: Volker Lendecke Date: Mon, 19 Jul 2010 12:35:58 +0200 Subject: [PATCH] s3-docs: Add more verbose description of "ctdb locktime warn threshold". --- .../smbdotconf/misc/ctdblocktimewarnthreshold.xml | 44 ++++++++++++++-------- 1 file changed, 28 insertions(+), 16 deletions(-) rewrite docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml (60%) diff --git a/docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml b/docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml dissimilarity index 60% index 149d8d67e3f..a3289a93bc4 100644 --- a/docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml +++ b/docs-xml/smbdotconf/misc/ctdblocktimewarnthreshold.xml @@ -1,16 +1,28 @@ - - - In a cluster, ctdb is very unhappy if tdb database locks - are held for extended periods of time. This parameter adds a - warning threshold in milliseconds. If Samba holds a lock for - longer that ctdb locktime warn threshold milliseconds, a debug - level 0 message is printed when the lock is released. This is - mainly a debugging aid for post-mortem analysis. - If this parameter is set to 0, no message is printed. - -0 - + + + + + In a cluster environment using Samba and ctdb it is critical + that locks on central ctdb-hosted databases like locking.tdb + are not held for long. With the current Samba architecture + it happens that Samba takes a lock and while holding that + lock makes file system calls into the shared cluster file + system. This option makes Samba warn if it detects that it + has held locks for the specified number of milliseconds. If + this happens, smbd will emit a debug level 0 + message into its logs and potentially into syslog. The most likely + reason for such a log message is that an operation of the cluster + file system Samba exports is taking longer than expected. + The messages are meant as a debugging aid for potential + cluster problems. + + + The default value of 0 disables this logging. + + +0 + -- 2.11.4.GIT