Oracle® Communications Converged Application Server

Installation Guide

Release 7.1

F18462-01

May 2019

Oracle Communications Converged Application Server Installation Guide, Release 7.1

F18462-01

Copyright © 2005, 2019, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Contents

Preface

- Audience

- Documentation Accessibility

1 Converged Application Server Installation Overview

- Overview of Installed Components

- Overview of the Converged Application Server Installation Procedure

- Ensuring a Successful Installation

- Placeholders Used in This Guide

2 Planning Your Converged Application Server Installation

- About Planning Your Converged Application Server Installation

- Understanding Converged Application Server Installation Topologies

- About Converged Application Server Coherence Planning

- About Installing a Secure System

3 Converged Application Server System Requirements

- Software Requirements

- Database Software

- Middleware Software

- Virtualization Software

- About SIP Clients

- About Critical Patch Updates

- Hardware Requirements

- Information Requirements

4 Converged Application Server Pre-Installation Tasks

- About Pre-Installation Tasks

- Pre-Installation Tasks for All Converged Application Server Systems

- General Pre-Installation Tasks

- Choosing an Installation Directory

- Installing the Java Development Kit

- Pre-Installation Tasks for Proxy Registrar Domains

- Creating an Oracle Database

- Creating a MySQL Database

- Recording Your Database Information

- Creating the Converged Application Server User Account

- Next Steps

5 Installing Converged Application Server

- About the GUI Installation and Silent Installation

- Installing Converged Application Server Using the GUI Installation

- Installing Converged Application Server Using the Silent Installation

- About the Response File

- Returning Exit Codes to the Console

- Running the Installer in Silent Mode

- Next Steps

6 Creating and Configuring Converged Application Server Domains

- About Domains and Domain Configuration

- About Converged Application Server Domain Types

- Creating a Converged Application Server Domain

- Preconfiguration Steps for Replicated Domains

- Starting the Configuration Wizard

- Creating a Converged Application Server Domain in Graphical Mode

- Configuration Type Screen

- Templates Screen

- Administrator Account Screen

- Domain Mode and JDK Screen

- JDBC Data Sources Screen

- JDBC Data Sources Test Screen

- Database Scripts Screen

- Advanced Configuration Screen

- Configuration Summary Screen

- Configuration Progress Screen

- End Of Configuration Screen

- Starting the Servers in Converged Application Server

- Starting the Administration Server

- Starting the Node Manager

- Starting the Managed Servers

- Next Steps

7 Converged Application Server Post-Installation Tasks

- Overview of Converged Application Server Post-Installation Tasks

- Apply Patches

- Enabling DNS Server Lookup

- Configuring Converged Application Server Authentication

- Configuring SSL Host Name Verification

- Configuring the Coherence Security Framework

8 Migrating or Upgrading Converged Application Server

- About Migrating or Upgrading Converged Application Server

- High Availability

- About the Upgrade or Migration Example

- Migrating or Upgrading to Converged Application Server 7.1.0.0.0

- Verifying Your 7.1.0.0.0 Domain Administration Settings

9 Patching Converged Application Server

- About Converged Application Server Patch Releases

- Types of Patch Releases

- About Patch Content

- About Patch Management In Clustered Environments

- About OPatch

- Preinstallation Tasks for OPatch

- Verifying the Oracle Universal Installer Inventory

- Creating a Backup of Your Current Converged Application Server Installation

- Checking Your Environment Variables

- Installing Converged Application Server Patches

- Troubleshooting

- Dealing with Conflicts When You Run the Apply Command

- Uninstalling the Patch

- OPatch Utility Reference

10 Troubleshooting a Converged Application Server Installation

- About Troubleshooting Converged Application Server Installations

- About Converged Application Server Installation Log Files

- Changing the Installer Logging Level

- About Domain Configuration Log Files

11 Uninstalling Converged Application Server

- Uninstalling Converged Application Server Components in GUI Mode

- Uninstalling Converged Application Server Components in Silent Mode

Preface

This document describes how to install Oracle Communications Converged Application Server.

Audience

This document is intended for system administrators or application developers who are installing Converged Application Server. You should be familiar with WebLogic Server and related Java technologies, and have a general understanding Linux system administration.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

1 Converged Application Server Installation Overview

This chapter describes the general process of installing and configuring Oracle Communications Converged Application Server. Subsequent chapters describe installation steps in detail.

For more information about Converged Application Server, see Converged Application Server Concepts.

Overview of Installed Components

During the installation process, you install and configure the following components:

- Oracle database software

- Java Development Kit (JDK) software

- The Converged Application Server software, which includes:

- Oracle WebLogic Server, which is the platform container

- Oracle Coherence software

To view the supported software versions, see "Converged Application Server System Requirements".

Overview of the Converged Application Server Installation Procedure

The process for installing Converged Application Server is similar to the process for installing WebLogic Server:

1. Plan your installation:

- Determine the scale of your implementation, for example, a small test system or a large production system.

- Determine how many physical machines you need, and which software components to install on each machine.

- Plan the system topology, for example, how the system components connect to each other over the network.

2. Review system requirements. System requirements include:

- Hardware requirements, such as disk space

- System software requirements, such as operating system (OS) versions and OS patch requirements, and Java Virtual Machine (JVM) process requirements (such as memory settings)

- Information requirements, such as IP addresses and host names

3. Perform pre-installation tasks such as assigning IP addresses to network assets, installing the database, and installing the JDK.

4. Install Converged Application Server.
When you install Converged Application Server, WebLogic Server and Oracle Coherence are also installed.

5. Configure a Converged Application Server domain.

6. Perform post-installation tasks.

7. Troubleshoot any installation issues.

Ensuring a Successful Installation

The Converged Application Server installation should be performed only by qualified personnel. You must be familiar with WebLogic Server and the supported operating systems. You should be experienced with installing Java-related packages. Oracle recommends that the Oracle database installation and configuration be performed by an experienced database administrator.

Follow these guidelines:

- As you install each component (for example, the Oracle database), verify that the component installed successfully before continuing the installation process.

- Pay close attention to the system requirements. Before you begin installing the software, make sure that your system has the required base software. In addition, make sure that you know all of the required configuration values, such as host names and port numbers.

- As you create new configuration values, write them down. You re-enter these configuration values later in the procedure.

- Use this guideline only if you are configuring Converged Application Server as a Proxy Registrar. Confirm that you have installed and configured an Oracle database for use as a Java Database Connectivity (JDBC) data source.

Placeholders Used in This Guide

Table 1-1 lists placeholders that are used in this guide to refer to the directories that contain Converged Application Server system components.

Table 1-1 Directory Placeholders

Placeholder

Directory

Central_inventory_location

The directory in which the Oracle inventory file lives. The Oracle inventory lists all Oracle software installed on a machine. This directory is created by the Oracle installer upon the first Oracle product installation.

Domain_home

The directory in which the Converged Application Server domain resides, located in Oracle_home/user_projects/domains.

Oracle_home

The directory that serves as the repository for common files that are used by Oracle Communications products installed on the same machine, such as Converged Application Server and WebLogic Server.

The files in the Oracle_home directory are essential to ensuring that software operates correctly on your system. They:

- Facilitate checking of cross-product dependencies during installation

- Facilitate Service Pack installation

temp_dir

A temporary directory into which you extract the installation images for Converged Application Server. Referenced when extracting installation files and other utilities.

occas_home

The directory in which the Converged Application Server software is installed. By default, this is a subdirectory of Oracle_home; for example, Oracle_home/occas

2 Planning Your Converged Application Server Installation

This chapter provides information about planning your Oracle Communications Converged Application Server installation.

About Planning Your Converged Application Server Installation

When planning a Converged Application Server installation, consider how many physical servers can handle your subscriber base and how many signaling and media server nodes to include in your cluster.

The difference between a Converged Application Server development system and a Converged Application Server production system is only the number of machines in the system. Install the same components in a development system as installed in a production system.

See "Converged Application Server System Requirements" for information about required hardware and software.

Understanding Converged Application Server Installation Topologies

Figure 2-1 shows a simple Converged Application Server installation topology, which consists of a domain with a single Administration Server. The Administration Server hosts all of the Converged Application Server applications on a single machine.

Figure 2-1 Basic Converged Application Server Topology

While a simple single host configuration is sufficient for development and Proof of Concept (PoC) installations, production systems must be robust and fault-tolerant.

Figure 2-2 shows a fault-tolerant Converged Application Server installation topology. In this topology, the Administration Server is installed on a separate machine from the two independent managed servers, which each host a dedicated instance of Converged Application Server. The managed servers can be separated geographically for extra fault tolerance, and more engines can be added as required.

Figure 2-2 Fault-Tolerant Converged Application Server Topology

Each element in this topology illustration is described in Table 2-1.

Table 2-1 Description of the Elements in the Converged Application Server and Coherence Standard Installation Topology

Element

Description and Links to Additional Documentation

Converged Application Server Domain

A group of logically related Java components (in this case, the Administration Server, managed servers, and other related software components).

For more information, see "Understanding Domains" in Understanding Oracle WebLogic Server.

Administration Server

The central control entity of a domain, which maintains the domain's configuration objects and distributes configuration changes to managed servers.

For more information, see "Administration Server" in Understanding Oracle WebLogic Server.

Cluster

A collection of multiple Converged Application Server instances running simultaneously and working together.

For more information, see "Managed Servers and Managed Server Clusters" in Understanding Oracle WebLogic Server.

Node Manager

Node Manager is a WebLogic Server utility that enables you to start, shut down, and restart Administration Server and managed server instances from a remote location. Although Node Manager is optional, Oracle recommends it if your WebLogic Server environment hosts applications with high availability requirements.

