4 Installing Offline Mediation Controller

This chapter describes how to install Oracle Communications Offline Mediation Controller. Before installing Offline Mediation Controller, read the following chapters:

Offline Mediation Controller Installation Options

You can install Offline Mediation Controller in the GUI mode (using the Oracle Universal Installer) or in the silent mode.

GUI mode: Use the GUI mode when you want to interact with the Offline Mediation Controller Installer GUI during installation. See "Installing Offline Mediation Controller in GUI Mode" for more information.
Silent mode: Use the silent mode when you are installing Offline Mediation Controller using the same configuration repeatedly. The silent mode runs in the background. See "Installing Offline Mediation Controller in Silent Mode" for more information.

Offline Mediation Controller Installation Types

When installing Offline Mediation Controller in the GUI mode, you can select the type of installation:

Install complete Offline Mediation Controller that contains all components. See "Installing Offline Mediation Controller in GUI Mode" for more information.
Install Offline Mediation Controller Node Manager. See "Installing Offline Mediation Controller Node Manager" for more information.
Install Offline Mediation Controller Admin Server. See "Installing Offline Mediation Controller Administration Server" for more information.
Install Offline Mediation Controller Admin Client. See "Installing Offline Mediation Controller Administration Client" for more information.

Installing Offline Mediation Controller in GUI Mode

You can install all Offline Mediation Controller components on an Oracle Solaris 10 (64-bit) server or Oracle Linux or Red Hat Enterprise Linux (64-bit) 5.0 server.

To install Offline Mediation Controller in the GUI mode:

Ensure that the Oracle Unified Directory server instance is running.
Create a temporary directory (temp_dir).
Go to the Oracle software delivery Web site:

http://edelivery.oracle.com

and download the OfflineMediationController-6.0.0-platform.zip software pack to temp_dir, where platform is linux, solaris, or solx86_64.
Unzip the OfflineMediationController-6.0.0-platform.zip file.

The following folder structure is created:

/ocomc/Disk1/install/

/ocomc/Disk1/stage/

/ocomc/Translations/
Go to the temp_dir/ocomc/Disk1/install directory and run the following command:
```
./runInstaller
```
The Welcome screen appears.
Click Next.

The Select Installation Type screen appears.

Note:
The Offline Mediation Controller Installer creates an oraInventory directory if it does not detect any installed Oracle products on the system. The oraInventory directory contains information about all Oracle products installed on your system. The default location of the oraInventory directory is in the /etc/oraInst.loc (Linux) file or the /var/opt/oracle/oraInst.loc (Solaris) file.
Select Complete and click Next.

The Specify Home Details screen appears.
Enter the following Offline Mediation Controller installation details:
1. In the Name field, enter the Offline Mediation Controller installation name.
  
  Note:
  You can select the name for the installation from the list of names the Offline Mediation Controller Installer provides.
2. In the Path field, enter the path to the directory in which you want to install Offline Mediation Controller.
  
  Note:
  Optionally, click Browse to navigate to the directory in which you want to install Offline Mediation Controller.
3. Click Next.
  
  The Oracle Unified Directory Information screen appears.
Enter the following information required to configure Oracle Unified Directory for Offline Mediation Controller:

Table 2-4, "Oracle Unified Directory Connection information" lists the Oracle Unified Directory details that are required.
1. In the Host Name field, enter the IP address or the host name of the machine on which Oracle Unified Directory is installed.
2. In the LDAP Listen Port field, enter the port used by LDAP to send and receive data.
3. In the Administration Connection Port field, enter the port used for administration traffic with Oracle Unified Directory.
4. In the Root User DN field, enter the root user distinguished name (DN).
5. In the Password field, enter the root user bind password for Oracle Unified Directory.
6. In the OUD Instance Path field, enter the path to the directory where the Oracle Unified Directory instance is installed.
7. In the Directory Base DN field, enter the base DN for Oracle Unified Directory.
8. Click Next.
  
  The OCOMC Admin User Password screen appears.
