7 Installing Oracle Identity Manager Server on UNIX

This chapter describes how to install Oracle Identity Manager on a computer running UNIX. Refer to "Supported Operating Systems" for more information on the supported UNIX platforms. You must install the Oracle Identity Manager server on systems running the application server. Oracle Identity Manager components such as the Remote Manager can be installed on separate systems. Each component has its own installer.

Oracle Identity Manager Components

Oracle Identity Manager for UNIX includes the following components.

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

• The Remote Manager—see "Installing the Remote Manager for UNIX" for more information.

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 Oracle Identity Manager on UNIX

Oracle Identity Manager for UNIX is installed through a console mode installer, which supports the following two input methods:

• Choose from among list of options

  Each option is numbered and accompanied by square brackets ([ ]). To select an option, type its number. Once selected, the associated square brackets display an X ([X]).

• Enter information at a prompt

  To enter information at the prompt, type the information and press Enter. To accept a default value—default values are enclosed in brackets after a prompt—simply press Enter to accept them.

The installer contains logical sections (panels).

• When you have selected an item from a list of options, type the number zero (0) to indicate that the desired item has been selected.

• To move to the next installation panel, type the number one (1).

• To go back to the previous panel, type the number 2.

• To cancel the installation, type the number 3.

• To redisplay the current panel, type the number 5.

To install Oracle Identity Manager server for UNIX:

1. Before installing the Oracle Identity Manager server you must set the JAVA_Home variable to the appropriate JDK. On Solaris and Linux, set JAVA_Home to Sun JDK 1.4.2 or higher. On AIX, set Java_Home to the WebSphere JDK. For example, use the following commands on AIX:

   • export JAVA_HOME=$<WEBSPHERE_HOME>/java

   • Add $JAVA_HOME/bin to the $PATH environment variable using the following command: export PATH=$JAVA_HOME/bin:$PATH

2. If you are using SQL Server as your database, before installing the Oracle Identity Manager server be sure the following three files are in the <WEBSPHERE_HOME>/AppServer/lib/ directory and add the driver location to the system CLASSPATH environment variable:

   • mssqlserver.jar

   • msbase.jar

   • msutil.jar

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

4. From the console, change directory (cd) to the installServer directory on the installation CD and run the install_server.sh using the following command:

   $ sh install_server.sh
   
   

5. The installer starts in console mode, and the product Welcome Message panel appears.

   1. Type 1 to display the next panel. The Oracle Identity Manager Application panel appears.

   2. Type 1 to display the next panel. The Application Selection panel appears.

      
      

      Note: If you are not installing Oracle Identity Manager from distributed media (CD), you must set the execute bit of all shell scripts under in the installServer directory. To set the execute bit for all shell scripts recursively, cd to the installServer directory and run the chmod -R u+x *.sh command.

      
      

6. Select the application to install:

   1. Type 1 for Oracle Identity Manager.

   2. Type 2 for the Oracle Identity Manager with Audit and Compliance Module.

      Type 0 when you are finished and then type 1 to move to the next section. The Target directory panel appears.

7. On the Target directory panel, complete one of the sub-steps that follow:

   
   

   Caution: Do not install Oracle Identity Manager on top of an existing Oracle Identity Manager installation. Use a different Oracle Identity Manager home directory. If you want to reuse the same directory name for the Oracle Identity Manager home directory then backup your previous Oracle Identity Manager home by renaming the original directory. Furthermore, all Oracle Identity Manager components must be installed in different home directories. For example, you cannot install the Remote Manager in the same directory where the Oracle Identity Manager server is installed.

   
   

   • Type the path to the directory where you want to install Oracle Identity Manager. For example, enter /opt/oracle/.

   • Type 1, to move to the next panel.

   If the directory does not exist, you are asked to create it. Type y, for yes. The Database Server Selection panel appears.

   
   

   Note: To install against an existing database, make sure 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. In some cases (such as a new installation), the config directory is not created. This does not indicate a failure in the installer. You must then create the config directory and copy the .xldatabasekey file into it.

   
   

8. Specify the type of database you are using.

   • Type 1 to select Oracle.

   • Type 2 to select SQL Server.

   • Type 0 to finish.

   • Type 1 to move to the next panel.

   The Database Information panel appears.

9. Enter your database information:

   1. Enter the database host name or IP address.

   2. Enter (or accept the default) port number.

   3. Enter the SID for the database name.

   4. Enter the database user name for the account that Oracle Identity Manager uses to connect to the database.

   5. Enter the password for the database account that Oracle Identity Manager uses to connect to the database.

   6. Type 1 to move to the next panel.

      The Authentication Information panel appears.

10. Select the authentication mode for the Oracle Identity Manager web application.

    • Type 1 for Oracle Identity Manager Default Authentication.

    • Type 2 for SSO Authentication.

    • Type 0 when you are finished.

    • If you selected SSO mode, provide the header value at the prompt.

    • Type 1 to move to the next panel.

      The Application Server Selection panel appears.

11. Specify your application server type.

    • Type 2 for IBM WebSphere.

    • Type 0 when you are finished.

    • Type 1 to move to the next panel.

    The Cluster Information panel appears.

12. Specify if the application server is clustered or not, provide the information specific to your cluster, then perform the following sub-steps:

    • Type 1 for Yes.

    • Type 2 for No.

    • Type 0 when you are finished.

    • If you selected Yes, enter the cluster name at the prompt.

    • Type 1 to move to the next section.

    The Application Server Information panel appears.

    
    

    Note: The next steps in procedure are for non-clustered, WebSphere-based Oracle Identity Manager server installations only. Refer to "Deploying in a Clustered WebSphere Configuration" for information on installing in a clustered WebSphere environment.

    
    

13. Enter the application server information at the prompts:

    1. Specify the path to the application server or press Enter to accept the default.

    2. Specify the path to the application server's JDK directory or press Enter to accept the default.

    3. Type 1 to move to the next section.

14. Enter the login information for the WebSphere server:

    1. Enter the Application Server host name or IP address.

    2. Enter the WebSphere Cell Name.

    3. Enter the WebSphere Node Name.

    4. Enter the WebSphere Server Name.

    5. Type 1 to move to the next section.

15. When a message appears warning you to back up your application server, proceed to back up your installation, then type 1 to move to the next section.

16. On the Installation summary information page, verify the information displayed, then do one of the following:

    • Type 2 to go back and make changes.

    • Type 1 to start the installation.

17. After Oracle Identity Manager installs, the Completed panel appears. Type 3 to finish and exit.

Before you can use Oracle Identity Manager, complete the steps in "Post-Install Configuration for Oracle Identity Manager and WebSphere" to continue the installation process.