Merge branch 'master' of ssh://jra@git.samba.org/data/git/samba
[samba.git] / examples / ad-bench / README
1 ==========================
2 Active Directory benchmark
3 ==========================
4
5 Setup
6 =====
7
8 You need to modify settings.sh to point to the correct binaries for your
9 platform. One thing you might want to do in order to be able to run the
10 benchmark as a non-root user is to compile your own samba version with the
11 --prefix configure option set to some location writeable by the user who will be
12 running the benchmark. You then need to point the NET variable to the correct
13 location.
14
15 Most likely, you will also want to put the realm to kdc hostname mappings into
16 krb5.conf and the hostname to IP address mappings for the kdcs to test into the
17 hosts file, so you actually benchmark the AD speed, not DNS lookup speed.
18
19 Running the benchmarks
20 ======================
21
22 Per default, the benchmark looks for a file called runs.txt in the directory the
23 benchmark is run from. (This is configurable in the settings.sh file)
24 runs.txt contains the credentials and server names to connect to, one set of
25 credentials/server per line. The format is as follows:
26
27 user@REALM.EXAMPLE.COM%password:domain_controller_host_name
28
29 License
30 =======
31 AD-Bench is free software: you can redistribute it and/or modify
32 it under the terms of the GNU General Public License as published by
33 the Free Software Foundation, either version 3 of the License, or
34 (at your option) any later version.
35
36 AD-Bench is distributed in the hope that it will be useful,
37 but WITHOUT ANY WARRANTY; without even the implied warranty of
38 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
39 GNU General Public License for more details.
40
41 You should have received a copy of the GNU General Public License
42 along with AD-Bench.  If not, see <http://www.gnu.org/licenses/>.