About OpenDS

OpenDS is a 100% pure Java, open source, directory server designed for large deployments. To know more about OpenDS visit its homepage.

For installation instructions download "Quick Setup" Web Start installer and read step-by-step instructions. As far as integration of OpenDS goes, the values of installation path, LDAP listener port, administrative User DN/password and the Directory Base DN, that you provide during installation are critically important.

About Adempiere

Adempiere is a ERP/CRM suite based on Compiere. To know more about Adempiere read the tutorials and manuals.

Integrating OpenDS with Adempiere

Starting and Configuring OpenDS

OpenDS can be started using the start-ds utility. The first thing you would want to do after starting OpenDS is to import data.

For importing large data sets into OpenDS, read the instructions here. In case the existing data is not in ldif format, makeldif tool should be used. To import data which is in ldif format, import-ldif tool can be used. The output of makeldif can be used with import-ldif to import data into server.

Alternately, ldapmodify can be used to import LDIF file. This is what we are going to do in this example. To add a user, the small LDIF file shown below is used.

dn: uid=praneet.tiwari,dc=example,dc=com
changetype: add
objectClass: top
objectClass: person
objectClass: organizationalPerson
objectClass: inetOrgPerson
uid: praneet.tiwari
givenName: Praneet
sn: Tiwari
cn: Praneet Tiwari
mail: Praneet.Tiwari@sun.com
userPassword: password

Now ldapmodify can be used to import this user into OpenDS. The example below shows the use of ldapmodify on Windows.

C:\Program Files\openDs\bat>ldapmodify.bat -p 389 -a -D"cn=Directory Manager" -w tiger -f c:\add.ldif

Also, the ldapsearch utility can be used to search existing entries in the OpenDS server.

Starting and configuring Adempiere

Adempiere server is started using RUN_Server2 utility. The client is started using RUN_Adempiere. On starting the client, a screen similar to the one shown below is presented. For now, let us not worry about the User ID and Password, that is what we are going to play around with.

Adempiere comes with the following predefined users: System, SuperUser, GardenAdmin, GardenUser.

Using OpenDS for authenticating Adempiere users

Login as “System”. Password for the System user is “system”. “System” is a predefined user with system management priviliges.

On logging in you would be presented with a screen similar to the one shown below. Just click on tick mark.
Goto Menu->System Admin-> General Rules ->System
Fill the “LDAP Server field” in the screen presented next
Logout and now login as SuperUser.
Goto Menu->General Rules->Security->User
In user contact field, fill the Name field
Now you can start using the ldap username and password

That's all to it!!!