7 Installing Oracle Identity Manager on UNIX

This chapter describes how to install Oracle Identity Manager on a computer running UNIX in a nonclustered installation.

7.1 Installation Prerequisites and Notes

The following is a list of prerequisites for installing Oracle Identity Manager on UNIX:

If Solaris sed is in use, then include the full path (including the name) of the sed directory in the PATH environment variable.

Note:
If you do not perform this procedure, then the Oracle Identity Manager Installer will not launch when you try to start it.
The Oracle Identity Manager Installer program requires at least 200 MB of free space in the home directory of the user 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 as a non-root user account on Oracle WebLogic Server, ensure that the user account has the following permissions:
- Write and execute permissions on the specific WebLogic Domain directory
- (Optional) Write permission on the WebLogic and lib/mbeantypes directories
Before you install Oracle Identity Manager, verify that the JAVA_HOME system variable is set to the appropriate Sun JDK. For example:
```
export JAVA_HOME=/opt/jdk160_10
```
See Oracle Identity Manager Readme for information about the certified versions of Java JDK.
Before you install Oracle Identity Manager, verify that the correct Sun JVM is being used when a Java command is run. To do this, include the Sun JVM bin directory in the PATH variable ahead of all other path entries. For example:
```
export PATH=/opt/jdk160_10/bin:$PATH
```
If you are using Microsoft SQL Server as the database, before installing Oracle Identity Manager, ensure that the sqljdbc.jar file is in the BEA_HOME/user_projects/domains/DOMAIN_NAME/lib directory, and add the driver location to the CLASSPATH environment variable. For example:
```
export CLASSPATH=/opt/sql_driver_location/sqljdbc.jar
```
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.
You cannot install Oracle Identity Manager on a WebLogic domain that already has Oracle Identity Manager or other applications deployed on it. You must use a new domain for installing Oracle Identity Manager.

7.2 Installing the Database Schema

As part of the installation, the Oracle Identity Manager Installer loads a schema into the database. 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 the OIM_HOME/logs directory.

7.3 Installing Documentation

The Oracle Identity Manager documentation is installed automatically in the OIM_HOME directory. A full documentation set is installed with each Oracle Identity Manager component.

7.4 Installing Oracle Identity Manager on UNIX

If Oracle WebLogic Server is installed in nondefault directory (other than wlserver_10.3), the Oracle Identity Manager Installer fails unless you create a symbolic link of wlserver_10.3 for a nondefault directory in which Oracle WebLogic Server is installed. You can create a symbolic link in UNIX by using the internal ln command.

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

Select from a list of options.

Each option is numbered and accompanied by brackets ([ ]). To select an option, enter its number. When selected, the associated brackets display an X ([X]).
Enter information at a prompt.

Type in 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 or panels. You can perform the following actions in the panels:

When you select an item from a list of options, enter the number zero (0) to indicate that the required 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:

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.
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 the distribution media (CD), then you must set the execute bit of all shell scripts in the installServer directory. To set the execute bit for all shell scripts recursively, navigate to the installServer directory and run the following command:
```
find . -name "*.sh" -exec chmod u+x {} \;
```
Specify 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 the password that 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 Oracle Identity Manager with Audit and Compliance Module.
Enter 0 when you are ready to move to the next panel. The Target directory panel is displayed.
On the Target directory panel, perform one of the following steps:
- 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.
If the directory does not exist, then you are prompted to create it. Enter y for yes.

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 will appear stating 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 to select Oracle Database.
- Enter 2 to select Microsoft SQL Server.
- Enter 0 after you select a database.
- Enter 1 to move to the next panel.
The Database Information panel is displayed.
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 Web application.
- Enter 1 for Oracle Identity Manager Default Authentication.
- Enter 2 for SSO Authentication.
- Enter 0 when you are ready to move to the next panel.
If you select SSO authentication, then 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 is displayed.
Specify your application server type.
- Enter 1 for Oracle WebLogic Server.
- Enter 0 when you are ready to move to the next panel.
- Enter 1 to move to the next panel.
The Cluster Information panel is displayed.
Specify whether or not the application server is clustered:
- Enter 1 to specify that the application server is clustered. Then, enter the cluster name at the prompt and the cluster details.
- Enter 2 to specify that the application server is not clustered.
- Enter 0 when you are ready to move to the next panel.
Enter 1 to move to the next section.

The Application Server Information panel is displayed.
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 domain JDK directory or press Enter to accept the default.
- Enter 1 to move to the next panel.
The Application Server Information panel is displayed.
Enter the login information for the application server:

Note:
The information that you enter is different for clustered and nonclustered installations.

For a nonclustered installation:
- Enter the host name or IP address of the application server computer.
  
  Note:
  The host name is case-sensitive.
- Enter the Admin Port.
  
  This is the WebLogic Server administrative port. The default is 7001.
- Enter the WebLogic Server Name. The default name is AdminServer.
- Enter the WebLogic Server Port.
  
  This is the WebLogic Server service port. The default is 7001.
  
  Note:
  Admin Port and WebLogic Server Port are the same for nonclustered installations. The default port is 7001.
- Enter the Admin Console user name for the WebLogic domain administrator. This is the administrator account you configured through the WebLogic configuration wizard.
- Enter and confirm the domain administrator password.
- Enter 1 to move to the next section.
For a clustered installation:
- Enter the host name or IP address of the computer hosting the application server.
  
  Note:
  The host name is case-sensitive.
- Enter the Admin Port.
  
  This is the WebLogic Admin Server port number. The default is 7001.
- Enter the WebLogic Server Name.
  
  This is the Managed Server name. The default is OIM_SERVER1.
- Enter the WebLogic Server Port.
  
  Note:
  The default port is 7001. Change it to the port of the Managed Server, for example, 7051.
- Enter the Login Name for the WebLogic domain administrator. This is the administrator account that you configured by using the WebLogic configuration wizard.
- Enter and confirm the administrator password.
- Enter 1 to move to the next section.
  
  The second Application Server Information panel is displayed.
Enter the domain information:
- Enter the domain location. This is the Oracle WebLogic Server directory that contains domain directories. This is sometimes called the configuration or target location in WebLogic.
- Enter the domain name. This is the name of the domain in which you are installing Oracle Identity Manager.
- Enter 1 to move to the next section.
When the Information Summary page is displayed, verify the information displayed, then perform one of the following steps:
- Enter 2 to return to earlier panels and make changes.
- Enter 1 to start the installation.
Oracle Identity Manager installs and the Completed panel is displayed.
Enter 3 to complete the procedure.

Note:
During the installation, WebLogic Server is restarted automatically. After successful installation, the server is automatically shut down. Therefore, you do not have to shut down the server.
Start the server. For detailed information about this procedure, refer to the "Starting Oracle Identity Manager" section.

After installing Oracle Identity Manager, follow the instructions in Chapter 9, "Postinstallation Configuration for Oracle Identity Manager and Oracle WebLogic Server".

7.5 Removing Oracle Identity Manager

To remove an Oracle Identity Manager installation:

Stop Oracle Identity Manager if it is running, and stop all Oracle Identity Manager processes.
Delete the OIM_HOME directory in which you installed Oracle Identity Manager.
Delete the WebLogic domain directory in which Oracle Identity Manager is installed.