Next Previous Contents

2. Installing the LDAP Server

Four steps are necessary to install the server : Download the package, Unpack the software, Configure the Makefiles and Build the server.

2.1 Downloading the package

There are two free distributed LDAP servers : University of Michigan LDAP server and OpenLDAP server. There's also the Netscape Directory Server, which is free only under some conditions (educational institutions get it free, for example).The OpenLDAP server is based on the latest version of the University of Michigan Server and there are mailing lists and aditional documentation avaiable for it. This document supposes that you are using the OpenLDAP server.

It's latest tar gziped version is avaiable on the following address :

http://www.openldap.org

If you want to get the latest version of University of Michigan Server, go to this address :

ftp://terminator.rs.itd.umich.edu/ldap

To write this document, I used the OpenLDAP latest stable version and OpenLDAP 1.2.3 on a Slackware Linux machine with kernel 2.0.36.

2.2 Unpacking the server

Now that you have the tar gziped package on your local machine you can unpack it.

First copy the package to a desirable directory, for example /usr/local.

Then use the following command :

tar xvzf openldap-stable.tgz 

You can use this command too, as well :

gunzip openldap-stable.tgz | tar xvf - 

2.3 Configuring the software

There are several options that you should like to customize so you can build the best software to your site.

To configure the software you just need 2 steps :

In the file include/ldapconfig.h.edit you can set options like the location of the slapd and slurpd daemons. The file itself is well commented and it's default settings also reflect the most common administrator choices so, if you are in a hurry you can skip this step, and run directly:

vi include/ldapconfig.h.edit 

The OpenLDAP server sources are distributed with a configuration script for setting options like instalation directories, compiler and linker flags. Type the following command on the directory where you unpacked the software :

./configure --help 
This will print all options that you can customize with the configure script before you build the software. Some usefull options are --prefix=pref , --exec-prefix=eprefix and --bindir=dir, for setting instalation directories. Normally if you run configure without options, it will auto-detect the appropriate settings and prepar to build things on the default common location. So just type :
./configure 
And watch the output to see if all went well

2.4 Building the server

After configuring the software you can start building it. First build the dependencies, using the command :

make depend 
After build the server, using the command :
make 
If all goes well, the server will build as configured. If not, return to the previous step to review the configuration settings. You should check the platform specific hints, they are located in the path doc/install/hints under the directory you unpacked the software.

Now install the binaries and man pages. You may need to be superuser to do this (depending on where you are installing things):

su 
make install 
That's all, now you have the binary of the server and the binaries of several other utilities. Go to the next section to see how to configure the operation of your LDAP server


Next Previous Contents