Contents

Title and Copyright Information

Preface

• Intended Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 An Overview of Oracle Communication and Mobility Server

• New in this Release
  • TLS Support
  • Scalable Presence Deployments with User Dispatcher
    • Presence Dispatching
  • Web Services Improvements
• Introduction to OCMS
• OCMS Three Layer Model
  • Proxy Layer
  • Application Layer
  • Data Layer
• OCMS System Components
  • SIP Servlets and SIP Servlet Applications
    • Differences between HTTP and SIP Servlets
    • Typical SIP Servlet Applications
  • SIP Servlet Container
    • How the OCMS SIP Servlet Container Works
  • Edge Proxy Server
  • Proxy Registrar
    • Location Lookup Service
    • ENUM Lookup Service
  • Presence Server
    • How the Presence Server Works
  • Application Router
    • Modes of Operation
    • Using the Application Router in Standard Mode: an Example
    • Using the Application Router in Incremental Mode: an Example
  • Subscriber Data Services
    • Authentication and Authorization Data
    • User Data
    • Location Lookup Data
  • Logging
  • Session Replication

2 Deployment Topologies

• About Deployment Topologies
• Topology Components
  • Third-Party Load Balancer
  • Edge Proxy Nodes
  • SIP Application Servers
  • Aggregation Proxy
  • Proxy Registrar
  • User Dispatcher
    • Presence Dispatching
• Supported OCMS Topologies
• Deploying OCMS as a Highly Available SIP Network
• Deploying OCMS as a Presence Server
• Deploying a Scalable Presence Deployment
  • Presence Cluster
  • XDM Cluster
  • Presence Node
  • XDM Node
  • Complete Presence and XDM Cluster
• Deploying OCMS as an Instant Messaging Service
• Deploying an OCMS Testing Environment
• Configuration Recommendations

3 Configuring the SIP Server MBeans

• Overview of SIP Server Management
• Starting, Stopping and Restarting the OCMS SIP Server
  • Starting an Application and Stopping a SIP Servlet Application
• Managing OCMS MBeans
  • Accessing MBeans
    • Accessing SIP Servlet Container MBeans
    • Accessing the MBeans for a Selected SIP Application
  • Configuring the SIP Servlet Container MBeans
    • SIP Servlet Container
    • Setting the Keystore
    • Enabling TLS
    • SIP Servlet Container Logging
    • STUN Service
  • Configuring SIP Applications
    • Subscriber Data Services
    • Proxy Registrar
    • Application Router
  • Setting and Viewing the SIP Port

4 Configuring Security and Login Modules

• Overview of Security
  • The OCMS JAAS-Compliant Login Modules
    • Application Type and Authentication Mode
• Configuring Subscriber Data Services
  • CommandService
• Configuring Applications to Use Login Modules
  • Configuring Login Modules though system-jazn-data.xml and orion-application.xml
    • Configuring Login Modules in system-jazn-data.xml
    • Declaring the OCMS Login Module in orion-application.xml
    • Declaring the RADIUS Login Module in orion-application.xml
• Security in SIP Servlets
• Authentication Using the P-Asserted Identity Header
• Authentication of Web Service Calls and XCAP Traffic
• Default Role for All Users
• Configuring Oracle Internet Directory as the User Repository
  • Overview of Configuration for OID Support
    • Prerequisites for OID Support
  • Configuring the OID LDAP Backend
    • Mapping JAAS Usernames to LDAP User Entries
    • Mapping JAAS Realms to LDAP Subscribers
    • Mapping JAAS Roles to LDAP Groups
  • Installing OCMS Components into the OID LDAP Tree
    • Associating an OCMS Instance with OID
    • Installing the OCMS Static Verifiers
  • Repackaging Subscriber Data Services
    • Configuring User Service and Security Service
  • Provisioning OCMS Users to OID
    • Adding Users to LDAP Groups

5 Configuring High Availability

• About Configuring High Availability
• Setting Up a Highly Available Cluster of OCMS Nodes
  • Associating Nodes with OPMN
    • Associating Nodes with OPMN Using the Dynamic Discovery Method
    • Associating Nodes with OPMN Using the Discovery Server Method
  • Starting the Cluster
  • Verifying the Status of the Cluster
  • Stopping the Cluster
• Configuring the OCMS SIP Containers for High Availability
• Configuring the Edge Proxy Nodes for High Availability
  • The NAT Traversal Option Enabled for the Edge Proxy
    • Disabling NAT Traversal Enabled by the Edge Proxy
• Configuring Highly Available SIP Servlet Applications
  • Enabling High Availability in SIP Servlet Applications
  • Configuring Application Session Data Replication
  • Configuring High Availability for a Deployed SIP Servlet Application
  • Disabling High Availability at the Application Level
  • Upgrading SIP Servlet Applications in OCMS
• Configuring an Overload Policy
  • Overview of Overload Policy Architecture
  • Collectors
  • Deactivating the Overload Protection for System Tuning

6 Viewing Statistics and Metrics

• Viewing Statistics and Metrics
  • SIP Servlet Container Monitor
    • Viewing System Status
    • Viewing Transactions
    • Using the Current, Peak, and Total Usage Statistics to Tune the System
  • Application Counters
  • Memory Monitor
    • Starting and Stopping the Memory Monitor
  • SIP Cluster

7 Configuring Presence and Presence Web Services

• Overview of Presence
• Configuring Presence
  • Configuring XDMS
  • Bus
  • PackageManager
  • Presence
  • PresenceEventPackage
  • PresenceWInfoEventPackage
  • UA-ProfileEventPackage
  • UserAgentFactoryService
  • Command Service (XDMS Provisioning)
  • XCapConfig
