Building LDAP Proxy version 4.0 from Source Code            September 2004
    ------------------------------------------------

    [NOTE: Replace "4.0" in the following instructions with the
           actual version of the LDAP Proxy you are building.]


    LDAP Proxy version 4.0 will compile on either Linux or Sun/Solaris systems.

    Prerequisites:

        OpenLDAP 2.1.30

                Available from http://www.openldap.org/.  
                The LDAP Proxy is not compatible with
                OpenLDAP 2.2.x or OpenLDAP 2.3.x.

        getcert 4.0

                Available from SourceForge.net or Boeing.
                Contents:
                    ldap_proxy_4.0_source/configure.in
                    ldap_proxy_4.0_source/servers/slapd/back-getcert/
                    ldap_proxy_4.0_source/servers/slapd/backend.c
                    ldap_proxy_4.0_source/servers/slapd/result.c

        autoconf 2.13.1

                Used to build the OpenLDAP configuration file.
                This is a very old version of autoconf required by OpenLDAP.
                Note that version 2.13 won't work with OpenLDAP 2.1.30.
                Available from http://www.gnu.org/software/autoconf/

        automake 1.4a
        libtool 1.4.2

                Used by autoconf.
                Available from the GNU org: ftp://ftp.gnu.org/pub/gnu/



    1) Install the autoconf, automake, and libtool packages according to
        the "INSTALL" file contained in each package.


    2) Unpack the OpenLDAP 2.1.30 source code and rename it to
        "ldap_proxy_4.0_source".


                gunzip openldap-2.1.30.tgz
                tar xf openldap-2.1.30.tar
                mv openldap-2.1.30 ldap_proxy_4.0_source
                rm openldap-2.1.30.tar


    3) Uncompress and untar the getcert software into the top level of the
        OpenLDAP source code tree. 


                cd ldap_proxy_4.0_source
                gunzip getcert_4.0.tar.gz
                tar xf getcert_4.0.tar
                rm getcert_4.0.tar


    4) Set your CC, CPPFLAGS, and CFLAGS environment variables.
        For example, using the Korn shell:

                export CC=gcc
                export CPPFLAGS="-DFD_SETSIZE=8192 -DNDEBUG"
                
        For Solaris: export CFLAGS="-O -g -D_REENTRANT"
        For Linux:   export CFLAGS="-O -g"

        If autoconf version 2.13.1 is not the first autoconf in your PATH,
        set your PATH environment variable (example using the Korn shell):

                export PATH=/usr/local/autoconf_2.13.1/bin:$PATH


    5) Build the LDAP Proxy configuration file:


                cd ldap_proxy_4.0_source
                autoconf
                autoheader

        You can ignore the warning issued by autoconf about "AC_TRY_RUN".
        You must re-run autoconf and autoheader whenever you make changes
        to the "configure.in" file.


    6) Build the new configuration.  Set the "--prefix" option to the full 
        path of the directory you will be installing the LDAP Proxy into.


        cd ldap_proxy_4.0_source
        ./configure --prefix=/usr/local/apps/ldap_proxy_4.0 \
            --with-threads --without-tls --without-cyrus-sasl \
            --enable-debug --enable-syslog --enable-slapd --enable-getcert \
            --disable-ipv6 --disable-rlookups --disable-slurpd --disable-bdb


    7) Build and install the LDAP Proxy.  Be sure you have read/write access
        to the install directory specified by the "--prefix" option in the 
        configure command above.


        cd ldap_proxy_4.0_source
        make depend
        make
        make install


    8) Copy the LDAP Proxy support files into the newly installed LDAP proxy:


        cd ldap_proxy_4.0_source/servers/slapd/back-getcert/PROTO_FILES/
        tar cf - * | (cd /usr/local/apps/ldap_proxy_4.0; tar xlpf -)


    9) Set ownership and permission attributes in the installed LDAP Proxy:

        Log in as "root".
        cd /usr/local/apps/ldap_proxy_4.0/bin/
        # Edit the "PROXYHOME" line in the "set_permissions.sh"
        # script to point to the LDAP Proxy install directory
        # (Example: "PROXYHOME=/usr/local/apps/ldap_proxy_4.0").
        ./set_permissions.sh


    At this point the installed LDAP Proxy should look like the pre-compiled
    version Boeing distributes.  Continue with the configuration steps in
    section 6 (Proxy Administration) of the main LDAP Proxy web page
    "ldap_proxy_release_notes.html" now located in
    "/usr/local/apps/ldap_proxy_4.0/docs/".


                Marc Amis      September 2004
                Boeing Information Technology
                Bellevue, Washington      USA

    -----------------------------------------------------------------------
    LDAP Proxy Team

    Wen Fang     -  Architecture & Design         -  wen.fang@boeing.com
    Marc Amis    -  Development & Implementation  -  marc.amis@boeing.com
    Darryl Lang  -  Proxy Administration          -  darryl.p.lang@boeing.com
    -----------------------------------------------------------------------