install.sdf 3.56 KB
Newer Older
Kurt Zeilenga's avatar
Kurt Zeilenga committed
1
# $OpenLDAP$
Quanah Gibson-Mount's avatar
Quanah Gibson-Mount committed
2
# Copyright 1999-2021 The OpenLDAP Foundation, All Rights Reserved.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
3
4
5
6
# COPYING RESTRICTIONS APPLY, see COPYRIGHT.

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}}) systems.  More detailed
Kurt Zeilenga's avatar
Kurt Zeilenga committed
9
10
information and instructions can be found in
{{The OpenLDAP Administrator's Guide}}
Kurt Zeilenga's avatar
Kurt Zeilenga committed
11
(available from {{URL:http://www.openldap.org/doc/}}).
12
13
14
15
16

It is recommended that you read, or at least skim through, ALL of
the instructions in this file before attempting to build the
software.

Kurt Zeilenga's avatar
Kurt Zeilenga committed
17
It is also recommended you review
18
19
20
21
22
23
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.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
24
25
26
27


P2: Making and Installing the OpenLDAP Distribution

28
^ Unpack the distribution and change directory:
Kurt Zeilenga's avatar
Kurt Zeilenga committed
29
30
31
32

E:	% tar xfz openldap-VERSION.tgz
E:	% cd openldap-VERSION

33
34
.(replacing {{EX:VERSION}} with the appropriate version string).  If
you are reading this file, you probably have already done this!
Kurt Zeilenga's avatar
Kurt Zeilenga committed
35
36
37
38
39
40


+ Type:

E:	% ./configure --help

Kurt Zeilenga's avatar
Kurt Zeilenga committed
41
.to list available configuration options.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
42

43
44
.The {{EX:configure}} script also looks for compiler/linker options
on the command line and in the environment.  These include:
Kurt Zeilenga's avatar
Kurt Zeilenga committed
45

Kurt Zeilenga's avatar
Kurt Zeilenga committed
46
>	Variable	Description	Example
Kurt Zeilenga's avatar
Kurt Zeilenga committed
47
>	CC		C compiler	gcc
Kurt Zeilenga's avatar
Kurt Zeilenga committed
48
>	CFLAGS		C flags		-O -g
Kurt Zeilenga's avatar
Kurt Zeilenga committed
49
>	CPPFLAGS	cpp flags	-I/path/include -D__FOO__=42
Kurt Zeilenga's avatar
Kurt Zeilenga committed
50
51
52
53
>	LDFLAGS		ld flags	-L/usr/local/lib
>	LIBS		libraries	-llib
>	PATH		command path	/usr/local/bin:/usr/bin:/bin

54
55
56
!if $var{'OPT_TARGET'} eq 'txt'
.See doc/install/configure for generic configure documentation.
!endif
Kurt Zeilenga's avatar
Kurt Zeilenga committed
57

58
59
60
+ Configure the build system:

E:	% ./configure [options] [var=value ...]
Kurt Zeilenga's avatar
Kurt Zeilenga committed
61

62
63
64
65
.If all goes well, the {{EX:configure}} script will automatically detect
the appropriate settings.  If the {{EX:configure}} script fails, you should
read the {{FILE:config.log}} file that it generated to see what it was trying
to do and exactly what failed.  You may need to specify additional
66
options and/or variables besides those listed above to
67
68
69
obtain desired results, depending on your operating system. The
{{Platform Hints}} section of the {{FAQ}} provides help for operating system
related problems.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
70

71
+ Build dependencies:
Kurt Zeilenga's avatar
Kurt Zeilenga committed
72
73
74

E:	% make depend

75
+ Build the system:
Kurt Zeilenga's avatar
Kurt Zeilenga committed
76
77
78
79

E:	% make

.If all goes well, the system will build as configured.  If not,
80
81
82
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.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
83

84
+ Test the standalone system:
Kurt Zeilenga's avatar
Kurt Zeilenga committed
85

86
.This step requires the standalone LDAP server, {{slapd}}(8),
87
with {{MDB}} support.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
88

89
E:	% make test
Kurt Zeilenga's avatar
Kurt Zeilenga committed
90
91

.If all goes well, the system has been built as configured.  If not,
92
return to step 2 after reviewing your configuration settings.  You
93
94
may want to consult the {{Installation}} section of the {{FAQ}}
if you have not done so already.
Kurt Zeilenga's avatar
Kurt Zeilenga committed
95

96
+ Install the software.  You may need to become the
Kurt Zeilenga's avatar
Kurt Zeilenga committed
97
98
{{super-user}} (e.g. {{EX:root}}) to do this (depending on where you
are installing things):
Kurt Zeilenga's avatar
Kurt Zeilenga committed
99

100
E:	% su root -c 'make install'
Kurt Zeilenga's avatar
Kurt Zeilenga committed
101

102
+ That's it.  Enjoy!
Kurt Zeilenga's avatar
Kurt Zeilenga committed
103

Kurt Zeilenga's avatar
Kurt Zeilenga committed
104
105
See the {{OpenLDAP Administrator's Guide}} and the manual pages
for the individual applications for configuration and use information.
106
107
108
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
109
{{FILE:/usr/local/etc/openldap}}).
Kurt Zeilenga's avatar
Kurt Zeilenga committed
110
111
112

>	ldap.conf		client defaults
>	slapd.conf		Standalone LDAP daemon
113
>	schema/*.schema		Schema Definitions
Kurt Zeilenga's avatar
Kurt Zeilenga committed
114