Making and Installing EnderUNIX QLDAPAdmin v.1.0-Release Candidate 1
--------------=======================================================

This file provides brief instructions on how to build and install
QLDAPAdmin Graphical User Interface on UNIX (and UNIX-like) system.  
More detailed information  and instructions can be found in 
EnderUNIX website: (http://www.enderunix.org/qldapadmin/INSTALL-GUI).

It is recommended that you read, or at least skim through, ALL of the
instructions in this file before attempting to build the software.


PREREQUISITES:

1.  Qt library 2.3.0 or higher from trolltech.
    If you don't have it, go and get it from 
    http://www.trolltech.com

    Most popular Linux distros and BSDs provide this by default, 
    so if you are running one of those, you won't need to bother about this.

Making and Installing GUI version
-----------------------------------------------


1.   For the gui version to be compiled, you should have successfully
     compiled the standart version found at qldapadmin-VERSION/src
     (replacing VERSION with the appropriate version string).  

3.    Edit Makefile and change SH, CC, CFLAGS, LDFLAGS, CPPFLAGS 
      and LIBS values, in your qldapadmin-VERSION/src directory.
      Note that your LDAP distribution's header files and libraries
      should be pointed out by CPPFLAGS, LDFLAGS and LIBS
      directives.

      Variable        Description     Example
      CC              C++ compiler    g++
      CPPFLAGS        cpp flags       -I/path/include 
      LDFLAGS         ld flags        -L-L/usr/lib/qt-2.3.1/lib /usr/local/lib
      LIBS            libraries       -lqt -ldap -llber -lcrypt

     If your OS is FreeBSD, you can simply copy Makefile.FreeBSD
     to Makefile, for a running Makefile :)
     For the time being, we coulnd't test the GUI in Solaris.

     One single note for FreeBSD users, you should use "gmake" not the 
     make program that comes with FreeBSD.

4.   Type:

        % gmake 

     If all goes well, a gui binary "qldapadmin" will be compiled. However
     for this step to become successfull, you will need to 
     supply the needed variables in Makefile and qconfig.h


5.   install the binary.  You may need to become the                                                          
     super-user (e.g. root) to do this (depending on where you are                                                              
     installing things):
	                                                                 
     % su root -c 'make install'

     Binary will be installed in /usr/local/bin


6.    Copy qldapadmin-VERSION/src/qldapadmin.conf.sample 
      as your CONFIGFILE and edit it with your favorite editor
      to change settings.


      LDAP_USER "cn=root, dc=enderunix, dc=org"
      This should be a user who is capable of doing write operations
      in the LDAP database.
      
      LDAP_PASSWORD "secret"
      Your password you use when binding to your LDAP server

      LDAP_BASEDN "dc=enderunix, dc=org"

      LDAP_SERVER "localhost" 
      Self explanatory though, your ldap server's hostname or IP

      LDAP_PORT 389
      Most of the time you won't need to change this. 
      The port number that your LDAP server binds to

      MAILHOST "agayev.enderunix.org"
      Default mailhost ;)

      DEFAULT_QUOTA_SIZE="10000000"
      If you set HARDQUOTA directive in qconfig.h, this should not be
      left blank. This is the quota for the user in *bytes*.

      DEFAULT_QUOTA_COUNT="1000"
      If you set HARDQUOTA directive in qconfig.h, this should not be
      left blank. This is the quota for the user measured in units e.g. mails


7.   That's it!

	Before you start using QLDAPAdmin you must create your base DN in the LDAP Server.  
     To create base DN edit ld.txt file in this directory and run the following command.

       root# ldapadd -D"cn=root, dc=enderunix, dc=org" -w secret -f ld.txt

     change "cn=root, dc=enderunix, dc=org" value with your LDAP_USER value 	and "secret" 
     value with your LDAP_PASSWORD value that you define in qconfig.h

8.   To start playing around, just type:

     qldapadmin and have fun!

     PS. Of course I don't feel the need to tell that you need a running X server to run this.
     If you cannot figure this out, you are in a very very bad condition...


(c) 2001, EnderUNIX Software Development Team @ Istanbul, Turkiye 
http://www.EnderUNIX.org/
mailto:roots@enderunix.org

End of INSTALL file.
Mon Dec  4 03:16:09 GMT 2001