Skip Headers

Oracle® Communication and Mobility Server Installation Guide Release 10.1.3 for Solaris Operating System (SPARC 64-Bit) Part Number E10397-03 |
Home | Contents | Index | Contact Us

Previous | Next
| View PDF

# 1 Product and Installation Overview

This chapter describes Oracle Communication and Mobility Server (OCMS), and recommended topologies in the following sections:

- Product Overview

- Installation Prerequisites

- Installation Modes

- What Components are Installed

- Typical and Custom Installations

## Product Overview

OCMS is a carrier grade SIP (Session Initiation Protocol) and J2EE execution platform for applications needing to send or receive messages over a SIP enabled broadband network or cellular network. This platform is referred to as a SIP Application Server.

Examples of such applications are as follows:

- IP Telephony

- Video Calling

- Instant Messaging

- Speed Dial Service

- Call Forwarding Service

- Third Party Call Control

- Emergency Call Service

- Network Gaming

  OCMS can be deployed either for broadband or 3GPP IP Multimedia System (IMS) networks offering value-added services.

### New in this Release

This release of Oracle Communication and Mobility Server includes enhancements and new features. To read about new and improved features, see

`http://www.oracle.com/technology/products/ocms/otn_front.htm`

## Installation Prerequisites

This section describes prerequisites for installing OCMS and for using specific OCMS functionality.

### System Requirements

To install OCMS your system must meet the following requirements:

- Solaris 8, Solaris 9, or Solaris 10

- Recommended for development purposes only: Microsoft Windows 2000 with Service Pack 3 or above, Microsoft Windows Server 2003 (32-bit) with Service Pack 1 or above, or Microsoft Windows XP Professional with Service Pack 2

- Java 2 Platform, Enterprise Edition Software Development Kit (JDK) 5.0, (JDK version 1.5). Oracle Application Server installation mode uses the JDK 1.5 (Update 6) from the installation of Oracle Application Server. Standalone developer mode bundles JDK 1.5 (Update 6) with the OCMS installation.

- Oracle TimesTen In-Memory Database 6.0 is required when installing Subscriber Data Services and using applications that require the authentication and authorization features provided by OCMS. Oracle TimesTen is provided with the OCMS distribution.

  Refer to What Components are Installed for more information on Subscriber Data Services.

- A LAN connection and an IP address and hostname

Note:

The listed operating systems are certified and supported for Oracle Communication and Mobility Server. Other operating systems have not been certified.

### Shared Memory Requirement

Before installing OCMS, make sure that you have set shmmax to a reasonably large value, approximately 1 GB or higher. As root, you can query for the current value by entering the following command:

`more /proc/sys/kernel/shmmax`

To set the value to approximately 1 GB, enter the following commands as root:

- `/sbin/sysctl -w kernel.shmmax=1073741824`

- Edit file /etc/sysctl.conf. At the end of the file add the line: kernel.shmmax=1073741824

Editing the /etc/sysctl.conf file makes the shmmax change done by the /sbin/sysctl -w kernel.shmmax=1073741824 command consistent across a reboot.

In general, we recommend this value to be set to be half the size of your physical RAM. If you have less than 2 GB of physical RAM, set it to approximately 1 GB as described above.

### Port Requirements

OCMS requires the use of ports for TCP and UDP communications for the SIP Container, Presence server, and, if installed, the Edge Proxy. You can have the InstallShield Wizard for OCMS assign default port numbers for the SIP Container and Edge Proxy ports, or use port numbers that you specify. The Presence port is not configurable during installation, but can be configured in the MBean browser. Refer to the Oracle Communication and Mobility Server Administrator's Guide for information on how to reconfigure port numbers following installation.

During installation, the InstallShield Wizard for OCMS validates that the selected ports are available. If a port is in use by another application, the installation will not succeed, and a port conflict error message is displayed and logged in an ocmsinstall.log file.

Table 1-1 lists the default ports used by OCMS when you install the Edge Proxy application.

Table 1-1 Default Ports: Edge Proxy Installed

SIP Port | Edge Proxy Port | Presence Port
--- | --- | ---
5070 | 5060 | 5081

Table 1-2 lists the default ports used by OCMS when you do not install the Edge Proxy application:

