1999-10-01 01:01:02 +08:00
|
|
|
# $OpenLDAP$
|
2000-07-23 02:59:40 +08:00
|
|
|
# Copyright 1999-2000, The OpenLDAP Foundation, All Rights Reserved.
|
1999-10-01 01:01:02 +08:00
|
|
|
# COPYING RESTRICTIONS APPLY, see COPYRIGHT.
|
|
|
|
|
|
|
|
P1: Making and Installing the OpenLDAP Distribution
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
This file provides brief instructions on how to build and install
|
|
|
|
OpenLDAP on UNIX (and UNIX-{{like}}) system. For other systems,
|
|
|
|
please consult {{The OpenLDAP Administrator's Guide}}
|
|
|
|
{{URL:http://www.openldap.org/devel/admin/}}.
|
|
|
|
|
|
|
|
It is recommended that you read, or at least skim through, ALL of
|
|
|
|
the instructions in this file before attempting to build the
|
|
|
|
software.
|
|
|
|
|
|
|
|
It is also recommended your review
|
|
|
|
{{The OpenLDAP Administrator's Guide}}
|
|
|
|
({{URL:http://www.openldap.org/devel/admin/}}) and
|
|
|
|
the {{Frequently Asked Questions}} ({{URL:http://www.openldap.org/faq/}})
|
|
|
|
pages, in particular the
|
|
|
|
{{Installation section}} ({{URL:http://www.openldap.org/faq/index.cgi?file=8}})
|
|
|
|
and
|
|
|
|
{{Platform Hints}} ({{URL:http://www.openldap.org/faq/index.cgi?file=9}})
|
|
|
|
should be examined.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
|
|
|
|
P2: Making and Installing the OpenLDAP Distribution
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
^ Unpack the distribution and change directory:
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
E: % tar xfz openldap-VERSION.tgz
|
|
|
|
E: % cd openldap-VERSION
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.(replacing {{EX:VERSION}} with the appropriate version string). If
|
|
|
|
you are reading this file, you probably have already done this!
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
|
|
|
|
+ Type:
|
|
|
|
|
|
|
|
E: % ./configure --help
|
|
|
|
|
|
|
|
.to list available configuration options. A description of
|
|
|
|
these options is provided in the 'CONFIGURE OPTIONS' section
|
|
|
|
below.
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.The {{EX:configure}} script uses environmental variables for
|
|
|
|
determining compiler/linker options. See the 'USING ENVIRONMENT
|
|
|
|
VARIABLES' section for commonly used settings.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
.These environment variables are used:
|
|
|
|
|
|
|
|
> CC C compiler gcc
|
|
|
|
> CFLAGS C flags -ansi
|
|
|
|
> 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
|
|
|
|
|
|
|
|
.See the 'USING ENVIRONMENT VARIABLES' section for information
|
|
|
|
on how to use the variables.
|
|
|
|
|
|
|
|
+ Configure the build system
|
|
|
|
|
|
|
|
E: % [env settings] ./configure [options]
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.If all goes well, the {{EX:configure}} script with automatically
|
|
|
|
detect the appropriate settings. However, you may need to
|
|
|
|
specify options and/or environment variables to obtain desired
|
|
|
|
results.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
+ Build dependencies
|
|
|
|
|
|
|
|
E: % make depend
|
|
|
|
|
|
|
|
+ Build the system
|
|
|
|
|
|
|
|
E: % make
|
|
|
|
|
|
|
|
.If all goes well, the system will build as configured. If not,
|
2000-07-29 10:44:55 +08:00
|
|
|
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.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
+ Test the standalone system
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.This step requires the standalone LDAP server, {{slapd}}(8),
|
|
|
|
with {{LDBM}} support.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
2000-07-29 03:55:55 +08:00
|
|
|
E: % make test
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
.If all goes well, the system has been built as configured. If not,
|
2000-07-29 10:44:55 +08:00
|
|
|
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.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
+ install the binaries and man pages. You may need to be {{superuser}}
|
|
|
|
to do this (depending on where you are installing things):
|
1999-10-01 01:01:02 +08:00
|
|
|
|
2000-07-29 03:55:55 +08:00
|
|
|
E: % su root -c 'make install'
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
+ That's it!
|
|
|
|
|
2000-07-30 23:14:33 +08:00
|
|
|
See the {{Administrator's Guide}} and the manual pages for the
|
2000-07-29 10:44:55 +08:00
|
|
|
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
|
|
|
|
{{F:/usr/local/etc/openldap}}).
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
> ldap.conf client defaults
|
|
|
|
> ldapfilter.conf search filter configuration
|
|
|
|
> ldapsearchprefs.conf search object definitions
|
|
|
|
> ldaptemplates.conf display template definitions
|
|
|
|
> slapd.conf Standalone LDAP daemon
|
2000-07-29 03:55:55 +08:00
|
|
|
> schema/*.schema Schema Definitions
|
1999-10-01 01:01:02 +08:00
|
|
|
|
2000-07-30 23:14:33 +08:00
|
|
|
There are section 5 man pages for these configuration files.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
|
|
|
|
P2: Building OpenLDAP For More Than One Platform
|
|
|
|
|
2000-07-30 23:14:33 +08:00
|
|
|
You can build OpenLDAP for more than one platform from the
|
1999-10-01 01:01:02 +08:00
|
|
|
same source tree.
|
2000-07-29 10:44:55 +08:00
|
|
|
This is accomplished by using {{make}}(1) {{EX:VPATH}} support.
|
|
|
|
If your {{make}}(1) program is old and doesn't have {{EX:VPATH}}
|
2000-07-29 03:55:55 +08:00
|
|
|
support, install {{BSD Make}} or {{GNU Make}}.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
2000-07-30 23:14:33 +08:00
|
|
|
Follow these steps for each different platform:
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
^ Create a directory for the platform object files.
|
|
|
|
|
|
|
|
E: % mkdir obj-platform
|
|
|
|
|
|
|
|
+ Change your working directory to the platform object directory.
|
|
|
|
|
|
|
|
E: % cd obj-platform
|
|
|
|
|
|
|
|
+ Configure the build system
|
|
|
|
|
|
|
|
E: % [env settings] ../configure --src-dir=.. [options]
|
|
|
|
|
2000-07-30 23:14:33 +08:00
|
|
|
. ( replace "{{F:..}}" with the appropriate path )
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
+ Continue as above (starting at step 6).
|
|
|
|
|
|
|
|
|
|
|
|
P2: CONFIGURE OPTIONS
|
|
|
|
|
|
|
|
Regrettably, this section has not been written (yet). See
|
2000-07-29 10:44:55 +08:00
|
|
|
"{{EX:./configure --help}}" for current list of options. For general
|
|
|
|
information about how to use "{{EX:configure}}", please read
|
|
|
|
{{F:doc/install/configure}}.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
|
|
|
|
P2: USING ENVIRONMENT VARIABLES
|
|
|
|
|
|
|
|
The configure script will also use your environmental
|
|
|
|
variables for determining compiler/linker options. This can
|
|
|
|
be used to manual specify features and compilation options.
|
|
|
|
|
2000-07-30 23:14:33 +08:00
|
|
|
Note[label=Warning]: Executables built in your environment may not run
|
2000-07-29 03:55:55 +08:00
|
|
|
in your users' environments. The portability of executables
|
2000-07-29 10:44:55 +08:00
|
|
|
between environments is your responsibility.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
Supported Environmental Variables:
|
|
|
|
|
|
|
|
> CC C compiler cc
|
|
|
|
> CFLAGS C flags -ansi
|
|
|
|
> 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
|
|
|
|
|
|
|
|
* Including alternative compilers
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.Use the {{EX:CC}} environment variable to tell configure to
|
2000-07-29 03:55:55 +08:00
|
|
|
use a specific compiler. For example, to use {{GNU C
|
|
|
|
Compiler}} instead of the default compiler, use:
|
1999-10-01 01:01:02 +08:00
|
|
|
|
2000-07-29 03:55:55 +08:00
|
|
|
E: % [env] CC=gcc ./configure
|
1999-10-01 01:01:02 +08:00
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.You can also use {{EX:CC}} use specific flags with the
|
1999-10-01 01:01:02 +08:00
|
|
|
specified compiler. For example, to require strict
|
2000-07-29 10:44:55 +08:00
|
|
|
{{ANSI C}} using the {{GNU C Compiler}}, use:
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
E: % [env] CC="gcc -ansi -pedantic" ./configure
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.(you can use {{EX:CFLAGS}} to specify compiler flags)
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
* Preprocessor Flags
|
|
|
|
|
|
|
|
.You may specify additional preprocessor flags by setting
|
2000-07-29 10:44:55 +08:00
|
|
|
{{EX:CPPFLAGS}}. For example, if you would like to use headers
|
2000-07-29 03:55:55 +08:00
|
|
|
installed in {{F:/usr/local/include}}, use:
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
E: % [env] CPPFLAGS="-I/usr/local/include" ./configure
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.You can also use {{EX:CPPFLAGS}} to specify preprocessor macros.
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
E: % [env] CPPFLAGS="-D__SPECIAL_FLAG__" ./configure
|
|
|
|
|
|
|
|
* Linker Flags
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
.You may specify additional linker flags by setting {{EX:LDFLAGS}}.
|
1999-10-01 01:01:02 +08:00
|
|
|
For example, if you would like to use libraries installed
|
2000-07-29 03:55:55 +08:00
|
|
|
in {{F:/usr/local/lib}}, use:
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
E: % [env] LDFLAGS="-L/usr/local/lib" ./configure
|
|
|
|
|
|
|
|
.You can also use CPPFLAGS to specify linker flags:
|
|
|
|
|
|
|
|
E: % [env] LDFLAGS="-Bstatic" ./configure
|
|
|
|
|
|
|
|
* Path
|
|
|
|
|
|
|
|
.You may alter your path to affect configure ability to
|
|
|
|
find (or not find) commands. For example, to have configure
|
2000-07-29 03:55:55 +08:00
|
|
|
additionally look in {{F:/usr/css/bin}} for commands, use:
|
1999-10-01 01:01:02 +08:00
|
|
|
|
|
|
|
E: % [env] PATH="/usr/css/bin:$PATH" ./configure
|
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
* Using locally installed software
|
1999-10-01 01:01:02 +08:00
|
|
|
|
2000-07-30 23:14:33 +08:00
|
|
|
.To use software under installed under {{F:/usr/local}}.
|
2000-07-29 03:55:55 +08:00
|
|
|
|
|
|
|
E: [env] \
|
|
|
|
E: CPPFLAGS="-I/usr/local/include" \
|
|
|
|
E: LDFLAGS="-L/usr/local/lib" \
|
|
|
|
E: ./configure
|
|
|
|
|
2000-07-30 23:14:33 +08:00
|
|
|
Note: You may have add additional flags if your system
|
2000-07-29 10:44:55 +08:00
|
|
|
supports shared libraries.
|
|
|
|
|
2000-07-29 03:55:55 +08:00
|
|
|
|
1999-10-01 01:01:02 +08:00
|
|
|
End of OpenLDAP INSTALL file.
|
2000-07-29 03:18:17 +08:00
|
|
|
|
2000-07-29 10:44:55 +08:00
|
|
|
{{S:$OpenLDAP$}}
|