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.

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

Oracle Identity Manager Components

Oracle Identity Manager on UNIX includes the following components:

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

• Oracle Identity Manager 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 the Oracle Identity Manager Server 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.

  
  

  Note: Before installing Oracle Identity Manager you must set the JAVA_HOME variable to Sun JDK 1.4.2 or higher

  
  
  
  

  Note: 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 UNIX by using the internal ln command.

  
  

To install Oracle Identity Manager server for UNIX:

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

3. From the console, change directory (cd) to the installServer directory on the installation CD and perform the following:

   1. Set the JAVA_HOME variable to the Sun JRE 1.4.2 or higher, for example:

      export JAVA_HOME=/opt/bea/jdk142_05

   2. Prepend the PATH variable with the /jre/bin directory, for example:

      export PATH=/opt/bea/jdk142_05/jre/bin:$PATH

4. Run the install_server.sh file 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 move 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:

   • Type 1 for Oracle Identity Manager.

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

   Type 0 when you are finished 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:

   
   

   Important: 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 3 for BEA WebLogic

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

13. Enter the application server information at the prompts.

    • Enter the path to the application server or press Enter to accept the default.

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

    • Type 1 to move to the next panel.

    The application server information panel appears.

14. Enter the login information for the application server:

    
    

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

    
    

    WebLogic server information for a non-clustered installation

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

       
       

       Note: The host name is case-sensitive.

       
       

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

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

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

    5. Enter 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. Enter 1 to move to the next section.

    WebLogic server information for a clustered installation

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

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

       
       

       Note: The host name is case-sensitive.

       
       

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

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

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

    6. Enter and confirm the administrator Password.

    7. Enter 1 to move to the next section.

       The second application server information panel appears.

15. Enter the domain information:

    1. Enter the domain location. This is the WebLogic directory that contains domain directories (sometimes called the configuration or target location in WebLogic).

    2. Enter the configuration directory name. This is the directory that contains the specific domain that you are installing Oracle Identity Manager in (sometimes called the configuration or domain name).

    3. Enter the domain name. This is the name of the domain that you are installing Oracle Identity Manager in.

    4. Type 1 to move to the next section.

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

17. After the Information Summary page appears, verify the information displayed, then do one of the following:

    • Type 2 to go back and make changes.

    • Type 1 to start the installation.

    Oracle Identity Manager installs and the Completed panel appears.

18. Type 3 to finish.

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.