5 Installing Oracle Identity Manager on Microsoft Windows

This chapter explains how to install Oracle Identity Manager on Microsoft Windows in a nonclustered installation.

See Also:

Chapter 9, "Deploying Oracle Identity Manager in a Clustered WebSphere Configuration" for information about deploying Oracle Identity Manager in a clustered installation

You must install Oracle Identity Manager on systems running the application server. Oracle Identity Manager components such as the Remote Manager and Design Console can be installed on separate systems. Each component has its own installer.

This chapter discusses the following topics:

• Installing the Database Schema

• Installing Documentation

• Installing Oracle Identity Manager on Microsoft Windows

• Removing Oracle Identity Manager

Caution:

Do not use a remote client tool, such as Symantec pcAnywhere, to install Oracle Identity Manager products.

5.1 Installing the Database Schema

As part of the installation, the Oracle Identity Manager Installer loads a schema into the database. You only install the database schema once. It is installed the first time you run the Oracle Identity Manager Installer. Each time you run the installer to deploy other Oracle Identity Manager components, you enter information about the database connection to configure the component for the same schema. If required, contact your database administrator (DBA).

Note:

During the schema installation, a log file is created in the OIM_HOME\logs directory.

5.2 Installing Documentation

Oracle Identity Manager documentation is installed automatically in the OIM_HOME directory. A full documentation set is installed with each Oracle Identity Manager component.

5.3 Installing Oracle Identity Manager on Microsoft Windows

This section describes how to install Oracle Identity Manager on a computer running Microsoft Windows.

Caution:

Do not install Oracle Identity Manager on top of an existing Oracle Identity Manager installation. For each new installation, use a different home directory. If you want to reuse the name of an existing Oracle Identity Manager home directory, then back up your original Oracle Identity Manager home by renaming that directory.

Remember that all Oracle Identity Manager components must be installed on different home directories. For example, you cannot install the Remote Manager in the same directory as Oracle Identity Manager.

To install Oracle Identity Manager on a Microsoft Windows host:

1. Before installing Oracle Identity Manager, you must set the JAVA_HOME and PATH variables by following the procedure specific to the operating system that you use. Refer to the "Setting Environment Variables" section for information about setting environment variables.

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

   Note:

   If the autostart routine is enabled for the computer, then proceed to Step 3.

3. Using the Windows Explorer, navigate to the installServer directory on the installation CD, and double-click the setup_server.exe file.

4. Select a language on the Installer page and click OK. The Welcome page is displayed.

5. Click Next on the Welcome page. The Admin User Information page is displayed.

6. Enter the password that you want to use as the Oracle Identity Manager administrator, confirm the password by entering it again, and then click Next. The OIM Application Options page is displayed.

7. Select one of the following applications to install, and then click Next:

   • Oracle Identity Manager

   • Oracle Identity Manager with Audit and Compliance Module

     See Also:

     Oracle Identity Manager Audit Report Developer's Guide for information about the Audit and Compliance Module

8. After the Target directory page is displayed, complete one of the following:

   • The default directory for Oracle Identity Manager is C:\oracle. To install Oracle Identity Manager into this directory, click Next.

   • To install Oracle Identity Manager into another directory, enter the path in the Directory field, and then click Next.

   Or:

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

   Note:

   If the directory path does not exist, then the Base Directory settings field is displayed. Click OK. The directory is automatically created. If you do not have write permission to create the default directory for Oracle Identity Manager, then a message is displayed informing you that the installer could not create the directory. Click OK to close the message, and then contact your system administrator to obtain the appropriate permissions.

9. On the Database Server Selection page, specify the type of database that you are using with Oracle Identity Manager, then click Next.