For more information, see "Running Node Manager as a Startup Service" in Administering Node Manager for Oracle WebLogic Server.

Machine

A logical representation of the computer that hosts one or more WebLogic Server instances (servers). Machines are also the logical glue between Converged Application Server managed servers and the Node Manager; to start or stop a managed server with Node Manager, the managed server must be associated with a machine.

Managed Server

The host for your applications, application components, Web services, and their associated resources.

For more information, see "Managed Servers and Managed Server Clusters" in Understanding Oracle WebLogic Server.

About Converged Application Server Coherence Planning

Converged Application Server nodes are based on Oracle Coherence. For optimal performance, determine how to configure Oracle Coherence settings for your Converged Application Server topology. For example, determine the number of servers needed in the cluster and the number of machines deployed to ensure that there are enough servers to accommodate any type of failure, such as server processes, machines, and so on. For more information, see "Configuring and Managing Coherence Clusters" in Administering Clusters for Oracle WebLogic Server.

About Installing a Secure System

In a production system, ensure that communication between components and access to the system servers are secure. For information about choices for installing a secure system, see Converged Application Server Security Guide.

3 Converged Application Server System Requirements

This chapter describes the software, hardware, and information requirements for Oracle Communications Converged Application Server.

Software Requirements

Converged Application Server is supported on the operating system, hardware, and Java Virtual Machine (JVM) combinations shown in Table 3-1.

Converged Application Server does not support any Open Java Development Kit (OpenJDK).

Table 3-1 Supported Software

Operating System

Hardware Architectures

JDK

Additional Information

Oracle Enterprise Linux 7.5 or 7.6

x86-64

Oracle JDK 1.8.0_131

Converged Application Server is certified on Oracle Linux running either natively or as a part of Oracle virtual machine (VM) Server.

Database Software

Table 3-2 shows the databases that Converged Application Server supports.

Table 3-2 Supported Databases

Database Software

Notes

Oracle 12c Release Standard Edition

NA

MySQL Server version 5.4, 5.7

NA

Middleware Software

Table 3-3 shows the middleware software that Converged Application Server supports.

Table 3-3 Supported Middleware Software

Middleware Software

Notes

WebLogic Server Version 12.2.1.3.0, with patch set update 12.2.1.3.190416

Oracle WebLogic Server is bundled with the Converged Application Server installer. Patch 12.2.1.3.190416 is automatically applied when WebLogic Server is installed.

Oracle Coherence 12.2.1.3.0

Oracle Coherence is bundled with the Converged Application Server installer.

Virtualization Software

Table 3-4 shows the virtualization software that Converged Application Server supports.

Table 3-4 Supported Virtualization Software

Virtualization Software

Notes

Kernel-based Virtual Machine (KVM) 0.12

NA

Oracle VM 3

NA

About SIP Clients

Any standards-compliant Session Initiation Protocol (SIP) User Agent can be used.

About Critical Patch Updates

Converged Application Server is supported on all Oracle Critical Patch Updates. Install all Critical Patch Updates as soon as possible.

To download Critical Patch Updates, find out about security alerts, and enable email notifications about Critical Patch Updates, see the topic about security on Oracle Technology Network:

http://www.oracle.com/technetwork/topics/security/whatsnew/index.html

Hardware Requirements

The number and configuration of the computers that you employ for your Converged Application Server system depend on the scale and the deployment type you plan. Work with your performance team to determine your sizing requirements.

Converged Application Server has similar requirements to Oracle WebLogic Server. The following items are required in addition to the basic WebLogic Server requirements:

- Gigabit Ethernet connections are required between engine servers for most production deployments.

- Dual network interface cards (NICs) are required to provide failover capabilities in a production environment.

- Extra RAM is required to support the throughput requirements of most production installations.

- A load balancer is required for production installations.

Information Requirements

Table 3-5 shows the information you provide during the Converged Application Server installation.

Table 3-5 Required Information

Information Type

Description

Default Value

Host name or IP address

The network names or IP addresses of the machines on which you are going to install the software.

Current host name or IP address

Directory

The directory on each machine that serves as your Oracle_home directory. It is the directory that serves as the repository for common files that are used by Oracle Communications products installed on the same machine, such as Converged Application Server and WebLogic Server.

NA

Directory

The directories on each machine in which to install Converged Application Server and WebLogic Server software. By default, these are subdirectories of Oracle_home.

NA

Password

A password for the administrative user. The password must have a minimum of eight characters, at least one of which is non-alphabetic.

NA

4 Converged Application Server Pre-Installation Tasks

This chapter describes tasks you must complete before installing Oracle Communications Converged Application Server.

About Pre-Installation Tasks

You must perform certain tasks before installing Converged Application Server. Pre-installation tasks are broken down into the following categories:

- Tasks that are required for all Converged Application Server systems. See "Pre-Installation Tasks for All Converged Application Server Systems".

- Tasks that are required for Proxy Registrar domains only. See "Pre-Installation Tasks for Proxy Registrar Domains".

Pre-Installation Tasks for All Converged Application Server Systems

Before installing the Converged Application Server software, complete the following pre-installation tasks:

- Perform general pre-installation tasks. See "General Pre-Installation Tasks".

- Choose your Oracle home directory. See "Choosing an Installation Directory".

- Install JDK on all machines in your Converged Application Server system. See "Installing the Java Development Kit".

General Pre-Installation Tasks

Complete the following general pre-installation tasks:

- Allocate IP addresses for Converged Application Server interfaces, including:

- Public-facing external interfaces

- Internal-facing interfaces

- Intra-system interfaces for private signaling between Converged Application Server 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) servers.

- Optionally assign fully qualified domain names to each server.

- Make a note of any required static routes.

Choosing an Installation Directory

When you install Converged Application Server, you are prompted to specify a Oracle_home directory. This directory serves as a repository for common files that are used by multiple Fusion Middleware products installed on the same machine. For this reason, the Oracle_home directory can be considered a central support directory for all of the Fusion Middleware products installed on your system.

The files in the Oracle_home directory are essential to ensuring that Converged Application Server and WebLogic Server 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.

Installing the Java Development Kit

Install Oracle Java Development Kit (JDK) plus the latest security update on each physical machine or VM in your Converged Application Server system. For a list of supported versions, see "Software Requirements".

To install and configure your JDK:

1. Download the JDK from the Java SE Development Kit Downloads page at:
http://www.oracle.com/technetwork/java/javase/downloads/

2. Install the JDK per instructions provided with it.

3. Add the JDK bin directory to the beginning of the PATH variable definition on the target system. For example:

PATH=$JAVA_HOME/bin:$PATH
export PATH

Pre-Installation Tasks for Proxy Registrar Domains

If your Converged Application Server system will use a Proxy Registrar domain, you must install and configure either an Oracle or MySQL database for use as a JDBC data source.

Before installing the Converged Application Server software, complete the following pre-installation tasks:

- Create your database.

- To create an Oracle database, see "Creating an Oracle Database".

- To create a MySQL database, see "Creating a MySQL Database".

- Write down key information about your database that is required when you install Converged Application Server. See "Recording Your Database Information".

- Create a user account for the primary user running Converged Application Server. See "Creating the Converged Application Server User Account".

Creating an Oracle Database

Create two Oracle schemas. Create one for the Registrar bindings, and another for the User Service and Security Service. For instructions about installing the Oracle database software, creating a schema, and granting user privileges, see the Oracle database documentation.

Notes:

- Oracle recommends that you create two schemas. However, you can choose to create a single schema for all of the Converged Application Server data sources, or you can create three schemas, with one for each data source. The choice you make depends on your database management preferences.

- The following, abbreviated instructions are intended to provide an overview of the procedures to create a database for use with Converged Application Server. Refer to the documentation for your Oracle database deployment for information about creating a schema and granting privileges.

To create an Oracle database user:

1. Start SQL*Plus (the Oracle SQL command-line tool).

2. Log in to the Oracle database as an administrative user with sufficient privileges to create new database users.

3. Create the users that you need in the database by entering the following command in SQL*Plus:

SQL> CREATE USER username IDENTIFIED BY password DEFAULT TABLESPACE
user_tablespace TEMPORARY TABLESPACE temp_tablespace;

Where username is the name identifying the database account to use when connecting to the database, password is the password associated with the user name, and temp_tablespace is the temporary tablespace to use when storing temporary tables.

4. Grant the following privileges to the users you create for use with Converged Application Server:

SQL> GRANT CREATE SESSION, CREATE TABLE, CREATE SEQUENCE TO username;
SQL> ALTER USER username QUOTA UNLIMITED ON user_tablespace;

5. Exit SQL*Plus.

Creating a MySQL Database

Create two MySQL databases. Create one database for the Registrar bindings, and another database for the User Service and Security Service. For instructions about installing the MySQL database software, creating a database, and granting user privileges, see the MySQL database documentation.

Notes:

- Oracle recommends that you create two databases. However, you can create a single database for all of the Converged Application Server data sources, or you can create databases, with one for each data source. The choice you make depends on your database management preferences.

- The following, abbreviated instructions are intended to provide an overview of the procedures to create a database for use with Converged Application Server. Refer to the documentation for your MySQL database deployment for information about creating databases and granting privileges.

- If the MySQL database is installed on a case-sensitive operating system such as Linux, set the MySQL variable lower_case_table_names to 1 to ensure that MySQL is case insensitive. For example:

set-variable=lower_case_table_names=1

For more information, see the documentation for your MySQL database deployment.

To create a MySQL database:

