|Oracle® Fusion Middleware Installation Guide for Oracle Identity Management
11g Release 1 (11.1.1)
Part Number E12002-04
This topic describes how to install and configure only Oracle Identity Manager (OIM) Design Console, which is supported on Windows operating systems only.
It includes the following sections:
Perform the installation and configuration in this topic if you want to install Oracle Identity Manager Design Console on a separate Windows machine where Oracle Identity Manager Server is not configured. For more information, see Scenario 1: Oracle Identity Manager Server and Design Console on Different Machines.
Performing the installation and configuration in this section deploys only Oracle Identity Manager Design Console on Windows operating systems.
The installation and configuration in this section depends on the installation of Oracle Identity Management 11g software and on the Oracle Identity Manager Server. For more information, see Installing the Oracle Identity Management 11g Software and Configuring OIM Server.
Perform the following steps to install and configure only Oracle Identity Manager Design Console on the Windows operating system:
Ensure that all the prerequisites, described in Prerequisites for Configuring Only OIM Design Console on a Different Machine, are satisfied. In addition, see Important Notes Before You Start Configuring OIM.
On the Windows machine where Oracle Identity Manager Design Console sound be configured, start the Oracle Identity Manager Configuration Wizard, as described in Starting the Oracle Identity Manager 11g Configuration Wizard. The Welcome screen appears.
On the Welcome screen, click Next. The Components to Configure screen appears.
On the Components to Configure screen, select only the OIM Design Console check box. Click Next. The OIM Server Host and Port screen appears.
On the OIM Server Host and Port screen, enter the host name of the Oracle Identity Server Manager Server in the OIM Server Hostname field. In the OIM Server Port field, enter the port number for the Oracle Identity Manager Server on which the Oracle Identity Manager application is running. Click Next. The Configuration Summary screen appears.
The Configuration Summary screen lists the application that you selected for configuration and summarizes your configuration options, such as OIM Server host name and port.
Review this summary and decide whether to start the configuration. If you want to modify any of the configuration settings at this stage, select a topic in the left navigation page and modify your choices. To continue installing this configuration of the Oracle Identity Management Design Console, click Configure.
Note:Before configuring an application, you can save your configuration settings and preferences in a response file. Response files are text files that you can create or edit in a text editor. You can use response files to perform a silent installation or use as templates or customized settings for your environment. For more information, see Performing a Silent Installation.
After you click Configure, the Configuration Progress screen appears. A configuration log is saved to the
logs directory under Oracle Inventory directory. For information about the log files, see Installation Log Files. If the Configuration Progress screen displays any errors, click Abort to stop the installation and restart the Oracle Identity Manager Configuration Wizard.
Note:If the configuration fails, click Abort to stop the installation and restart the Oracle Identity Manager Configuration Wizard, as described in Starting the Oracle Identity Manager 11g Configuration Wizard.
Complete the following steps after configuring the Oracle Identity Manager Design Console on Windows operating systems:
On the machine where Oracle WebLogic Server is installed (the machine where Oracle Identity Manager Server is installed), create the
wlfullclient.jar file as follows:
cd command to move from your present working directory to the
Ensure that JAVA_HOME is set, as in the following example:
To set this variable, right-click the My Computer icon and select Properties. The System Properties screen is displayed. Click the Advanced tab and click the Environment Variables button. The Environment Variables screen is displayed. Ensure that the JAVA_HOME variable in the User Variables section is set to the path of the JDK directory installed on your machine.
After setting the JAVA_HOME variable, select the Path variable in the System Variables section on the same Environment Variables screen, and click Edit. The Edit System Variable dialog box is displayed. In the variable value field, enter the complete path to your JAVA_HOME, such as D:\oracle\<Middleware_Home>\jdk160_11, preceded by a semicolon (;). The semicolon is used as the delimiter for multiple paths entered in this field.
After verifying the values, click OK.
At the DOS command prompt, type the following command:
java -jar <Middleware_Home>modules/com.bea.core.jarbuilder_126.96.36.199.jar
This command generates the
wlfullclient.jar file to the
<Oracle_IDM2>\designconsole\ext\ directory on the machine where Design Console is configured.
Ensure that the Administration Server and the Oracle Identity Manager Managed Server are started. For information about starting the servers, see Starting the Stack.
Start the Design Console client by running the
xlclient.cmd executable script, which is available in the
Log in to the Design Console with your Oracle Identity Manager user name and password.
To update the
xlconfig.xml file and start the Design Console on a new port as opposed to what was set during configuration, complete the following steps:
In a text editor, open the
Edit the following tags:
Change the port number.
Restart the Design Console.
Note:You do not have to perform this procedure during installation. It is required if you want to change ports while using the product. You must ensure that the Oracle Identity Manager server port is changed to this new port before performing these steps.
To configure the Design Console to use SSL, complete the following steps:
Add the WebLogic Server jar files required to support SSL by copying the
webserviceclient+ssl.jar file from the
<WL_HOME>/server/lib directory to the
Use the server trust store in Design Console as follows:
Log in to the WebLogic Administration Console using the WebLogic administrator credentials.
Under Domain Structure, click Environment > Servers. The Summary of Servers page is displayed.
Click on the Oracle Identity Manager server name (for example, oim_server1). The Settings for oim_server1 is displayed.
Click the Keystores tab.
From the Trust section, note down the path and file name of the trust keystore.
TRUSTSTORE_LOCATION environment variable as follows:
If Oracle Identity Manager Design Console and Oracle Identity Manager Server are installed and configured on the same machine, set the
TRUSTSTORE_LOCATION environment variable to the location of the trust keystore that you noted down.
If Oracle Identity Manager Design Console and Oracle Identity Manager Server are installed and configured on different machines, copy the trust keystore file to the machine where Design Console is configured. Set the
TRUSTSTORE_LOCATION environment variable to the location of the copied trust keystore file on the local machine.
If the Design Console was installed without SSL enabled, complete the following steps:
<IDM_Home>/designconsole/config/xlconfig.xml file in a text editor.
<ApplicationURL> entry to use HTTPS, T3S protocol, and SSL port to connect to the server, as in the following example:
Note:For a clustered installation, you can send an https request to only one of the servers in the cluster, as shown in the following element:
Save the file and exit.