This chapter describes tasks you must complete before installing Oracle Communications Evolved Communications Application Server (OCECAS).
You must perform certain tasks before installing OCECAS. Pre-installation tasks are broken down into the following categories:
Tasks that are not specific to OCECAS but that are required for a functioning installation. See "General Pre-Installation Tasks".
Tasks that you must perform before you install OCECAS. See "OCECAS Pre-Installation Tasks".
Note:
If you are using Network Function Virtualization and installing OCECAS on an OVA image file, follow the procedure in "Creating the OVA Image File" in the Oracle Communications Evolved Communications Application Server System Administrator's Guide and refer to this guide as required.Before continuing, complete the following general pre-installation tasks:
Allocate IP addresses for OCECAS interfaces, including:
Public-facing external interfaces
Internal-facing interfaces
Intra-system interfaces for private signaling between OCECAS nodes
If required by your organization, a separate systems management interface
Determine which logical interfaces map to which physical interfaces on each server.
Have access to a Domain Name Service (DNS) and Network Time Protocol (NTP) server.
Optionally assign fully qualified domain names to each server.
Make a note of any required static routes.
Before you install the OCECAS software, perform the following pre-installation tasks on each physical or virtual machine:
Create a user account for installing the OCECAS software. See "Creating a UNIX User for Installing OCECAS".
Install the JDK software. See "Installing a Java Development Kit".
Install the Oracle database software. See "Installing the Oracle Database Software".
If LDAP authentication is required, install the OpenLDAP software. See "Installing the OpenLDAP Software".
If you will be using OCECAS service centralization or need to integrate with an MSC not enhanced for IMS Centralized Services (ICS), install Oracle Communications Converged Application Server, Service Controller (OCCAS-SC). See "Installing OCCAS-SC".
Choose a directory for installing all Oracle software. See "Choosing an Installation Directory".
You create a UNIX user to:
Install the Oracle database software.
For more information, see "Installing the Oracle Database Software".
Run the root.sh script for creating your OCECAS database and schema.
For more information, see "About the OCECAS Database Creation Script".
Install the OCECAS software.
For more information, see "Installing OCECAS in GUI Mode".
Create the OCECAS domains.
For more information, see "Starting the Domain Configuration Wizard".
Although you can use any UNIX user with sufficient privileges, this guide assumes that the user is named ocecas and is a member of the dba group.
To create a UNIX user for installing OCECAS:
Log into your system as user root.
Create a directory for storing the OCECAS software. For example:
mkdir -p Ocecas_home
Create a user named ocecas that has a home directory of Ocecas_home and a default login shell of bash. For example:
/usr/sbin/useradd -d Ocecas_home -s /bin/bash ocecas -p ocecas -g dba
Change the user and group ownership to ocecas for the Ocecas_home directory and all of its files and subdirectories. For example:
chown -R ocecas:dba Ocecas_home
Install Oracle Java Development Kit (JDK) plus the latest security update on each physical machine or VM in your OCECAS system. For a list of supported software versions, see "Software Requirements".
To install and configure your JDK:
Download the JDK from the Java SE Development Kit Downloads page at:
Install the JDK per instructions provided with it.
Add the JDK bin directory to the beginning of the PATH variable definition. For example:
PATH=$JAVA_HOME/bin:$PATH export PATH
Check that your system is using the correct version of the JDK by entering the following command:
java -version
Install the Oracle 12c database software as the user ocecas. Install the software either:
On the machine that hosts your management domain
On a machine that is connected by Transparent Network Substrate (TNS) or Java Database Connectivity (JDBC) to the machine that hosts your management domain. In this case, the database is referred to as a remote database.
To download the software, go to the Oracle Database Software Downloads page at:
http://www.oracle.com/technetwork/database/enterprise-edition/downloads/index.html
Note:
Do not create a database. During OCECAS installation, you will do one of the following to automatically create the OCECAS database and schema:If the database is on the machine that hosts your management domain, run the root.sh script to create the OCECAS database instance and schema
If the database is on a machine that is connected to machine that hosts your management domain (a remote database), run the sdc-db.sh script to create the OCECAS database instance and schema
For more information about:
Supported database software versions, see "Database Software".
The root.sh and sdc-db.sh scripts, see "About the OCECAS Database Creation Script".
If your system requires LDAP authentication, you must install the OpenLDAP software on each physical machine in your OCECAS system.
To see the list of supported OpenLDAP software versions, see "LDAP Software".
To install the OpenLDAP software:
Download the OpenLDAP software from the OpenLDAP software web site:
Unpack the archive file by entering the following command:
tar xfz openldap-n.n.nn.tgz
The openldap-n.n.nn subdirectory is created, where n.n.nn is the OpenLDAP software version number. For example, openldap-2.4.40.
Go to the openldap-n.n.nn subdirectory.
Configure the software by using the OpenLDAP configure script. See "Building and Installing OpenLDAP Software" in OpenLDAP Software 2.4 Administrator's Guide.
Build dependencies by entering the following command:
make depend
Build and compile the OpenLDAP software by entering the following command:
make
Run the test suite to verify the build by entering the following command:
make test
As a super user, install the OpenLDAP software by entering the following command:
su root -c 'make install'
For more information about:
Installing and using the OpenLDAP software, see OpenLDAP Software 2.4 Administrator's Guide.
Configuring LDAP authentication, see "Managing User Entities" in Evolved Communications Application Server System Administrator's Guide.
If you will be utilizing OCECAS service centralization or need to integrate with an MSC not enhanced for IMS Centralized Services (ICS), you must install Oracle Communications Converged Application Server, Service Controller (OCCAS-SC), which supports CAP and MAP for communicating with MSC and HLR respectively. For an overview of service centralization and integrating with an MSC not enhanced for ICS, see "About Service Centralization" in Oracle Communications Evolved Communications Application Server Concepts. For the required version of OCCAS-SC, see "Middleware Software".
For information on installing OCCAS-SC, see Oracle Communications Service Broker Installation Guide.
Note:
The product name Oracle Communications Service Broker was subsequently changed to Oracle Communications Converged Application Server, Service Controller (OCCAS-SC).In addition to installing OCCAS-SC, you must apply the latest rolling patch, and patches 23028822 and 23185006. Patch 23028822 adds MAP operations that are needed for integration with OCECAS. Patch 23185006 enhances the IM-PSX ETSI plugin to support the SendRoutingInfo operation.
Note:
You must apply patch 23028822 before patch 23185006.To Obtain the Latest Rolling Patch:
Go to My Oracle Support:
Click Sign In...
Enter your User ID and Password.
Click the Knowledge tab.
In the text box labelled Select a product or product line, start typing and then select:
Oracle Communications Converged Application Server - Service Controller
In the text box labelled Enter search terms, enter 1561025.1
and click Search.
Select the link for:
Oracle Communications Converged Application Server - Service Controller (OCCAS - SC) - Latest Rolling Patch (RP) Available for Version 6.1.0.0
This article describes how to access and apply the latest rolling patch.
To Obtain Patches 23028822 and 23185006:
Go to My Oracle Support:
Click Sign In...
Enter your User ID and Password.
Click the Patches and Updates tab.
Make sure Patch Name or Number appears in the first drop-down list.
In the text box for Patch Name or Number, enter the patch number and click Search.
On the Patch Details page, click Download to download the patch.
Note:
Any OCCAS-SC rolling patch subsequent to RP8, should one occur, would include patches 23028822 and 23185006. In such a case, you would not need to install these patches.Following the installation of OCECAS, you must configure OCCAS-SC to interact properly with OCECAS. For information on configuring OCCAS-SC, see "Configuring OCECAS and OCCAS-SC Integration".
When you install OCECAS, you are prompted to specify an Oracle Home directory. This is the directory in which you install the OCECAS software. This directory also serves as a repository for common files that are used by multiple Oracle products installed on the same machine.
The files in the Ocecas_home directory are essential to ensuring that OCECAS, WebLogic Server, and Oracle Coherence operate correctly on your system. They facilitate checking of cross-product dependencies during installation.
For more information about selecting an installation directory, see "Understanding the Oracle WebLogic Server and Coherence Directory Structure" in Installing and Configuring Oracle WebLogic Server and Coherence.
After you complete the pre-installation tasks, install OCECAS. See "Installing OCECAS" for instructions.