Skip Headers
Oracle® Communications Data Model Adapters and Analytics Installation Guide
Release 11.3.2

E37744-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

3 Installation of Oracle Communications Data Model Add-ons

This chapter describes how to install Oracle Communications Data Model Add-ons:

Preinstallation Tasks

Before you install the Oracle Communications Data Model Add-ons, perform the following tasks:

  • Back up the Oracle Database.

  • Ensure that the Oracle Communications Data Model Add-ons is installed, as described in "Ensuring that Required Software is Installed".

  • Ensure that ocdm_sys account is unlocked.

  • The rules for tnsnames entry for OCDM Add-ons installation are as follows:

    Note:

    The rules for tnsnames is mandatory for Social Network Analytics Add-ons.
    • Non- Oracle Real Application Cluster Environment

      For non- Oracle RAC environment, Oracle System Identifier (SID) will be set to lowercase tnsnames entry chosen by the user. So TNSNAMES entry must accurately reflect the SID.

      If the SID is orcl11203, you cannot set the tnsnames entry to OCDM_Test. If SID is orcl11203, then tnsnames entry must be set to orcl11203.

    • Oracle Real Application Cluster Environment

      For Oracle RAC environment, SID is set to lowercase tnsnames entry chosen by the user. So TNSNAMES entry should accurately reflect the SID for the system on which Add-ons are installed in an Oracle RAC environment.

      Modify the tnsnames entry name to match the SID of the database node for the system. After the Add-ons installation, revert the tnsnames entry to the previous entry. Follow the same procedure during the deinstallation steps for the SNA Add-ons. When reinstalling or installing the Add-ons at a later stage, modify the tnsnames entry name.

      If the SID is orcl2, you cannot set the tnsnames entry to localhost_orcl. If SID is orcl2, then the tnsnames entry must be set to orcl2.

Ensuring that Required Software is Installed

As discussed in "Software Requirements", you must have certain software installed before you can successfully install any of the Oracle Communications Data Model Add-ons components.

Installer Execution

Before you install Oracle Communications Data Model Add-ons, perform the necessary preinstallation tasks described in "Preinstallation Tasks".

Note:

You must install Oracle Communications Data Model Add-ons on the localhost where the database server and the Oracle Communications Data Model core installation is located. You can determine the value of your localhost by issuing the following command where db-name is the name of your Oracle database.
tnsname db-name

Follow these steps to install Oracle Communications Data Model Add-ons:

  1. Log in using the user ID that you plan to use to run the installation. You should use the same user ID to install Oracle Communications Data Model Add-ons as used to install the Oracle Database and Oracle Communications Data Model.

  2. Set the ORACLE_HOME environment variable to the location of the database on which to install Oracle Communications Data Model Add-ons.

    For example, suppose that Oracle home is in the directory: /loc/app/oracle/product/dbhome

    In a Bourne, Bash, or Korn shell, use these commands to set ORACLE_HOME:

    $ ORACLE_HOME=/loc/app/oracle/product/dbhome
    $ export ORACLE_HOME
    

    In a C shell, use this command to set ORACLE_HOME:

    % setenv ORACLE_HOME /loc/app/oracle/product/dbhome
    
  3. Start the installer from the directory that contains the Oracle Communications Data Model Add-ons installation files:

    cd directory-containing-OCDM_Addon_installation-files
    ./runInstaller
    
  4. The Welcome page is displayed. Click Next.

  5. In the Specify Home Details page, verify that the Name and Path correspond to the Oracle Database in which you want to install Oracle Communications Data Model Add-ons. You can click Browse to navigate to any valid local data file path.

    Click Next.

  6. In the Product-Specific Prerequisite Checks page, if one or more items are flagged, manually verify that your environment meets the minimum requirements. For details about performing this manual verification, click the flagged item and review the details in the box at the bottom of the page.

    When the status of all items are checked as Succeeded, click Next.

  7. In the Available Product Components page, select the components you want to install.

    Note:

    At least one component must be selected in this dialog. By default the Oracle Communications BRM Adapter is selected. If you do not want to install the Oracle Communications BRM Adapter, first select another component and then deselect the Oracle Communications BRM Adapter.
    • Oracle Communications BRM Adapter

    • Oracle Communications NCC Adapter

    • Oracle Communications Social Network Analytics

    • Oracle Communications Billing Analytics

    Note:

    The installer only supports installing one component at a time. To install multiple components, run the installer for each component you want to install.

    When the selection includes the component you want to install, click Next.

  8. In the Specify Database Connection Information page, provide the following information:

    • Select the Net Service Name which is the alias used for a connect descriptor to connect to the Oracle Database where Oracle Communications Data Model will be installed.

      Tip:

      A net service name is a simple name for a service that resolves to a connect descriptor. Net service names are populated from the OracleHome/network/admin/tnsnames.ora file.
    • Enter the Password for SYSTEM user of the Oracle Database where the selected Add-ons for Oracle Communications Data Model will be installed.

    Click Next.

  9. In the Specify Add-ons Information page, specify where all of the data files that correspond to the Oracle Communications Data Model Add-ons should reside:

    • If you do not want to use the Automatic Storage Management (ASM) feature in Oracle Database, but instead want to explicitly specify a folder name, select File System and enter a folder name. You can click Browse to navigate to any valid local data file path.

      Click Next.

    • If you have stored your Oracle database files using the Automatic Storage Management (ASM) feature, and you also want store Oracle Communications Data Model data files using ASM, select Automatic Storage Management (ASM).

      Click Next.

      In the Select ASM Disk Group page, select the disk group in which you want to install the Oracle Communications Data Model data files.

      Click Next.

  10. The installer summarizes the information that you specified. Check that this information is correct. If necessary, click Back to return to previous screens and make corrections. When you are satisfied with the information, click Install.

