[ $Id: INSTALL,v 1.2 2003/05/20 23:00:35 visick Exp $]

Usually all you have to do is:

        perl Makefile.PL [PREFIX=...]
        make
        make install
        make clean
 
At this point you should edit your configuration file to reflect 
your LDAP directory. At the very least you must add a line specifying
the hostname of your LDAP server and base:

host ldap.example.edu
base example.edu

Each option must be one one per line and be in the format:
<option> <configuration>

Currently usertools supports the following options:

host -- hostname of LDAP server
port -- port for LDAP connections (default 389)
version -- protocol version being used (default is 2)
base -- the rootDSE entry
userbase -- the DN that is the base object for users (default ou=People,$base)
groupbase -- the base object for groups (default ou=Groups,$base)
password_hash -- password hash for users (default crypt)
binddn -- user to bind to LDAP server as (default uid=$user,ou=People,$base)
default_shell -- shell to assign to new users (default ask)
group_attribute -- a comma separated list non RFC2307 attributes
user_attribute -- a comma separated list non RFC2307 attributes
group_objectclass -- comma separated list of non RFC2307 objectclasses 
user_objectclass -- comma separated list of non RFC2307 objectclasses
password_attribute -- comma separated list of attributes of password type
required_attribute -- comma separated list of attributes which can't be blank
default_gid -- group numeric ID for new users 
homedir_command -- command to create user home directories (default mkdir)
sslversion -- version of SSL/TLS protocol (LDAP v3 only), default none
cafile -- location of the CA certificate file for tls

You may edit the template "usertools.conf" in this directory. 
The configuration file should be placed in /etc or renamed to .usertoolsrc
and placed in your home directory.
