CTDB and Clustered Samba: Difference between revisions
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.