Difference between revisions of "CTDB and Clustered Samba"
From SambaWiki
(Change first heading) |
(Move "Getting and Building" to its own page to avoid clutter here) |
||
| 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]. |
||
| + | There are more details available on [[Getting and Building CTDB]]. |
||
| − | == Getting CTDB Source code == |
||
| − | |||
| − | If you [[Obtaining_Samba|download source code for Samba >= 4.2.0]] then CTDB is included in the <code>ctdb</code> subdirectory. |
||
| − | |||
| − | == Binary packages == |
||
| − | |||
| − | * 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> |
||
| − | |||
| − | == Building from source code == |
||
| − | |||
| − | CTDB should be built with Samba. Add the following options to the <code>./configure</code> command. |
||
| − | |||
| − | ; <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 |
||
| − | |||
| − | Other than that, just [[Build_Samba_from_Source|follow instructions for building Samba]]. |
||
| − | |||
| − | == Legacy CTDB versions == |
||
| − | |||
| − | You should use a version of CTDB that comes with [[Samba_Release_Planning|a supported Samba version]]. |
||
| − | |||
| − | 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 = |
= Configuring Clusters with CTDB = |
||
Revision as of 00:40, 21 October 2016
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.
There are more details available on Getting and Building CTDB.