Friday, April 29, 2011

Configuring Design Console for OIM 11g

In OIM 11g, Design Console still is a required tool for system configuration, custom development and customization. But differently from 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 ‘’ that is available at $IAM_HOME/bin folder and NOT the one available at ‘$IAM_HOME/common/bin/’

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'!


  1. This is Super Cool stuff Thanks for the Post.
    I wanted to know one thing though. Is there any config file where the database connection is specified ?? because on my design console window is see connected to jdbc:oracle:thin@localhost:1521/orcl.

    Is this information picked from the java.naming.provider.url ??

    I just wanted to make sure that my design console is reading data form the server and not from the local database on the client machine

  2. Although Design Console shows the database URL on the window bar, it does NOT connect directly to the database. Design Console will always connect to the OIM server specified in the configuration file. The database URL shown is retrieved from the OIM server.

  3. Bedanta,

    This is configured as a system property in OIM.
    You can turn it off if you dont want the URL to be displayed on your DC window.

  4. Thanks for the nice blog. Is it possible to modify designerconsole property files to point to a different OIM server ?

    1. Yes, you can modify the file and point to a different OIM server. But keep in mind that you should point to an OIM running on the same application server type and on the same version number, otherwise you may end up with problems.


Note: Only a member of this blog may post a comment.