1. Log in to the MySQL database as an administrative user.

2. Create a MySQL database:

mysql> CREATE DATABASE database_name;

Where database_name is a label (or name) that you specify to identify the database.

3. Verify that the database was created:

mysql> SHOW DATABASES;

4. Grant the following connect and resource privileges to the databases you create:

mysql> GRANT ALTER, CREATE, DELETE, INDEX, INSERT, LOCK TABLES, SELECT, UPDATE ON database_name.* TO 'username'@'hostname'
IDENTIFIED BY 'password' WITH GRANT OPTION;

Where username is the name identifying the database account to use when connecting to the database, password is the password associated with the username, and hostname identifies the network address of the host computer running that database.

5. Exit MySQL:

exit;

Recording Your Database Information

When you install and configure a database, you define system configuration values that you enter when you install and configure the Converged Application Server software. When you create the following values, write them down so you can use them during the installation process:

- Vendor: The database vendor's name. For Converged Application Server, either Oracle or MySQL.

- JDBC driver: The JDBC driver to use to connect to the database.

- Database username: The user name for connecting to the database.

- Database user password: The password for the specified user name.

- Database SID or database name: If you are using an Oracle database, this is the Database System Identifier. If you are using a MySQL database, this is the name of the database.

- Host name: The name or IP address assigned to the server hosting the database.

- Port: The port number for connecting to the database. The default port numbers are port 1521 for the Oracle database, and port 3306 for the MySQL database.

Creating the Converged Application Server User Account

Create a user account for the primary user running Converged Application Server in your environment. All machines in your system must use the same user name.

To create the Converged Application Server user account:

1. Log in to the target machine.

2. Enter the following command:

useradd passwd user_name

where user_name is the name of the user, and passwd is the password for the user.

3. Write down the user name. You will need to specify the user name when you install Converged Application Server.

Next Steps

After you complete the pre-installation tasks, install Converged Application Server. See "Installing Converged Application Server" for instructions.

5 Installing Converged Application Server

This chapter describes how to install the Oracle Communications Converged software.

Before you install Converged Application Server, complete all pre-installation tasks described in "Converged Application Server Pre-Installation Tasks".

About the GUI Installation and Silent Installation

You can install Converged Application Server by using the GUI installation or the silent installation. The silent installation enables you to perform a non-interactive installation of Converged Application Server. You can use the silent installation to install Converged Application Server quickly on multiple systems.

For installation instructions, see the following sections:

- Installing Converged Application Server Using the GUI Installation

- Installing Converged Application Server Using the Silent Installation

Installing Converged Application Server Using the GUI Installation

To run the installation program in graphical mode, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for Linux systems do.

To install Converged Application Server:

1. Log in to the target machine.

2. Download the Converged Application Server software from the Oracle software delivery website at:
http://edelivery.oracle.com

3. Go to the directory where you downloaded the installation ZIP file and extract occas_generic.jar.

4. Launch the installation program by entering the following command from the JDK directory on your system:

java -jar occas_generic.jar

The installation program starts.

If no other Oracle products are installed on the system, the Installation Inventory Setup screen appears. Specify the location where you want to create your central inventory. Make sure that the operating system group name selected on this screen has write permissions to the central inventory location.

For more information about the central inventory, see "Understanding the Oracle Central Inventory" in Installing Software with the Oracle Universal Installer.

If an Installation Inventory exists, the Oracle Communications Converged Application Server Installation Welcome screen appears.

5. Click Next.
The Auto Updates screen appears.

6. If you already have an Oracle Technical Support account, use this screen to indicate how you would prefer to receive product and security updates.
Either enter your account details or select Skip Auto Updates, then click Next.

The Installation Location screen appears.

7. Use this screen to specify the location of your Oracle home directory.
For more information about the Oracle Fusion Middleware directory structure, see "Selecting Directories for Installation and Configuration" in Planning an Installation of Oracle Fusion Middleware.

Click Next.

The Installation Type screen appears.

8. Select one of the following options:

- Converged Application Server Installation: This option includes everything you need to install, configure, and run Converged Application Server.

- Complete Installation: In addition to the Converged Application Server software, this option also includes example converged applications. The examples are installed in your Oracle_home/occas/samples/sipserver/examples directory. Oracle_home is the directory that serves as the repository for common files that are used by Oracle Communications products installed on the same machine, such as Converged Application Server and WebLogic Server. For more information about the examples, see Converged Application Server Developer's Guide.
Click Next.

The Prerequisite Checks screen appears.

9. This screen verifies that your system meets the minimum requirements.
If there are any warnings or errors, make sure that your environment meets all of the prerequisites. See "Converged Application Server System Requirements" for more information.

Click Next.

The Installation Summary screen appears.

10. Use this screen to verify the installation options you selected. If you want to save these options to a response file, click Save Response File and provide a location and name for the response file. Response files can be used later in a silent installation.

Note:
If you only want to save a response file, exit the installer now.

For more information about silent installation, see "Installing Converged Application Server Using the Silent Installation".

11. Review the selections you have made, and click Install.
The Installation Progress screen appears and the installation begins.

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

12. When the installation completes, click Next.
The Installation Complete screen appears.

At this point, Converged Application Server and Oracle WebLogic Server are installed and WebLogic Server is patched with patch set update 12.2.1.3.190416.

The next step is to launch the configuration wizard to create your WebLogic Server domain. There are two ways to launch the configuration wizard:

- Select Automatically Launch the Configuration Wizard on this screen. After you click Finish to close the installer, the configuration wizard starts and you can begin to configure your domain. Proceed to "Creating a Converged Application Server Domain".

- Do not select Automatically Launch the Configuration Wizard on this screen. After you click Finish to close the installer, manually start the configuration wizard to begin configuring your domain. Proceed to "Starting the Configuration Wizard".

Installing Converged Application Server Using the Silent Installation

Silent mode is a way of setting installation options once and then using those settings to duplicate the installation on many machines. The installation program reads your settings from a Response File that you create before you begin installation. The installation program does not display any options during the installation process.

About the Response File

The entries in the Response File (response.rsp) correspond to the prompts that you would see if you used GUI mode.

Incorrect entries in response.rsp can cause installation failures. To help you determine the cause of a failure, Oracle recommends that you create a log file when you start the installation.

The following shows a sample version of a response.rsp file. Your input may be slightly different, depending on your installation.

[ENGINE]

#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0

[GENERIC]

#Set this to true if you wish to skip software updates
DECLINE_AUTO_UPDATES=true

#My Oracle Support User Name
MOS_USERNAME=

#My Oracle Support Password
MOS_PASSWORD=<SECURE VALUE>

#If the Software updates are already downloaded and available on your local system, then specify the path to the directory where these patches are available and set SPECIFY_DOWNLOAD_LOCATION to true
AUTO_UPDATES_LOCATION=

#Proxy Server Name to connect to My Oracle Support
SOFTWARE_UPDATES_PROXY_SERVER=

#Proxy Server Port
SOFTWARE_UPDATES_PROXY_PORT=

#Proxy Server Username
SOFTWARE_UPDATES_PROXY_USER=

#Proxy Server Password
SOFTWARE_UPDATES_PROXY_PASSWORD=<SECURE VALUE>

#The oracle home location. This can be an existing Oracle Home or a new Oracle Home
ORACLE_HOME=/home/wenxili/lwx_work/software/occas/install/occas710_test/occas710

#The federated oracle home locations. This should be an existing Oracle Home. Multiple values can be provided as comma seperated values
FEDERATED_ORACLE_HOMES=

#Set this variable value to the Installation Type selected. e.g. Converged Application Server, Complete with Examples.
INSTALL_TYPE=Converged Application Server

Returning Exit Codes to the Console

The silent installation program generates exit codes that indicate the success or failure of the installation. Table 5-1 describes these exit codes:

Table 5-1 Installation Program Exit Codes

Code

Description

0

Installation completed successfully.

-1

Installation failed due to a fatal error.

-2

Installation failed due to an internal XML parsing error.

If you start the silent installation process from a script, you can have these exit codes displayed to the console. Example 5-1 shows a sample command file that runs the WebLogic Platform installation while in silent mode and echoes the exit codes to the console from which the script is executed.

Example 5-1 Return Exit Codes

#!/bin/bash

#rem Execute the installer in silent mode
java -jar occas_generic.jar -silent -responseFile /home/user/bin/response.rsp

exit_code=$?

echo ${exit_code}

echo Exit Code Key
echo ---------------
echo 0=Installation completed successfully
echo -1=Installation failed due to a fatal error
echo -2=Installation failed due to an internal XML parsing error
rem Execute the installer in silent mode

Running the Installer in Silent Mode

To perform a silent installation:

1. Log in to the target system.

2. Download the Converged Application Server software from the Oracle software delivery website at:
http://edelivery.oracle.com

3. Create a response file, as described in "About the Response File".

4. Go to the directory where you downloaded the Converged Application Server software.

5. Start the installer by entering the following command:

java -jar occas_generic.jar -silent -responseFile ResponseFile

The installer checks for all required software and writes errors to a log file if it detects any missing or unavailable components, or if there are any connectivity-related issues.

6. Check whether the installer completed successfully by retrieving the exit codes, as described in "Returning Exit Codes to the Console".

Next Steps

After you install Converged Application Server, you must configure a Converged Application Server domain. See "Creating and Configuring Converged Application Server Domains" for instructions.

6 Creating and Configuring Converged Application Server Domains

This chapter describes the steps required to create your Oracle Communications Converged Application Server domain.

Before continuing in this chapter, you need to understand the following:

