ctdb/doc/ctdb-tunables.7.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry
   3         PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   4         "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
   5
   6 <refentry id="ctdb-tunables.7">
   7
   8   <refmeta>
   9     <refentrytitle>ctdb-tunables</refentrytitle>
  10     <manvolnum>7</manvolnum>
  11     <refmiscinfo class="source">ctdb</refmiscinfo>
  12     <refmiscinfo class="manual">CTDB - clustered TDB database</refmiscinfo>
  13   </refmeta>
  14
  15   <refnamediv>
  16     <refname>ctdb-tunables</refname>
  17     <refpurpose>CTDB tunable configuration variables</refpurpose>
  18   </refnamediv>
  19
  20   <refsect1>
  21     <title>DESCRIPTION</title>
  22
  23     <para>
  24       CTDB's behaviour can be configured by setting run-time tunable
  25       variables.  This lists and describes all tunables.  See the
  26       <citerefentry><refentrytitle>ctdb</refentrytitle>
  27       <manvolnum>1</manvolnum></citerefentry>
  28       <command>listvars</command>, <command>setvar</command> and
  29       <command>getvar</command> commands for more details.
  30     </para>
  31
  32     <para>
  33       Unless otherwise stated, tunables should be set to the same
  34       value on all nodes.  Setting tunables to different values across
  35       nodes may produce unexpected results.  Future releases may set
  36       (some or most) tunables globally across the cluster but doing so
  37       is currently a manual process.
  38     </para>
  39
  40     <para>
  41       Tunables can be set at startup from the
  42       <filename>/usr/local/etc/ctdb/ctdb.tunables</filename>
  43       configuration file.
  44
  45       <literallayout>
  46 <replaceable>TUNABLE</replaceable>=<replaceable>VALUE</replaceable>
  47       </literallayout>
  48     </para>
  49
  50     <para>
  51       For example:
  52
  53       <screen format="linespecific">
  54 MonitorInterval=20
  55       </screen>
  56     </para>
  57
  58     <para>
  59       The available tunable variables are listed alphabetically below.
  60     </para>
  61
  62     <refsect2>
  63       <title>AllowClientDBAttach</title>
  64       <para>Default: 1</para>
  65       <para>
  66         When set to 0, clients are not allowed to attach to any databases.
  67         This can be used to temporarily block any new processes from
  68         attaching to and accessing the databases.  This is mainly used
  69         for detaching a volatile database using 'ctdb detach'.
  70       </para>
  71     </refsect2>
  72
  73     <refsect2>
  74       <title>AllowMixedVersions</title>
  75       <para>Default: 0</para>
  76       <para>
  77         CTDB will not allow incompatible versions to co-exist in
  78         a cluster.  If a version mismatch is found, then losing CTDB
  79         will shutdown.  To disable the incompatible version check,
  80         set this tunable to 1.
  81       </para>
  82       <para>
  83         For version checking, CTDB uses major and minor version.
  84         For example, CTDB 4.6.1 and CTDB CTDB 4.6.2 are matching versions;
  85         CTDB 4.5.x and CTDB 4.6.y do not match.
  86       </para>
  87       <para>
  88         CTDB with version check support will lose to CTDB without
  89         version check support.  Between two different CTDB versions with
  90         version check support, one running for less time will lose.
  91         If the running time for both CTDB versions with version check
  92         support is equal (to seconds), then the older version will lose.
  93         The losing CTDB daemon will shutdown.
  94       </para>
  95     </refsect2>
  96
  97     <refsect2>
  98       <title>AllowUnhealthyDBRead</title>
  99       <para>Default: 0</para>
 100       <para>
 101         When set to 1, ctdb allows database traverses to read unhealthy
 102         databases.  By default, ctdb does not allow reading records from
 103         unhealthy databases.
 104       </para>
 105     </refsect2>
 106
 107     <refsect2>
 108       <title>ControlTimeout</title>
 109       <para>Default: 60</para>
 110       <para>
 111         This is the default setting for timeout for when sending a
 112         control message to either the local or a remote ctdb daemon.
 113       </para>
 114     </refsect2>
 115
 116     <refsect2>
 117       <title>DatabaseHashSize</title>
 118       <para>Default: 100001</para>
 119       <para>
 120         Number of the hash chains for the local store of the tdbs that
 121         ctdb manages.
 122       </para>
 123     </refsect2>
 124
 125     <refsect2>
 126       <title>DatabaseMaxDead</title>
 127       <para>Default: 5</para>
 128       <para>
 129         Maximum number of dead records per hash chain for the tdb databses
 130         managed by ctdb.
 131       </para>
 132     </refsect2>
 133
 134     <refsect2>
 135       <title>DBRecordCountWarn</title>
 136       <para>Default: 100000</para>
 137       <para>
 138         When set to non-zero, ctdb will log a warning during recovery if
 139         a database has more than this many records. This will produce a
 140         warning if a database grows uncontrollably with orphaned records.
 141       </para>
 142     </refsect2>
 143
 144     <refsect2>
 145       <title>DBRecordSizeWarn</title>
 146       <para>Default: 10000000</para>
 147       <para>
 148         When set to non-zero, ctdb will log a warning during recovery
 149         if a single record is bigger than this size. This will produce
 150         a warning if a database record grows uncontrollably.
 151       </para>
 152     </refsect2>
 153
 154     <refsect2>
 155       <title>DBSizeWarn</title>
 156       <para>Default: 1000000000</para>
 157       <para>
 158         When set to non-zero, ctdb will log a warning during recovery if
 159         a database size is bigger than this. This will produce a warning
 160         if a database grows uncontrollably.
 161       </para>
 162     </refsect2>
 163
 164     <refsect2>
 165       <title>DeferredAttachTO</title>
 166       <para>Default: 120</para>
 167       <para>
 168         When databases are frozen we do not allow clients to attach to
 169         the databases. Instead of returning an error immediately to the
 170         client, the attach request from the client is deferred until
 171         the database becomes available again at which stage we respond
 172         to the client.
 173       </para>
 174       <para>
 175         This timeout controls how long we will defer the request from the
 176         client before timing it out and returning an error to the client.
 177       </para>
 178     </refsect2>
 179
 180     <refsect2>
 181       <title>DisableIPFailover</title>
 182       <para>Default: 0</para>
 183       <para>
 184         When set to non-zero, ctdb will not perform failover or
 185         failback. Even if a node fails while holding public IPs, ctdb
 186         will not recover the IPs or assign them to another node.
 187       </para>
 188       <para>
 189         When this tunable is enabled, ctdb will no longer attempt
 190         to recover the cluster by failing IP addresses over to other
 191         nodes. This leads to a service outage until the administrator
 192         has manually performed IP failover to replacement nodes using the
 193         'ctdb moveip' command.
 194       </para>
 195     </refsect2>
 196
 197     <refsect2>
 198       <title>ElectionTimeout</title>
 199       <para>Default: 3</para>
 200       <para>
 201         The number of seconds to wait for the election of recovery
 202         master to complete. If the election is not completed during this
 203         interval, then that round of election fails and ctdb starts a
 204         new election.
 205       </para>
 206     </refsect2>
 207
 208     <refsect2>
 209       <title>EnableBans</title>
 210       <para>Default: 1</para>
 211       <para>
 212         This parameter allows ctdb to ban a node if the node is misbehaving.
 213       </para>
 214       <para>
 215         When set to 0, this disables banning completely in the cluster
 216         and thus nodes can not get banned, even it they break. Don't
 217         set to 0 unless you know what you are doing.
 218       </para>
 219     </refsect2>
 220
 221     <refsect2>
 222       <title>EventScriptTimeout</title>
 223       <para>Default: 30</para>
 224       <para>
 225         Maximum time in seconds to allow an event to run before timing
 226         out.  This is the total time for all enabled scripts that are
 227         run for an event, not just a single event script.
 228       </para>
 229       <para>
 230         Note that timeouts are ignored for some events ("takeip",
 231         "releaseip", "startrecovery", "recovered") and converted to
 232         success.  The logic here is that the callers of these events
 233         implement their own additional timeout.
 234       </para>
 235     </refsect2>
 236
 237     <refsect2>
 238       <title>FetchCollapse</title>
 239       <para>Default: 1</para>
 240       <para>
 241        This parameter is used to avoid multiple migration requests for
 242        the same record from a single node. All the record requests for
 243        the same record are queued up and processed when the record is
 244        migrated to the current node.
 245       </para>
 246       <para>
 247         When many clients across many nodes try to access the same record
 248         at the same time this can lead to a fetch storm where the record
 249         becomes very active and bounces between nodes very fast. This
 250         leads to high CPU utilization of the ctdbd daemon, trying to
 251         bounce that record around very fast, and poor performance.
 252         This can improve performance and reduce CPU utilization for
 253         certain workloads.
 254       </para>
 255     </refsect2>
 256
 257     <refsect2>
 258       <title>HopcountMakeSticky</title>
 259       <para>Default: 50</para>
 260       <para>
 261         For database(s) marked STICKY (using 'ctdb setdbsticky'),
 262         any record that is migrating so fast that hopcount
 263         exceeds this limit is marked as STICKY record for
 264         <varname>StickyDuration</varname> seconds. This means that
 265         after each migration the sticky record will be kept on the node
 266         <varname>StickyPindown</varname>milliseconds and prevented from
 267         being migrated off the node.
 268        </para>
 269        <para>
 270         This will improve performance for certain workloads, such as
 271         locking.tdb if many clients are opening/closing the same file
 272         concurrently.
 273       </para>
 274     </refsect2>
 275
 276     <refsect2>
 277       <title>IPAllocAlgorithm</title>
 278       <para>Default: 2</para>
 279       <para>
 280         Selects the algorithm that CTDB should use when doing public
 281         IP address allocation.  Meaningful values are:
 282       </para>
 283       <variablelist>
 284         <varlistentry>
 285           <term>0</term>
 286           <listitem>
 287             <para>
 288               Deterministic IP address allocation.
 289             </para>
 290             <para>
 291               This is a simple and fast option.  However, it can cause
 292               unnecessary address movement during fail-over because
 293               each address has a "home" node.  Works badly when some
 294               nodes do not have any addresses defined.  Should be used
 295               with care when addresses are defined across multiple
 296               networks.
 297             </para>
 298           </listitem>
 299         </varlistentry>
 300         <varlistentry>
 301           <term>1</term>
 302           <listitem>
 303             <para>
 304               Non-deterministic IP address allocation.
 305             </para>
 306             <para>
 307               This is a relatively fast option that attempts to do a
 308               minimise unnecessary address movements.  Addresses do
 309               not have a "home" node.  Rebalancing is limited but it
 310               usually adequate.  Works badly when addresses are
 311               defined across multiple networks.
 312             </para>
 313           </listitem>
 314         </varlistentry>
 315         <varlistentry>
 316           <term>2</term>
 317           <listitem>
 318             <para>
 319               LCP2 IP address allocation.
 320             </para>
 321             <para>
 322               Uses a heuristic to assign addresses defined across
 323               multiple networks, usually balancing addresses on each
 324               network evenly across nodes.  Addresses do not have a
 325               "home" node.  Minimises unnecessary address movements.
 326               The algorithm is complex, so is slower than other
 327               choices for a large number of addresses.  However, it
 328               can calculate an optimal assignment of 900 addresses in
 329               under 10 seconds on modern hardware.
 330             </para>
 331           </listitem>
 332         </varlistentry>
 333       </variablelist>
 334       <para>
 335         If the specified value is not one of these then the default
 336         will be used.
 337       </para>
 338     </refsect2>
 339
 340     <refsect2>
 341       <title>KeepaliveInterval</title>
 342       <para>Default: 5</para>
 343       <para>
 344         How often in seconds should the nodes send keep-alive packets to
 345         each other.
 346       </para>
 347     </refsect2>
 348
 349     <refsect2>
 350       <title>KeepaliveLimit</title>
 351       <para>Default: 5</para>
 352       <para>
 353         After how many keepalive intervals without any traffic should
 354         a node wait until marking the peer as DISCONNECTED.
 355        </para>
 356        <para>
 357         If a node has hung, it can take
 358         <varname>KeepaliveInterval</varname> *
 359         (<varname>KeepaliveLimit</varname> + 1) seconds before
 360         ctdb determines that the node is DISCONNECTED and performs
 361         a recovery. This limit should not be set too high to enable
 362         early detection and avoid any application timeouts (e.g. SMB1)
 363         to kick in before the fail over is completed.
 364       </para>
 365     </refsect2>
 366
 367     <refsect2>
 368       <title>LockProcessesPerDB</title>
 369       <para>Default: 200</para>
 370       <para>
 371         This is the maximum number of lock helper processes ctdb will
 372         create for obtaining record locks.  When ctdb cannot get a record
 373         lock without blocking, it creates a helper process that waits
 374         for the lock to be obtained.
 375       </para>
 376     </refsect2>
 377
 378     <refsect2>
 379       <title>LogLatencyMs</title>
 380       <para>Default: 0</para>
 381       <para>
 382         When set to non-zero, ctdb will log if certains operations
 383         take longer than this value, in milliseconds, to complete.
 384         These operations include "process a record request from client",
 385         "take a record or database lock", "update a persistent database
 386         record" and "vaccum a database".
 387       </para>
 388     </refsect2>
 389
 390     <refsect2>
 391       <title>MaxQueueDropMsg</title>
 392       <para>Default: 1000000</para>
 393       <para>
 394         This is the maximum number of messages to be queued up for
 395         a client before ctdb will treat the client as hung and will
 396         terminate the client connection.
 397       </para>
 398     </refsect2>
 399
 400     <refsect2>
 401       <title>MonitorInterval</title>
 402       <para>Default: 15</para>
 403       <para>
 404         How often should ctdb run the 'monitor' event in seconds to check
 405         for a node's health.
 406       </para>
 407     </refsect2>
 408
 409     <refsect2>
 410       <title>MonitorTimeoutCount</title>
 411       <para>Default: 20</para>
 412       <para>
 413         How many 'monitor' events in a row need to timeout before a node
 414         is flagged as UNHEALTHY.  This setting is useful if scripts can
 415         not be written so that they do not hang for benign reasons.
 416       </para>
 417     </refsect2>
 418
 419     <refsect2>
 420       <title>NoIPFailback</title>
 421       <para>Default: 0</para>
 422       <para>
 423         When set to 1, ctdb will not perform failback of IP addresses
 424         when a node becomes healthy. When a node becomes UNHEALTHY,
 425         ctdb WILL perform failover of public IP addresses, but when the
 426         node becomes HEALTHY again, ctdb will not fail the addresses back.
 427       </para>
 428       <para>
 429         Use with caution! Normally when a node becomes available to the
 430         cluster ctdb will try to reassign public IP addresses onto the
 431         new node as a way to distribute the workload evenly across the
 432         clusternode. Ctdb tries to make sure that all running nodes have
 433         approximately the same number of public addresses it hosts.
 434       </para>
 435       <para>
 436         When you enable this tunable, ctdb will no longer attempt to
 437         rebalance the cluster by failing IP addresses back to the new
 438         nodes. An unbalanced cluster will therefore remain unbalanced
 439         until there is manual intervention from the administrator. When
 440         this parameter is set, you can manually fail public IP addresses
 441         over to the new node(s) using the 'ctdb moveip' command.
 442       </para>
 443     </refsect2>
 444
 445     <refsect2>
 446       <title>NoIPTakeover</title>
 447       <para>Default: 0</para>
 448       <para>
 449         When set to 1, ctdb will not allow IP addresses to be failed
 450         over to other nodes.  Any IP addresses already hosted on
 451         healthy nodes will remain.  Any IP addresses hosted on
 452         unhealthy nodes will be released by unhealthy nodes and will
 453         become un-hosted.
 454       </para>
 455     </refsect2>
 456
 457     <refsect2>
 458       <title>PullDBPreallocation</title>
 459       <para>Default: 10*1024*1024</para>
 460       <para>
 461         This is the size of a record buffer to pre-allocate for sending
 462         reply to PULLDB control. Usually record buffer starts with size
 463         of the first record and gets reallocated every time a new record
 464         is added to the record buffer. For a large number of records,
 465         this can be very inefficient to grow the record buffer one record
 466         at a time.
 467       </para>
 468     </refsect2>
 469
 470     <refsect2>
 471       <title>QueueBufferSize</title>
 472       <para>Default: 1024</para>
 473       <para>
 474         This is the maximum amount of data (in bytes) ctdb will read
 475         from a socket at a time.
 476       </para>
 477       <para>
 478         For a busy setup, if ctdb is not able to process the TCP sockets
 479         fast enough (large amount of data in Recv-Q for tcp sockets),
 480         then this tunable value should be increased.  However, large
 481         values can keep ctdb busy processing packets and prevent ctdb
 482         from handling other events.
 483       </para>
 484     </refsect2>
 485
 486     <refsect2>
 487       <title>RecBufferSizeLimit</title>
 488       <para>Default: 1000000</para>
 489       <para>
 490         This is the limit on the size of the record buffer to be sent
 491         in various controls.  This limit is used by new controls used
 492         for recovery and controls used in vacuuming.
 493       </para>
 494     </refsect2>
 495
 496     <refsect2>
 497       <title>RecdFailCount</title>
 498       <para>Default: 10</para>
 499       <para>
 500         If the recovery daemon has failed to ping the main dameon for
 501         this many consecutive intervals, the main daemon will consider
 502         the recovery daemon as hung and will try to restart it to recover.
 503       </para>
 504     </refsect2>
 505
 506     <refsect2>
 507       <title>RecdPingTimeout</title>
 508       <para>Default: 60</para>
 509       <para>
 510         If the main dameon has not heard a "ping" from the recovery dameon
 511         for this many seconds, the main dameon will log a message that
 512         the recovery daemon is potentially hung.  This also increments a
 513         counter which is checked against <varname>RecdFailCount</varname>
 514         for detection of hung recovery daemon.
 515       </para>
 516     </refsect2>
 517
 518     <refsect2>
 519       <title>RecLockLatencyMs</title>
 520       <para>Default: 1000</para>
 521       <para>
 522         When using a reclock file for split brain prevention, if set
 523         to non-zero this tunable will make the recovery dameon log a
 524         message if the fcntl() call to lock/testlock the recovery file
 525         takes longer than this number of milliseconds.
 526       </para>
 527     </refsect2>
 528
 529     <refsect2>
 530       <title>RecoverInterval</title>
 531       <para>Default: 1</para>
 532       <para>
 533         How frequently in seconds should the recovery daemon perform the
 534         consistency checks to determine if it should perform a recovery.
 535       </para>
 536     </refsect2>
 537
 538     <refsect2>
 539       <title>RecoverTimeout</title>
 540       <para>Default: 120</para>
 541       <para>
 542         This is the default setting for timeouts for controls when sent
 543         from the recovery daemon. We allow longer control timeouts from
 544         the recovery daemon than from normal use since the recovery
 545         dameon often use controls that can take a lot longer than normal
 546         controls.
 547       </para>
 548     </refsect2>
 549
 550     <refsect2>
 551       <title>RecoveryBanPeriod</title>
 552       <para>Default: 300</para>
 553       <para>
 554        The duration in seconds for which a node is banned if the node
 555        fails during recovery.  After this time has elapsed the node will
 556        automatically get unbanned and will attempt to rejoin the cluster.
 557       </para>
 558       <para>
 559        A node usually gets banned due to real problems with the node.
 560        Don't set this value too small.  Otherwise, a problematic node
 561        will try to re-join cluster too soon causing unnecessary recoveries.
 562       </para>
 563     </refsect2>
 564
 565     <refsect2>
 566       <title>RecoveryDropAllIPs</title>
 567       <para>Default: 120</para>
 568       <para>
 569         If a node is stuck in recovery, or stopped, or banned, for this
 570         many seconds, then ctdb will release all public addresses on
 571         that node.
 572       </para>
 573     </refsect2>
 574
 575     <refsect2>
 576       <title>RecoveryGracePeriod</title>
 577       <para>Default: 120</para>
 578       <para>
 579        During recoveries, if a node has not caused recovery failures
 580        during the last grace period in seconds, any records of
 581        transgressions that the node has caused recovery failures will be
 582        forgiven. This resets the ban-counter back to zero for that node.
 583       </para>
 584     </refsect2>
 585
 586     <refsect2>
 587       <title>RepackLimit</title>
 588       <para>Default: 10000</para>
 589       <para>
 590         During vacuuming, if the number of freelist records are more than
 591         <varname>RepackLimit</varname>, then the database is repacked
 592         to get rid of the freelist records to avoid fragmentation.
 593       </para>
 594       <para>
 595         Databases are repacked only if both <varname>RepackLimit</varname>
 596         and <varname>VacuumLimit</varname> are exceeded.
 597       </para>
 598     </refsect2>
 599
 600     <refsect2>
 601       <title>RerecoveryTimeout</title>
 602       <para>Default: 10</para>
 603       <para>
 604         Once a recovery has completed, no additional recoveries are
 605         permitted until this timeout in seconds has expired.
 606       </para>
 607     </refsect2>
 608
 609     <refsect2>
 610       <title>SeqnumInterval</title>
 611       <para>Default: 1000</para>
 612       <para>
 613         Some databases have seqnum tracking enabled, so that samba will
 614         be able to detect asynchronously when there has been updates
 615         to the database.  Every time a database is updated its sequence
 616         number is increased.
 617       </para>
 618       <para>
 619         This tunable is used to specify in milliseconds how frequently
 620         ctdb will send out updates to remote nodes to inform them that
 621         the sequence number is increased.
 622       </para>
 623     </refsect2>
 624
 625     <refsect2>
 626       <title>StatHistoryInterval</title>
 627       <para>Default: 1</para>
 628       <para>
 629         Granularity of the statistics collected in the statistics
 630         history. This is reported by 'ctdb stats' command.
 631       </para>
 632     </refsect2>
 633
 634     <refsect2>
 635       <title>StickyDuration</title>
 636       <para>Default: 600</para>
 637       <para>
 638         Once a record has been marked STICKY, this is the duration in
 639         seconds, the record will be flagged as a STICKY record.
 640       </para>
 641     </refsect2>
 642
 643     <refsect2>
 644       <title>StickyPindown</title>
 645       <para>Default: 200</para>
 646       <para>
 647         Once a STICKY record has been migrated onto a node, it will be
 648         pinned down on that node for this number of milliseconds. Any
 649         request from other nodes to migrate the record off the node will
 650         be deferred.
 651       </para>
 652     </refsect2>
 653
 654     <refsect2>
 655       <title>TakeoverTimeout</title>
 656       <para>Default: 9</para>
 657       <para>
 658         This is the duration in seconds in which ctdb tries to complete IP
 659         failover.
 660       </para>
 661     </refsect2>
 662
 663     <refsect2>
 664       <title>TDBMutexEnabled</title>
 665       <para>Default: 1</para>
 666       <para>
 667         This parameter enables TDB_MUTEX_LOCKING feature on volatile
 668         databases if the robust mutexes are supported. This optimizes the
 669         record locking using robust mutexes and is much more efficient
 670         that using posix locks.
 671       </para>
 672     </refsect2>
 673
 674     <refsect2>
 675       <title>TickleUpdateInterval</title>
 676       <para>Default: 20</para>
 677       <para>
 678         Every <varname>TickleUpdateInterval</varname> seconds, ctdb
 679         synchronizes the client connection information across nodes.
 680       </para>
 681     </refsect2>
 682
 683     <refsect2>
 684       <title>TraverseTimeout</title>
 685       <para>Default: 20</para>
 686       <para>
 687         This is the duration in seconds for which a database traverse
 688         is allowed to run.  If the traverse does not complete during
 689         this interval, ctdb will abort the traverse.
 690       </para>
 691     </refsect2>
 692
 693     <refsect2>
 694       <title>VacuumFastPathCount</title>
 695       <para>Default: 60</para>
 696       <para>
 697        During a vacuuming run, ctdb usually processes only the records
 698        marked for deletion also called the fast path vacuuming. After
 699        finishing <varname>VacuumFastPathCount</varname> number of fast
 700        path vacuuming runs, ctdb will trigger a scan of complete database
 701        for any empty records that need to be deleted.
 702       </para>
 703     </refsect2>
 704
 705     <refsect2>
 706       <title>VacuumInterval</title>
 707       <para>Default: 10</para>
 708       <para>
 709         Periodic interval in seconds when vacuuming is triggered for
 710         volatile databases.
 711       </para>
 712     </refsect2>
 713
 714     <refsect2>
 715       <title>VacuumLimit</title>
 716       <para>Default: 5000</para>
 717       <para>
 718         During vacuuming, if the number of deleted records are more than
 719         <varname>VacuumLimit</varname>, then databases are repacked to
 720         avoid fragmentation.
 721       </para>
 722       <para>
 723         Databases are repacked only if both <varname>RepackLimit</varname>
 724         and <varname>VacuumLimit</varname> are exceeded.
 725       </para>
 726     </refsect2>
 727
 728     <refsect2>
 729       <title>VacuumMaxRunTime</title>
 730       <para>Default: 120</para>
 731       <para>
 732         The maximum time in seconds for which the vacuuming process is
 733         allowed to run.  If vacuuming process takes longer than this
 734         value, then the vacuuming process is terminated.
 735       </para>
 736     </refsect2>
 737
 738     <refsect2>
 739       <title>VerboseMemoryNames</title>
 740       <para>Default: 0</para>
 741       <para>
 742         When set to non-zero, ctdb assigns verbose names for some of
 743         the talloc allocated memory objects.  These names are visible
 744         in the talloc memory report generated by 'ctdb dumpmemory'.
 745       </para>
 746     </refsect2>
 747
 748   </refsect1>
 749
 750   <refsect1>
 751     <title>FILES></title>
 752
 753     <simplelist>
 754       <member><filename>/usr/local/etc/ctdb/ctdb.tunables</filename></member>
 755     </simplelist>
 756   </refsect1>
 757
 758   <refsect1>
 759     <title>SEE ALSO</title>
 760     <para>
 761       <citerefentry><refentrytitle>ctdb</refentrytitle>
 762       <manvolnum>1</manvolnum></citerefentry>,
 763
 764       <citerefentry><refentrytitle>ctdbd</refentrytitle>
 765       <manvolnum>1</manvolnum></citerefentry>,
 766
 767       <citerefentry><refentrytitle>ctdb.conf</refentrytitle>
 768       <manvolnum>5</manvolnum></citerefentry>,
 769
 770       <citerefentry><refentrytitle>ctdb</refentrytitle>
 771       <manvolnum>7</manvolnum></citerefentry>,
 772
 773       <ulink url="http://ctdb.samba.org/"/>
 774     </para>
 775   </refsect1>
 776
 777   <refentryinfo>
 778     <author>
 779       <contrib>
 780         This documentation was written by
 781         Ronnie Sahlberg,
 782         Amitay Isaacs,
 783         Martin Schwenke
 784       </contrib>
 785     </author>
 786
 787     <copyright>
 788       <year>2007</year>
 789       <holder>Andrew Tridgell</holder>
 790       <holder>Ronnie Sahlberg</holder>
 791     </copyright>
 792     <legalnotice>
 793       <para>
 794         This program is free software; you can redistribute it and/or
 795         modify it under the terms of the GNU General Public License as
 796         published by the Free Software Foundation; either version 3 of
 797         the License, or (at your option) any later version.
 798       </para>
 799       <para>
 800         This program is distributed in the hope that it will be
 801         useful, but WITHOUT ANY WARRANTY; without even the implied
 802         warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 803         PURPOSE.  See the GNU General Public License for more details.
 804       </para>
 805       <para>
 806         You should have received a copy of the GNU General Public
 807         License along with this program; if not, see
 808         <ulink url="http://www.gnu.org/licenses"/>.
 809       </para>
 810     </legalnotice>
 811   </refentryinfo>
 812
 813 </refentry>