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
|
2002-02-19 02:10:25 +08:00
|
|
|
(available from http://www.openldap.org/doc/).
|
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-02-19 02:10:25 +08:00
|
|
|
It is also recommended you review the 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
|
|
|
|
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
|
|
|
|
2002-02-13 14:35:27 +08:00
|
|
|
to list available configuration options.
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2004-06-23 12:56:53 +08:00
|
|
|
Note also that the configure script uses environmental variables
|
|
|
|
for determining 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
|
2003-02-14 07:58:54 +08:00
|
|
|
CPPFLAGS cpp flags -I/path/include -DFOO=42
|
2000-08-23 08:54:08 +08:00
|
|
|
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
|
|
|
|
2004-06-23 12:56:53 +08:00
|
|
|
See doc/install/configure for generic configure documentation.
|
|
|
|
|
2004-02-25 10:12:00 +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
|
|
|
|
2004-10-02 18:12:58 +08:00
|
|
|
If all goes well, the configure script will automatically detect
|
|
|
|
the appropriate settings. If the configure script fails, you
|
|
|
|
should read the config.log file that it generated to see what it
|
|
|
|
was trying to do and exactly what failed. You may need to specify
|
|
|
|
additional options and/or environment variables besides those
|
|
|
|
listed above to obtain desired results, depending on your operating
|
|
|
|
system. The Platform Hints section of the FAQ provides help for
|
|
|
|
operating system related problems.
|
1998-08-09 08:43:13 +08:00
|
|
|
|
2004-02-25 10:12:00 +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
|
|
|
|
2004-02-25 10:12:00 +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
|
|
|
|
2004-02-25 10:12:00 +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
|
2006-01-14 02:16:07 +08:00
|
|
|
BDB or HDB 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
|
2004-02-25 10:12:00 +08:00
|
|
|
not, return to step 2 after reviewing your configuration
|
2000-08-23 08:54:08 +08:00
|
|
|
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
|
|
|
|
2004-02-25 10:12:00 +08:00
|
|
|
7. Install the software. 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
|
|
|
|
2004-02-25 10:12:00 +08:00
|
|
|
8. That's it. Enjoy!
|
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
|
|
|
|
2003-11-26 12:17:25 +08:00
|
|
|
---
|
2002-02-19 02:10:25 +08:00
|
|
|
$OpenLDAP: pkg/openldap-guide/release/install.sdf,v 1.16 2002/02/18
|
|
|
|
17:09:26 kurt Exp $
|
1998-12-01 04:41:52 +08:00
|
|
|
|
2003-11-26 12:17:25 +08:00
|
|
|
This work is part of OpenLDAP Software <http://www.openldap.org/>.
|
|
|
|
|
2012-01-01 23:07:45 +08:00
|
|
|
Copyright 1998-2012 The OpenLDAP Foundation.
|
2003-11-26 12:17:25 +08:00
|
|
|
All rights reserved.
|
2003-11-26 10:58:56 +08:00
|
|
|
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
|
|
modification, are permitted only as authorized by the OpenLDAP
|
|
|
|
Public License.
|
|
|
|
|
|
|
|
A copy of this license is available in the file LICENSE in the
|
|
|
|
top-level directory of the distribution or, alternatively, at
|
|
|
|
<http://www.OpenLDAP.org/license.html>.
|
|
|
|
|
|
|
|
OpenLDAP is a registered trademark of the OpenLDAP Foundation.
|