Table 1-2 Default Ports: Edge Proxy Not Installed

SIP Port | Edge Proxy Port | Presence Port
--- | --- | ---
5060 | N/A | 5071

#### Checking if a Port is in Use

To check if a port is being used, you can run the `netstat` command as follows:

netstat -a | grep <portnum>

## Installation Modes

Oracle Communication and Mobility Server can be installed in the following installation modes:

- Oracle Application Server Mode (Release 10.1.3.2 or Higher)

- Standalone Developer Mode

Table 1-3 lists requirements for each installation mode.

Table 1-3 Requirements for Installation Modes

Requirement | Oracle Application Server mode | Standalone Developer mode
--- | --- | ---
Oracle Containers for J2EE (OC4J) | Required before installation | Not required. Included with the installation.
Java Development Kit (JDK) 1.5 | Provided by Oracle Application Server. | Included.
Oracle TimesTen In-Memory Database | Required if installing Subscriber Data Services. | Required if installing Subscriber Data Services.

### Oracle Application Server Mode (Release 10.1.3.2 or Higher)

The recommended installation mode installs OCMS into an Oracle Application Server Release 10.1.3.2 or higher environment. This installation mode allows OCMS to use OC4J features such as Oracle High Availability (HA), clustering, and replication.

Oracle Communication and Mobility Server is deployed with an OC4J container that you manage using the Oracle 10g Enterprise Manager Application Server Control console. The Application Server Control functions enable starting, stopping, restarting, deploying, undeploying, and redeploying applications

Additionally, the Application Server Control MBean browser enables you to configure and manage the OCMS components. Configuring the attributes of the OCMS MBeans (Managed Beans) enables you to execute such administrative tasks as configuring the DNS (Domain Name System), configuring and managing Presence, and the basic configuration (port, IP, and host address) of the OCMS SIP Server itself.

For more information on managing and configuring OCMS in an Oracle Application Server environment, refer to "Managing the SIP Server" in the Oracle Communication and Mobility Server Administrator's Guide.

For more information on features provided by Oracle Application Server, refer to Oracle Communication and Mobility Server Administrator's Guide

### Standalone Developer Mode

The standalone developer mode allows developers to develop and test SIP applications in a minimal installation environment, without an application server. This installation mode installs Oracle Containers for J2EE (OC4J).

Standalone developer mode is not typically recommended for production deployment because of limited management capabilities.

## What Components are Installed

The following applications are included in a typical installation:

- SIP Container: A SIP Servlet Container extends the J2EE Application Server, providing a runtime environment for SIP applications, including services such as security, concurrency, lifecycle management, transaction, deployment, and other services. A JSR116-compliant SIP Servlet Container provides network services for sending and receiving SIP requests and responses using a combination of transport protocols, IP addresses, and port numbers to listen for incoming SIP traffic. The OCMS SIP Servlet Container can be installed on an existing instance of Oracle Application Server, running in OC4J. Alternatively, the OCMS SIP Servlet Container can run on its own standalone instance of OC4J. The typical OCMS SIP Servlet Container is composed of an Oracle Application Server instance with OC4J as its J2EE container, and Oracle Process Manager and Notification Server (OPMN) to monitor the server. OCMS currently supports high availability deployments in this configuration only.

- Subscriber Data Services: Subscriber Data Services is installed when applications require the authentication and security services provided by OCMS.

  The Subscriber Data Services application depends on the SIP Container and requires an Oracle TimesTen In-Memory database for storing data and user information to be installed.

- Proxy Registrar: Proxy Registrar combines the functions of a SIP Proxy Server and Registrar. Its main tasks include registering subscribers, looking up subscriber locations, and proxying requests to destinations.

  The Proxy Registrar depends on the Subscriber Data Services for the Location Service and the registrar subcomponents of the Proxy Registrar to function.

- Presence: The Presence application enables a service provider to provide Presence services to end users as well as enabling the service provider to base other services on Presence information (for example, intelligent call routing based on Presence information).

  The Presence application depends on the SIP Container.

The following applications must selected for installation in the custom installation flow:

- Presence Web Services: Presence Web Services provides support for the Parlay X Presence Web Services. This is an implementation of the Parlay X Web Services interface. Refer to Chapter 6, OCMS Parlay X Web Services in the Oracle Communication and Mobility Server Developer's Guide for more information.

  The Presence Web Service application depends on the SIP Container and is available only for installation in the Standalone Developer Mode or the Oracle Application Server mode.

- Aggregation Proxy: Aggregation Proxy authenticates any XCAP requests and Web Services calls. The XCAP requests and Web Services calls are then proxied to their respective servers. For more information, refer to Oracle Communication and Mobility Server Developer's Guide, and the Oracle Communication and Mobility Server Administrator's Guide.

  The Aggregation Proxy depends on the SIP Container and Subscriber Data Services.

- STUN Server: The STUN server implements the STUN (Simple Traversal of User Datagram Protocol (UDP) Through Network Address Translators) server protocol. This acts as a NAT traversal mechanism to allow clients to find out the external IP address and port that the client is represented by.

  The STUN server depends on the SIP Container.

- Application Router: Application Router is a SIP application that routes incoming SIP requests to the correct application. It is a required component for composing applications or for deploying new applications of your own.

  The Application Router routes requests by placing route headers in each SIP request it processes. A number of route headers can be placed in a request, each representing a different destination URI. The SIP request is either sent through the chain of destination URIs, or proxied to a new URI after arriving at its first destination.

  The Application Router application depends on the SIP Container and Subscriber Data Services.

- Edge Proxy: Edge Proxy provides a SIP distribution for routing requests, proxying SIP requests to a particular OCMS SIP Server instance. The Edge Proxy forms logical pathways between individual clients and SIP servers, such that SIP traffic sent from a particular client session is always handled by the same server. As the number of SIP clients increases, additional Edge Proxy servers can be added, providing highly scalable handling of SIP clients.

  The Edge Proxy is available for installation only in Oracle Application Server Mode.

For more description and configuration information on these features, refer to Oracle Communication and Mobility Server Administrator's Guide.

## Typical and Custom Installations

You can install OCMS as a typical installation that includes a set of certain installation components (SIP Container, Subscriber Data Services, Application Router, Proxy Registrar, and Presence) or you can perform a custom installation of specific features. Certain components can only be installed through a custom installation.

OCMS provides a SIP Container, a Presence server, a Proxy Registrar, Presence Webservices, a STUN Server, an Application Router, an Edge Proxy, an Aggregation Proxy, and a tool for developing third party applications, OCMS Service Creation Environment. Refer to What Components are Installed for more information on these features. OCMS also provides a framework for applications requiring user authentication and authorization called Subscriber Data Services. In a typical installation, the SIP Container is installed with an Application Router, Subscriber Data Services, Proxy Registrar, and Presence.

### Custom Installation Requirements

When you only plan to use certain OCMS functionality and do not require all the provided functionality, you can perform a custom installation. Table 1-4 lists requirements for installing OCMS applications in a custom installation.

Table 1-4 Application Requirements for Custom Installations

OCMS Application | Requirements | Dependencies | Availability
--- | --- | --- | ---
SIP Container | None | None | All modes and supported platforms
Subscriber Data Services | Oracle TimesTen In-Memory Database | SIP Container | All modes and supported platforms
Proxy Registrar | (Subscriber Data Services Requirements) | SIP Container, Subscriber Data Services | All modes and supported platforms
Application Router | (Subscriber Data Services Requirements) | SIP Container, Subscriber Data Services | All modes and supported platforms
Presence | None | SIP Container | All modes and supported platforms
Presence Webservices | None | SIP Container | Standalone Developer and Oracle Application Server modes only, all Platforms
Aggregation Proxy | (Subscriber Data Services Requirements) | SIP Container, Subscriber Data Services | All modes and supported platforms
STUN Server | None | SIP Container | All modes and supported platforms
Edge Proxy | None | None | Oracle Application Server mode only, all supported platforms

#### Oracle TimesTen In-Memory Database

Subscriber Data Services (and applications that depend on Subscriber Data Services including Proxy Registrar, Application Router, and Aggregation Proxy) require Oracle TimesTen In-Memory Database, with data access control enabled. The OCMS installer automatically creates a data source for Oracle Times Ten during installation and sets permsize to 256MB.