- WebLogic Server domains and clustering. See "Understanding Oracle WebLogic Server Domains" and "Understanding WebLogic Server Clustering" in Oracle Fusion Middleware Understanding Domain Configuration for Oracle WebLogic Server.

- The domain topologies available for use with Converged Application Server. See "Understanding Converged Application Server Installation Topologies".

About Domains and Domain Configuration

You must configure the domains of all servers in your Converged Application Server system. You can configure your domains by:

- Using the WebLogic Server Configuration Wizard to configure each server in your installation.

- You can scale your domain horizontally, with managed servers and engines. Start by configuring the domain on the Administration Server and then using the pack and unpack commands provided by Oracle WebLogic Server to package the configuration data for copying to all the other servers. The Converged Application Server installer puts the pack and unpack commands in the Oracle_home/wlserver/common/bin directory. Oracle_home is the directory that serves as the repository for common files that are used by Oracle Communications products installed on the same machine, such as Converged Application Server and WebLogic Server.
The pack and unpack commands do not copy security files. Security files need to be provisioned manually after unpacking a domain configuration on the target system with the necessary certificates and security files.

For more information about packing and unpacking configurations, see Oracle Fusion Middleware Creating Templates and Domains Using the Pack and Unpack Commands.

- Using the WebLogic Scripting Tool (WLST) to configure each domain. The WLST scripting environment is based on the Java scripting interpreter, Jython. See Oracle Fusion Middleware Understanding the WebLogic Scripting Tool for more information.

For more information about other methods available for domain creation, see "Additional Tools for Creating, Extending, and Managing WebLogic Domains" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

About Converged Application Server Domain Types

Converged Application Server ships with default domain configuration templates for each type of deployment that Converged Application Server supports. You use one of these templates to configure your domain. These templates contain the basic configurations for setting up domains, but you may need to adjust some aspects of the domain during the domain configuration process.

- Basic Domain
The Basic Domain template enables you to create a simple Converged Application Server domain. This domain configuration can be used during development where it is more convenient to deploy and test applications on a single server. The Basic Domain topology can also be used in deployments that do not have high-availability and scalability requirements.

This domain template is specified in oracle.communications.occas.basic.template.jar.

The domain configuration script for this domain type is occas-basic.py, which you can find in Oracle_Home/occas/common/templates/scripts/wlst.

- Replicated Domain
The Replicated Domain template enables you to create a replicated Converged Application Server domain. The Replicated Domain topology is designed for use with SIP applications that require high levels of scalability, availability, and performance.

This domain template is specified in oracle.communications.occas.combined.coherence.template.jar.

The domain configuration script for this domain type is occas-replicated.py, which you can find in Oracle_Home/occas/common/templates/scripts/wlst.

- Converged Application Server - Diameter Domain
The Diameter Domain template enables you to create a simple Diameter Converged Application Server domain, complete with a Home Subscriber Server (HSS), HSS client, and relay servers. The Diameter Domain topology supports the Diameter protocol over the TCP, TLS, and SCTP transport protocols.

Note:
The Diameter Domain is not available through the Graphical Mode Domain Configuration Wizard. To configure the Diameter Domain graphically with the Domain Configuration Wizard, you need to choose one of the custom templates below.
You install and configure the Diameter Domain manually. For instructions, see "Configuring Diameter Client Nodes and Relay Agents" in Converged Application Server Administrator's Guide.

These domain templates are specified in Oracle_Home/wlserver/common/templates/wls/

- diameterdomain.jar: enables you to configure hss, hssclient and relay servers.

- diameterextension.jar: enables you to add diameter protocol support to existing domains.

The domain configuration script for this domain type is occas-diameter.py, which you can find in Oracle_Home/occas/common/templates/scripts/wlst.

- Proxy Registrar - Basic Domain
The Proxy Registrar - Basic Domain template enables you to create a non-clustered (single-server) Converged Application Server domain with the Proxy Registrar component. The Proxy Registrar combines the functionality of a SIP proxy server and registrar. Its main tasks include registering subscribers, looking up subscriber locations, and proxying requests. The Proxy and Registrar functions are described in RFC 3261.

The Proxy Registrar - Basic Domain template creates a domain appropriate for development environments, or cases where high availability is not an important consideration.

This domain template is specified in Oracle_Home/wlserver/common/templates/wls/oracle.communications.proxyregistar.basic.template.jar.

The domain configuration script for this domain type is occas-proxyregistrar.py, and the associated properties file is occas-proxyregistrar.properties, which you can find in Oracle_Home/occas/common/templates/scripts/wlst.

- Proxy Registrar - Replicated Domain
The Proxy Registrar - Replicated Domain template enables you to create a clustered (multi-server) Converged Application Server domain with the Proxy Registrar component. The Proxy Registrar Replicated Domain template creates a domain appropriate for production environments where high availability and scalability are crucial.

This domain template is specified in oracle.communications.proxyregistrar.combined.coherence.template.jar.

The domain configuration script for this domain type is occas-proxyregistrar-replicated.py, and the associated properties file is occas-proxyregistrar-replicated.properties, which you can find in Oracle_Home/occas/common/templates/scripts/wlst.

The domain template JAR files for these domain types are located in the directory Oracle_home/wlserver/common/templates/wls.

The domain configuration scripts and property files are located in the directory Oracle_home/occas/common/templates/scripts/wlst.

Creating a Converged Application Server Domain

To create a Converged Application Server domain:

1. If you are creating a replicated domain, perform the required preconfiguration steps.

2. Start the Configuration Wizard.
Oracle_Home/oracle_common/common/bin/config.sh

3. Answer the questions in each screen of the Configuration Wizard.

For more information about creating a WebLogic Server domain by using the Configuration Wizard, see "Creating a WebLogic Domain" in Oracle Fusion Middleware Creating Domains Using the Configuration Wizard.

Preconfiguration Steps for Replicated Domains

If you are creating a Converged Application Server replicated domain, perform the following configuration steps:

- Specify an explicit listener address for each machine in your cluster. This enables your machines to communicate with each other when the Coherence Cluster uses the default cluster mode.
If you do not want to specify an explicit listen address for each machine, change the Coherence cluster mode either to unicast addressing by using the Well Known Address (WKA) feature or to multicast addressing.

- Keep the directory structures the same on each machine in the cluster to simplify deployment.

- Install the Converged Application Server binaries on each machine in the cluster.

- Install any required patches manually on each machine in the cluster; they are not distributed automatically.

- Create the replicated domain on your Administration Server, and copy that domain to each of your cluster machines.

Note:
If the Administration Server is already started before you copy its domain to the cluster servers, delete the existing domains on each cluster server:

rm -rf Domain_home/servers/

Domain_home is the directory in which the Converged Application Server domain resides, located in Oracle_home/user_projects/domains.

For more information, see the following:

- "Configuring and Managing Coherence Clusters" in Oracle Fusion Middleware Administering Clusters for Oracle WebLogic Server.

- "Introduction to Coherence Clusters" in Oracle Fusion Middleware Developing Applications with Oracle Coherence.

- "Relationship Between Coherence and WebLogic Server Clusters" in Oracle Fusion Middleware Understanding Oracle WebLogic Server.

Starting the Configuration Wizard

If you selected the Automatically Launch the Configuration Wizard check box during Converged Application Server installation, the Domain Configuration Wizard starts automatically.

To start the Configuration Wizard manually:

1. Enable graphical login on the target system by enabling VNC (or another similar tool).

2. Log in to the target system.

3. Go to the Oracle_home/oracle_common/common/bin directory.

4. At a command prompt, enter:

sh config.sh

The Configuration Wizard starts and the Configuration Type screen appears. Go to "Creating a Converged Application Server Domain in Graphical Mode" and follow the steps for configuring the domain.

Creating a Converged Application Server Domain in Graphical Mode

The Configuration Wizard displays a sequence of screens in the order listed below. The screens that you see depend on the type of product configuration template that you use. To configure your domain, answer the questions in the following screens:

- Configuration Type Screen

- Templates Screen

- Administrator Account Screen

- Domain Mode and JDK Screen

- JDBC Data Sources Screen

- JDBC Data Sources Test Screen

- Database Scripts Screen

- Advanced Configuration Screen

- Configuration Summary Screen

- Configuration Progress Screen

- End Of Configuration Screen

Configuration Type Screen

In the Configuration Type screen:

1. Select Create a new domain.

2. In the Domain Location field, specify your Domain_home directory. This directory must be empty.
Oracle recommends that you create your domain outside of the Oracle_home directory. This directory structure helps you avoid issues when you upgrade or reinstall your software.

3. Click Next.
The Templates screen appears.

For more information about:

- The Domain_home directory, see "Choosing a Domain Home" in Oracle Fusion Middleware Planning an Installation of Oracle Fusion Middleware.

- Other options on the Configuration Type screen, see "Configuration Type" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

Templates Screen

In the Templates screen:

1. Select Create Domain Using Product Templates.
This option offers you a set of domain templates. See "About Domains and Domain Configuration" for a description of the different templates.

2. In the Available Templates area, select one of the following Converged Application Server configuration templates:

- Converged Application Server - Proxy Registrar Replicated Domain - 7.1.0.0.

- Converged Application Server - Proxy Registrar Basic Domain - 7.1.0.0.

- Converged Application Server - Replicated Domain - 7.1.0.0.

- Converged Application Server - Basic Domain - 7.1.0.0.

3. Click Next.
The Administrator Account screen appears.

For more information about the options on the Templates screen, see "Templates" in Oracle Fusion Middleware Creating WebLogic Domains Using the Configuration Wizard.

Administrator Account Screen

