Difference between revisions of "CTDB and Clustered Samba"

(Add configuration section)
(Analysing CTDB problems)
 
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= CTDB and Clustered Samba =
+
= Introduction =
  
 
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].
  
== Getting CTDB Source code ==
+
More details:
  
If you [[Obtaining_Samba|download source code for Samba &gt;= 4.2.0]] then CTDB is included in the <code>ctdb</code> subdirectory.
+
* [[Getting and Building CTDB]]
 +
* [[Upgrading a CTDB cluster]]
  
== Binary packages ==
+
= Configuring Clusters with CTDB =
 
 
* Your operating system may include pre-built packages for Samba and CTDB
 
 
 
* If you use pre-built packages then you need to ensure that Samba was built with cluster support
 
 
 
:  You can get information about smbd's clustering features:
 
 
 
  # smbd -b | grep -i 'ctdb\|cluster'
 
    CLUSTER_SUPPORT
 
    CTDB_SOCKET
 
  Cluster support features:
 
    CLUSTER_SUPPORT
 
    CTDB_SOCKET: /var/run/ctdb/ctdbd.socket
 
    CTDB_PROTOCOL: 1
 
 
 
:  Note that output may vary slightly, but the <code>CLUSTER_SUPPORT</code> feature must be present.
 
  
* CTDB will usually be in a separate package to other Samba components called <code>ctdb</code>
+
* [[Basic CTDB configuration]]
 +
* [[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]]
  
== Building from source code ==
+
= Analysing CTDB problems =
  
CTDB should be built with Samba.  Add the following options to the <code>./configure</code> command.
+
* [[Merged logs]]
 +
* [[CTDB log file search patterns]]
  
; <code>--with-cluster-support</code> : This enables clustering support in Samba and includes CTDB in the build
+
= Developing CTDB =
; <code>--with-shared-modules=idmap_rid,idmap_tdb2,idmap_ad</code> : Clustered Samba needs an IDMAP facility so it is worth building a few
 
  
Other than that, just [[Build_Samba_from_Source|follow instructions for building Samba]].
+
* [[CTDB database design]]
 +
* [[Running CTDB tests]]
  
== Legacy CTDB versions ==
+
= Historical and Background Information =
  
You should use a version of CTDB that comes with [[Samba_Release_Planning|a supported Samba version]].
+
Note that some of this information is out of date.
 
 
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].
 
 
 
= Configuring Clusters with CTDB =
 
  
* [[CTDB_Setup|Configuring a Samba Cluster with CTDB]]
+
* [[CTDB Project]]
 +
* [[Clustered Samba]]
 +
* [[Samba & Clustering]]
 +
* [http://samba.org/~obnox/presentations/sambaXP-2009/ Michael Adam's clustered NAS articles]

Latest revision as of 04:25, 30 June 2020

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.