Oracle® Identity Manager Installation and Configuration Guide for Oracle Application Server Release 9.1.0.1 Part Number E14062-01 |
|
|
View PDF |
This chapter explains how to install Oracle Identity Manager on UNIX in a nonclustered installation.
See Also:
Oracle Identity Manager Readme for information about supported UNIX platforms
Chapter 9, "Deploying in a Clustered Oracle Application Server Configuration" for information about deploying Oracle Identity Manager in a clustered installation
You must install Oracle Identity Manager on systems running Oracle Application Server. Oracle Identity Manager components such as the Remote Manager can be installed on separate systems. Each component has its own installer.
This chapter contains the following topics:
The following is a list of prerequisites and notes for installing Oracle Identity Manager on UNIX:
The Oracle Identity Manager Installer program requires at least 200 MB of free space in the home directory while installing Oracle Identity Manager. Check the /etc/passwd file to determine the home directory. Note that you cannot work around this requirement by changing the value of the $HOME variable.
There must be at least 200 MB of free space in the /var/tmp directory.
Before installing Oracle Identity Manager, you must set the JAVA_HOME variable to point to Oracle Application Server JDK. For details, go to "Setting Environment Variables" and see the section "For UNIX".
The default logging package included by the base RedHat 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, ensure that you 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.
Set the Java binary in the PATH variable for Oracle Identity Manager Installer to work effectively. For details, refer to "Setting Environment Variables" and see the section "For UNIX".
During the installation process, an unused log file named log.conf is created in the OIM_HOME
/xellerate/config/
directory.
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 back up your previous Oracle Identity Manager home by renaming the original directory.
In addition, all Oracle Identity Manager components must be installed in different home directories. For example, you cannot install the Remote Manager in the same directory in which Oracle Identity Manager is installed.
Ensure that the LC_ALL environment variable points towards en_US. To set the LC_ALL variable to en_US, run any one of the following commands:
setenv LC_ALL en_US
Or:
export LC_ALL=en_US
As part of the installation, the Oracle Identity Manager Installer loads a schema into the 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. If required, contact your database administrator (DBA).
Note:
During the schema installation, a log file is created in theOIM_HOME
/logs
directory.The Oracle Identity Manager documentation is installed automatically in the OIM_HOME
directory. No special input is required. A full documentation set is installed with each Oracle Identity Manager component.
To install Oracle Identity Manager on the Oracle Application Server running on UNIX, you must install Oracle Identity Manager as the same non-root user who installed the Oracle Application Server. Do not attempt to install Oracle Identity Manager on the Oracle Application Server running on UNIX as the root user.
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 brackets ([ ]). To select an option, enter its number. Once selected, the associated brackets display an X ([X]).
Enter information at a prompt
Type the information at the prompt and press Enter. Default values are enclosed in brackets after a prompt; to accept a default value, press Enter.
The installer contains logical sections (panels). You can perform the following actions in the panels:
When you have selected an item from a list of options, enter zero (0) to indicate that the desired item has been selected.
To move to the next installation panel, enter 1.
To go back to the previous panel, enter 2.
To cancel the installation, enter 3.
To redisplay the current panel, enter 5.
To install Oracle Identity Manager on UNIX:
Note:
Create a backup of the Oracle Application Server configuration before installing Oracle Identity Manager. For more information, see "Creating a Backup of the Oracle Application Server Configuration".Insert the Oracle Identity Manager Installation CD into your CD-ROM drive.
From the console, change directory (cd) to the installServer directory on the installation CD and run the install_server.sh file by 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 in the installServer directory. To set the execute bit for all shell scripts recursively, cd to the installServer directory and run the following command:find . -name "*.sh" -exec chmod u+x {} \;
Choose a language by entering a number from the list of languages.
Enter 0 to apply the language selection. The Welcome Message panel is displayed.
Enter 1 on the Welcome Message panel to display the next panel.
The Admin User Information panel is displayed
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 is displayed.
Enter 1 on the OIM Application Options panel to display the next panel.
The Select the Oracle Identity Manager application to install panel is displayed.
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 is displayed.
On the Target directory panel, enter the path to the directory in which 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 Oracle Identity Manager is installed.If the directory does not exist, you are asked to create it. Enter y to create the directory.
The Database Server Selection panel is displayed.
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. See Oracle Identity Manager Readme to confirm the certified configurations.When Oracle Identity Manager is installed against an existing database, a warning message is displayed indicating that the database schema already exists and instructing you to copy the .xldatabasekey file from the existing Oracle Identity Manager installation to the new OIM_HOME
/xellerate/config
directory after you complete the installation process.
Create the new OIM_HOME
/xellerate/config
directory if it does not already exist.
On the Database Server Selection panel, specify the type of database that you are using:
Enter 1 for Oracle Database.
Enter 0 when you are finished.
Enter 1 to move to the next panel.
Note:
Only Oracle database is supported for Oracle Identity manager installation on Oracle Application Server.Enter the database information:
Enter the database host name or IP address.
Enter the port number, or accept the default.
Enter the SID for the database name.
Enter the database user name for the account that Oracle Identity Manager uses to connect to the database.
Enter the password for the database account that Oracle Identity Manager uses to connect to the database.
Enter 1 to move to the next panel.
The Authentication Information panel is displayed.
Select the authentication mode for the Oracle Identity Manager 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.
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 is displayed.
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.
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 is displayed.
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 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 Application Server Instance Name
When you receive a message about backing up the application server installation, enter 1 to move to the next section. The Summary panel is displayed.
On the Summary panel, enter 1 to begin installation.
After the installation finishes, the Completed panel is displayed. Enter 3 to finish and exit.
After installing Oracle Identity Manager, follow the instructions in Chapter 7, "Postinstallation Configuration for Oracle Identity Manager and Oracle Application Server".