In the Administrator Account screen:

1. In the Name field, enter the user name for the domain's default WebLogic Administrator account.
This user name is used for booting and connecting to the Administration Server. For setup and testing, Oracle recommends that you use weblogic.

User names are case-sensitive. Do not use commas or any characters in the following comma-separated list:

\t, < >, #, |, &, ?, ( ), { }

2. In the Password field, enter the main administrator password.
The password is case-sensitive and must contain a minimum of eight characters, at least one of which is not alphabetic.

3. In the Confirm Password field, re-enter your password.

4. Write down the user name and password. You need this information later to start and access the Administration Server.

5. Click Next.
The Domain Mode and JDK screen appears.

Domain Mode and JDK Screen

In the Domain Mode and JDK screen:

1. In the Domain Mode area, select the appropriate startup mode for your installation:

- Development Mode

- Production Mode
Production mode gives your environment a higher degree of security, requiring a user name and password to start the Administration Server.

For more information about startup modes, see "Development vs. Production Mode Default Tuning Values" in Oracle Fusion Middleware Performance and Tuning for Oracle WebLogic Server.

2. In the JDK area, select the JDK to use for the domain.
By default, the installer selects the JDK that was used when you installed Converged Application Server. You can specify a different JDK.

3. Click Next.
For Proxy Registrar domains, the JDBC Data Sources screen appears.

For non-proxy registrar domains, the Advanced Configuration screen appears. (See "Advanced Configuration Screen").

JDBC Data Sources Screen

This screen appears only if you selected one of the Proxy Registrar domains.

Specify the connection information between Converged Application Server and the JDBC data sources (databases). A JDBC data source contains a pool of database connections that are created when the data source instance is created, when the data source is deployed or targeted, or at server startup. Applications look up a data source on the JNDI tree, and then request a connection.

In the JDBC Database Sources screen:

1. In the table, select the Location Source, Security Service, and User Service check boxes.

2. Edit the following fields to meet your system requirements:

- Vendor: Select the database vendor.

- Driver: Select the driver for your database type from the list.

- DBMS/Service: Enter the name of the Converged Application Server database.

- Host Name: Enter the name of the server that is hosting your Converged Application Server database. The default is localhost.

- Port: Enter the port number for contacting the database. For Oracle, the default is 1521. For MySQL, the default is 3306.

- Username: The Converged Application Server user name you created when you installed the database.

- Password: The Converged Application Server password you created when you installed the database (it is not echoed on the screen).

- Oracle RAC configuration for data sources: If you are using Real Application Cluster features, do one of the following:

- To convert one or more data sources to GridLink Oracle RAC data sources, select Convert to GridLink.

- To convert one or more data sources to Oracle RAC multi-data sources, select Convert to RAC multi data source.

- To not convert the data sources, select Don't Convert.

3. Click Next.
The JDBC Data Sources Test screen appears.

JDBC Data Sources Test Screen

This screen appears only if you selected one of the Proxy Registrar domains.

The JDBC Data Sources Test screen automatically tests your data source configurations:

- A green check mark displayed in the Status column indicates that the configuration is valid.

- A red circle indicates a problem.
The bottom of the screen shows a short error message to help you troubleshoot the problem. Fix the error and click Test Selected Connections to test your data source configurations again.

Click Next when you are ready to proceed to the next screen.

Database Scripts Screen

This screen appears only if you selected one of the Proxy Registrar domains.

The Database Scripts screen allows you to run scripts for creating your JDBC data source tables.

In the Database Scripts screen:

1. In the JDBC Data Sources area, select Location Service.

2. In the SQL Files area, the create service table script is selected by default.

3. From the DB Version list, select the database version: 10 or 11.

4. To configure the script to generate a log file, select the Enable Logging check box.

5. Click Run Scripts.

The script status is output to the Results area.

6. In the JDBC Data Sources area, select Security Service.

7. Repeat steps 2 through 5.

8. In the JDBC Data Sources area, select User Service.

9. Repeat steps 2 through 5.

10. Click Next.
The Advanced Configuration screen appears.

Advanced Configuration Screen

The Advanced Configuration screen allows you to perform advanced configuration on the listed items. If you approve of the current settings, keep all of the check boxes deselected and click Next.

In the Advanced Configuration Screen:

1. Select one or more of the following check boxes.

- Administration Server

- Node Manager

- Managed Servers, Clusters and Coherence

- Deployments and Services

2. Click Next.

Administration Server Screen

In the Administration Server screen:

1. In the Server Name field, enter the name of your Administration Server.

2. In the Listen Address list, select an explicit listener address for your Administration Server. Using an explicit listener address enables your machines to communicate with each other when the Coherence Cluster uses the default cluster mode.

3. In the Listen Port field, enter a port number to use as a listening port for the Administration Server.

4. To enable the SSL listen port, select the Enable SSL check box and enter the port number to use for secure requests. The default port number is 7002.

5. Click Next.

Node Manager Screen

In the Node Manager screen:

1. In the Node Manager Type area, select one of the following:

- Per Domain Default Location. If you select this option, the Node Manager home is predefined within the domain as DomainName/nodemanager and you cannot edit the Node Manager home. The Node Manager for each domain can have a different configuration, as determined by the files in this directory.

- Per Domain Custom Location. If you select this option, the Node Manager configuration files are created in a specific location for this domain. Specify the directory in the Node Manager Home field, or click Browse to navigate to the location. The specified directory must be empty. The nodemanager.properties and nodemanager.domains files are created in this directory.

- Manual Node Manager Setup. If you select this option, Node Manager configuration for the domain is skipped. You must manually create and update the Node Manager configuration for the domain.

2. In the Node Manager Credentials area, enter the user name and password that is used to start the specified Node Manager.

3. Click Next.

Managed Servers Screen

Add or change connection information for your managed servers. You can add server instances now by clicking the Add or Clone buttons or add them later by using the Administration Console.

In the Managed Servers screen:

1. In the Server Name field, enter the name of the managed server.

2. In the Listen Address list, select an explicit listener address for your managed server. Using an explicit listener address enables your machines to communicate with each other when the Coherence Cluster uses the default cluster mode.
The values for the listener address can include alphanumeric characters, dots [.], and dashes [-] only.

3. In the Listen Port field, enter a port number to use as a listening port for the managed server.

4. To enable the SSL listen port, select the Enable SSL check box and enter the port number to use for secure requests.
Do not enable SSL unless you have a trusted key.

5. Click Next.

Clusters Screen

Clusters enable you to group managed servers such that they operate as a single unit for hosting applications and resources. You can add clusters by clicking the Add button.

In the Clusters screen:

1. In the Cluster Name field, enter the name of the cluster. The name of the cluster must be unique among all component names within the domain.

2. In the Cluster Address field, enter the addresses for identifying the managed servers in the clusters.

3. In the Frontend Host field, enter the IP address of the frontend host for the cluster.

4. In the Frontend HTTP Port field, enter the plain port (HTTP) of the frontend host for the cluster.

5. In the Frontend HTTPS field, enter the secure port (HTTPS) of the frontend host for the cluster.

6. Click Next.

Server Templates Screen

In the Server Templates Screen:

1. Click Add to add a new server record.

2. Enter a name, for the server record, specify a listen port and an SSL listen port, and specify whether SSL is enabled.

3. Click Next.

To delete a server record, select a row and click the Delete button.

To discard all changes you've made, click the Discard Changes button.

Dynamic Servers Screen

Use the Dynamic Servers screen to configure however many dynamic servers that you need. Configuring dynamic clusters is an optional configuration.

If you want to configure a dynamic cluster for your domain:

1. In the Dynamic Cluster column, enable the dynamic cluster checkbox for your domain.
Notice that a new row is added to the table of dynamic clusters.

2. In the Cluster Name column, enter a name for your dynamic server.

3. In the Server Name Prefix column, enter the server name prefix.

4. From the Server Template column, select a server template that you created on the previous screen.

5. In the Dynamic Cluster Size column, enter the size of the dynamic cluster.

6. In the Machine Name Match Expression column, enter the regular expression to match the dynamic cluster with the machine.

7. If the machine names are calculated dynamically according to the Machine Name Match Expression, select the checkbox in the Calculated Machine Names column.

8. If the listen ports are calculated dynamically according to the port defined on the server template, select the checkbox in the Calculated Listen Ports column.

9. Click Next.

For more information, see the discussion about administering clusters and creating dynamic clusters in your Oracle WebLogic Server documentation.

Assign Servers to Clusters Screen

In the Assign Servers to Clusters screen:

1. In the Servers pane, select one or more managed servers.

2. In the Clusters pane, select the cluster to which you want to assign the managed servers.

3. Click the right arrow button.

4. Click Next.

Coherence Clusters Screen

In the Coherence Clusters screen:

1. In the Cluster Name field, enter the name of the Coherence cluster.

2. In the Unicast Listen Port field, enter the port number to use as the Coherence cluster unicast listen port.

3. Click Next.

Machines Screen

Add or change information about the machines in your Converged Application Server system. In the context of WebLogic Server, a machine is the logical representation of the system that hosts one or more WebLogic Server instances, for the purposes of starting and stopping remote servers using the Node Manager. In a domain, machine definitions identify a particular, physical piece of hardware and are used to associate a computer with the managed servers it hosts.

1. In the Machines screen, select the Unix Machine tab.

2. To add machines to your Converged Application Server system, click Add.

3. In the Name field, enter the name of the machine.
The name does not have to match the network name for the machine. However, the name must be unique among all component names within the domain.

