All versions of LDAPHttp from 0.6 on require the use of a Java
1.4+ JRE/SDK.

In order to make use of the LDAPHttp framework, you need to add 
the files:

 ./lib/ldapjdk.jar
 ./lib/ldaphttp.jar

to the class path for the Java Virtual Machine (JVM) that runs 
your servlet container, or under the directory:

 [ JAVA HOME ]/jre/lib/ext/

For Tomcat, the recommended location for deploying these files 
is instead under:

 [ CATALINA HOME ]/shared/lib/

If you already have the Netscape LDAP Java SDK somehow visible, 
you do not need to add visibility to the ldapjdk.jar file above. 
However, you must be sure you are using version 4.1 or greater 
of the SDK for the LDAPHttp software to work properly.

To use the gateway, you will need to deploy the Web Application 
Archive:

 ./lib/gateway.war

Please consult your web server or servlet engine documentation 
for detailed instructions on how to do this. For a modern Tomcat 
installation where the relevant autoDeploy option is set to 
true (as it is by default), this can be accomplished by simply 
copying the file to the directory:

 [ CATALINA HOME ]/webapps/

and restarting the engine. Note that for security reasons, only 
the retrieve servlet is deployed by default. If you want to 
deploy the other gateway servlets, you will need to unpack the 
gateway.war file, edit its web.xml file, repack, and redeploy it.

To make use of LDAPHttp, you will need to define at least one 
local context package with at least one object. These are Java 
classes and must be compiled together in a package: 

 mentata.ldaphttp.<context name>

The context class must be named:

 mentata.ldaphttp.<context name>.localContext

Example context and person object classes are given in the files: 

 ./examples/localContext.java
 ./examples/person.java

You will need to modify these files to reflect your directory 
server. Make sure the ldaphttp.jar and ldapjdk.jar files are in 
your CLASSPATH during compilation, and that the source files are 
in a relative path:

 ./mentata/ldaphttp/<context name>/

The resulting compiled classes will need to be made visible to the 
servlet container, either by adding them to the contents of 
gateway.war, adding them to the JVM classpath, or making them 
available to the Java Runtime Engine (JRE). Please consult your 
web server or servlet engine documentation for detailed instructions 
on how to do this. For a Tomcat installation you can also put these 
files under: 

 [ CATALINA HOME ]/shared/classes/mentata/ldaphttp/<context name>/

or as a Java Archive (.jar) file under:

 [ CATALINA HOME ]/shared/lib/

*Warning*
Although there are no known security issues, the LDAPHttp Gateway 
servlets provide a great deal of capability and should be used 
cautiously. Mentata Systems currently recommends that the use of 
any Gateway servlet other than retrieve with production directory 
servers should be limited to an intranet or firewalled environment. 
At the very least, any use of directory authentication over the 
internet should be done with encrypted connections to protect account 
passwords.

Thank you for your interest in LDAPHttp. If you have any questions, 
problems, or suggestions, don't hesitate to contact Mentata Systems 
through the email addresses:

 questions@mentata.com
 problems@mentata.com
 suggestions@mentata.com

Your privacy is assured and your mail address will not be misused. 
For more information, see:

 http://www.mentata.com/privacy.htm