• Configuring Presence Web Services
  • PresenceWebServiceDeployer
  • PresenceSupplierWebService
  • PresenceConsumerWebService
  • Aggregation Proxy
  • Configuring the Aggregation Proxy to Work with Realms
  • Securing the XDMS with the Aggregation Proxy
• Configuring Scalable Presence Deployments with the User Dispatcher
  • Failover
    • Presentity Migration
    • Standby Server Pool
    • Failure Types
    • Failover Actions
    • Overload Policy
    • Synchronization of Failover Events
  • Expanding the Cluster
    • Updating the Node Set
    • Migrating Presentities
  • Failover Use Cases
    • One Presence Server Overloaded for 60 Seconds
    • One Presence Server Overloaded Multiple Times for Five Seconds
    • Overload Policy Triggered by an OCMS Software Failure
    • A Presence Server Hardware Failure
    • Expanding the Cluster with One Presence Node
    • Removing a Node from the Cluster
    • OPMN Restart After a Presence Server Crash
    • 503 Responses from an Application

8 OCMS Parlay X Web Services Architecture

• Architecture of Web Service Client Applications
• Web Service Security
  • Web Service Security on Notification
• Installing the Web Services

9 OCMS Parlay X Presence Web Services

• Introduction
• Presence Web Services Interface Descriptions
• Using the Presence Web Services Interfaces
  • Interface: PresenceConsumer, Operation: subscribePresence
    • Code Example
  • Interface: PresenceConsumer, Operation: getUserPresence
    • Code Example
  • Interface: PresenceConsumer, Operation: startPresenceNotification
    • Code Example
  • Interface: PresenceConsumer, Operation: endPresenceNotification
    • Code Example
  • Interface PresenceSupplier, Operation: publish and Oracle Specific Remove Presence
    • Code Example
  • Interface: PresenceSupplier, Operation: getOpenSubscriptions
    • Code Example
  • Interface: PresenceSupplier, Operation: updateSubscriptionAuthorization
    • Code Example
  • Interface: PresenceSupplier, Operation: getMyWatchers
    • Code Example
  • Interface: PresenceSupplier, Operation: getSubscribedAttributes
    • Code Example
  • Interface: PresenceSupplier, Operation: blockSubscription
    • Code Example
• OCMS Parlay X Presence Custom Error Codes

10 OCMS Parlay X Multimedia Messaging Web Services

• Introduction
• Multimedia Messaging Web Services Interface Descriptions
• Using the Multimedia Messaging Web Services Interfaces
  • Interface: SendMessage, Operation: sendMessage
  • Interface: sendMessage, Operation: getMessageDeliveryStatus
  • Interface: ReceiveMessage, Operation: getReceivedMessages
  • Interface: ReceiveMessage, Operation: getMessageURIs
  • Interface ReceiveMessage, Operation: getMessage
  • Interface: MessageNotificationManager, Operation: startMessageNotification
  • Interface: MessageNotificationManager, Operation: stopMessageNotification

11 Provisioning Users with Sash

• Overview of Sash
• Launching Sash
  • Launching Sash from the Command Line
  • Connecting Sash to an External OCMS Instance
    • Connecting to an External Instance of OC4J
    • Connecting Sash to an External Oracle Application Server Instance
• Using Sash
  • Viewing Available Commands
    • Viewing Subcommands
• Creating a User
  • Creating a User from the Sash Command-Line Prompt
  • Creating a User with the Command Service MBean
  • Creating a User with the identity add Command
    • Deleting a User Account with the identity delete Command
• Provisioning the XDMS Using Sash
  • Provisioning XDMS User Accounts Using the CommandService MBean
  • Provisioning XDMS User Accounts from the Sash Prompt
  • Using xcap Commands
    • Provisioning XDMS User Accounts
    • Adding XDMS Users
    • Removing an XDMS User
    • Searching for Application Usage for an XDMS User
    • Listing XDMS Users
    • Provisioning Application Usage
    • Listing All Application Usages
• Scripting with Sash
• Error Logging in Sash

12 Configuring the Logging System

• Overview of Oracle Diagnostic Logging in OCMS
  • Logging Components
  • Filtering of Logging Information by Single Class Files
  • Log Files
  • Logger Interfaces
• Logging Levels
• Setting the Log Levels for Components

13 Deploying Applications

• Overview of SIP Servlet Applications
• Deploying SIP Applications
  • Deploying, Undeploying, and Redeploying SIP Applications Using Oracle Application Server Control
  • Deploying, Undeploying, and Redeploying SIP Servlet Applications with Application Server Control
    • Deploying an Application using the Deployment Wizard
    • Undeploying an Application Using the Deployment Wizard
    • Redeploying an Application Using the Deployment Wizard
  • Deploying, Undeploying, and Redeploying an Application Using the admin_client.jar Utility
    • Deploying an Application Using admin_client.jar
    • Undeploying an Application Using admin_client.jar
    • Redploying an Application Using admin_client.jar
  • Deploying the SIP Application Using the admin_client.jar Command-Line Utility

A Supported Protocols, RFCs, and Standards

• SIP Servlet Container
  • RFCs
  • Drafts
  • Specification Requests
• Presence Server
  • RFCs
  • Drafts Referenced in the Composition Policies
  • XDMS Server
  • Authorization and Privacy Filtering
  • Presence Data Modeling and Processing
  • OMA Extensions
  • Hard State via XCAP

B Third-Party Licensing

• Third-Party Licenses

Index