From a840602cd8a4645bdfdd73e67adb16a0eb12de54 Mon Sep 17 00:00:00 2001 From: Ronnie Sahlberg Date: Thu, 5 Jul 2007 10:17:46 +1000 Subject: break the tickle description into two paragraphs (This used to be ctdb commit 3bde3c68b965e704281c5a8c57505a7f76cd4612) --- ctdb/doc/ctdb.1 | 4 +++- ctdb/doc/ctdb.1.html | 26 +++++++++++++------------- ctdb/doc/ctdb.1.xml | 3 ++- 3 files changed, 18 insertions(+), 15 deletions(-) (limited to 'ctdb/doc') diff --git a/ctdb/doc/ctdb.1 b/ctdb/doc/ctdb.1 index 4e7ce4ac1c..256687449a 100644 --- a/ctdb/doc/ctdb.1 +++ b/ctdb/doc/ctdb.1 @@ -322,7 +322,9 @@ This command will trigger the recovery daemon to do a cluster recovery. This command will kill the specified TCP connection by issuing a TCP RST to the srcip:port endpoint. .SS "tickle " .PP -This command will will send a TCP tickle to the source host for the specified TCP connection. A TCP tickle is a TCP ACK packet with an invalis sequence and acknowledge number and will when received by the source host result in it sending an immediate correct ACK back to the other end. TCP tickles are useful to "tickle" clients after a ip failover has occured since this will make the client immediately recognize the tcp connection has been disrupted and that the client will need to reestablish. This greatly speeds up the time it takes for a client to detect and reestablish after an ip failover in the ctdb cluster. +This command will will send a TCP tickle to the source host for the specified TCP connection. A TCP tickle is a TCP ACK packet with an invalis sequence and acknowledge number and will when received by the source host result in it sending an immediate correct ACK back to the other end. +.PP +TCP tickles are useful to "tickle" clients after a ip failover has occured since this will make the client immediately recognize the tcp connection has been disrupted and that the client will need to reestablish. This greatly speeds up the time it takes for a client to detect and reestablish after an ip failover in the ctdb cluster. .SH "DEBUGGING COMMANDS" .PP These commands are primarily used for CTDB development and testing and should not be used for normal administration. diff --git a/ctdb/doc/ctdb.1.html b/ctdb/doc/ctdb.1.html index cb932112ab..a5e8c77c27 100644 --- a/ctdb/doc/ctdb.1.html +++ b/ctdb/doc/ctdb.1.html @@ -208,18 +208,18 @@ CTDB version 1 A TCP tickle is a TCP ACK packet with an invalis sequence and acknowledge number and will when received by the source host result in it sending an immediate correct ACK back to the other end. - +

TCP tickles are useful to "tickle" clients after a ip failover has occured since this will make the client immediately recognize the tcp connection has been disrupted and that the client will need to reestablish. This greatly speeds up the time it takes for a client to detect and reestablish after an ip failover in the ctdb cluster. -

Debugging Commands

+

Debugging Commands

These commands are primarily used for CTDB development and testing and should not be used for normal administration. -

process-exists <pid>

+

process-exists <pid>

This command checks if a specific process exists on the CTDB host. This is mainly used by Samba to check if remote instances of samba are still running or not. -

getdbmap

+

getdbmap

This command lists all clustered TDB databases that the CTDB daemon has attahced to.

Example: ctdb getdbmap @@ -231,21 +231,21 @@ dbid:0x42fe72c5 name:locking.tdb path:/var/ctdb/locking.tdb.0 dbid:0x1421fb78 name:brlock.tdb path:/var/ctdb/brlock.tdb.0 dbid:0x17055d90 name:connections.tdb path:/var/ctdb/connections.tdb.0 dbid:0xc0bdde6a name:sessionid.tdb path:/var/ctdb/sessionid.tdb.0 -

catdb <dbname>

+

catdb <dbname>

This command will dump a clustered TDB database to the screen. This is a debugging command. -

getmonmode

+

getmonmode

This command returns the monutoring mode of a node. The monitoring mode is either ACTIVE or DISABLED. Normally a node will continously monitor that all other nodes that are expected are in fact connected and that they respond to commands.

ACTIVE - This is the normal mode. The node is actively monitoring all other nodes, both that the transport is connected and also that the node responds to commands. If a node becomes unavailable, it will be marked as DISCONNECTED and a recovery is initiated to restore the cluster.

DISABLED - This node is not monitoring that other nodes are available. In this mode a node failure will not be detected and no recovery will be performed. This mode is useful when for debugging purposes one wants to attach GDB to a ctdb process but wants to prevent the rest of the cluster from marking this node as DISCONNECTED and do a recovery. -

setmonmode <0|1>

+

setmonmode <0|1>

This command can be used to explicitely disable/enable monitoring mode on a node. The main purpose is if one wants to attach GDB to a running ctdb daemon but wants to prevent the other nodes from marking it as DISCONNECTED and issuing a recovery. To do this, set monitoring mode to 0 on all nodes before attaching with GDB. Remember to set monitoring mode back to 1 afterwards. -

attach <dbname>

+

attach <dbname>

This is a debugging command. This command will make the CTDB daemon create a new CTDB database and attach to it. -

dumpmemory

+

dumpmemory

This is a debugging command. This command will make the ctdb daemon to write a fill memory allocation map to the log file. -

freeze

+

freeze

This command will lock all the local TDB databases causing clients that are accessing these TDBs such as samba3 to block until the databases are thawed. @@ -253,12 +253,12 @@ dbid:0xc0bdde6a name:sessionid.tdb path:/var/ctdb/sessionid.tdb.0 This is primarily used by the recovery daemon to stop all samba daemons from accessing any databases while the database is recovered and rebuilt. -

thaw

+

thaw

Thaw a previously frozen node. -

SEE ALSO

+

SEE ALSO

ctdbd(1), onnode(1) http://ctdb.samba.org/ -

COPYRIGHT/LICENSE


+

COPYRIGHT/LICENSE


Copyright (C) Andrew Tridgell 2007
Copyright (C) Ronnie sahlberg 2007

diff --git a/ctdb/doc/ctdb.1.xml b/ctdb/doc/ctdb.1.xml index dd7a5e4a84..43ca4b6b51 100644 --- a/ctdb/doc/ctdb.1.xml +++ b/ctdb/doc/ctdb.1.xml @@ -423,7 +423,8 @@ CTDB version 1 A TCP tickle is a TCP ACK packet with an invalis sequence and acknowledge number and will when received by the source host result in it sending an immediate correct ACK back to the other end. - + + TCP tickles are useful to "tickle" clients after a ip failover has occured since this will make the client immediately recognize the tcp connection has been disrupted and that the client will need -- cgit