Enter the following information required for an Offline Mediation Controller administrator user:
1. In the Password field, enter a password for the Offline Mediation Controller administrator user.
  
  Note:
  The Offline Mediation Controller administrator user password can be a maximum of 12 characters long and should contain at least one non-alphabetic character and one special character. You are prompted to reset this password when you log in into Administration Client for the first time.
2. In the Confirm Password field, enter the password again, to confirm it.
3. Click Next.
  
  The Summary screen appears.
Review the selections you have made in the preceding screens, and click Install.

The Install screen appears and then the Configuration Assistants screen appears.

Note:
After the installation begins, if you click Stop installation, the installation process stops but the files that are already copied are not removed.

The Installer runs the createPasswordPolicy and createDefaultData scripts and displays the results in the Configuration Assistants screen.
Click Next.

The End of Installation screen appears.

Note:
Note down the path to the configure script. You must run the configure script to perform some additional configurations for Offline Mediation Controller. See "Adding Offline Mediation Controller Service to System Startup" for more information.
Click Exit.

The Exit dialog box appears.
Click Yes.

See "Verifying the Offline Mediation Controller Installation" for information on verifying the successful installation of Offline Mediation Controller.

See "About Installation Logs" for information on the Offline Mediation Controller Installer logs.

Installing Offline Mediation Controller Node Manager

You can install Offline Mediation Controller Node Manager on an Oracle Solaris 10 (64-bit) server or Oracle Linux or Red Hat Enterprise Linux (64-bit) 5.0 server.

To install Offline Mediation Controller Node Manager in the GUI mode:

Create a temporary directory (temp_dir).
Go to the Oracle software delivery Web site:

http://edelivery.oracle.com

and download the OfflineMediationController-6.0.0-platform.zip software pack to temp_dir, where platform is linux, solaris, or solx86_64.
Unzip the OfflineMediationController-6.0.0-platform.zip file.

The following folder structure is created:

/ocomc/Disk1/install/

/ocomc/Disk1/stage/

/ocomc/Translations/
Go to the temp_dir/ocomc/Disk1/install directory and run the following command:
```
./runInstaller
```
The Welcome screen appears.
Click Next.

The Select Installation Type screen appears.

Note:
The Offline Mediation Controller Installer creates an oraInventory directory if it does not detect any installed Oracle products on the system. The oraInventory directory contains information about all Oracle products installed on your system. The default location of the oraInventory directory is in the /etc/oraInst.loc (Linux) file or the /var/opt/oracle/oraInst.loc (Solaris) file.
Select Node Manager and click Next.

The Specify Home Details screen appears.
Enter the following Offline Mediation Controller installation details:
1. In the Name field, enter the Offline Mediation Controller Node Manager installation name.
  
  Note:
  You can select the name for the installation from the list of names the Offline Mediation Controller Installer provides.
2. In the Path field, enter the path to the directory in which you want to install Offline Mediation Controller Node Manager.
  
  Note:
  Optionally, click Browse to navigate to the directory in which you want to install Offline Mediation Controller Node Manager.
3. Click Next.
  
  The Summary screen appears.
Review the selections you have made in the preceding screens, and click Install.

The Install screen appears.

Note:
After the installation begins, if you click Stop installation, the installation process stops but the files that are already copied are not removed.
Click Next.

The End of Installation screen appears.
Click Exit.

The Exit dialog box appears.
Click Yes.

See "Verifying the Offline Mediation Controller Installation" for information on verifying the successful installation of Offline Mediation Controller Node Manager.

See "About Installation Logs" for information on the Node Manager Installer logs.

Installing Offline Mediation Controller Administration Server

You can install Administration Server on an Oracle Solaris 10 (64-bit) server or Oracle Linux or Red Hat Enterprise Linux (64-bit) 5.0 server.

To install Administration Server in the GUI mode:

Create a temporary directory (temp_dir).
Go to the Oracle software delivery Web site:

http://edelivery.oracle.com

