summaryrefslogtreecommitdiff
path: root/examples/ad-bench/README
diff options
context:
space:
mode:
authorKai Blin <kai@samba.org>2009-10-07 15:45:17 +0200
committerKai Blin <kai@samba.org>2009-10-07 15:45:46 +0200
commit37038905965631cbc8f10a2bfe719df0d2ad067e (patch)
treee76ef4fdde7a17dbae8689e7fd06283dcda0f3d5 /examples/ad-bench/README
parent3c3725a340ffe20ab679cf2f9d41ccd0b51b4b3a (diff)
downloadsamba-37038905965631cbc8f10a2bfe719df0d2ad067e.tar.gz
samba-37038905965631cbc8f10a2bfe719df0d2ad067e.tar.bz2
samba-37038905965631cbc8f10a2bfe719df0d2ad067e.zip
AD-Bench: A first go at an Active Directory benchmark.
Diffstat (limited to 'examples/ad-bench/README')
-rw-r--r--examples/ad-bench/README42
1 files changed, 42 insertions, 0 deletions
diff --git a/examples/ad-bench/README b/examples/ad-bench/README
new file mode 100644
index 0000000000..de6235f278
--- /dev/null
+++ b/examples/ad-bench/README
@@ -0,0 +1,42 @@
+==========================
+Active Directory benchmark
+==========================
+
+Setup
+=====
+
+You need to modify settings.sh to point to the correct binaries for your
+platform. One thing you might want to do in order to be able to run the
+benchmark as a non-root user is to compile your own samba version with the
+--prefix configure option set to some location writeable by the user who will be
+running the benchmark. You then need to point the NET variable to the correct
+location.
+
+Most likely, you will also want to put the realm to kdc hostname mappings into
+krb5.conf and the hostname to IP address mappings for the kdcs to test into the
+hosts file, so you actually benchmark the AD speed, not DNS lookup speed.
+
+Running the benchmarks
+======================
+
+Per default, the benchmark looks for a file called runs.txt in the directory the
+benchmark is run from. (This is configurable in the settings.sh file)
+runs.txt contains the credentials and server names to connect to, one set of
+credentials/server per line. The format is as follows:
+
+user@REALM.EXAMPLE.COM%password:domain_controller_host_name
+
+License
+=======
+AD-Bench is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+AD-Bench is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with AD-Bench. If not, see <http://www.gnu.org/licenses/>.