Best Practices from Oracle Development's A‑Team

Configuring Design Console for OIM 11g


In OIM 11g, Design Console still is a required tool for system configuration, custom development and customization. It is now part of the Server installation procedure. Read this article to understand how to install the Design Console by itself on your own personal laptop or Desktop.

Main Article

But unlike the Design console for OIM 9.x, Design Console 11g does not have its own installer anymore. It is installed and configured along with the OIM server installation.

One of the common questions around Design Console 11g is: if there is no installer anymore, how do I get it working on my desktop/laptop without installing the whole Identity and Access Management pack?

This is an easy task and this post describes the steps for getting it done:

1. If you don't have a JDK 1.6 in your laptop, you will have to install it.

2. Run the configuration script for OIM once again. The script is available at $IAM_HOME/bin (where IAM_HOME is the folder where the ‘Identity and Access Management Pack’ was installed). You have to run the ‘config.sh’ that is available at $IAM_HOME/bin folder and NOT the one available at ‘$IAM_HOME/common/bin/config.sh’

3. In the configuration wizard, select ‘Design Console’ checkbox ONLY.


4. In the next screen, enter the OIM server host and port name. The wizard will configure the Design Console files for you

5. Copy the ‘$WL_HOME/server/lib/wlfullclient.jar’ to ‘$IAM_HOME/designconsole/ext’. If the wlfullclient.jar hasn’t been generated yet, follow the steps available here to generate it.

6. Using your favorite FTP/SCP tool, copy the whole ‘$IAM_HOM/designconsole’ folder and its contents to your laptop/desktop

7. Now, in your laptop/desktop, edit the file ‘$DC_HOME/designconsole/xlclient.cmd’ ($DC_HOME is the folder where you copied the ‘designconsole’ folder) to change the following values:
  • "@loc\java\bin\java" - '@loc' points to your JDK installation
  • "-DXL.HomeDir=@loc" - '@loc' will be  $DC_HOME/designconsole
  • "config\@auth_config" - '@auth_config' will be authwl.conf
The picture below shows the file after editing:

Extra steps for OIM R2

if you are running OIM 11g R2, there are a couple of extra steps:

1. Copy (or ftp) the ‘$MIDDLEWARE_HOME/oracle_common/modules/oracle.jrf_11.1.1/jrf-api.jar’ library file to ‘$DC_HOME/designconsole/ext’

2. Edit the file $DC_HOME/classpath.bat and add ";.\ext\jrf-api.jar" to Java classpath statement

That's all! Your Design Console can now be used from your laptop/desktop to connect to the remote OIM Server. All you have to do is to double-click on the 'xlclient.cmd'!

Be the first to comment

Comments ( 0 )
Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.Captcha