Making and Installing EnderUNIX QLDAPAdmin v.0.40-BETA ======================================================= This file provides brief instructions on how to build and install QLDAPAdmin on UNIX (and UNIX-like) system. More detailed information and instructions can be found in EnderUNIX website: (http://www.enderunix.org/qldapadmin/INSTALL). It is recommended that you read, or at least skim through, ALL of the instructions in this file before attempting to build the software. Making and Installing ----------------------------------------------- 1. Unpack the software and change directory: % tar xfz enderldap-VERSION.tar.gz % cd enderldap-VERSION (replacing VERSION with the appropriate version string). If you are reading this file, you probably have already done this!:)) 2. Edit file named qconfig.h and make appropriate changes to suit your system. #define LDAP_USER "cn=root, dc=enderunix, dc=org" This should be a user who is capable of doing write operations in the LDAP database. #define LDAP_PASSWORD "secret" Your password you use when binding to your LDAP server #define LDAP_BASEDN "dc=enderunix, dc=org" #define LDAP_SERVER "localhost" Self explanatory though, your ldap server's hostname or IP #define LDAP_PORT 389 Most of the time you won't need to change this. The port number that your LDAP server binds to #define MAILHOST "agayev.enderunix.org" Default mailhost ;) #define MAXFORWARDS 3 Maximun number of mailForwardingAddress values #define MAXALTERNATES 3 Maximum number of mailAlternateAddress values If your OS is Linux, comment out #define LINUX directive, similarly, if you are using Solaris, #define SOLARIS should be commented out! 3. Edit Makefile and change SH, CC, CFLAGS, LDFLAGS, CPPFLAGS and LIBS values. 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++ CFLAGS C++ flags -O2 --pipe CPPFLAGS cpp flags -I/path/include LDFLAGS ld flags -L/usr/local/lib LIBS libraries -ldap -llber -lcrypt If your OS is Solaris, you can simply copy Makefile.Solaris to Makefile, for a running Makefile :) 4. Type: % make If all goes well, all binaries 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 binaries. 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' Binaris will be installed in /usr/local/bin Installed tools are: /usr/local/bin/qadddomain /usr/local/bin/qadduser /usr/local/bin/qdeldomain /usr/local/bin/qdeluser /usr/local/bin/qsetmailhost /usr/local/bin/qsetmaildir /usr/local/bin/qsetquota /usr/local/bin/qpasswd /usr/local/bin/qmodifyuser /usr/local/bin/qlistdomains /usr/local/bin/qlistusers 6. 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 How to Add Domain: ================== You should've been created the BASE_DN entry in your LDAP server. If you didn't consult OpenLDAP documentation or the docs of your LDAP distribution. If your BASE_DN exists, then simply type: # qadddomain or # qaddomain -c domain_description domainname How to Add Users: ================= simply run qadduser. If no argument is given qadduser will ask you the questions about the user and will create the appropriate entries in the LDAP server. Avalible options to qadduser: -m mail address -s mail server -p password -q mail quota in the format: 10000S, 100C -d mailMessageStore -c Gecos -h help secreen -v version information Example: # qadduser -m tosbi@aliveli.com -p aaa -s agayev.enderunix.org \ -c "Big Tosbi" -q "10000000S, 1000C" -d /usr/home/foo/bar or # qadduser How to Delete Domain: ===================== run qdeldomain! # qdeldomain or # qdeldomain -d aliveli.com -f -f is to force deletion (do not ask for confirmation) How to Delete User: =================== run qdeluser! # qdeluser or # qdeluser tosbi@aliveli.com How to Change Password: ======================= # qpasswd -p new_password deliali@aliveli.com or # qpasswd How to Modify a User: ===================== # qmodifyuser How to get information about a user: ==================================== # quserinfo roots@enderunix.org How to Set User Quota: ====================== # qsetquota -s 10000000 -c 1000 ali@veli.com where -s specifies mail size and -c specifies mail count. How to Set Mail Host: ===================== # qsetmailhost -u ali@aliveli.com agayev.enderunix.org How to Set User Mail Message Store: =================================== # qsetmsgstore -m /usr/home/alibaba alibaba@enderunix.org How to List Qmail Domains: ========================== # qlistdomains How to List Qmail Users for a Domain: ===================================== # qlistusers aliveli.com You may use -h switch to get help! For the time being, there are no man pages available! We are working on code refinement and bug fixing bugs we can find (c) 2001, EnderUNIX Software Development Team @ Istanbul, Turkiye http://www.EnderUNIX.org/ mailto:roots@enderunix.org Sat Jun 16 15:30:37 GMT 2001 End of INSTALL file. Mon Jul 2 01:56:09 GMT 2001