| Oracle® Communication and Mobility Server Installation Guide Release 10.1.3 for AIX 5L Based Systems (64-Bit) Part Number E10061-01 |
|
|
View PDF |
| Oracle® Communication and Mobility Server Installation Guide Release 10.1.3 for AIX 5L Based Systems (64-Bit) Part Number E10061-01 |
|
|
View PDF |
This chapter describes Oracle Communication and Mobility Server (OCMS), Oracle Communication and Mobility Server Service Creation Environment (OCMS SCE) and recommended topologies:
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.
OCMS Service Creation Environment (OCMS SCE) is a package for third-party developers on the Microsoft Windows operating system. OCMS Service Creation Environment (SCE) consists of tools and APIs for developers to create their own services using the OCMS platform.
OCMS SCE requires the installation of the third-party tool Eclipse. Eclipse is the development environment for creating projects, writing code, and for automatically deploying applications into OCMS.
This section describes prerequisites for installing OCMS and for using specific OCMS functionality.
To install OCMS your system must meet the following requirements:
AIX 5L Version 5.2 and AIX 5L Version 5.3
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 Additional OCMS Features 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.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 command as root:
/sbin/sysctl -w kernel.shmmax=1073741824
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.
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 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-2 lists the default ports used by OCMS when you do not install the Edge Proxy application:
Oracle Communication and Mobility Server can be installed in the following installation modes:
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. |
|
Eclipse WebTools 1.5 |
Required if installing OCMS SCE. |
Required if installing OCMS SCE. |
|
Provided by Oracle Application Server. |
Included. |
|
|
Oracle TimesTen In-Memory Database |
Required if installing Subscriber Data Services. |
Required if installing Subscriber Data Services. |
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 Application Server Administrator's Guide.
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.
The minimal OCMS installation consists of an OCMS SIP Servlet 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.
The following applications are included in a typical installation, except the Edge Proxy which you can only install in a custom installation.
Subscriber Data Services: Subscriber Data Services is installed when applications require the authentication and security services provided by OCMS.
Note:
Proxy Registrar and Application Router both require Subscriber Data Services. In the case of the former, the Location Service and the registrar component of the Proxy Registrar depend on Subscriber Data Services. Subscriber Data Services also depends on the Oracle TimesTen In-Memory database for storing data and user information.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.
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).
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.
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.
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.
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.
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.
Service Creation Environment (SCE) Eclipse Plugin: OCMS SCE is the development environment for OCMS. SCE allows the developer to create and build applications in Eclipse, and to deploy them to OCMS.
For more description and configuration information on these features, refer to Oracle Communication and Mobility Server Administrator's Guide.
You can install OCMS as a typical installation that includes a set of certain installation components (Subscriber Data Services, 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 Additional OCMS Features 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.
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 |
|---|---|
|
Subscriber Data Services |
Requires Oracle TimesTen In-Memory Database, with data access control enabled. |
|
Proxy Registrar |
Requires Subscriber Data Services. |
|
Presence |
None |
|
Presence Webservices |
None |
|
STUN Server |
None |
|
Application Router |
Requires Subscriber Data Services. |
|
Edge Proxy |
Requires installing in Oracle Application Server mode. |
|
Aggregation Proxy |
Requires Subscriber Data Services. |
|
Service Creation Environment (SCE) |
Requires Eclipse WebTools 1.5. |
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 TimesTen during installation and sets permsize to 256MB.
