dkbf - Installation
=========================
I.
You will need to have MPI correctly installed on your system FIRST!
You will also need to have rsh or ssh working.

II.
dkbf is distributed as a tarball named dkbf-[version].tar.gz,
where version 1.0 would be named dkbf-1.0.tar.gz

Unpacking the source creates the directory dkbf-[version]/.
To start, put the tarball in your /home directory. 
To unpack type:

	gzip -dc dkbf-1.0.tar.gz | tar xf -
	cd dkbf-1.0

III.
To 'make', 'cd' into the dkbf-1.0/src/ directory.
You will likely need to edit the Makefile.
Near the top you will see the line:

	 MPILIBRARY=mpipro.

Change the "mpipro" to whatever mpi library you have on your system.
Type:

	make 
	make clean

IV.
Next, you must distribute the binary to all nodes you plan on running dkbf on.
Some MPI implementations compile binaries using static libraries. If this is the
case you don't need to install MPI on all nodes.  Other MPI implementations
(like MPIPro) use shared libraries, which will need to be installed on all nodes.

V.
Benchmark your computers with the bin/bench utility to determine how many passwords
per block you want.  On a Lintel 400Mhz Celeron, I use about 40 Million passwords 
per block. (YMMV)

VI.
You will need to configure the following files:
	bin/dkbf.ini   (see the OPTIONS file)
	bin/dkbf.pg    

VII.
To run type:
	mpirun -pg_file dkbf.pg dkbf
