Setup Eclipse to Compile and Run OIM Custom Clients

Required Software

1. OIM Design Console. Its "lib", "ext", and "config" folders are required to compile and run a custom client.
2. A custom client project setup in Eclipse. Click here if you need a sample custom client.

Compile Settings

In order to compile a custom client the Design Console's 'lib' jar files need to be added to the build path.

 

1. First add a user library to Eclipse.

   Select menu item Window -> Preferences, then type in "user libraries" in the filter text.

   Click 'New' button, enter a library name (example 'oim-lib'), click 'Add Jars' button, and add all jars from the Design Console "lib" folder.

   Click OK to save and close Eclipse preferences dialog.

    

2. Second add the user library to the build path

   Select menu item Project -> Properties, type in "java build path" in the filter text.

   Click "libraries" tab. Click 'Add Library' button. Wizard will show up. Select 'User Library' and click next. Select 'oim-lib' and click Finish.

   Click OK to save and close project properties dialog.

Eclipse should now be able to compile the project.

Run and Debug Settings

In order to run and debug the custom client the Design Console's 'ext' folder needs to be added to classpath. Then the login configuration needs to be set.

If not already done so go in 'Run' -> 'Debug...' and add a new debug configuration of type 'Java Application'.

From debug configuration dialog click on tab 'Classpath', click on 'User Entries', click on 'Add External Jars', and add all jars from the Design Console "ext" folder.

Then click on tab 'Arguments', and add this VM argument : -Djava.security.auth.login.config="design-console-dir/Config/auth.conf"

Where 'design-console-dir' is the absolute path to the OIM Design Console.

Eclipse is now configured to run and debug the OIM custom client.