Difference between revisions of "CTDB and Clustered Samba"

From SambaWiki
(Add getting/building instructions, mostly copied over from CTDB_Setup)
(Undo revision 17220 by Hortimech (talk) - Undoing this at least temporarily because I haven't seen any evidence of this...)
Tag: Undo
 
(26 intermediate revisions by 4 users not shown)
Line 1: Line 1:
  +
= Introduction =
= CTDB and Clustered Samba =
 
   
 
CTDB is a clustered database component in clustered Samba that provides a high-availability load-sharing CIFS server cluster.
 
CTDB is a clustered database component in clustered Samba that provides a high-availability load-sharing CIFS server cluster.
Line 21: Line 21:
 
Samba and CTDB must be installed on all nodes of a cluster. CTDB is part of Samba (>= 4.2.0), so to get CTDB you need to [https://www.samba.org/samba/download/ get Samba].
 
Samba and CTDB must be installed on all nodes of a cluster. CTDB is part of Samba (>= 4.2.0), so to get CTDB you need to [https://www.samba.org/samba/download/ get Samba].
   
  +
More details:
== Getting CTDB Source code ==
 
   
  +
* [[Getting and Building CTDB]]
If you [[Obtaining_Samba|download source code for Samba &gt;= 4.2.0]] then CTDB is included in the <code>ctdb</code> subdirectory.
 
  +
* [[Upgrading a CTDB cluster]]
   
  +
= Configuring Clusters with CTDB =
== Binary packages ==
 
   
  +
* [[Basic CTDB configuration]]
* Your operating system may include pre-built packages for Samba and CTDB
 
  +
* [[Setting up a cluster filesystem]]
  +
* [[Configuring the CTDB recovery lock]]
  +
* [[Adding public IP addresses]]
  +
* [[Configuring clustered Samba]]
  +
* [[Setting up CTDB for Clustered NFS]]
  +
* [[Setting up CTDB with other services]]
  +
* [[Advanced CTDB configuration]]
  +
* [[Samba_CTDB_GPFS_Cluster_HowTo|CTDB with GPFS]]
  +
* [[GFS_CTDB_HowTo|CTDB with GFS]]
   
  +
= Analysing CTDB problems =
* If you use pre-built packages then you need to ensure that Samba was built with cluster support
 
   
  +
* [[Merged logs]]
* CTDB will usually be in a separate package to other Samba components called <code>ctdb</code>
 
  +
* [[CTDB log file search patterns]]
   
  +
= Developing CTDB =
== Building from source code ==
 
   
  +
* [[CTDB database design]]
CTDB should be built with Samba. Add the following options to the <code>./configure</code> command.
 
  +
* [[Running CTDB tests]]
   
  +
= Historical and Background Information =
; <code>--with-cluster-support</code> : This enables clustering support in Samba and includes CTDB in the build
 
; <code>--with-shared-modules=idmap_rid,idmap_tdb2,idmap_ad</code> : Clustered Samba needs an IDMAP facility so it is worth building a few
 
   
  +
Note that some of this information is out of date.
Other than that, just [[Build_Samba_from_Source|follow instructions for building Samba]].
 
   
== Legacy CTDB versions ==
+
* [[CTDB Project]]
 
* [[Clustered Samba]]
 
  +
* [[Samba & Clustering]]
You should use a version of CTDB that comes with [[Samba_Release_Planning|a supported Samba version]].
 
  +
* [http://samba.org/~obnox/presentations/sambaXP-2009/ Michael Adam's clustered NAS articles]
 
However, [https://download.samba.org/pub/ctdb/ legacy, standalone versions of CTDB are still available] (including [[CTDB2releaseNotes|2.x]]). These versions were used with Samba versions older than 4.2.0.
 
 
The code is also available from the CTDB git repository at git://git.samba.org/ctdb.git. See also the [https://git.samba.org/?p=ctdb.git;a=summary GIT web interface].
 

Latest revision as of 05:59, 1 February 2021

Introduction

CTDB is a clustered database component in clustered Samba that provides a high-availability load-sharing CIFS server cluster.

The main functions of CTDB are:

  • Provide a clustered version of the TDB database with automatic rebuild/recovery of the databases upon node failures.
  • Monitor nodes in the cluster and services running on each node.
  • Manage a pool of public IP addresses that are used to provide services to clients. Alternatively, CTDB can be used with LVS.

Combined with a cluster filesystem CTDB provides a full high-availablity (HA) environment for services such as clustered Samba, NFS and other services.

Supported platforms

CTDB is primarily developed and tested on Linux. A subset of features may work on other platforms.

Getting and Building CTDB

Samba and CTDB must be installed on all nodes of a cluster. CTDB is part of Samba (>= 4.2.0), so to get CTDB you need to get Samba.

More details:

Configuring Clusters with CTDB

Analysing CTDB problems

Developing CTDB

Historical and Background Information

Note that some of this information is out of date.