Introduction

Starting from Penrose 2.0 the service configuration is no longer stored in PENROSE_SERVER_HOME/conf/server.xml. Instead, now each service has been moved into a separate directory under the PENROSE_SERVER_HOME/services directory. Each service directory will have the following directory structure:

<service directory>/
 + SERVICE-INF/
    + service.xml
    + classes/
    + lib/
 + <supporting files>

The service.xml contains the configuration parameters for the service.

<service enabled="true">

  <service-class>...</service-class>

</service>

LDAP Service

The LDAP service provides interface for connecting via LDAP protocol. There are 3 built-in implementations:

• OpenDS: this service is implemented using OpenDS 1.0
• LDAP: this service is implemented using MINA 1.0
• ApacheDS: this service is implemented using Apache DS 1.0

The default LDAP service is OpenDS. To change the LDAP service, edit SERVICE-INF/service.xml and set the "enabled" parameter appropriately. You can also run multiple LDAP services as long as they are listening to different ports.

JMX Service

The JMX service provides interface for connecting via JMX protocol. This service is needed to connect using Penrose Studio.

Custom Service

To create a custom service, simply create a new directory under PENROSE_SERVER_HOME. Specify the service name and class name in SERVICE-INF/service.xml. Put compiled Java code in SERVICE-INF/classes. Put the library files in the SERVICE-INF/lib directory.