1998-08-26 07:29:01 +08:00
|
|
|
Making and Installing the OpenLDAP Distribution
|
2000-08-23 08:54:08 +08:00
|
|
|
===============================================
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
This file provides brief instructions on how to build and install
|
2000-09-12 02:44:55 +08:00
|
|
|
OpenLDAP on UNIX (and UNIX-like) system. More detailed information
|
|
|
|
|
and instructions can be found in The OpenLDAP Administrator's Guide
|
|
|
|
|
(http://www.openldap.org/doc/admin/).
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
It is recommended that you read, or at least skim through, ALL of the
|
|
|
|
|
instructions in this file before attempting to build the software.
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2002-01-13 10:54:30 +08:00
|
|
|
It is also recommended you review Frequently Asked Questions
|
2000-09-12 02:44:55 +08:00
|
|
|
(http://www.openldap.org/faq/) pages, in particular the Installation
|
|
|
|
|
section (http://www.openldap.org/faq/index.cgi?file=8) and Platform
|
|
|
|
|
Hints (http://www.openldap.org/faq/index.cgi?file=9) should be
|
|
|
|
|
examined.
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2002-01-13 10:54:30 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
Making and Installing the OpenLDAP Distribution
|
|
|
|
|
-----------------------------------------------
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
1. Unpack the distribution and change directory:
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
% tar xfz openldap-VERSION.tgz
|
|
|
|
|
% cd openldap-VERSION
|
1998-08-24 07:15:03 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
(replacing VERSION with the appropriate version string). If you
|
|
|
|
|
are reading this file, you probably have already done this!
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
2. Type:
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
% ./configure --help
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
to list available configuration options. A description of these
|
|
|
|
|
options is provided in the 'CONFIGURE OPTIONS' section below.
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
The configure script uses environmental variables for determining
|
2000-09-12 02:44:55 +08:00
|
|
|
compiler/linker options including:
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-09-12 02:44:55 +08:00
|
|
|
Variable Description Example
|
2000-08-23 08:54:08 +08:00
|
|
|
CC C compiler gcc
|
|
|
|
|
CFLAGS C flags -O -g
|
|
|
|
|
CPPFLAGS cpp flags -I/path/include -Ddef
|
|
|
|
|
LDFLAGS ld flags -L/usr/local/lib
|
|
|
|
|
LIBS libraries -llib
|
|
|
|
|
PATH command path /usr/local/bin:/usr/bin:/bin
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
3. Configure the build system
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
% [env settings] ./configure [options]
|
1998-10-25 09:41:42 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
If all goes well, the configure script with automatically detect
|
|
|
|
|
the appropriate settings. However, you may need to specify
|
|
|
|
|
options and/or environment variables to obtain desired results.
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
4. Build dependencies
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
% make depend
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
5. Build the system
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
% make
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
If all goes well, the system will build as configured. If not,
|
|
|
|
|
return to step 3 after reviewing the configuration settings. You
|
|
|
|
|
may want to consult the Platform Hints subsection of the FAQ if
|
|
|
|
|
you have not done so already.
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
6. Test the standalone system
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
This step requires the standalone LDAP server, slapd(8), with
|
|
|
|
|
LDBM support.
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
% make test
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
If all goes well, the system has been built as configured. If
|
|
|
|
|
not, return to step 4 after reviewing your configuration
|
|
|
|
|
settings. You may want to consult the Installation section of
|
|
|
|
|
the FAQ if you have not done so already.
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-09-12 02:44:55 +08:00
|
|
|
7. install the binaries and man pages. You may need to be come the
|
|
|
|
|
super-user (e.g. root) to do this (depending on where you are
|
|
|
|
|
installing things):
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
% su root -c 'make install'
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
8. That's it!
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2000-09-12 02:44:55 +08:00
|
|
|
See the OpenLDAP Administrator's Guide and the manual pages for the
|
|
|
|
|
individual applications for configuration and use information. You may
|
|
|
|
|
also want to edit the configuration files used by the various
|
|
|
|
|
components. These configuration files are located in the OpenLDAP
|
|
|
|
|
configuration directory (normally /usr/local/etc/openldap).
|
1999-02-09 02:52:42 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
ldap.conf client defaults
|
|
|
|
|
slapd.conf Standalone LDAP daemon
|
|
|
|
|
schema/*.schema Schema Definitions
|
1999-02-09 02:52:42 +08:00
|
|
|
|
2002-01-13 10:54:30 +08:00
|
|
|
|
2000-08-23 08:54:08 +08:00
|
|
|
End of OpenLDAP INSTALL file.
|
1998-11-03 09:12:04 +08:00
|
|
|
|
2000-09-12 02:44:55 +08:00
|
|
|
$OpenLDAP: pkg/openldap-guide/release/install.sdf,v 1.12 2000/09/09
|
|
|
|
|
21:16:09 kurt Exp $
|
1998-12-01 04:41:52 +08:00
|
|
|
|
