web2ldap - Installing

A brief description on how to install it
General
<Download> <News> <Demo> <Related>
Support
<Commercial> <Feedback> <FAQ>
Documentation
<Features> <Installing> <Configuration> <Compability> <Security> <Changes> <Files> <Roadmap>

Run modes

web2ldap is designed to be very flexible. It can be installed in two different modes running persistent as a multi-threaded server process under Win32 and Unix platforms:

stand-alone
You can start web2ldap as stand-alone web server running on a specific address (default is fully-qualified hostname) and port (default 1760). You can serve some other static web content in that mode (e.g. the .css files).
FastCGI
If you are running a web server with support for FastCGI you might want to consider running web2ldap as multi-threaded FastCGIServer.
SCGI
If you are running Apache web server with support for SCGI you might want to consider running web2ldap as SCGIServer.

Prerequisites

For running web2ldap 0.11.0+ you need:

Python (mandatory)
Python 2.0 or later (current supported and tested version is Python 2.2) built with thread support (configure --with-threads).
PyWebLib 1.2.0+ (mandatory)
Module package for web application programming.
python-ldap (mandatory)
You have to grab a recent pre-release 2.0.0pre06+ and build it against OpenLDAP 2.0.13+ libs.
PyDNS (optional)
If you want to make use of SRV RR's to automatically locate your LDAP server for a given dc-style DN you have to install this DNS module.
md4.py (optional)
This is needed if you want to set Samba NT passwords.

Web server

Additional web server software depends on the running mode:
Running mode Start script Web server Additional software needed SSL support
stand-alone sbin/web2ldap.py Python standard lib - currently not supported
CGI-BIN (cgi-fcgi wrapper) cgi-bin/web2ldap.fcgi Any web server with CGI support FastCGI Dev Kit and Python module fcgi.py. Apache SSL or Apache with mod_ssl
FastCGI server (mod_fastcgi) fcgi/web2ldap.py Apache mod_fastcgi and Python module fcgi.py. Apache SSL or Apache with mod_ssl
FastCGI server
(ISAPI/NSAPI)
fcgi/web2ldap.py Netscape/AOL, Sun/iPlanet or MS IIS FastCGI for ISAPI/NSAPI and Python module fcgi.py. built-in
SCGI server scgi/web2ldap.py Apache mod_scgi including the Python module Apache SSL or Apache with mod_ssl

Pre-compiled packages

There are some ready-to-use packages of the required software and web2ldap. Note that the Prerequisites have changed since web2ldap 0.11.x!

See python-ldap's download page for a comprehensive list of pre-compiled python-ldap packages.

Linux-Distributions

S.u.S.E.
Already has packages of OpenLDAP 2, Apache with mod_ssl and mod_fastcgi.
Red Hat
Various useful RPM packages for Red Hat 7.2
Debian
Potato includes various packages of Python, OpenLDAP and python-ldap for Python as well as ApacheSSL and Apache with mod_ssl.

FreeBSD

Oddbjorn Steffensen <oddbjorn@oddbjorn.bdc.no> maintains a FreeBSD port which you can directly retrieve via CVS from the FreeBSD archive.

Win32

There are currently no OpenLDAP 2 libs for Win32 available. Therefore python-ldap is currently not available on Win32. If you manage to make a Win32 build of python-ldap let me know. Contributors welcome!
The easiest way to use web2ldap on Win32 is to deploy cygwin and install pre-built packages for cygwin of Python 2.x, OpenLDAP libs and python-ldap.

Installing

  1. Install all required software on your system.
  2. Extract content of archive web2ldap-*.tar.gz to e.g. /usr/local. Regarding directory names under several Unix flavours: Your mileage may vary.
  3. Rename /usr/local/web2ldap-<version> to /usr/local/web2ldap.
  4. Edit configuration modules under [web2ldapdir]/etc/web2ldap/web2ldapcnf/ which contain comments about every configuration parameter. See also the documentation.
  5. Change current directory to the directory where you extracted web2ldap and invoke python [web2ldapdir]/sbin/compile.py or python -O [web2ldapdir]/sbin/compile.py for compiling all Python sources.
  6. Choose the right start script for your running mode (see table above) and adjust the path to the Python interpreter executable in the first line of the web2ldap.py script (see also python -h for usage of option -O and -OO for running with optimized bytecode generation).
  7. Configure and run WWW server:
    stand-alone
    [web2ldapdir]/sbin/web2ldap.py
    For a quick start as stand-alone web gateway simply invoke the script at the command-line which outputs the start URL before detaching from console.
    Any HTTP server with CGI-FCGI wrapper
    Install cgi-bin/web2ldap.fcgi to CGI-BIN directory of web server.
    Apache with mod_fastcgi
    See configuration directives in file etc/httpd/sample-mod_fastcgi.conf.
    Apache with mod_scgi
    See configuration directives in file etc/httpd/sample-mod_scgi.conf.

Page last modified: Friday, 30-May-2003 18:38:52 CEST, sponsored by
stroeder.com - Information Technology, IT-Security, Identity Management, System Integration