Skip Headers
Oracle® Identity Manager Installation Guide for Oracle Application Server
Release 9.0.3

Part Number B32459-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

6 Installing Oracle Identity Manager Server on UNIX or Linux

This chapter explains how to install Oracle Identity Manager on UNIX or Linux. Refer to the Oracle Identity Manager Release Notes for more information on the supported UNIX or Linux 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:

The default logging package included by the base RedHat UNIX or Linux installation causes installation problems and exceptions for Oracle Identity Manager. Before installing Oracle Identity Manager on RedHat Linux, delete the commons-logging-1.0.2 library from the base operating system installation. The commons-logging-1.0.2 library is typically installed with any standard RedHat installation. Also, be sure to delete the symbolic links in the /usr/share/java/ directory. Deleting these symbolic links will force Oracle Identity Manager to use its own internal logger jar files during installation.

This chapter contains the following topics:

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.

Note:

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 or Linux

To install Oracle Identity Manager on the Oracle Application Server running on UNIX or Linux, you must install as the same non-root user that installed the Oracle Application Server. Do not attempt to install Oracle Identity Manager on the Oracle Application Server running on UNIX or Linux as the root user.

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

The installer contains logical sections (panels).

Note:

Before installing Oracle Identity Manager you must set the JAVA_HOME variable to <ORACLE_HOME>/jdk/bin.

To install Oracle Identity Manager server on UNIX or Linux:

Note:

During the installation process, an unused log file named log.conf is created in the <XL_HOME>/xellerate/config/ directory. You can safely ignore this file.
  1. Insert the Oracle Identity Manager Installation CD into your CD-ROM drive.

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

    sh install_server.sh
    
    

    The installer starts in console mode.

    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 following command:

    # chmod -R u+x *.sh

  3. Choose a language by entering a number from the list of languages.

    Enter 0 to apply the language selection. The Welcome Message panel appears.

  4. Enter 1 on the Welcome Message panel to display the next panel.

    The Admin User Information panel appears.

  5. Enter a password you want to use for the Oracle Identity Manager Administrator, confirm the password by entering it again, and then enter 1 to move to the next panel.

    The OIM Application Options panel appears.

  6. Enter 1 on the OIM Application Options panel to display the next panel.

    The Select the Oracle Identity Manager application to install panel appears.

  7. Select the application to install:

    • Enter 1 for Oracle Identity Manager.

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

    Enter 0 when you are finished to apply the application selection. The Target directory panel appears.

  8. On the Target directory panel, enter the path to the directory where you want to install Oracle Identity Manager. For example, enter /opt/oracle/. Enter 1 to move to the next panel.

    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 backup your previous Oracle Identity Manager home by renaming the original directory.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.

    If the directory does not exist, you are asked to create it. Enter y for yes.

    The Database Server Selection panel appears.

    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. Refer to the Oracle Identity Manager Release Notes to confirm the certified configurations.

    When Oracle Identity Manager is installed against an existing database, a warning message will appear indicating the database schema already exists and instructing you to copy the .xldatabasekey file from the existing Oracle Identity Manager installation to the new to the new <XL_HOME>/xellerate/config directory after you complete the installation process.

    Create the new <XL_HOME>/xellerate/config directory if it does not already exist.

  9. On the Database Server Selection panel, specify the type of database you are using.

    • Enter 1 for Oracle.

    • Enter 0 when you are finished.

    • Enter 1 to move to the next panel.

  10. 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. Enter 1 to move to the next panel.

    The Authentication Information panel appears.

  11. Select the authentication mode for the Oracle Identity Manager web application:

    • Enter 1 for Oracle Identity Manager Default Authentication.

    • Enter 2 for SSO Authentication.

    • Enter 0 when you are finished.

    • If you select SSO authentication, you must provide the header variable used in the Single Sign-On system when prompted.

    • Enter 1 to move to the next panel.

    The Application Server Selection panel appears.

  12. Specify your application server type.

    • Enter 1 for Oracle Application Server.

    • Enter 0 when you are finished.

    • Enter 1 to move to the next panel.

    The Cluster Information panel appears.

  13. Enter 2 for No (non-clustered). Refer to Chapter 9, "Deploying in a Clustered Oracle Application Server Configuration" if you are deploying Oracle Identity Manager for an Oracle Application Server cluster. Enter 0 to proceed to the next panel.

    The Application Server Information panel appears.

  14. In the Application Server Information panel:

    • Enter the path to where the application server is installed

    • Enter the path to where the Oracle Application Server JDK is installed

    • Enter 1 to move to the next section.

    The Oracle Application Server Information panel appears.

  15. On the Oracle Application Server Information panel:

    • Enter the user name for the Oracle Application Server administrator

    • Enter the password for the Oracle Application Server administrator

    • Enter the Oracle Application Server Instance Name

    • Enter the RMI port number. You can identify the RMI port number by executing the following command from the <ORACLE_HOME>/opmn/bin/ directory:

      opmnctl status -l
      
      
    • Enter the Oracle Process Manager and Notification (OPMN) Port Number. The default port number is 6003.

    • Enter 1 to move to the next panel.

  16. When you receive a message about backing up the application server installation, enter 1 to move to the next section. The Summary panel appears.

  17. On the Summary panel, enter 1 to begin installation.

  18. After the installation finishes, the Completed panel appears. Enter 3 to finish and exit.

After installing the Oracle Identity Manager server, perform the steps in Chapter 7, "Post-Install Configuration for Oracle Identity Manager Server and Oracle Application Server" to continue the installation process.

Removing the Oracle Identity Manager Server Installation

To remove the Oracle Identity Manager server installation, perform the following steps:

  1. Stop the Oracle Identity Manager server if it is running and stop all Oracle Identity Manager processes by stopping Oracle Application Server.

  2. Delete the <XL_HOME> directory where you installed the Oracle Identity Manager server.