Building and installing¶
python-ldap is built and installed using the Python DistUtils installed along with your Python installation:
python setup.py build python setup.py install
If you have more than one Python interpreter installed locally you should use the same one you plan to use python-ldap with.
See further instructions for using DistUtils here: http://docs.python.org/install/index.html
The following software packages are required to be installed on the local system when building python-ldap:
- Python version 2.3 or later including its development files: http://www.python.org/
- OpenLDAP client libs version 2.4.11 or later: http://www.openldap.org/ It is not possible and not supported to build with prior versions.
- OpenSSL (optional): http://www.openssl.org/
- cyrus-sasl (optional): http://www.cyrussasl.org
- Kerberos libs, MIT or heimdal (optional)
The file setup.cfg allows to set some build and installation parameters for reflecting the local installation of required software packages. Only section [_ldap] is described here. More information about other sections can be found in the documentation of Python’s DistUtils.
Specifies in which directories to search for required libraries.
Specifies in which directories to search for include files of required libraries.
The LDAP protocol library of OpenLDAP. ldap_r is the reentrant version and should be preferred.
The BER encoder/decoder library of OpenLDAP.
The Cyrus-SASL library if needed and present during build
The SSL/TLS library of OpenSSL if needed and present during build
The basic cryptographic library of OpenSSL if needed and present during build
The following example is for a full-featured build (including SSL and SASL support) of python-ldap with OpenLDAP installed in a different prefix directory (here /opt/openldap-2.4) and SASL header files found in /usr/include/sasl. Debugging symbols are preserved with compile option -g.
[_ldap] library_dirs = /opt/openldap-2.4/lib include_dirs = /opt/openldap-2.4/include /usr/include/sasl extra_compile_args = -g extra_objects = libs = ldap_r lber sasl2 ssl crypto