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: ( 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 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 "" 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 End of INSTALL file. Mon Dec 4 03:16:09 GMT 2001