4. To enable a server running on this machine to bind to a UNIX group ID (GID) after it finishes all privileged startup actions, select the Enable Post Bind GID check box and enter the GID in the Post Bind GID field.

5. To enable a server running on this machine to bind to a UNIX user ID (UID) after it finishes all privileged startup actions, select the Enable Post Bind UID check box and enter the UID in the Post Bind UID field.

6. In the Node Manager Listen Address list, select the address that Node Manager uses to listen for connection requests.

7. In the Node Manager Listen Port list, select the port that Node Manager uses to listen for connection requests.

8. Click Next.

For Windows

1. In the Machines screen, select the Machine tab.

2. To add machines to your Converged Application Server system, click Add.

3. In the Name field, enter the name of the machine.
The name does not have to match the network name for the machine. However, the name must be unique among all component names within the domain.

4. In the Node Manager Listen Address list, select the address that Node Manager uses to listen for connection requests.

5. In the Node Manager Listen Port list, select the port that Node Manager uses to listen for connection requests.

6. Click Next.

Virtual Targets Screen

A virtual target represents a target for a resource group, both at the domain level and in a domain partition

To add a virtual target:

1. Click the Add button.
A row is added to the table on the screen.

2. Enter a Name and a Target, one or more Host Names, a URI Prefix, Explicit Port, and Port Offset.

3. Click Next.

To delete a virtual target, select a row and click Delete.

For more information, see the discussion about configuring virtual targets in your WebLogic Server documentation:

https://docs.oracle.com/middleware/1221/wls/WLSMT/config_virtual.htm#WLSMT580

Partitions Screen

A domain partition is a portion of a WebLogic domain that is dedicated to running application instances and related resources.

To add a partition:

1. Click the Add button.
A partition record is added to the screen.

2. Enter a name for the partition.

3. Click Next.

To delete a partition, select a row and click Delete.

Assign Virtual Targets to Partitions Screen

This screen appears if you configured a partition on the Partitions screen.

To assign virtual targets to partitions:

1. Select a virtual target.

2. Select a partition.

3. Click the Right arrow.

4. Click Next.

Services Targeting Screen

Target services for deployment on servers or clusters.

In the Services Targeting screen:

1. In the Services pane, select one or more services to deploy.

2. In the Targets pane, select the cluster or server on which to deploy the service.

3. Click the right arrow button.

4. Click Next.

Configuration Summary Screen

The Configuration Summary screen lists the detailed configuration settings of your domain.

Click Create to accept the domain details and to start creating the domain.

Configuration Progress Screen

The Configuration Progress screen displays a progress bar that indicates the status of the configuration process.

After the domain is created successfully, click Next.

End Of Configuration Screen

The Configuration Success screen displays the name of your domain, the path to the domain files, and the URL for accessing the Administration Console.

Click Finish to end your configuration session.

Starting the Servers in Converged Application Server

To access the tools for managing your domain, start the necessary servers:

- Starting the Administration Server

- Starting the Node Manager

- Starting the Managed Servers

Starting the Administration Server

To start the Administration Server:

1. Go to the Domain_home/bin directory.

2. Enter the following command:

./startWebLogic.sh

3. If you selected a production startup mode, you are prompted for the login credentials of the Administrator user.
You can create a boot identity file to bypass the need to provide a user name and password when starting the Administration Server in production mode. For more information, see "Creating a Boot Identity File for an Administration Server" in Oracle Fusion Middleware Administering Server Startup and Shutdown for Oracle WebLogic Server.

For more information about starting the Administration Server, see "Starting and Stopping Administration Server" in Oracle Fusion Middleware Administering Oracle Fusion Middleware.

Starting the Node Manager

To start Node Manager:

1. Go to the Domain_home/bin directory.

2. Enter the following command:

./startNodeManager.sh

Oracle recommends that you install Node Manager to run as a startup service, which allows Node Manager to start up automatically each time the system restarts. For more information about installing a per domain Node Manager service, see "Running Node Manager as a Startup Service" in Oracle Fusion Middleware Administering Node Manager for Oracle WebLogic Server.

Starting the Managed Servers

Before starting your managed servers for the first time, copy the Domain_home/security/SerializedSystemIni.dat file from the Administration Server to the same directory on each managed server.

To start a managed server:

1. Log in to the target system.

2. Go to the Domain_home/bin directory.

3. Enter the following command:

./startManagedWebLogic.sh managed_server_name admin_server_url

where:

- managed_server_name is the name of the managed server you want to start.

- admin_server_url is the full URL of the Administration Server.

The following shows sample commands for starting occas_server_1 and occas_server_2:

./startManagedWebLogic.sh occas_server_1 t3://host.example.com:7001 &
./startManagedWebLogic.sh occas_server_2 t3://host.example.com:7001 &

For more information about starting managed servers, see "Starting and Stopping Managed Servers" in Oracle Fusion Middleware Administering Oracle Fusion Middleware.

Next Steps

After you configure the Converged Application Server domain, complete the Converged Application Server post-installation tasks. See "Converged Application Server Post-Installation Tasks" for instructions.

7 Converged Application Server Post-Installation Tasks

This chapter provides instructions for Oracle Communications Converged Application Server post-installation tasks.

Before continuing, complete the tasks in the following chapters:

- Installing Converged Application Server

- Creating and Configuring Converged Application Server Domains

Overview of Converged Application Server Post-Installation Tasks

After installing Converged Application Server, complete the following post-installation tasks:

- Apply Patches

- Enabling DNS Server Lookup

- Configuring Converged Application Server Authentication

- Configuring the Coherence Security Framework

Before continuing, start the servers in your Converged Application Server system. See "Starting the Servers in Converged Application Server" for more information.

Apply Patches

It is a good idea to occasionally search for and apply new, critical patches, for Converged Application Server and for Oracle WebLogic Server.

For more information about patching Converged Application Server, see "Patching Converged Application Server".

For more information about patching Oracle WebLogic Server, see your WebLogic Server documentation.

Enabling DNS Server Lookup

You must enable DNS server lookup on your Converged Application Server system to ensure that the maddr parameter in SIP headers is processed properly.

To enable DNS server lookup:

1. Start your Converged Application Server servers if they are not already running. See "Starting the Servers in Converged Application Server" for more information.

2. Navigate to the WebLogic Server Administration Console and log in with your administrator user name and password:

http://hostname:port/console

where hostname is the name of the machine that hosts your Administration Server, and port is the Administration Console access port number. The default port number is 7001.

3. In the Domain Structure pane, select Sip Server.
The SIP Server page appears.

4. Click the Configuration tab, and then click the General subtab.

5. Scroll down and select the Enable DNS Server Lookup option.

6. Click Save.

7. Log out of the Administration Console.

Configuring Converged Application Server Authentication

If your Converged Application Server system uses a Proxy Registrar domain, set up authentication. For more information, see "Setting Authentication for the Proxy Registrar" in Converged Application Server Administrator's Guide.

Configuring SSL Host Name Verification

If your Converged Application Server system supports Secure Socket Layer (SSL), set the host name verification to None by using the WebLogic Server Administration Console.

To configure SSL host name verification:

1. Start your Administration Server.

2. Log in to the WebLogic Server Administration Console with your administrator user name and password:

http://hostname:port/console

where hostname is the name of the machine that hosts your Administration Server, and port is the Administration Console access port number. The default port number is 7001.

3. In the Domain Structure pane, expand Environment and then select Servers.
The Summary of Servers page appears.

4. Select the Configuration tab.

5. For each server in the Servers table, do the following:

1. Click the name of the server, for example, AdminServer.
The Settings for ServerName page appears.

2. Click the Configuration tab, and then click the SSL subtab.

3. Expand the Advanced settings at the bottom of the page.

4. From the Hostname Verification list, select None.

5. Click Save.

You do not need to restart your Administration Server.

Configuring the Coherence Security Framework

If you created a clustered domain, enable the Coherence Security Framework. For instructions, see "Enabling the Oracle Coherence Security Framework" in Securing Oracle Coherence.

8 Migrating or Upgrading Converged Application Server

This chapter provides instructions for upgrading your Oracle Communications Converged Application Server system.

About Migrating or Upgrading Converged Application Server

Because of architectural changes in the underlying WebLogic Server platform, there is no automated upgrade path. Instead, you must manually upgrade or migrate your Converged Application Server 5.1 or 7.0.0.1.0 system to version 7.1.0.0.0.

High Availability

During your upgrade and migration, you can introduce high availability (HA).

For information about HA environments, see "Failure Prevention and Automatic Recovery Features" in the Converged Application Server Administrator's Guide.

About the Upgrade or Migration Example

The instructions in this chapter assume that you have a replicated Converged Application Server 5.1 system with fives machines, or a 7.0.0.1.0 system with three machines. For example:

- One Administration Server (5.1_Admin)

- Two engine servers (5.1_engine_1 and 5.1_engine_2)

- Two replica servers (5.1_replica_1 and 5.1_replica_2)

Figure 8-1 shows the Converged Application Server 5.1 replicated topology used for the instructions in this chapter.

Figure 8-1 Converged Application Server 5.1 Replicated Topology

The instructions assume that your Converged Application Server 7.1.0.0.0 system contains three machines:

- One Administration Server (7.1.0.0.0_Admin)

- Two engine servers (7.1.0.0.0_engine_1 and 7.1.0.0.0_engine_2)

Note:
Converged Application Server no longer uses replicas. If you are upgrading from version 5.1 with replicas, you can either repurpose your 5.1_replica_1 and 5.1_replica_2 machines as additional engine servers or decommission them completely.

Figure 8-2 shows the Converged Application Server 7.1.0.0.0 replicated topology used for the instructions in this chapter.

