Configuration and build process

To configure and build the pow2toolkit library, follow those steps:

Database

Create the example "toolkit" database; up to now, the distribuition supports the following rdbms:

The database data files are stored into the $POW2TOOLKIT_HOME/src/conf/db directory.

LDAP server

If you plan to use an LDAP server to store / authenticate user profiles, use the example $POW2TOOLKIT_HOME/src/conf/ldap/exampleTree.ldif file to populate the LDAP data base.

Note: the data contained into the exampleTree.ldif file will be use by the Cactus LDAP test suite.

LDAP resources
Open LDAP OpenLDAP Software is an open source implementation of the Lightweight Directory Access Protocol.
JLDAP The LDAP Class Libraries for Java (JLDAP) enable you to write applications to access, manage, update, and search for information stored in directories accessible using LDAPv3.

Toolkit configuration

Open the toolkit's configuration.properties file; this file provides default example values; set them according to your environment.

To use the LDAP User authentication, set the toolkit configuration.properties file as follow:

sectiondescription
LDAP support set the set the LDAP server connection properties and the attributes mapping between the com.pow2.user.User class and the LDAP inetOrgPerson class
User data set the user_data_provider key value to ldap

Build process

The buid process uses Apache Maven 1.0 as build tool. Please read the getting started with Maven document to install and understand how to use it.

Edit the $POW2TOOLKIT_HOME/project.properties file and set the value of maven.repo.remote property according to your environment. I.e.:

                   
# specifies to the remote repositories a comma-separated list of URLs;
maven.repo.remote = file://C:/code/java/maven_repo,http://www.ibiblio.org/maven
        

Open a shell, enter into the $POW2TOOLKIT_HOME directory and digit:

> maven
to build the library.Use
> maven war
to generate the $POW2TOOLKIT_HOME/target/pow2toolkit.war web application archive.

Tomcat: configuration of the Web application Context

Please note pow2toolkit is currently used and tested on Tomcat 4.1.x and 5.x servlet containers. Tomcat 3 is not supported anymore.

Tomcat 4.x

Please read the Tomcat4 Manager App HOW-TO to understand how to manage the deployment and the lifecycle of the web applications.