]>
Commit | Line | Data |
---|---|---|
806557a5 | 1 | Making and Installing the OpenLDAP Distribution |
122a5d2f | 2 | =============================================== |
42e0d83c | 3 | |
122a5d2f | 4 | This file provides brief instructions on how to build and install |
c922e5db | 5 | OpenLDAP on UNIX (and UNIX-like) systems. More detailed information |
d48e6dd7 | 6 | and instructions can be found in The OpenLDAP Administrator's Guide |
1257469b | 7 | (available from http://www.openldap.org/doc/). |
42e0d83c | 8 | |
122a5d2f KZ |
9 | It is recommended that you read, or at least skim through, ALL of the |
10 | instructions in this file before attempting to build the software. | |
42e0d83c | 11 | |
122a5d2f KZ |
12 | Making and Installing the OpenLDAP Distribution |
13 | ----------------------------------------------- | |
42e0d83c | 14 | |
122a5d2f | 15 | 1. Unpack the distribution and change directory: |
42e0d83c | 16 | |
122a5d2f KZ |
17 | % tar xfz openldap-VERSION.tgz |
18 | % cd openldap-VERSION | |
37b4b3f6 | 19 | |
122a5d2f KZ |
20 | (replacing VERSION with the appropriate version string). If you |
21 | are reading this file, you probably have already done this! | |
42e0d83c | 22 | |
122a5d2f | 23 | 2. Type: |
42e0d83c | 24 | |
122a5d2f | 25 | % ./configure --help |
42e0d83c | 26 | |
275f3be3 | 27 | to list available configuration options. |
42e0d83c | 28 | |
c922e5db HF |
29 | The configure script also looks for compiler/linker options on |
30 | the command line and in the environment. These include: | |
42e0d83c | 31 | |
d48e6dd7 | 32 | Variable Description Example |
122a5d2f KZ |
33 | CC C compiler gcc |
34 | CFLAGS C flags -O -g | |
c922e5db | 35 | CPPFLAGS cpp flags -I/path/include -D__FOO__=42 |
122a5d2f KZ |
36 | LDFLAGS ld flags -L/usr/local/lib |
37 | LIBS libraries -llib | |
38 | PATH command path /usr/local/bin:/usr/bin:/bin | |
42e0d83c | 39 | |
a1cc0bf5 KZ |
40 | See doc/install/configure for generic configure documentation. |
41 | ||
e57e0a2f | 42 | 3. Configure the build system: |
42e0d83c | 43 | |
c922e5db | 44 | % ./configure [options] [var=value ...] |
2a869f5a | 45 | |
8dc6cc13 HC |
46 | If all goes well, the configure script will automatically detect |
47 | the appropriate settings. If the configure script fails, you | |
48 | should read the config.log file that it generated to see what it | |
c922e5db HF |
49 | was trying to do and exactly what failed. You may need to |
50 | specify additional options and/or variables besides those listed | |
51 | above to obtain desired results, depending on your operating | |
405e6b31 | 52 | system. |
42e0d83c | 53 | |
e57e0a2f | 54 | 4. Build dependencies: |
41f649ef | 55 | |
122a5d2f | 56 | % make depend |
41f649ef | 57 | |
e57e0a2f | 58 | 5. Build the system: |
41f649ef | 59 | |
122a5d2f | 60 | % make |
41f649ef | 61 | |
122a5d2f | 62 | If all goes well, the system will build as configured. If not, |
405e6b31 | 63 | return to step 3 after reviewing the configuration settings. |
41f649ef | 64 | |
e57e0a2f | 65 | 6. Test the standalone system: |
41f649ef | 66 | |
405e6b31 QGM |
67 | This step requires the standalone LDAP server, slapd(8), with MDB |
68 | support. | |
69 | ||
122a5d2f | 70 | % make test |
42e0d83c | 71 | |
122a5d2f | 72 | If all goes well, the system has been built as configured. If |
e57e0a2f | 73 | not, return to step 2 after reviewing your configuration |
405e6b31 | 74 | settings. |
42e0d83c | 75 | |
c922e5db | 76 | 7. Install the software. You may need to become the super-user |
e57e0a2f KZ |
77 | (e.g. root) to do this (depending on where you are installing |
78 | things): | |
42e0d83c | 79 | |
122a5d2f | 80 | % su root -c 'make install' |
41f649ef | 81 | |
e57e0a2f | 82 | 8. That's it. Enjoy! |
42e0d83c | 83 | |
d48e6dd7 KZ |
84 | See the OpenLDAP Administrator's Guide and the manual pages for the |
85 | individual applications for configuration and use information. You may | |
86 | also want to edit the configuration files used by the various | |
87 | components. These configuration files are located in the OpenLDAP | |
88 | configuration directory (normally /usr/local/etc/openldap). | |
3bd38313 | 89 | |
122a5d2f | 90 | ldap.conf client defaults |
122a5d2f | 91 | slapd.conf Standalone LDAP daemon |
405e6b31 | 92 | lload.conf LDAP Load Balancer daemon |
122a5d2f | 93 | schema/*.schema Schema Definitions |
3bd38313 | 94 | |
2c21fdce | 95 | --- |
2c21fdce KZ |
96 | This work is part of OpenLDAP Software <http://www.openldap.org/>. |
97 | ||
073232bb | 98 | Copyright 1998-2024 The OpenLDAP Foundation. |
2c21fdce | 99 | All rights reserved. |
e3a4c4ec KZ |
100 | |
101 | Redistribution and use in source and binary forms, with or without | |
102 | modification, are permitted only as authorized by the OpenLDAP | |
103 | Public License. | |
104 | ||
105 | A copy of this license is available in the file LICENSE in the | |
106 | top-level directory of the distribution or, alternatively, at | |
107 | <http://www.OpenLDAP.org/license.html>. | |
108 | ||
109 | OpenLDAP is a registered trademark of the OpenLDAP Foundation. |