------------------------------------------------------------
revno: 444
revision-id: [EMAIL PROTECTED]
parent: [EMAIL PROTECTED]
committer: Andrew Tridgell <[EMAIL PROTECTED]>
branch nick: tridge
timestamp: Sun 2007-06-03 15:56:23 +1000
message:
web page tidy ups
modified:
web/ctdb.html ctdb.html-20070601052353-vgod9lfo4an4o83j-2
=== modified file 'web/ctdb.html'
--- a/web/ctdb.html 2007-06-03 01:48:13 +0000
+++ b/web/ctdb.html 2007-06-03 05:56:23 +0000
@@ -7,75 +7,128 @@
<h1>CTDB</h1>
-CTDB is a cluster implementation of the TDB database used by samba and other
-projects to store temporary data.<br>
-
-CTDB provides the same functions as TDB but with the difference that it is
-clustered and thus it appears as a TDB database that spans multiple physical
-hosts in a cluster.<br>
-
-CTDB provides a TDB that has consistent data and consistent locking across
-all nodes in a cluster.<br>
-
-CTDB is fast. Very fast.<br>
-
-In case of node failures, CTDB will automatically recover and repair all TDB
databases that it manages.<br>
-
-If an application is already using TDB for temporary data it is very easy to
convert that application to be cluster aware and use CTDB instead.<br>
-
-CTDB is the core component that provides <strong>pCIFS</strong> with
samba3/4.<br><br>
-
-CTDB provides HA features such as node monitoring, node failover, and ip
takeover.<br><br>
-
-CTDB provides a messaging transport to allow applications linked with CTDB to
communicate to other instances of the application running on different nodes in
the cluster. Allowing an easy to use mechanism for an application running on
one node in the cluster to communicate with an application running on a
different node.
+CTDB is a cluster implementation of the TDB database used by Samba and
+other projects to store temporary data. If an application is already
+using TDB for temporary data it is very easy to convert that
+application to be cluster aware and use CTDB instead.
+
+<p>CTDB provides the same types of functions as TDB but with the
+difference that it is clustered and thus it appears as a TDB database
+that spans multiple physical hosts in a cluster.
+
+<p>Features include:
+<ul>
+<li>CTDB provides a TDB that has consistent data and consistent locking across
+all nodes in a cluster.
+<li>CTDB is very fast.
+<li>In case of node failures, CTDB will automatically recover and
+ repair all TDB databases that it manages.
+<li>CTDB is the core component that provides <strong>pCIFS</strong>
+("parallel CIFS") with Samba3/4.
+<li>CTDB provides HA features such as node monitoring, node failover,
+ and IP takeover.
+<li>CTDB provides a reliable messaging transport to allow applications
+ linked with CTDB to communicate to other instances of the application
+ running on different nodes in the cluster.
+<li>CTDB has pluggable transport backends. Currently implemented backends are
TCP
+ and Infiniband.
+<li>CTDB supports a system of application specific management scripts,
+ allowing applications that depend on network or filesystem resources
+ to be managed in a highly available manner on a cluster.
+</ul>
<h2>Requirements</h2>
-CTDB relies on that a clustered filesystem is available and shared on all
nodes that participate in the CTDB cluster.<br>
-This filesystem must be mounted and available on all nodes in the CTDB
cluster.<br><br>
-Ontop of this cluster filesystem, CTDB then provides clustered HA features so
that data from the clustered filesystem can be exported through multiple nodes
in the CTDB cluster using various services.<br><br>
-Currently this is used to export data off a clustered filesystem using
SMB/CIFS and NFS to clients.
+
+CTDB relies on that a clustered filesystem is available and shared on
+all nodes that participate in the CTDB cluster. This filesystem must
+be mounted and available on all nodes in the CTDB cluster.
+
+<p>On top of this cluster filesystem, CTDB then provides clustered HA
+features so that data from the clustered filesystem can be exported
+through multiple nodes in the CTDB cluster using various
+services. Currently this is used to export data off a clustered
+filesystem using Samba (for SMB/CIFS) and NFS to Windows and Unix
+clients.
<h2>TDB</h2>
-TDB is a very fast simple database that was originally developed for use in
samba. Today many other projects use TDB to store its data.
-
-See <a
href="http://viewcvs.samba.org/cgi-bin/viewcvs.cgi/branches/SAMBA_4_0/source/lib/tdb/docs/README";>TDB
README file</a> for some description of how TDB is used.
+
+TDB is a very fast simple database that was originally developed for
+use in Samba. Today several other projects use TDB to store their data.
+
+<p>See <a
+href="http://viewcvs.samba.org/cgi-bin/viewcvs.cgi/branches/SAMBA_4_0/source/lib/tdb/docs/README";>TDB
+README file</a> for some description of how TDB is used.
<h2>Getting Started</h2>
To get started with ctdb, I would recommend you read <a
href="http://wiki.samba.org/index.php/CTDB_Setup";>the ctdb wiki</a>.
<h2>HA Features</h2>
-The CTDB node sin a cluster designates one node as a recovery master through
an election process.<br>
-If the recovery master node fail a new election is initiated so that the
cluster will always guarantee there will be a recovery master.<br>
-The recovery master will continously monitor the cluster to verify that all
nodes contain a consistent configuration and view of the cluster and will
initiate a recovery process when required.<br>
-During the recovery phase, the recovery master will automatically
rebuild/recover all clustered TDB database to ensure that the databases are
consistent.
+
+The CTDB nodes in a cluster designates one node as a recovery master
+through an election process. If the recovery master node fail a
+new election is initiated so that the cluster will always guarantee
+there will be a recovery master. The recovery master will
+continuously monitor the cluster to verify that all nodes contain a
+consistent configuration and view of the cluster and will initiate a
+recovery process when required.
+
+<p>During the recovery phase, the recovery master will automatically
+rebuild/recover all clustered TDB database to ensure that the
+databases are consistent. Recovery typically takes between 1 and 3
+seconds. During the recovery period the databases are 'frozen', and
+all IO operations by ctdb clients are suspended.
<h3>IP Takeover</h3>
-When a node in a cluster fails, CTDB will arrange that a different node takes
over the IP address of the failed node to ensure that the ip addresses for the
services provided are always available.<br>
-To speed up the process of IP takeover and when clients attached to a failed
node recovers as fast as possible, CTDB will automatically generate Gratious
ARP packets to inform all nodes of the changed MAC address for that IP.
-CTDB will also send "tickle ACK" packets to all attached clients to trigger
the clients to immediately recognize that the TCP connection needs to be
reestablished and to shortcut any TCP retransmission timeouts that may be
active in the clients.
+
+When a node in a cluster fails, CTDB will arrange that a different
+node takes over the IP address of the failed node to ensure that the
+IP addresses for the services provided are always available.
+
+<p>To speed up the process of IP takeover and when clients attached to
+a failed node recovers as fast as possible, CTDB will automatically
+generate gratuitous ARP packets to inform all nodes of the changed MAC
+address for that IP. CTDB will also send "tickle ACK" packets to all
+attached clients to trigger the clients to immediately recognize that
+the TCP connection needs to be re-established and to shortcut any TCP
+retransmission timeouts that may be active in the clients.
<h2>Services using CTDB</h2>
<h3>Samba 3/4</h3>
-Extensions has been developed to samba3 and samba 4 to integrate with CTDB to
build a clustered HA version os samba where the same data/network shares are
exported read-write from multiple nodes in a cluster.<br>
-These versions of samba have been demonstrated to provide very good
scalability.<br><br>
-See <a href="http://wiki.samba.org/index.php/CTDB_Project";>CTDB Project at
samba.org</a> for more information about this <strong>pCIFS</strong>
implementation.
+
+Extensions has been developed to Samba3 and Samba 4 to integrate with
+CTDB to build a clustered highly available version of Samba where the
+same data/network shares are exported read-write from multiple nodes
+in a cluster. These versions of Samba have been demonstrated to provide very
good
+scalability.
+
+<p>See <a href="http://wiki.samba.org/index.php/CTDB_Project";>CTDB
+Project at samba.org</a> for more information about
+this <strong>pCIFS</strong> implementation.
<h3>NFS v2/v3</h3>
-NFS v2/v3 has been successfully tested with exporting the same data/network
share from multiple nodes in a CTDB cluster with correct file locking behaviour
and lock recovery.
-
-See <a
href="http://wiki.samba.org/index.php/CTDB_Setup#Setting_up_CTDB_for_clustered_NFS";>Configuring
NFS for CTDB clustering</a> for isntructions on how to configure a CTDB
cluster to provide NFS clustering.
+
+NFS v2/v3 has been successfully tested with exporting the same
+data/network share from multiple nodes in a CTDB cluster with correct
+file locking behaviour and lock recovery.
+
+See <a
+href="http://wiki.samba.org/index.php/CTDB_Setup#Setting_up_CTDB_for_clustered_NFS";>Configuring
+NFS for CTDB clustering</a> for instructions on how to configure a
+CTDB cluster to provide NFS clustering.
<h2>Discussion and bug reports</h2>
ctdb does not currently have its own mailing list or bug tracking
-system. For now, please use the
<ahref="https://lists.samba.org/mailman/listinfo/samba-technical";>samba-technical</a>
+system. For now, please use
+the
<ahref="https://lists.samba.org/mailman/listinfo/samba-technical";>samba-technical</a>
mailing list, and the <a href="http://bugzilla.samba.org/";>Samba
-bugzilla</a> bug tracking system.<br><br>
+bugzilla</a> bug tracking system.
-We would be very interested in hearing from and work with other projects that
want to make their services cluster aware using CTDB.
+<p>We would be very interested in hearing from and work with other
+projects that want to make their services cluster aware using CTDB.
<h2>Download</h2>
