3 Performing Common Installation Tasks

3.1.1 Starting an Installation

This topic explains the steps that are common to starting most Oracle Identity Management installations and configurations. It begins with starting the Installer and ends after you complete the steps on the Prerequisites Check screen.

Perform the following steps to start an Oracle Identity Management installation:

1. Start the Installer by executing one of the following commands:

   UNIX: ./runInstaller

   Windows: DRIVE:\setup.exe

   After the Installer starts, the Welcome screen appears.

2. Click Next on the Welcome screen. The Select Installation Type screen appears.

3. Select Install - Do Not Configure and click Next. The Prerequisites Check screen appears.

4. Monitor the prerequisites checking.

   • If there is an issue, an error or warning message will appear. Investigate the issue and resolve it. After resolving the issue, click Retry to restart the prerequisite checks.

     Note:

     You can proceed with the installation without resolving the issue by clicking Continue. However, failing to resolve the issue during the prerequisites checking may cause additional issues later in the installation.

   • If all prerequisite checks pass inspection, click Next.

   After installing the software, you can configure the Oracle Identity Management component by running the Oracle Identity Management Configuration Wizard. To start this configuration wizard, run the following command:

   • On UNIX: <Oracle_Home>/bin/config.sh

   • On Windows: <Oracle_Home>\bin\config.bat

   The Select Domain screen appears. Continue by referring to the appropriate procedure in this document for the installation you want to perform.

3.1.2 Creating the Inventory Directory (UNIX Only)

If you are installing on a UNIX system, and if this is the first time any Oracle product is being installed on your system with the Oracle Universal Installer, you will be asked to provide the location of an inventory directory. This is where the installer will set up subdirectories and maintain inventory data for each Oracle product that is installed on this system.

Follow the instructions in Table 3-1 to configure the inventory directory information:

3.1.3 Identifying Installation Directories

This topic describes directories you must identify in most Oracle Identity Management installations and configurations—it does not describe one particular Installer screen. During installation, you will have to identify other component-specific directories not described in this topic.

The common directories described in this section include the following:

• Oracle Middleware Home Location

• Oracle Home Directory

• WebLogic Server Directory

• Oracle Instance Location

• Oracle Instance Name

3.1.4 Determining Port Numbers

If you want to install an Oracle Identity Management 11g Release 1 (11.1.1) component against an existing Oracle Identity Management 11g Release 1 (11.1.1) component, you may need to identify the ports for the existing component. For example, if you want to install Oracle Directory Integration Platform 11g Release 1 (11.1.1) against an existing Oracle Internet Directory 11g Release 1 (11.1.1) component, you must identify its port when you install Oracle Directory Integration Platform.

You can get information about ports using the following:

• WebLogic Server Administration Console.

  Log in to the Administration Console. Click on Servers under Environment to see what ports are in use for the Administration Server and Managed Servers.

• $ORACLE_INSTANCE/config/OPMN/opmn/ports.prop

  Note:

  If you change a component's port number after installation, the ports.prop file is not updated.

• The $ORACLE_INSTANCE/bin/opmnctl status -l command to see port numbers of components managed by OPMN.

3.1.5 Completing an Installation

This topic explains the steps that are common to completing most Oracle Identity Management installations and configurations. It begins with the steps on the Installation Summary screen and ends after the Installation Complete screen.

When the Installation Summary screen appears, perform the following steps to complete the installation:

1. Verify the installation and configuration information on the Installation Summary screen.

   • Click Save to save the installation response file, which contains your responses to the Installer prompts and fields. You can use this response file to perform silent installations.

     Note:

     The installation response file is not saved by default—you must click Save to retain it.

   • Click Install. The Installation Progress screen appears.

2. Monitor the progress of your installation. The location of the installation log file is listed for reference. After the installation progress reaches 100%, the Configuration Progress screen appears.

   Note:

   On UNIX systems, after the installation progress reaches 100%, a confirmation dialog box appears with information about the oracleRoot.sh script. Execute the script in different terminal and continue to the Configuration Progress screen. For more information, see the "Executing the oracleRoot.sh Script on UNIX Platforms" topic in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.

3. Monitor the progress of the configuration. The location of the configuration log file is listed for reference. After the configuration progress reaches 100%, the Installation Complete screen appears.

