README
1src/test/ldap/README
2
3Tests for LDAP functionality
4============================
5
6This directory contains a test suite for LDAP functionality. This
7requires a full OpenLDAP installation, including server and client
8tools, and is therefore kept separate and not run by default. You
9might need to adjust some paths in the test file to have it find
10OpenLDAP in a place that hadn't been thought of yet.
11
12Also, this test suite creates an LDAP server that listens for TCP/IP
13connections on localhost without any real access control, so it is not
14safe to run this on a system where there might be untrusted local
15users.
16
17Running the tests
18=================
19
20NOTE: You must have given the --enable-tap-tests argument to configure.
21
22Run
23 make check
24or
25 make installcheck
26You can use "make installcheck" if you previously did "make install".
27In that case, the code in the installation tree is tested. With
28"make check", a temporary installation tree is built from the current
29sources and then tested.
30
31Either way, this test initializes, starts, and stops a test Postgres
32cluster, as well as a test LDAP server.
33
34Requirements
35============
36
37LDAP server and client tools are required.
38
39Debian/Ubuntu packages: slapd ldap-utils
40
41RHEL/CentOS/Fedora packages: openldap-clients openldap-servers
42(You will already have needed openldap and openldap-devel to build.)
43
44FreeBSD: openldap-server
45(You will already have needed openldap-client to build. If building
46from the ports source tree, you want to build net/openldap24-client
47and net/openldap24-server.)
48
49macOS: We do not recommend trying to use the Apple-provided version of
50OpenLDAP; it's very old, plus Apple seem to have changed the launching
51conventions for slapd. The paths in the test file are set on the
52assumption that you installed OpenLDAP using Homebrew or MacPorts.
53