10. On the Database Information page, provide all database connectivity information that is required to install the database schema.

    You install this schema just once, as part of your initial Oracle Identity Manager installation. After this, you configure all the other Oracle Identity Manager components to point to this common schema.

    Note:

    To install against an existing database, verify that the release of Oracle Identity Manager you are installing is certified with the existing database version. See Oracle Identity Manager Readme for information about certified configurations.

    When Oracle Identity Manager is installed against an existing database, a warning message is displayed indicating that the database schema already exists and instructing you to copy the .xldatabasekey file from the existing Oracle Identity Manager installation to the new OIM_HOME\xellerate\config\ directory after you complete the installation process.

    You must create the \config directory in the new OIM_HOME\xellerate\ path if it does not exist.

    • In the host field, enter the host name or the IP address of the computer on which the database is installed.

    • In the PORT field, enter the port number on which the database listens for connections. The default port is 1521 for Oracle Database and 1433 for Microsoft SQL Server.

    • In the Database SID field, enter the name of the database instance.

    • In the User Name field, enter the user name of the database account that you created for Oracle Identity Manager.

    • In the Password field, enter the Oracle Identity Manager database user password.

    • Click Next to commit the settings.

      Note:

      When you set the preceding items, see the configuration settings specified in "Using an Oracle Database for Oracle Identity Manager" or "Using a Microsoft SQL Server Database for Oracle Identity Manager" to verify your settings.

      The installer checks for database connectivity if a database schema exists. If the check passes, then the installer proceeds to the next step in the process. If the check fails, then an error message is displayed.

    • Select the appropriate database options:

      • If a database exists and the connectivity is good, then proceed to Step 11.

      • If no connectivity is detected, then you are prompted to enter new information or to fix the connection. After you do that, click Next.

11. On the Authentication Information page, select either the Oracle Identity Manager Default Authentication or SSO Authentication option. If you select Single Sign-On authentication, then you must provide the header variable used in the Single Sign-On system in the Enter the header value for SSO Authentication field. Click Next.

12. On the Application Server Selection page, select IBM WebSphere, and then click Next.

13. On the Cluster Information page, specify whether the server configuration is clustered or nonclustered.

    For a nonclustered installation, select No, and then click Next.

    If you are deploying in a clustered installation, then select Yes, enter the cluster name, and refer to the "Deploying Oracle Identity Manager in a Clustered WebSphere Configuration" section for more information.

14. On the WebSphere Directory Information page, enter the information appropriate for the application server and Java installation:

    1. Enter the full path to the WebSphere installation directory. Ensure that you include AppServer in this path, for example: C:\Program Files\IBM\WebSphere\AppServer.

       Alternatively, click Browse and navigate to the location of the WebSphere installation directory.

    2. Enter the path to the JDK associated with the WebSphere application server. Do not include JRE in this path. For example, a valid path might be: C:\Program Files\IBM\WebSphere\AppServer\java.

       Alternatively, click Browse and navigate to the location of the JDK installation.

    3. Click Next.

15. On the WebSphere Details page, enter the following application server information:

    1. Enter the host name or IP address for the computer on which the application server is running. You can enter localhost for a local installation.

    2. Enter the cell name mentioned in the "Obtaining the WebSphere Cell and Node Name" section.

    3. Enter the node name, mentioned in the "Obtaining the WebSphere Cell and Node Name" section.

    4. For the WebSphere server name, enter the Oracle Identity Manager server name. The default server name is server1.

    5. For the profile name, enter AppSrv01 or the directory name under the WEBSPHERE_HOME\profiles\ directory based on the operating system.

    6. Click Next.

16. Back up the application server when the Application Server Configuration Backup page is displayed, then click Next to initiate server installation.

17. On the Summary page, click Install to initiate the server software installation.

18. If the installer detects an existing database, then you use that database.

    Select Yes, then click Next.

    If the existing database is not encrypted, then you are prompted to encrypt it. Select Yes, then click Next.

19. After Oracle Identity Manager is installed, a message is displayed listing the location of the installer log file and the subsequent steps that you must perform.

    Click OK and complete the postinstallation steps listed in the message.

20. On the Completed page, click Finish to exit the installer.

    After installing Oracle Identity Manager, follow the instructions in "Postinstallation Configuration for Oracle Identity Manager and IBM WebSphere Application Server".

5.4 Removing Oracle Identity Manager

To remove an Oracle Identity Manager installation:

1. Stop Oracle Identity Manager if it is running, and stop all Oracle Identity Manager processes.

2. Delete the OIM_HOME directory in which you installed Oracle Identity Manager.