4. By default the installation summary file, which can help you get started with administration, is saved to the OUI_INVENTORY/logs/ directory. The filename is of the form: installSummaryDATE.txt. This file contains information about the configuration, such as locations of install directories and URLs for management components.

   If desired, you can click the Save button on the Installation Complete screen and choose a different name and location for the file.

   Click Finish to close and exit the Installer.

3.1.6 Optional: Configuring the Minimum Amount for Oracle WebLogic Server's Maximum Heap Size

After installing Oracle Identity Management 11g Release 1 (11.1.1), if you want to configure the minimum (lowest) level of maximum heap size (-Xmx) required for Oracle WebLogic Server to host Oracle Identity Management components, perform the steps in this section.

The minimum (lowest) levels for maximum heap size are:

• Oracle WebLogic Administration Server: 512 MB

• Oracle WebLogic Managed Server: 256 MB

Perform the following steps to configure the heap size for Oracle WebLogic Administration Servers and Oracle WebLogic Managed Servers:

1. Open the setDomainEnv script (.sh or .bat) in the MW_HOME/user_projects/domains/DOMAIN_NAME/bin/ directory.

2. Locate the last occurrence of the EXTRA_JAVA_PROPERTIES entry.

3. In the last occurrence of the EXTRA_JAVA_PROPERTIES entry, locate the last occurrence of heap size parameters: -Xmx, -Xms, and so on.

   Note:

   These are the heap size parameters for the Oracle WebLogic Administration Server.

4. Set the heap size parameters (-Xms and -Xmx) for the Oracle WebLogic Administration Server as desired, for example: -Xms256m and -Xmx512m

5. To set the heap size parameters for the Oracle WebLogic Managed Server, enter the text in Example 3-1 immediately below the last occurrence of the EXTRA_JAVA_PROPERTIES entry and:

   • Set the heap size parameters (-Xms and -Xmx) as desired, for example: -Xms256m -Xmx256m

   • Replace wls_ods1 with the name of the Oracle WebLogic Managed Server hosting Oracle Directory Services Manager.

   • Replace wls_oif1 with the name the Oracle WebLogic Managed Server hosting Oracle Identity Federation.

   Example 3-1 Heap Size Parameters for Oracle WebLogic Managed Server

   if [ "${SERVER_NAME}" = "wls_ods1" -o  "${SERVER_NAME}" = "wls_oif1" ] ; then
           EXTRA_JAVA_PROPERTIES=" ${EXTRA_JAVA_PROPERTIES} -Xms256m -Xmx256m "
           export EXTRA_JAVA_PROPERTIES
   fi
   

6. Save and close the setDomainEnv script.

7. Restart the Oracle WebLogic Administration Server and the Oracle WebLogic Managed Server by referring to Starting the Stack.

3.1.7 Locating Installation Log Files

The Installer writes log files to the ORACLE_INVENTORY_LOCATION/logs directory on UNIX systems and to the ORACLE_INVENTORY_LOCATION\logs directory on Windows systems.

On UNIX systems, if you do not know the location of your Oracle Inventory directory, you can find it in the ORACLE_HOME/oraInst.loc file.

On Microsoft Windows systems, the default location for the inventory directory is C:\Program Files\Oracle\Inventory\logs.

The following install log files are written to the log directory:

• installDATE-TIME_STAMP.log

• installDATE-TIME_STAMP.out

• installActionsDATE-TIME_STAMP.log

• installProfileDATE-TIME_STAMP.log

• oraInstallDATE-TIME_STAMP.err

• oraInstallDATE-TIME_STAMP.log

• opatchDATE-TIME_STAMP.log

3.2.1 Starting an Installation

This topic explains the steps that are common to starting most Oracle Identity Management installations and configurations. It begins with starting the Installer and ends after you complete the steps on the Prerequisites Check screen.

Perform the following steps to start an Oracle Identity Management installation:

1. Extract the contents of the iamsuite.zip file to a directory. By default, this directory is named iamsuite.

2. Move to the Disk1 directory under the iamsuite folder.

