Project Aristotle Files

Introduction
============
The OpenDS Provider for ArisID is a demonstration of how to embed OpenDS
within an application server and to enable ArisID enabled applications to use
it.

For developers this allows standalone development of applications storing and
managing personal information in an IGF compliant way. Additionally developers
of applications may choose to include ArisID, the OpenDS Provider for ArisID and 
OpenDS subject to the terms of APL 2.0 and CDDL (the license for OpenDS).

Then, in the future, if a deployer needs more than a local directory store, the
deployer can choose to configure a different provider that has more features
such as virtualization and support for external LDAP servers and other
protocols without modification to the client application.

Installation instructions
=========================
This project requires OpenDS server distribution (version 2.2) as a separate 
download due to differing licenses between projects. You can obtain OpenDS from
  opends.org

For Eclipse developers, to install OpenDS, follow the instructions on OpenDS.org 
for running OpenDS in Eclipse at this URL:
https://www.opends.org/wiki/page/BuildingAndRunningOpenDSWithinEclipse

Note that the OpenDS provider code assumes that the OpenDS server root (with 
config files and libraries) will be installed in a folder called "server" at 
the top level of your project folder.

This same configuration should be able to run within NetBeans and JDeveloper. 
Instructions on other IDE environments to be provided soon. 

To configure ArisID to use the OpenDS provider, set the java property
org.openliberty.arisid.stack 
 to 
org.openliberty.arisid.provider.opends.DsProvider

If you play around with OpenDS running in embedded form, you will note that you
can enable many of the directory servers normal LDAP features such as the
LDAP listener and administrative services.

Provider Project Notes
======================
If you are playing with the ArisID source project, you will need to copy the 
following jars to the "lib" folder of the org.openliberty.arisid.provider.opends
project:
  OpenDS.jar
  servlet-api.jar
  
As instructed above, a copy of the OpenDS "server" folder must also be copied
to the top level of the provider project.

LICENSING
=========
These libraries and source are licensed under Apache License 2.0

This project depends on OpenDS which is available from OpenDS.org under CDDL.