6 Installing Oracle Identity Manager Server on Windows

This chapter explains how to install Oracle Identity Manager on Windows. You must install the Oracle Identity Manager server 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.

Caution: DO NOT use a remote client tool such as PCAnywhere to install Oracle Identity Manager products.

Note: Make sure the WebLogic server is running during Oracle Identity Manager installation.

Oracle Identity Manager Components

Oracle Identity Manager for Windows includes the following components:

• Oracle Identity Manager Server—see "Installing the Oracle Identity Manager Server on Windows" for more information.

• Oracle Identity Manager Design Console—see "Installing the Design Console"for more information.

• Oracle Identity Manager Remote Manager—see"Installing the Remote Manager on Windows" for more information.

All components use a single database schema. Oracle Identity Manager documentation is also installed with each component.

Installing the Database Schema

As part of the installation, the Oracle Identity Manager installer loads a schema into your database. You only install the database schema once. It is installed the first time you run the Oracle Identity Manager installer. Each subsequent 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. Contact your database administrator (DBA) for details on the particulars of your database.

During the schema installation, a corresponding log file is created under the <XL_HOME>\logs\ directory

Installing Documentation

The Oracle Identity Manager documentation is installed automatically under the <XL_HOME> directory. No special input is required. A full documentation set is installed with each Oracle Identity Manager component.

Installing the Oracle Identity Manager Server on Windows

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

Important: If WebLogic is installed in nondefault directory (other than weblogic81), the Oracle Identity Manager installer will fail unless you create a symbolic link of weblogic81 for the nondefault directory where WebLogic is installed. You can create a symbolic link in Windows by using additional Microsoft or 3rd-party tools.

To install the Oracle Identity Manager server on a Windows host:

1. If you are using SQL Server as your database, before installing the Oracle Identity Manager server be sure to copy the following three files located in C:\Program Files\<Microsoft SQL Server 2000 Driver for JDBC>\lib\ to the <WEBLOGIC_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 machine, proceed to Step 4.

   
   

3. From Windows Explorer, access the installServer directory on the installation CD and double-click the setup_server.exe file.

4. On the Welcome Message screen, click Next.

5. On the Oracle Identity Manager Application Options screen, select to install one of the following applications, and then click Next:

   • Oracle Identity Manager

   • Oracle Identity Manager with Audit and Compliance Module

     
     

     Important: 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 same name of an existing Oracle Identity Manager home directory, then backup your original Oracle Identity Manager home by renaming that directory.Remember at all times 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 the Oracle Identity Manager server.

     
     

6. After the Target directory screen appears, complete one of the following bulleted actions:

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

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

     or

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

     
     

     Note: If the directory path 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 popup appears informing you that the installer could not create the directory. Click OK to dismiss the popup, then contact your System Administrator to obtain the appropriate permissions.

     
     

7. On the Database Server Selection page, specify the type of database you are using with Oracle Identity Manager (either Oracle or SQL Server), then click Next.

8. 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 this version of Oracle Identity Manager supports your existing database version. When Oracle Identity Manager is installed against an existing database, the .xldatabasekey file from the earlier Oracle Identity Manager installation must be copied to the new <XL_HOME>\xellerate\config directory. You should create the \config directory in the new <XL_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 resides.

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

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

   • In the User Name field, enter the user name of the database account 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 setting the preceding items, refer to the configuration settings specified in "Setting Up the Oracle Database" or "Setting Up the SQL Server" to verify your settings.

     
     

     The installer checks for database connectivity as well as the existence of a database schema. A success or failure page appears, depending on the results of the test.

   • Select the appropriate database options:

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

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

9. On the Authentication Information page, select either the Oracle Identity Manager Default Authentication or SSO (Single Sign On) Authentication option. If you select SSO authentication, you must provide the header value in the field and click Next.

10. On the Application Server Selection page, select BEA WebLogic, and click Next.

11. On the Cluster Information page, specify the server configuration (clustered or non-clustered).

    • Select No for non-clustered and click Next.

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

      
      

      Important: Refer to Chapter 10, "Deploying in a Clustered WebLogic Configuration" if you are deploying in a clustered environment.

      
      

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

    1. Type the path to the root directory for your application server

       or

       Navigate to the root directory for your application server

    2. Type the path to the JDK directory associated with your application server

       or

       Navigate to the JDK directory associated with your application server.

    3. Click Next.

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

    
    

    Note: The information you enter differs for clustered and non-clustered installations.

    
    

    WebLogic server information for a non-clustered installation

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

       
       

       Note: The host name is case-sensitive.

       
       

    2. Type the WebLogic Server Name (default is myserver).

    3. Type the Admin Port (default is 7001).

    4. Type the WebLogic Server Port (default is 7001).

    5. Type the Login Name for the WebLogic domain administrator. (This is the administrator account you configured through the WebLogic configuration wizard).

    6. Enter and confirm the domain administrator Password.

    7. Click Next to commit your settings.

    WebLogic server information for a clustered installation

    1. Type the host name or IP address of the machine hosting the application server.

    2. Type the Managed Server Name (for example, XL_MANAGED_SERVER_1).

       
       

       Note: The host name is case-sensitive.

       
       

    3. Type the Admin Port (default is 7001).

    4. Type the Managed Server Port (for example, 7051).

    5. Type the Login Name for the WebLogic domain administrator (the administrator account you configured using the WebLogic configuration wizard).

    6. Type and confirm the administrator Password.

    7. Click Next.

14. On the WebLogic Domain Information page, type the appropriate WebLogic domain information.

    1. Type the path to the WebLogic domains folder.

       or

       Navigate to the location.

    2. Type the configuration directory name (generally this is the same as the domain name).

    3. Type the configuration directory name (generally this is the same as the domain name).

    4. Click Next.

15. Backup your application server when the Application Server Configuration Backup screen appears, then click Next.

16. On the Installation Summary page, click Install to initiate the server software installation. Depending on the speed of your machine, the installation script may require a few minutes to load the base database schema script and generate the corresponding log file.

17. If the installer detects an existing encrypted database, it will display a pop-up message to copy the .xldatabasekey file to the new installation location. Click OK to proceed. If the existing database is not encrypted, you are prompted to encrypt it. Click OK to proceed.

18. On the Completed screen, click Finish to exit the installer.

Once you have finished installing the Oracle Identity Manager Server, follow the instructions in Chapter 8, "Post-Install Configuration for Oracle Identity Manager and WebLogic" to continue the installation.