2 # Copyright 1999-2000, The OpenLDAP Foundation, All Rights Reserved.
3 # COPYING RESTRICTIONS APPLY, see COPYRIGHT.
5 P1: Making and Installing the OpenLDAP Distribution
7 This file provides brief instructions on how to build and install
8 OpenLDAP on UNIX (and UNIX-{{like}}) system. More detailed
9 information and instructions can be found in
10 {{The OpenLDAP Administrator's Guide}}
11 ({{URL:http://www.openldap.org/doc/admin/}}).
13 It is recommended that you read, or at least skim through, ALL of
14 the instructions in this file before attempting to build the
17 It is also recommended you review
18 {{The OpenLDAP Administrator's Guide}}
19 ({{URL:http://www.openldap.org/doc/admin/}}),
20 the {{Frequently Asked Questions}} ({{URL:http://www.openldap.org/faq/}})
21 pages, in particular the
22 {{Installation section}} ({{URL:http://www.openldap.org/faq/index.cgi?file=8}})
24 {{Platform Hints}} ({{URL:http://www.openldap.org/faq/index.cgi?file=9}})
28 P2: Making and Installing the OpenLDAP Distribution
30 ^ Unpack the distribution and change directory:
32 E: % tar xfz openldap-VERSION.tgz
33 E: % cd openldap-VERSION
35 .(replacing {{EX:VERSION}} with the appropriate version string). If
36 you are reading this file, you probably have already done this!
41 E: % ./configure --help
43 .to list available configuration options. A description of
44 these options is provided in the 'CONFIGURE OPTIONS' section
47 .The {{EX:configure}} script uses environmental variables for
48 determining compiler/linker options including:
50 > Variable Description Example
52 > CFLAGS C flags -O -g
53 > CPPFLAGS cpp flags -I/path/include -Ddef
54 > LDFLAGS ld flags -L/usr/local/lib
55 > LIBS libraries -llib
56 > PATH command path /usr/local/bin:/usr/bin:/bin
58 + Configure the build system
60 E: % [env settings] ./configure [options]
62 .If all goes well, the {{EX:configure}} script with automatically
63 detect the appropriate settings. However, you may need to
64 specify options and/or environment variables to obtain desired
75 .If all goes well, the system will build as configured. If not,
76 return to step 3 after reviewing the configuration settings. You
77 may want to consult the {{Platform Hints}} subsection of the {{FAQ}}
78 if you have not done so already.
80 + Test the standalone system
82 .This step requires the standalone LDAP server, {{slapd}}(8),
83 with {{LDBM}} support.
87 .If all goes well, the system has been built as configured. If not,
88 return to step 4 after reviewing your configuration settings. You
89 may want to consult the {{Installation}} section of the {{FAQ}}
90 if you have not done so already.
92 + install the binaries and man pages. You may need to be come the
93 {{super-user}} (e.g. {{EX:root}}) to do this (depending on where you
94 are installing things):
96 E: % su root -c 'make install'
100 See the {{OpenLDAP Administrator's Guide}} and the manual pages
101 for the individual applications for configuration and use information.
102 You may also want to edit the configuration files used by the
103 various components. These configuration files are located in
104 the OpenLDAP configuration directory (normally
105 {{F:/usr/local/etc/openldap}}).
107 > ldap.conf client defaults
108 > ldapfilter.conf search filter configuration
109 > ldapsearchprefs.conf search object definitions
110 > ldaptemplates.conf display template definitions
111 > slapd.conf Standalone LDAP daemon
112 > schema/*.schema Schema Definitions
115 End of OpenLDAP INSTALL file.