10 Installing and Configuring the Oracle Identity Manager Design Console

This section explains how to install the Oracle Identity Manager Design Console, which is a Java client. You have the option to install the Design Console on the same computer as your Oracle Identity Manager server or on a separate computer.

This chapter discusses the following topics:

• Requirements

• Installing the Design Console

• Post-install Requirements for the Design Console

• Starting the Design Console

Requirements

Verify that your environment meets the following requirements for Design Console installation:

• You must have an Oracle Identity Manager server installed and running.

• If you are installing on a computer other than the host for the application server, you need to know the host name and port number of the computer hosting that application server.

• The Design Console host must be able to ping the application server host using both IP and hostname.

• For clustered Oracle Identity Manager server installations, you must know the host name and port number of the Web server.

  
  

  Note: If you cannot resolve the hostname of the application server, then try adding the hostname and IP address in the hosts file in the following directory: C:\winnt\system32\drivers\etc\

  
  

Installing the Design Console

The following procedure describes how to install the Design Console.

Important: All Oracle Identity Manager components must be installed in different home directories. If you are installing the Design Console on a machine that is hosting another Oracle Identity Manager component, such as the Oracle Identity Manager server or the Remote Manager, you must specify a different install directory for the Design Console.

To install the Design Console on a Windows host:

1. Insert the Oracle Identity Manager Installation CD into your CD-ROM drive.

2. Launch Windows Explorer, then navigate to the installServer directory on the installation CD.

3. Double-click the setup_client.exe file.

4. Choose a language from the list on the Installer screen.

   The Welcome page appears.

5. On the Welcome page, click Next.

6. On the target directory screen, complete one of the following sub-steps:

   1. The default directory for the Design Console is C:\oracle. To install the Design Console into this directory, click Next.

   2. To install the Design Console into another directory, enter the path in the Directory name field, then click Next.

      or

      Click Browse, navigate to the desired location, then click Next.

      
      

      Tip: If the directory path that you specified does not exist, the Base Directory settings text box appears: Click OK. Oracle Identity Manager creates this directory for the Oracle Identity Manager server. If you do not have write permission to create the default directory for the Oracle Identity Manager server, a dialog appears informing you that the installer could not create the directory. Click OK to dismiss the dialog, then contact your System Administrator to obtain the appropriate permissions.

      
      

7. On the Application Server page, select BEA WebLogic, then click Next.

   The Application Client Location page appears.

8. Specify the JRE to use with the Design Console, choosing between the JRE bundled with Oracle Identity Manager, or point to an existing and compatible JRE on the system.

   Click Next.

9. On the Application Server configuration page, enter the information appropriate for the application server hosting your Oracle Identity Manager server:

   1. Enter the host name or IP address in the upper text box.

   2. Enter the naming port for the application server on which Oracle Identity Manager is deployed in the lower text box.

      
      

      Note: The host name is case-sensitive.

      
      

   3. Click Next.

10. On the Graphical Workflow Rendering Information page, enter the Application server configuration information.

    1. Enter the Oracle Identity Manager server host IP address.

    2. Enter the port number.

    3. Select Yes or No to specify whether the Design Console should use SSL.

    4. Click Next.

11. On the Shortcut page, select or deselect the check boxes for the shortcut options according to your preferences:

    1. Choose to create a shortcut to the Design Console on the Start Menu.

    2. Choose to create a shortcut to the Design Console on the desktop.

    3. Click Next when you are satisfied with the check box settings.

12. On the Summary page, click Install to initiate Design Console installation.

13. The final installation page displays a reminder to copy certain application server-specific files to your Oracle Identity Manager server installation.

    Perform these steps and click OK.

14. Click Finish to complete the installation process.

Removing the Design Console Installation

To remove the Design Console installation:

1. Stop the Oracle Identity Manager server and the Design Console if they are running.

2. Stop all Oracle Identity Manager processes.

3. Delete the <XL_DC_HOME> directory where you installed the Design Console.

Post-install Requirements for the Design Console

Perform the following steps after installing the Design Console:

1. Copy <BEA_HOME>\weblogic81\server\lib\weblogic.jar on the machine hosting the Oracle Identity Manager Server to the <XL_DC_HOME>\xlclient\ext directory on the machine where the Design Console is installed.

2. If you are pointing the Design Console to a clustered server installation, edit the <XL_DC_HOME>\xlclient\Config\xlconfig.xml file and add the cluster members in the URL under the <Discovery> section and point the Application URL for Workflow Visualization to the webserver to access the cluster.

   For example:

   • <ApplicationURL>http://<webserver>/xlWebApp/

     LoginWorkflowRenderer.do</ApplicationURL>

   • <Discovery>.<CoreServer>.<java.naming.provider.url>t3://

     192.168.50.31:7005,192.168.50.32:7005 </java.naming.provider.url>

Starting the Design Console

Double-click <XL_DC_HOME>\xlclient\xlclient.cmd or select Design Console from the Windows Start menu or desktop.