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 in a Clustered BEA WebLogic Server 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.

Note:

You must ensure that BEA WebLogic Server is running during the Oracle Identity Manager installation.

This chapter discusses the following topics:

• Setting Environment Variables Before Installing Oracle Identity Manager

• 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.

Setting Environment Variables Before Installing Oracle Identity Manager

Before you install Oracle Identity Manager, perform the following steps to set the environment variables:

• Verify that the JAVA_HOME system variable is set to the appropriate Sun JDK. For example:

  set JAVA_HOME=c:\j2ksdk1.4.2_15
  

  See Also:

  Oracle Identity Manager Release Notes for information about certified JDK versions

• Verify that the Sun JVM C:\j2sdk1.4.2_15\ is being used when a Java command is run. To do this, include the Sun JDK bin directory, for example, C:\jdk142_15\bin\, in the PATH ahead of all other path entries, for example:

  set PATH = C:\j2sdk1.4.2_15\bin;%PATH%
  

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.

Installing Documentation

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

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 the original Oracle Identity Manager home by renaming that directory.Remember that all Oracle Identity Manager components must be installed in 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:

Note:

Microsoft SQL Server is not supported in Oracle Identity Manager release 9.1.0. See ÒCertified ComponentsÓ in Oracle Identity Manager Release Notes for information about certified components.

1. If you are using Microsoft SQL Server as database, then before installing Oracle Identity Manager, ensure that you copy the following three files located in C:\Program Files\Microsoft SQL Server 2000 Driver for JDBC\lib\ to the BEA_HOME\weblogic81\server\lib\ directory, and add the driver location to the system CLASSPATH environment variable:

   • mssqlserver.jar

   • msbase.jar

   • msutil.jar

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

   Note:

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

3. Using 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 box, 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, and 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. Thereafter, 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 version of Oracle Identity Manager you are installing is certified with your existing database version. See Oracle Identity Manager Release Notes for information about the 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 should create the \config directory in the new OIM_HOME\xellerate\ path if it does not already exist.

    Enter the following database information:

    • 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 these 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 and whether 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 BEA WebLogic, and click Next.

13. On the Cluster Information page, specify the server configuration (clustered or nonclustered).

    • Select No for nonclustered, and then click Next.

    • Select Yes for clustered, enter the cluster name, and then click Next.

      Note:

      Refer to Chapter 9, "Deploying in a Clustered BEA WebLogic Server Configuration" if you are deploying in a clustered installation.

14. On the WebLogic Directory page, enter the application server and Java information.

    1. Enter the path to the BEA WebLogic Server product installation directory for the application server.

       Alternatively, click Browse and navigate to the BEA WebLogic Server product installation directory for the application server. For example: C:\bea\weblogic81.

    2. Enter the path to the JDK directory associated with the application server domain.

       Alternatively, click Browse and navigate to the JDK directory associated with the application server domain.

    3. Click Next.

15. On the WebLogic Application Server Information page, enter appropriate information for the WebLogic server host.

    Note:

    The information you enter is different for clustered and nonclustered installations.

    For a nonclustered installation:

    1. Enter the host name or IP address of the application server computer.

       Note:

       The host name is case-sensitive.

    2. Enter the BEA WebLogic Server name. The default name is myserver.

    3. Enter the Admin Port.

       This is the WebLogic server administrative port. The default is 7001.

    4. Enter the WebLogic Server Port.

       This is the WebLogic server service port. The default is 7001.

       Note:

       Admin Port and WebLogic Server Port are the same for nonclustered installations. The default port is 7001.

    5. Enter the Admin Console user name for the WebLogic domain administrator. This is the administrator account that you configured by using the WebLogic Configuration Wizard.

    6. Enter and confirm the domain administrator password.

    7. Click Next to commit the settings.

    For clustered installation:

    1. Enter the host name or IP address of the computer hosting the application server.

       Note:

       The host name is case-sensitive.

    2. Enter the WebLogic Server Name.

       This is the Managed Server name. For example, xlManagedServer_1.

    3. Enter the Admin Port.

       This is the WebLogic Administrative Server port. The default is 7001.

    4. Enter the WebLogic Server Port.

       This is the WebLogic Managed Server port. The default is 7001.

    5. Enter the Login Name for the WebLogic domain administrator. This is the administrator account that you configured by using the WebLogic Configuration Wizard.

    6. Enter and confirm the administrator password.

    7. Click Next.

16. On the WebLogic Domain Information page, enter the appropriate WebLogic domain information.

    1. Specify the path to the WebLogic domains folder.

    2. Enter the configuration directory name. Usually, this is same as the domain name.

    3. Enter the domain name.

    4. Click Next.

17. Back up the application server when the Application Server Configuration Backup page is displayed, and then click Next.

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

    Depending on the processor speed of the computer, the installation script might require a few minutes to load the base database schema script and generate the corresponding log file.

19. If the installer detects an existing encrypted database, then it will display a message to copy the .xldatabasekey file to the new installation location.

    Click OK to proceed. If the existing database is not encrypted, then you are prompted to encrypt it. Click OK to proceed.

20. After Oracle Identity Manager is installed, a message is displayed listing the location of the installer log file and the next steps you should perform.

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

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

22. Shut down the application server gracefully and then restart it. For detailed information about this procedure, refer to Chapter 8, "Starting and Stopping Oracle Identity Manager".

After installing Oracle Identity Manager, follow the instructions in Chapter 7, "Postinstallation Configuration for Oracle Identity Manager and BEA WebLogic Server".

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.

3. Delete the WebLogic domain directory in which Oracle Identity Manager is installed.