Configuration Guide

Overview of Oracle Communications Converged Application Server Configuration and Management

The following sections provide an overview of how to configure and manage Oracle Communications Converged Application Server deployments:

Shared Configuration Tasks for Oracle Communications Converged Application Server and WebLogic Server

Oracle Communications Converged Application Server is based on the Oracle WebLogic Server 10g Release 3 application server, and many system-level configuration tasks are the same for both products. This manual addresses only those system-level configuration tasks that are unique to Oracle Communications Converged Application Server, such as tasks related to network and security configuration and cluster configuration for the engine and SIP data tiers.

HTTP server configuration and other basic configuration tasks such as server logging are addressed in the Oracle WebLogic Server 10g Release 3 Documentation.

Oracle Communications Converged Application Server Configuration Overview

The SIP Servlet container, SIP data tier replication, and Diameter protocol features of Oracle Communications Converged Application Server are implemented in the Oracle WebLogic Server 10g Release 3 product as custom resources. A pair of custom resources, sipserver and datatier, implement the engine tier SIP Servlet container functionality and SIP data tier replication functionality. In production deployments, both resources are generally installed. Specialized deployments may use only the sipserver resource in conjunction with a SIP-aware load balancer, as described in Alternate Configurations.

Another custom resource, diameter, provides Diameter base protocol functionality, and is required only for deployments that utilize one or more Diameter protocol applications.

The Oracle Communications Converged Application Server custom resource assignments are visible in the domain configuration file, config.xml, and should not be modified. Listing 2-1 shows the definitions for each resource. Note that the sipserver and datatier resources must each be targeted to the same servers or clusters; in Listing 2-1, the resources are deployed to both the engine tier and SIP data tier cluster.

<custom-resource>

    <name>sipserver</name>

    <target>ORA_DATA_TIER_CLUST,ORA_ENGINE_TIER_CLUST</target>

    <descriptor-file-name>custom/sipserver.xml</descriptor-file-name>

    <resource-class>com.bea.wcp.sip.management.descriptor.resource.SipServerResource</resource-class>

    <descriptor-bean-class>com.bea.wcp.sip.management.descriptor.beans.SipServerBean</descriptor-bean-class>

</custom-resource>

<custom-resource>

    <name>datatier</name>

    <target>ORA_DATA_TIER_CLUST,ORA_ENGINE_TIER_CLUST</target>

    <descriptor-file-name>custom/datatier.xml</descriptor-file-name>

    <resource-class>com.bea.wcp.sip.management.descriptor.resource.DataTierResource</resource-class>

    <descriptor-bean-class>com.bea.wcp.sip.management.descriptor.beans.DataTierBean</descriptor-bean-class>

  </custom-resource>

<custom-resource>

    <name>diameter</name>

    <target>ORA_ENGINE_TIER_CLUST</target>

    <deployment-order>200</deployment-order>

    <descriptor-file-name>custom/diameter.xml</descriptor-file-name>

    <resource-class>com.bea.wcp.diameter.DiameterResource</resource-class>

    <descriptor-bean-class>com.bea.wcp.diameter.management.descriptor.beans.ConfigurationBean</descriptor-bean-class>

</custom-resource>

The Oracle Communications Converged Application Server custom resources utilize the basic domain resources defined in config.xml, such network channels, cluster and server configuration, and Java EE resources. However, Oracle Communications Converged Application Server-specific resources are configured in separate configuration files based on functionality:

Keep in mind that the domain configuration file, config.xml, defines all of the Managed Servers available in the domain. The sipserver.xml, datatier.xml, and diameter.xml configuration files included in the sipserver application determines the role of each server instance, such as whether they behave as SIP data tier replicas, engine tier nodes, or Diameter client nodes.

Configuration changes to SIP Servlet container properties can be applied dynamically to a running server by using the Administration Console SIP Servers node or from the command line using the WLST utility. Configuration for SIP data tier nodes cannot be changed dynamically, so you must reboot SIP data tier servers in order to change the number of partitions or replicas.

Diameter Configuration

The Diameter protocol implementation is implemented as a custom resource separate from the SIP Servlet container functionality. The Diameter configuration file configures one or more Diameter protocol applications to provide Diameter node functionality. Oracle Communications Converged Application Server provides the Diameter protocol applications to support the following node types:

The Diameter custom resource is deployed only to domains having servers that need to act as Diameter client nodes or relay agents, or to servers that want to provide HSS simulation capabilities. The actual function of the server instance depends on the configuration defined in the diameter.xml file.

See Configuring Diameter Client Nodes and Relay Agents in Configuring Network Resources for instructions to configure the Diameter Web Application in a Oracle Communications Converged Application Server domain. See Using the IMS Sh Interface (Diameter) in Developing Diameter Applications for more information about using the Sh profile API.

Methods and Tools for Performing Configuration Tasks

Oracle Communications Converged Application Server provides several mechanisms for changing the configuration of the SIP Servlet container:

Administration Console

Oracle Communications Converged Application Server provides Administration Console extensions that allow you to modify and SIP Servlet container, SIP Servlet domain, and Diameter configuration properties using a graphical user interface. The Administration Console extensions for Oracle Communications Converged Application Server are similar to the core console available in Oracle WebLogic Server 10g Release 3. All Oracle Communications Converged Application Server configuration and monitoring is provided via these nodes in the left pane of the console:

WebLogic Scripting Tool (WLST)

The WebLogic Scripting Tool (WLST) enables you to perform interactive or automated (batch) configuration operations using a command-line interface. WLST is a JMX tool that can view or manipulate the MBeans available in a running Oracle Communications Converged Application Server domain. Configuring Engine Tier Container Properties provides instructions for modifying SIP Servlet container properties using WLST.

Additional Configuration Methods

Most Oracle Communications Converged Application Server configuration is performed using either the Administration Console or WLST. The methods described in the following sections may also be used for certain configuration tasks.

Editing Configuration Files

You may also edit sipserver.xml, datatier.xml, and diameter.xml by hand, following the respective schemas described in the Configuration Reference Manual.

If you edit configuration files by hand, you must manually reboot all servers to apply the configuration changes.

Custom JMX Applications

Oracle Communications Converged Application Server properties are represented by JMX-compliant MBeans. You can therefore program JMX applications to configure SIP container properties using the appropriate Oracle Communications Converged Application Server MBeans.

The general procedure for modifying Oracle Communications Converged Application Server MBean properties using JMX is described in Configuring Container Properties Using WLST (JMX) (WLST itself is a JMX-based application). For more information about the individual MBeans used to manage SIP container properties, see the Oracle Communications Converged Application Server Javadocs.

Common Configuration Tasks

General administration and maintenance of Oracle Communications Converged Application Server requires that you manage both WebLogic Server configuration properties and Oracle Communications Converged Application Server container properties. These common configuration tasks are summarized in Table 2-1.