1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-29 11:21:54 +03:00
samba-mirror/ctdb/web/samba.html
Amitay Isaacs a40b9f2e7c web: Update webpages
Signed-off-by: Amitay Isaacs <amitay@gmail.com>

(This used to be ctdb commit ed9ba1d3dcfcb51aa69bf4d7a74b95063743d8d9)
2013-07-11 15:16:55 +10:00

98 lines
3.1 KiB
HTML

<!--#set var="TITLE" value="CTDB and Samba" -->
<!--#include virtual="header.html" -->
<h1>Setting up clustered samba</h1>
It is assumed tou have already installed the ctdb version of samba and also installed, configured and tested CTDB.
<h2>Create a user account</h2>
First you need to initialise the Samba password database so that you have some user that can authenticate to the samba service.<br>
Do this by running:
<pre>
smbpasswd -a root
</pre>
Samba with clustering must use the tdbsam or ldap SAM passdb backends (it must not use the default smbpasswd backend), or must be configured to be a member of a domain.<br>
The rest of the configuration of Samba is exactly as it is done on a normal system.<br><br>
See the docs on http://samba.org/ for details.
<h2>Critical smb.conf parameters</h2>
A clustered Samba install must set some specific configuration parameters
<pre>
clustering = yes
idmap backend = tdb2
</pre>
<h2>Using smbcontrol</h2>
You can check for connectivity to the smbd daemons on each node using smbcontrol
<pre>
smbcontrol smbd ping
</pre>
<h2>Using Samba4 smbtorture</h2>
The Samba4 version of smbtorture has several tests that can be used to
benchmark a CIFS cluster. You can download Samba 4 from Samba website.
The particular tests that are helpful for cluster benchmarking are the RAW-BENCH-OPEN, RAW-BENCH-LOCK and BENCH-NBENCH tests.<br>
These tests take a unclist that allows you to spread the workload out over more than one node. For example:
<pre>
smbtorture //localhost/data -Uuser%password RAW-BENCH-LOCK --unclist=unclist.txt --num-progs=32 -t60
</pre>
The file unclist.txt should contain a list of server names in your cluster prefixed by //. For example
<pre>
//192.168.1.1
//192.168.1.2
//192.168.2.1
//192.168.2.2
</pre>
For NBENCH testing you need a client.txt file.<br>
A suitable file can be found in the dbench distribution at http://samba.org/ftp/tridge/dbench/
<h3>CTDB_MANAGES_SAMBA</h3>
This is a parameter in /etc/sysconfig/ctdb<br><br>
When this parameter is set to "yes" CTDB will start/stop/restart the local samba daemon as the cluster configuration changes.<br><br>
When this parameter is set you should also make sure that samba is NOT started by default by the linux system when it boots, e.g.
<pre>
chkconfig smb off
</pre>
on a Redhat system and
<pre>
chkconfig smb off
chkconfig nmb off
</pre>
on a SuSE system.
Example:
<pre>
CTDB_MANAGES_SAMBA="yes"
</pre>
It is strongly recommended that you set this parameter to "yes" if you intend to use clustered samba.
<h3>CTDB_MANAGES_WINBIND</h3>
This is a parameter in /etc/sysconfig/ctdb<br><br>
When this parameter is set to "yes" CTDB will start/stop/restart the local winbind daemon as the cluster configuration changes.<br><br>
When this parameter is set you should also make sure that winbind is NOT started by default by the linux system when it boots:
<pre>
chkconfig winbind off
</pre>
Example:
<pre>
CTDB_MANAGES_WINBIND="yes"
</pre>
It is strongly recommended that you set this parameter to "yes" if you
intend to use clustered samba in DOMAIN or ADS security mode.
<!--#include virtual="footer.html" -->