and download the OfflineMediationController-6.0.0-platform.zip software pack to temp_dir, where platform is linux, solaris, or solx86_64.
Unzip the OfflineMediationController-6.0.0-platform.zip file.

The following folder structure is created:

ocomc/Disk1/install/

ocomc/Disk1/stage/

ocomc/Translations/
Go to the ocomc/Disk1/install directory and run the following command:
```
./runInstaller
```
The Welcome screen appears.
Click Next.

The Select Installation Type screen appears.

Note:
The Offline Mediation Controller Installer creates an oraInventory directory if it does not detect any installed Oracle products on the system. The oraInventory directory contains information about all Oracle products installed on your system. The default location of the oraInventory directory is in the /etc/oraInst.loc (Linux) file or the /var/opt/oracle/oraInst.loc (Solaris) file.
Select Admin Server and click Next.

The Specify Home Details screen appears.
Enter the following Offline Mediation Controller installation details:
1. In the Name field, enter the Administration Server installation name.
  
  Note:
  You can select the name for the installation from the list of names the Offline Mediation Controller Installer provides.
2. In the Path field, enter the path to the directory in which you want to install Administration Server.
  
  Note:
  Optionally, click Browse to navigate to the directory in which you want to install Administration Server.
3. Click Next.
  
  The Summary screen appears.
Review the selections you have made in the preceding screens, and click Install.

The Install screen appears.

Note:
After the installation begins, if you click Stop installation, the installation process stops but the files that are already copied are not removed.
Click Next.

The End of Installation screen appears.
Click Exit.

The Exit dialog box appears.
Click Yes.

See "Configuring Authentication For Administration Server" for information on configuring authentication for Administration Server.

See "Verifying the Offline Mediation Controller Installation" for information on verifying the successful installation of Administration Server.

See "About Installation Logs" for information on the Administration Server Installer logs.

Configuring Authentication For Administration Server

Administration Server uses Oracle Unified Directory for authentication.

To configure authentication for Administration Server:

Log on to the system on which Offline Mediation Controller is installed.
Open the OMC_Home/web/htdocs/AdminServerImpl.properties file in a text editor, where OMC_Home is the directory in which you installed Offline Mediation Controller.
Enter the values for the following parameters:
- com.nt.udc.admin.server.AdminServerImpl.ldapURL. Specifies the URL and the LDAP listening port of the Oracle Unified Directory system.
- com.nt.udc.admin.server.AdminServerImpl.ldapDomain. Specifies the base DN for Oracle Unified Directory.
For example:
```
com.nt.udc.admin.server.AdminServerImpl.ldapURL       ldap://localhost:1389
com.nt.udc.admin.server.AdminServerImpl.ldapDomain    dc=ocomcexample.com
```
Save and close the file.
Open the OMC_Home/bin/createPasswordPolicy file in a text editor.
Enter the values for the following parameters:
- OUD_HOME. Specifies the path to the directory where the Oracle Unified Directory instance is installed.
- OUD_HOST. Specifies the IP address or the host name of the machine on which Oracle Unified Directory is installed.
- OUD_ADMIN_PORT. Specifies the port used for administration traffic with Oracle Unified Directory.
- OUD_BINDDN. Specifies the root user DN.
For example:
```
                        OUD_HOME=/Oracle/Middleware/asinst_1/OUD; 
                        OUD_HOST=localhost; 
                        OUD_ADMIN_PORT=4444; 
                        OUD_BINDDN="cn=Directory Manager";
```
Save and close the file.
Open the OMC_Home/bin/createDefaultData file in a text editor.
Enter the values for the following parameters:
- OUD_HOME. Specifies the path to the directory where the Oracle Unified Directory instance is installed.
- OUD_HOST. Specifies the IP address or the host name of the machine on which Oracle Unified Directory is installed.
- OUD_ADMIN_PORT. Specifies the port used for administration traffic with Oracle Unified Directory.
- OUD_BINDDN. Specifies the root user DN.
- OUD_BASEDN. Specifies the base DN for Oracle Unified Directory.
- OUD_LDAPPORT. Specifies the port used by LDAP to send and receive data.
For example:
```
        OUD_HOME=/Oracle/Middleware/asinst_1/OUD; 
                        OUD_HOST=localhost;
                        OUD_ADMIN_PORT=4444; 
                        OUD_BINDDN="cn=Directory Manager"; 
                        OUD_BASEDN="dc=ocomcexample.com"
OUD_LDAPPORT="1389"
```
Save and close the file.
Open the OMC_Home/bin/populateDirTemp.ldif file in a text editor.
Enter the value for the following parameter:

userpassword: Specifies the password for the Offline Mediation Controller administrator user.
Save and close the file.
Ensure that the Oracle Unified Directory server instance is running.
Go to the OMC_Home/bin directory and run the following command:
```
./createPasswordPolicy -p OUD_Password
```
where OUD_Password is the root user bind password for Oracle Unified Directory.

The default password policies are set in Oracle Unified Directory. See the discussion about the default password policies in Offline Mediation Controller System Administrator's Guide.
Go to the OMC_Home/bin directory and run the following command:
```
./createDefaultData -p OUD_Password
```
The default user data is added in Oracle Unified Directory.

Note:
The populateDirTemp.ldif file is automatically deleted after the default user data is added in Oracle Unified Directory.

Installing Offline Mediation Controller Administration Client

You can install Administration Client on an Oracle Solaris 10 (64-bit) server or Oracle Linux or Red Hat Enterprise Linux (64-bit) 5.0 server.

To install Administration Client in the GUI mode:

Create a temporary directory (temp_dir).
Go to the Oracle software delivery Web site:

http://edelivery.oracle.com

and download the OfflineMediationController-6.0.0-platform.zip software pack to temp_dir, where platform is linux, solaris, or solx86_64.
Unzip the OfflineMediationController-6.0.0-platform.zip file.

The following folder structure is created:

ocomc/Disk1/install/

ocomc/Disk1/stage/

ocomc/Translations/
Go to the temp_dir/ocomc/Disk1/install directory and run the following command:
```
./runInstaller
```
The Welcome screen appears.
Click Next.

The Select Installation Type screen appears.

Note:
The Offline Mediation Controller Installer creates an oraInventory directory if it does not detect any installed Oracle products on the system. The oraInventory directory contains information about all Oracle products installed on your system. The default location of the oraInventory directory is in the /etc/oraInst.loc (Linux) file or the /var/opt/oracle/oraInst.loc (Solaris) file.
Select Admin Client and click Next.

The Specify Home Details screen appears.
Enter the following Offline Mediation Controller installation details:
1. In the Name field, enter the Administration Client installation name.
  
  Note:
  You can select the name for the installation from the list of names the Offline Mediation Controller Installer provides.
2. In the Path field, enter the path to the directory in which you want to install Administration Client.
  
  Note:
  Optionally, click Browse to navigate to the directory in which you want to install Administration Client.
3. Click Next.
  
  The Summary screen appears.
Review the selections you have made in the preceding screens, and click Install.

The Install screen appears.

Note:
After the installation begins, if you click Stop installation, the installation process stops but the files that are already copied are not removed.
Click Next.

The End of Installation screen appears.
Click Exit.

The Exit dialog box appears.
Click Yes.

See "Verifying the Offline Mediation Controller Installation" for information on verifying the successful installation of Administration Client.

See "About Installation Logs" for information on the Administration Client Installer logs.

Installing Offline Mediation Controller in Silent Mode

The silent mode installation is a way of setting installation configurations only once and then using those configurations to duplicate the installation on many systems. In this mode, you use a response file template that contains a predefined set of values to install Offline Mediation Controller.

Note:

The silent installation is not meant for production environments and it should be used only in test environments for setting up quickly or backing up the properties for later use in another test environment.

About the Response File