3. Start the Installer by executing one of the following commands:

   UNIX: <full path to the runInstaller directory>/runInstaller -jreLoc <Middleware Home>/jrockit_160_05_R27.6.2-20/jre

   Windows: <full path to the setup.exe directory>\ setup.exe -jreLoc <Middleware Home>\jrockit_160_05_R27.6.2-20\jre

   Note:

   The installer prompts you to enter the absolute path of the JDK that is installed on your system. When you install Oracle WebLogic Server, the jrockit_160_05_R27.6.2-20 directory is created under your Middleware Home. You must enter the absolute path of the JRE folder located in this JDK when launching the installer. For example, on Windows, if the JRE is located in D:\oracle\Middleware\jrockit_160_05_R27.6.2-20, then launch the installer from the command prompt as follows:

   D:\setup.exe -jreLoc D:\oracle\Middleware\jrockit_160_05_R27.6.2-20\jre

   If you do not specify the -jreLoc option on the command line when using the Oracle JRockit JDK, the following warning message is displayed:

   -XX:MaxPermSize=512m is not a valid VM option. Ignoring

   This warning message does not affect the installation. You can continue with the installation.

   After the Installer starts, the Welcome screen appears. Continue by referring to the appropriate procedure in this document for the installation you want to perform.

3.2.2 Starting Oracle Fusion Middleware Configuration Wizard

To start the Oracle Fusion Middleware Configuration Wizard, which is used to configure Oracle Identity Management products in a new or existing WebLogic administration domain, run the <IDM_Home>/common/bin/config.sh script (on UNIX). On Windows, run the <IDM_Home>\common\bin\config.bat script. The Oracle Fusion Middleware Configuration Wizard is displayed.

3.2.3 List of Executable Files

Table 3-2 lists the executable files that are included in the Oracle WebLogic Server, Oracle Identity Management, Oracle SOA Suite, Oracle Web Tier, and Oracle HTTP Server 11g WebGate for Oracle Access Manager Installers.

3.2.4 Identifying Installation Directories

This topic describes directories you must identify in most Oracle Identity Management installations and configurations—it does not describe one particular Installer screen. During installation, you will have to identify other component-specific directories not described in this topic.

The common directories described in this section include the following:

• Oracle Middleware Home Location

• Oracle Home Directory

• Oracle Common Directory

• Oracle WebLogic Domain Directory

• WebLogic Server Directory

3.2.5 Determining Port Numbers

If you want to install an Oracle Identity Management 11g Release 1 (11.1.1) component against an existing Oracle Identity Management 11g Release 1 (11.1.1) component, you may need to identify the ports for the existing component. For example, if you want to install Oracle Identity Manager 11g Release 1 (11.1.1) against an existing Oracle Internet Directory 11g Release 1 (11.1.1) component, you must identify its port when you install Oracle Identity Manager.

3.2.6 Completing an Installation

This topic explains the steps that are common to completing most Oracle Identity Management installations and configurations. It begins with the steps on the Installation Summary screen and ends after the Installation Complete screen.

When the Installation Summary screen appears, perform the following steps to complete the installation:

1. Verify the installation and configuration information on the Installation Summary screen.

   • Click Save to save the installation response file, which contains your responses to the Installer prompts and fields. You can use this response file to perform silent installations. Refer to the topic "Performing Silent Installations" in the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.

     Note:

     The installation response file is not saved by default—you must click Save to retain it.

   • Click Install. The Installation Progress screen appears.

2. Monitor the progress of your installation. The location of the installation log file is listed for reference. After the installation progress reaches 100%, click OK. The Installation Complete screen appears.

3. Click Save to save the installation summary file. This file contains information about the configuration, such as locations of install directories, that will help you get started with configuration and administration.

   Note:

   The installation summary file is not saved, by default—you must click Save to retain it.

   Click Finish to close and exit the Installer.

3.2.7 Locating Installation Log Files

The Installer writes log files to the ORACLE_INVENTORY_LOCATION/logs directory on UNIX systems and to the ORACLE_INVENTORY_LOCATION\logs directory on Windows systems.

On UNIX systems, if you do not know the location of your Oracle Inventory directory, you can find it in the ORACLE_HOME/oraInst.loc file.

On Microsoft Windows systems, the default location for the inventory directory is C:\Program Files\Oracle\Inventory\logs.

The following install log files are written to the log directory:

• installDATE-TIME_STAMP.log

• installDATE-TIME_STAMP.out

• installActionsDATE-TIME_STAMP.log

• installProfileDATE-TIME_STAMP.log

• oraInstallDATE-TIME_STAMP.err

• oraInstallDATE-TIME_STAMP.log