Figure 8-2 Converged Application Server 7.1.0.0.0 Replicated Topology

Migrating or Upgrading to Converged Application Server 7.1.0.0.0

In this section, the system you are upgrading from is called old (for example, your old system), and the system you are upgrading to is called new (for example, your new system).

To manually upgrade or migrate your Converged Application Server system:

1. Back up all of your old Converged Application Server domains.

2. Install Converged Application Server 7.1.0.0.0 on your 7.1.0.0.0_Admin, 7.1.0.0.0_engine_1, and 7.1.0.0.0_engine_2 machines. For information, see "Installing Converged Application Server".

3. Create your new Converged Application Server domains. See "Creating and Configuring Converged Application Server Domains" for more information.

4. Copy the WAR or EAR files from your old domains into your new domains.

5. Verify the domain administration settings on your new Converged Application Server system. See "Verifying Your 7.1.0.0.0 Domain Administration Settings".

6. Install and deploy your old applications to your new system.

7. Verify your database connections.

8. Verify that the applications deployed on your new Converged Application Server system work as expected.

Verifying Your 7.1.0.0.0 Domain Administration Settings

In this section, the system you are upgrading from is called old (for example, your old system), and the system you are upgrading to is called new (for example, your new system).

1. Start your new Converged Application Server Administration Server.

2. Log in to your new Converged Application Server Administration Console:

http://address:port/console

where address is the Administration Server's listen address and port is the listen port.

3. Verify that your new domain configuration is correct. In particular, pay attention to the following settings:

- SSL is enabled/disabled consistently on every node machine

- All security authentication providers are listed and configured correctly

- Coherence security has been configured

- Work managers are configured correctly

- The application router is configured correctly

- The call state storage and data tier has been configured

For more information about using the Administration Console and configuring settings, see Converged Application Server Administrator's Guide.

9 Patching Converged Application Server

This chapter describes how to apply patches to your Oracle Communications Converged Application Server system.

About Converged Application Server Patch Releases

You can develop and maintain a strategy to handle the installation of patch releases so that your customers experience a seamless transition.

Types of Patch Releases

Oracle Communications distributes the following types of patch releases for Converged Application Server to resolve issues, to resolve any perceived vulnerability in the software, or to improve its overall performance:

- Patch Set. A Patch Set is the most comprehensive patch release. It contains the accumulated resolutions and updates in Converged Application Server from the time of the last general release up to the current Patch Set release. Oracle recommends that you stay up-to-date by installing Patch Sets as soon as they become available.
Converged Application Server 7.0 Patch Sets use the release numbering scheme 7.0.0.x.0, where x is the Patch Set number. For example, the first Patch Set for Converged Application Server 7.0 would be Converged Application Server 7.0.0.1.0.

- Debug patch. A debug patch is used to troubleshoot an ongoing issue in your Converged Application Server system. A debug patch represents a concerted attempt by you and Oracle Technical Support to fix an issue in your Converged Application Server system. Oracle Technical Support uses debug patches as a tool to extract better data from your Converged Application Server system as a way of resolving the issue. Therefore, the debug patch may not resolve the issue, and more patches may be required.
Because debug patches address a single issue, Converged Application Server numbers them as v1, v2, v3, and so on. Each subsequent version replaces the prior version of the debug patch.

- Temporary fix. Temporary fixes are tailored to solve an issue in your Converged Application Server system. They are urgent, time-sensitive, or critical corrections that solve an issue you are experiencing. You may have to install more patches to make the temporary fix work.
Because each temporary fix addresses a single issue, Converged Application Server numbers the fixes as v1, v2, v3, and so on. Each subsequent version replaces the prior version of the temporary fix.

About Patch Content

By default, every patch contains the following items:

- A README file
The README file for a patch release describes how to install the patch. Additionally, in case you encounter problems while applying the patch, the README describes how you can revert to your current setup by rolling back the patch.

- Software updates to Converged Application Server
These updates consist of fixes or debug changes.

At times, the patch includes a subdirectory named custom, which contains the following items:

- Additional documentation resources
For example, the patch may contain the description of a specific fix detailing what configuration settings are required to utilize the fix.

- Manual patching steps
The patch may target a resource you have modified, such as startup scripts.

About Patch Management In Clustered Environments

If your Converged Application Server system operates in a clustered environment, review the README file that accompanies the patch. Ensure that you apply the patch to all of the servers. Then, perform a rolling restart unless otherwise stated in the README file.

About OPatch

OPatch is an Oracle-supplied Java-based utility that supports the following tasks:

- Applying a patch

- Rolling back a patch to a previous version

- Listing the installed patches

- Detecting a conflict when applying a patch after previous patches have been applied. It also suggests the best options to resolve a conflict

OPatch requires installation of the Oracle Universal Installer software. It is platform-independent and runs on all supported operating systems.

For more information, see "About OPatch" in Oracle Fusion Middleware Patching with OPatch.

Preinstallation Tasks for OPatch

Complete the following tasks before you use OPatch for the first time on your system:

1. Verifying the Oracle Universal Installer Inventory

2. Creating a Backup of Your Current Converged Application Server Installation

3. Checking Your Environment Variables

For more information about the prerequisite checks for OPatch, see Oracle Universal Installer and OPatch User's Guide.

For the latest information about the OPatch utility, the JRE versions, or the Java commands Linux, or to check for updates and get the latest versions, go to My Oracle Support at:

https://support.oracle.com/

Verifying the Oracle Universal Installer Inventory

To apply patches successfully, OPatch needs access to a valid version of Oracle Universal Installer, a valid Oracle Inventory directory (oraInventory), and a valid version of oPatch. Validate the versions on your system by using the following command:

opatch lsinventory

This command displays your system's OPatch and Oracle Universal Installer versions and directories, and lists the patches currently installed in Oracle_home. This is the directory that serves as the repository for common files that are used by Oracle Communications products installed on the same machine, such as Converged Application Server and WebLogic Server. For example, the following shows a sample of the information displayed at the beginning of the output:

Oracle Interim Patch Installer version 13.2.0.0.0
Copyright (c) 2014, Oracle Corporation. All rights reserved.

Oracle Home          : Oracle_home
Central Inventory    : /export/oraInventory
from              : Oracle_home/oraInst.loc
OPatch version       : 13.2.0.0.0
OUI Version          : 13.2.0.0.0
Log file location    : Oracle_home/cfgtoollogs/opatch/opatch2015-12-16_11-16-55AM_1.log

For more information, see "OPatch Utility Reference".

Caution:
If the lsinventory command errors out, do not proceed further with the patch attempt.
Contact Oracle Technical Support to validate and verify the inventory setup.

Creating a Backup of Your Current Converged Application Server Installation

Before you start any patch operation, back up the contents of the Oracle_home directory. You can back up the contents of Oracle_home by using your preferred method, such as ZIP, TAR, cp -r, or cpio.

Checking Your Environment Variables

The patch installation process uses the OPatch and ZIP software. Ensure that your system can find and use the software by setting the following environment variables:

- Set your PATH environment variable to include the path to your Oracle_home/OPatch directory and to your ZIP software.

- Set your ORACLE_HOME environment variable to your Oracle_home directory.

To confirm that your system can find the OPatch and ZIP software, enter the following at a command prompt:

which opatch
which unzip

Note:
If your system cannot find the path to the software, double-check that your environment variables are set correctly.

Installing Converged Application Server Patches

To install a Converged Application Server patch:

1. Determine whether you need to stop all servers in your Converged Application Server system by checking the patch README file.
The README file explicitly states whether the patch requires you to stop your servers before installing the patch.

2. Log in to the target system.

3. Download the patch from the My Oracle Support website to a temporary directory:
https://support.oracle.com/

The patch archive (PatchName.zip) is downloaded to your temporary directory.

4. Create a directory for storing the unpacked patch contents. This document and the patch README file refer to this directory as the Patch_top directory.

Note:
Ensure that the PatchName.zip file is not located inside the Patch_top directory.

5. Go to your temporary directory and unpack the patch archive (PatchName.zip) into the Patch_top directory.
The PatchName subdirectory is created.

6. Go to the Patch_top/PatchName directory.

7. Run the OPatch utility by entering the following at a command prompt:

opatch apply

OPatch validates the patch and makes sure that there are no conflicts with the software already installed in Oracle_home before applying the patch to your Converged Application Server system.

For more information, see "OPatch Utility Reference" and "Dealing with Conflicts When You Run the Apply Command".

8. Verify that the patch installed successfully by running the following command:

opatch lsinventory

For more information, see "OPatch Utility Reference".

9. Determine whether you need to restart all servers in your Converged Application Server system or perform other tasks by checking the patch README file.
The patch README file explicitly states whether the patch requires you to restart your servers or to perform other tasks after installing the patch.

If you encounter any issues in any of these steps, see "Troubleshooting".

Troubleshooting

OPatch is reliable and protects Oracle_home and the inventory. It can bring back the contents of the Oracle_home directory to a stable state from patch application failures. It can also easily detect patch conflicts.

OPatch logs information to a .log file. Here is an example entry:

Log file location : /home/oracle_
TEST/product/11.1.0/db1/cfgtoollogs/opatch/opatch-yyyy_month_dd_HH-MM-SS-IST_Wed.log

If you encountered errors while installing a patch and you need assistance from Oracle Technical Support, be sure to provide the associated log file together with the patch command you used to install the patch.

Dealing with Conflicts When You Run the Apply Command

When you run the OPatch apply command, you may encounter the following conflicts:

- Conflict with a patch already applied to the contents of the Oracle_home directory.
In this case, stop the patch installation and contact Oracle Technical Support.