The Offline Mediation Controller Installer includes the following response file templates, in the temp_dir/ocomc/Disk1/stage/Response/ directory:

oracle.communications.ocomc.Complete.rsp

Use this file template if you are doing a complete installation.
oracle.communications.ocomc.AdminClient.rsp

Use this file template if you are installing only Administration Client.
oracle.communications.ocomc.AdminServer.rsp

Use this file template if you are installing only Administration Server.
oracle.communications.ocomc.NodeManager.rsp

Use this file template if you are installing only Node Manager.

The response file templates contain all the parameters that the Offline Mediation Controller Installer requires during the silent, unattended installation but it does not contain the parameter values. You must update the response file template as per your installation requirements before starting the silent installation.

Running the Silent Mode Installation

To install Offline Mediation Controller in the silent mode:

Go to the temp_dir/ocomc/Disk1/stage/Response/ directory.
Make a copy of the oracle.communications.ocomc.Complete.rsp file and open it in a text editor.
Enter the values for the following parameters as per your installation requirements:
- ORACLE_HOME: Specifies the path to the directory in which you want to install Offline Mediation Controller.
- ORACLE_HOME_NAME: Specifies the Offline Mediation Controller installation name.
- AdminUserPwd: Specifies the password for the Offline Mediation Controller administrator user.
- OUD_DETAILS: Specifies the Oracle Unified Directory server details using the following syntax:
```
OUD_DETAILS={"Host_Name","Ldap_Listen_Port","Administration_Connector_Port","Root_User_DN","Password","OUD_Instance_Path","Directory_Base_DN"} 
```
  where:
  - Host_Name is the IP address or the host name of the machine on which Oracle Unified Directory is installed.
  - LDAP_Listen_Port is the LDAP listening port to send and receive data.
  - Administration_Connection_Port is the port used for administration traffic with Oracle Unified Directory.
  - Root_User_DN is the root user distinguished name (DN).
  - Password is the root user bind password for Oracle Unified Directory.
  - OUD_Instance_Path is the path to the directory where the Oracle Unified Directory instance is installed.
  - Directory_Base_DN is the base DN for Oracle Unified Directory.
  For example:
```
OUD_DETAILS={"localhost","1389","4444","cn=Directory Manager","oracle","/home/oracle/Oracle/Middleware/asinst_1/OUD","dc=ocnmexample.com"}
```
Note:
- The response file template contains guidelines and examples on how to enter the values.
- The Offline Mediation Controller Installer treats incorrect context, format, or type values within a response file as if no value were specified.
Save the file with a different file name and close the file.
Go to the temp_dir/ocomc/Disk1/install/ directory and run the following command:
```
./runInstaller -responseFile path -silent
```
where path is the response file name and location.

The installation runs silently in the background.

See "Adding Offline Mediation Controller Service to System Startup" for more information on additional configurations for Offline Mediation Controller.

See "Verifying the Offline Mediation Controller Installation" for information on verifying the successful installation of Offline Mediation Controller.

See "About Installation Logs" for information on the Offline Mediation Controller Installer logs.

Installing Offline Mediation Controller on an Oracle Real Application Clusters System

Note:

This is an optional installation configuration.

To install Offline Mediation Controller on an Oracle Real Application Clusters (RAC) system:

Ensure that the servers in the RAC system are running. for more information on RAC system, see the Oracle Real Application Clusters documentation.
Install the Offline Mediation Controller on each server. See "Installing Offline Mediation Controller in GUI Mode" for more information on installing Offline Mediation Controller.

About Installation Logs

You can check the log files in the oraInventory/logs directory. The default location of the oraInventory directory is in the /etc/oraInst.loc (Linux) file or the /var/opt/oracle/oraInst.loc (Solaris) file.

Use the following log files to monitor installation and post-installations:

installActionTimeStamp.log
oraInstallTimeStamp.err
oraInstallTimeStamp.out
silentInstallTimeStamp.log (for the silent mode installation)

where TimeStamp is the date and time the log file was created.