Skip Headers
Oracle® Identity Manager Installation and Upgrade Guide for JBoss
Release 9.0
B25938-01
  Go To Documentation Library
Home
Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

7 Installing Oracle Identity Manager Server on Linux

This chapter explains how to install Oracle Identity Manager on Linux. 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:

Oracle Identity Manager is certified for RedHat Linux 4.1.

Oracle Identity Manager Components

Oracle Identity Manager for Linux includes the following components:

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 Linux


Note:

Before installing Oracle Identity Manager server, be sure to copy the three Microsoft SQL Server JDBC driver .jar files to the Linux server and add the files to the CLASSPATH.

Oracle Identity Manager for 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 Sun JDK 1.4.2 or higher.

To install Oracle Identity Manager server for Linux:

  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 <JBOSS_HOME>/server/default/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 run the install_server.sh file using the following command:

    $ sh install_server.sh
    
    
  4. 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 Options 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 following command:

      # chmod -R u+x *.sh


  5. Select the application to install:

    • Type 1 for Oracle Identity Manager.

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

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

    • 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. You should create the /config directory in the new <XL_HOME>/xellerate/ path if it does not already exist.


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

    • Type 1 for Oracle.

    • Type 2 for SQL Server.

    • Type 0 when you are finished.

    • Type 1 to move to the next panel.

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

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

  10. Specify your application server type.

    • Type 4 for JBoss.

    • Type 0 when you are finished.

    • Type 1 to move to the next panel.

    The Cluster Information panel appears.

  11. Provide the following information regarding deploying in a cluster:

    • Type 1 for Yes (clustered) and enter the unique partition name at the prompt.

    • Type 2 for No (non-clustered).

    • Type 0 when you are finished.

    • Type 1 to move to the next section.

    The Application Server Information panel appears.


    Important:

    If you are deploying in a clustered environment, select Yes and see Chapter 10, "Deploying in a Clustered JBoss Configuration" for more information.

  12. In the Application Server Information panel:

    • Provide the location where the application server is installed

    • Provide the location where the JDK is installed

    • Type 1 to move to the next section.

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

  14. On the Summary panel, type 1 to begin installation.

  15. After the installation is finished, the Completed panel appears. Type 3 finish and exit.

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