After you exit the installer, perform any necessary postinstallation tasks described in "Postinstallation Tasks".

Silent Installation

A silent installation has no graphical output and no input by the user. It is accomplished by supplying Oracle Universal Installer with a response file and specifying the -silent flag on the command line. Use silent installation when you want the same installation parameter on more than one computer.

Selecting a Response File

Before performing a silent installation, you must provide information specific to your installation in a response file. The installer will fail if you attempt an installation using a response file that is not configured correctly. Response files are text files that you can create or edit in a text editor. The response file (adapters_off.rsp) is located in the /response directory (in the directory that contains the Oracle Communications Data Model Add-ons response path). Edit the response file according to your requirements for silent installation. To use a response file, first copy it to your system.

Note:

You must install Oracle Communications Data Model on the localhost where the database server is located. You can determine the value of your localhost by issuing the following command where db-name is the name of your Oracle database.
tnsname db-name

Editing the Response File

Use any text editor to edit the response file to include information specific to your system. You must specify values for variables in your response file. Each variable listed in the response file is associated with a comment, which identifies the variable type. For example:

string = "Sample Value" 
Boolean = True or False 
Number = 1000
StringList = {"StringValue 1", "String Value 2"}

The values that are given as Value Required must be specified for silent installation. Remove the comment from the variable values in the response file before starting the Oracle Communications Data Model installation.

Specifying a Response File and Starting the Installation

Caution:

During installation, response files may be copied to subdirectories in the Oracle home. If you have provided passwords or other sensitive information in your response files, then for security purposes you should delete them after completing and verifying the installation.

Before you specify a response file, ensure that all values in the response file are correct. To make Oracle Universal Installer use the response file during an installation specify the location of the response file as a parameter when starting Oracle Universal Installer. To perform a silent installation, use the -silent parameter as follows:

 ./runInstaller -silent -responseFile absolute_path_and_filename

Silent Installation Log Files

The success or failure of silent installations is logged in the installActions.log file. Additionally, the silent installation creates the silentInstall.log file. The log files are created in the /oraInventory/logs directory. The silentInstallDate_Time.log file contains the following line if the installation was successful:

The installation of Add-ons for Oracle Communications Data Model was successful.

The corresponding installActionsDate_Time.log file contains specific information regarding installation.

Security Tips for Silent Installations

The response file contains the installation password in clear text. To minimize security issues, follow these guidelines:

  • Set the permissions on the response files so that they are readable only by the operating system user performing the silent installation.

  • If possible, remove the response files from the system after the silent installation is completed.

Error Handling

Values for variables that are of the wrong context, format, or type are treated as if no value were specified. Variables that are outside any section are ignored. If you attempt a silent installation with an incorrect or incomplete response file, or if Oracle Universal Installer encounters an error, such as insufficient disk space, then the installation will fail.

Postinstallation Tasks

After you execute the Installer perform the following postinstallation, cleanup, and configuration steps:

  1. If you installed BRM Application Adapter, perform the additional installation and configuration steps as described in Appendix A, "BRM Adapter Installation and Configuration" to complete the installation and configuration of the BRM Adapter.

  2. If you installed NCC Application Adapter, perform the additional installation and configuration steps as described in Appendix C, "NCC Adapter Installation and Configuration" to complete the installation and configuration of the NCC Adapter.

  3. If you installed Billing Analytics, perform the postinstallation steps as described in Appendix D, "Oracle Communications Billing Analytics Postinstallation Steps" to complete the postinstallation steps of the Billing Analytics.

  4. If you installed Social Network Analytics, perform the postinstallation and additional configuration steps as described in Appendix E, "Oracle Communications Social Network Analytics Postinstallation Steps" to complete the postinstallation and additional configuration steps of the Social Network Analytics.