Penrose 0.9.9 Modules

Modules provide a way to extend the functionality of the virtual directory. See Module API. Module configuration can be found in PENROSE_HOME/conf/modules.xml.

<module>

    <module-name>MyModule</module-name>
    <module-class>com.mycompany.MyModule</module-class>

    <parameter>
        <param-name>something</param-name>
        <param-value>some value</param-value>
    </parameter>

</module>

<module-mapping>

    <module-name>MyModule</module-name>
    <base-dn>ou=groups,dc=penrose,dc=safehaus,dc=org</base-dn>
    <filter>(objectClass=*)</filter>
    <scope>ONELEVEL</scope>

</module-mapping>

To define a module, you need to specify:

  • Module Name
  • Module Class
  • Parameters

A module can be mapped to entries or subtrees in the virtual directory. You will need to specify:

  • Module Name
  • Base DN
  • Filter
  • Scope

Penrose contains 2 built-in modules:

  • Polling Connector Module
  • LDAP Sync Module

Polling Connector Module

Polling Connector module can be used to monitor the data source for any changes and update Penrose's cache data immediately.

LDAP Sync Module

LDAP Sync Module can be used to improve performance, reliability, and scalability by storing the directory entries in an external LDAP server.