- Conflicts with a subset patch already applied to the contents of the Oracle_home directory.
In this case, continue the installation, because the new patch contains all of the fixes from the existing patch. The subset patch is automatically rolled back before the installation of the new patch.

Uninstalling the Patch

If you experience any problems after installing a patch, remove the patch.

To uninstall the patch:

1. Stop all servers in your Converged Application Server system.

2. Roll back the patch with the following command:

opatch rollback -id PatchNumber

where PatchNumber is the patch number. For more information, see "OPatch Utility Reference".

If you need further assistance, contact Oracle Technical Support with the required information.

OPatch Utility Reference

By default, the OPatch utility is located in the Oracle_home/OPatch directory. The following shows the syntax for running the OPatch utility:

opatch [-help] [-report] [command]

where:

- -help lists the commands and options supported by the utility.
Use the -help parameter together with a command to view detailed information for the OPatch command. For example:

opatch apply -help

- -report prints the actions without executing the command.

- command is one of these OPatch commands:

- apply [PatchDirectory]
This command applies the patch to the software located in Oracle_home. If you do not run the utility from the directory in which the patch content resides (PatchDirectory), include the complete path to the directory.

For the command to work properly, the ORACLE_HOME environment variable must be set to Oracle_home. See "Dealing with Conflicts When You Run the Apply Command".

- lsinventory
This command displays your system's OPatch and Oracle Universal Installer versions and directories, and lists the patches currently installed in Oracle_home. The following shows sample output for the lsinventory command:

----------------------------------------------------------------------
Oracle Interim Patch Installer version 13.2.0.0.0
Copyright (c) 2014, Oracle Corporation. All rights reserved.

Oracle Home          : Oracle_home
Central Inventory    : /export/oraInventory
from              : Oracle_home/oraInst.loc
OPatch version       : 13.2.0.0.0
OUI Version          : 13.2.0.0.0
Log file location    : Oracle_home/cfgtoollogs/opatch/opatch2015-12-16_11-16-55AM_1.log

OPatch detects the Oracle Home as "Oracle_home"

-----------------------------------------------------------------------
Interim patches (1):

Patch  19836145      : applied on Tue Dec 16 10:51:13 CST 2015
Unique Patch ID      : 1418034883552
Patch description    : "[Patch Set v7.0.0.1.0] - Patch set zero"
Created on 8 Dec 2014, 02:34:45 hrs PST8PDT
Bugs fixed:
123412
-----------------------------------------------------------------------

- rollback -id PatchNumber
This command removes the specified patch from the Oracle_home directory, where PatchNumber is the patch number.

You can find the patch number by using the lsinventory command. For example, you would use the command rollback -id 19836145 to roll back the patch shown in the following sample lsinventory output:

----------------------------------------------------------------------
Interim patches (1) :

Patch  19836145     : applied on Tue Dec 16 10:51:13 CST 2014
Unique Patch ID:  1418034883552
Patch description:  "[Patch Set v7.0.0.1.0] - Patch set zero"
Created on 8 Dec 2014, 02:34:45 hrs PST8PDT
Bugs fixed:
123412
-----------------------------------------------------------------------

For a full list of the OPatch commands and their descriptions, see "Common OPatch Commands When Patching an Oracle Fusion Middleware Oracle home" in Oracle Fusion Middleware Patching with OPatch.

10 Troubleshooting a Converged Application Server Installation

This chapter describes how to troubleshoot Oracle Communications Converged Application Server installations.

About Troubleshooting Converged Application Server Installations

The Converged Application Server installer and the Domain Configuration Wizard write information to log files. You can check those log files for information about errors and actions performed during the installation process.

About Converged Application Server Installation Log Files

The Converged Application Server installation logs can be found at Central_inventory_location/oraInventory/logs, where Central_inventory_location is the directory path to the oraInventory directory. If you do not know the location of your Oracle Inventory directory, you can find it in the Oracle_home/oraInst.loc file. Oracle_home is the directory that serves as the repository for common files that are used by Oracle Communications products installed on the same machine, such as Converged Application Server and WebLogic Server.

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

- installdate-time-stamp.log
The main log file.

- installdate-time-stamp.out
This log file contains the output and error streams during the installation.

- installProfiledate-time-stamp.log
This log file contains the overall statistics such as time taken to complete the installation, as well as configuration, memory, and CPU details.

- oraInstalldate-time-stamp.out
This log file contains the output stream of the copy session.

- oraInstalldate-time-stamp.err
This log file contains the error stream of the copy session.

Changing the Installer Logging Level

To change the logging level, add the -logLevel parameter when you start the installer at a command prompt. For example:

java -jar occas_generic.jar -logLevel info

The following shows valid values for -logLevel from most detailed to least detailed:

- severe

- warning

- info

- config

You can also specify logging details from detailed to least detailed in the following manner:

- fine

- finer

- finest

About Domain Configuration Log Files

If you encounter errors when configuring a Converged Application Server domain, you can start the Fusion Middleware Configuration Wizard with the appropriate logging options.

To enable domain configuration logging, go to Oracle_home/oracle_common/common/bin and enter the following command:

./config.sh -log=log_filename -log_priority=log_level

Table 10-1 describes the -log and -log_priority options.

Table 10-1 Configuration Wizard Log File Options

Parameter

Description

-log

Specify the location of your log file.

If you specify a log file name, it is created in the same directory as the config.sh script unless you add a path component. Log files are otherwise created in Oracle_home/logs.

Other values that can be specified with -log are:

- stdout
Writes the error message to the standard output stream.

- stderr
Writes the error message to the standard error stream.

- disable
Disables default logging so that no log files are generated in Oracle_home/logs.

-Log_priority

Specify the level of detail you want included in your logs.

The following list shows the acceptable values:

- OFF

- SEVERE

- WARNING

- INFO

- CONFIG

- FINE

- FINER

- FINEST

11 Uninstalling Converged Application Server

This chapter describes how to uninstall Oracle Communications Converged Application Server and its components.

Uninstalling Converged Application Server Components in GUI Mode

To uninstall Converged Application Server components in GUI mode:

1. Go to the Oracle_home/oui/bin directory, and enter the following in a command window:

./deinstall.sh

2. If you have multiple Oracle products installed in your Oracle Inventory directory (oraInventory), the Distribution to Uninstall screen appears.
Perform the following to specify the Oracle product to uninstall:

1. From the Select Distribution to Uninstall list, select the software you want to uninstall. For example, select Oracle Communications Converged Application Server~7.1.0.0.0.

2. Click Uninstall.

3. From the Welcome screen, click Next.
The Deinstallation Summary screen appears.

4. Verify that the list of feature sets to uninstall is correct.
To save the information to a response file so you can uninstall the components later, click Save Response File and specify the name and location of the response file.

5. Click Deinstall.
The Deinstallation Progress screen appears, and a progress bar indicates the status of the uninstallation process.

6. When the uninstallation process is complete, click Next.
The Deinstallation Complete screen appears.

7. Click Finish.
The uninstaller exits.

Uninstalling Converged Application Server Components in Silent Mode

This section describes how to uninstall Converged Application Server components in silent mode on all platforms.

Use silent mode to uninstall duplicate installations on multiple machines. In silent mode, you create and use a response_uninistall.rsp configuration file, and then specify it as a parameter at the command line. The program does not display any options during the uninstallation process.

To uninstall Converged Application Server components in silent mode:

1. Create a text file on your target system.

2. Add the following contents to your file:

[ENGINE]

#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0

[GENERIC]

#This will be blank when there is nothing to be de-installed in distribution level
SELECTED_DISTRIBUTION=Oracle Communications Converged Application Server~7.1.0.0.0

#The oracle home location. This can be an existing Oracle Home or a new Oracle Home
ORACLE_HOME=Oracle_home

where SELECTED_DISTRIBUTION is set to the component to uninstall. For Converged Application Server, set SELECTED_DISTRIBUTION to Oracle Communications Converged Application Server~7.1.0.0.0.

3. Save the file with the name response_uninstall.rsp.

4. Go to the Oracle_home/oui/bin directory and enter the following in a command window:

./deinstall.sh -silent -responseFile ResponseFile

where ResponseFile is the full path and name of the response_uninstall.rsp file. For example, Oracle_home/oui/bin/response_uninstall.rsp.

The uninstallation process completes with no prompts.

If the uninstallation procedure completes successfully, you see a response similar to the following:

Launcher log file is /tmp/OraInstall2014-11-06_01-46-10PM/launcher2014-11-06_01-46-10PM.log.
Starting Oracle Universal Installer

Checking if CPU speed is above 300 MHz.   Actual 2893.030 MHz    Passed
Checking swap space: must be greater than 512 MB.   Actual 15826924 MB    Passed
Checking if this platform requires a 64-bit JVM.   Actual 64    Passed (64-bit not required)
Checking temp space: must be greater than 300 MB.   Actual 136360 MB    Passed

Preparing to launch the Oracle Universal Installer from /tmp/OraInstall2014-11-06_01-46-10PM
Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=512m; support was removed in 8.0
Log: /tmp/OraInstall2014-11-06_01-46-10PM/deinstall2014-11-06_01-46-10PM.log
Setting ORACLE_HOME to /home/oracle/
Copyright (c) 1996, 2015, Oracle and/or its affiliates. All rights reserved.
Starting silent deinstallation...
-----------20%----------40%----------60%----------80%--------100%

The uninstall of Oracle Communications Converged Application Server 7.1.0.0.0 completed successfully.
Logs successfully copied to /export/oraInventory/logs.