Contents

Title and Copyright Information

Preface

• Audience
• Related Documents
• Documentation Accessibility

Part I Configuring WebRTC Session Controller

1 WebRTC Session Controller Configuration Overview

• About the Oracle WebLogic Platform
• Overview of Configuration and Administration Tools
  • Administration Console
  • WebLogic Scripting Tool
  • WebRTC Session Controller Console
  • Additional Configuration Methods
    • Editing Configuration Files
    • Custom JMX Applications
• Common Configuration Tasks

2 Configuring WebRTC Session Controller Signaling Properties and Media Nodes

• About WebRTC Session Controller Console Configuration
  • About Signaling Engine Properties
  • About Media Engine Nodes Configuration and Status
• Accessing the WebRTC Session Controller Console Configuration Tab
• Configuring Signaling Engine Parameters
• Configuring Media Engine Nodes
  • Adding Media Engine Nodes
  • Removing Media Engine Nodes
  • Blocking and Unblocking Media Node Traffic
  • Setting Media Node Information Auto Refresh

3 Using the Administration Console and WLST

• Accessing the Administration Console
  • Locking and Persisting the Configuration
• Using WLST (JMX) to Configure WebRTC Session Controller
  • Configuring the SIP Container with WLST
    • Managing Configuration Locks
    • Configuration MBeans for the SIP Servlet Container
    • Locating the SIP Container MBeans
  • Configuring the WebRTC Session Controller Application with WLST
    • Managing Configuration Locks
    • Configuration MBeans for WebRTC Session Controller
    • Accessing WebRTC Session Controller Application MBeans
• WLST Configuration Examples
  • Invoking WLST
  • WLST Template for Configuring Container Attributes
  • Creating and Deleting MBeans
  • WebRTC Session Controller Code Sample
• Setting Logging Levels
• Startup Sequence for a WebRTC Session Controller Domain
• Startup Command Options
• Reverting to the Original Boot Configuration

4 Configuring WebRTC Session Controller Authentication

• About WebRTC Session Controller Security Schemes
• About Provisioning WebRTC Session Controller Guest Access
  • Configuring the WebLogic Server Guest Access Provider
  • Configuring the WebRTC Session Controller Guest Access Application
• About Provisioning WebRTC Session Controller HTTP Access
  • Configuring the WebLogic Server HTTP Authentication Provider
  • Configuring the WebRTC Session Controller HTTP Access Application
• About Provisioning WebRTC Session Controller OAuth Access
  • Configuring the WebLogic Server OAuth Access Provider
  • Configuring the WebRTC Session Controller OAuth Access Application

5 Configuring WebRTC Session Controller Diameter Rx to PCRF Integration

• About the WebRTC Session Controller Rx Interface
• Overview of Diameter Rx Protocol Configuration
• Installing the Diameter Domain Template
• Creating TCP, TLS, and SCTP Network Channels for the Diameter Protocol
  • Configuring Two-Way SSL for Diameter TLS Channels
  • Configuring and Using SCTP for Diameter Messaging
• Configuring Diameter Nodes
  • Creating a New Node Configuration (General Node Configuration)
  • Configuring Diameter Applications
    • Configuring the Rx Client Application
  • Configuring Peer Nodes
  • Configuring Routes
• Troubleshooting Diameter Configurations

6 Configuring WebRTC Session Controller Media Engine

• About WebRTC Session Controller Media Engine Configuration
• Common Media Engine Configuration Tasks
  • Configuring Permissions, Users and Authorization
  • Enabling Media Engine Interfaces and Protocols
  • Enabling Media Engine Services
  • Configuring Accounting and Archiving Services
  • Configuring Media Engine Domain Name Systems
  • Configuring SIP Servers

7 Configuring WebRTC Session Controller Container Properties

• Configure General SIP Application Server Properties
• Adding Servers to the WebRTC Session Controller Cluster
• Configuring Timer Processing
  • Configuring Timer Affinity (Optional)
  • Configuring NTP for Accurate SIP Timers

8 Configuring SIP Data Tier Partitions and Replicas

• Overview of SIP Data Tier Configuration
  • datatier.xml Configuration File
  • Configuration Requirements and Restrictions
• Best Practices for Configuring and Managing SIP Data Tier Servers
• Example SIP Data Tier Configurations and Configuration Files
  • SIP Data Tier with One Partition
  • SIP Data Tier with Two Partitions
  • SIP Data Tier with Two Partitions and Two Replicas
• Monitoring and Troubleshooting SIP Data Tier Servers

9 Configuring Network Connection Settings

• Overview of Network Configuration
• Configuring External IP Addresses in Network Channels
• About IPv4 and IPv6 Support
• Enabling DNS Support
• Configuring Network Channels for SIP or SIPS
  • Reconfiguring an Existing Channel
  • Creating a New SIP or SIPS Channel
• Configuring Custom Timeout, MTU, and Other Properties
• Configuring SIP Channels for Multihomed Machines
• Configuring Engine Servers to Listen on Any IP Interface
• Configuring Static Source Port for Outbound UDP Packets
• Configuring Unique Listen Address Attributes for SIP Data Tier Replicas

10 Configuring Server Failure Detection

• Overview of Failover Detection
  • WlssEchoServer Failure Detection
  • Forced Shutdown for Failed Replicas
• WlssEchoServer Requirements and Restrictions
• Starting WlssEchoServer on SIP Data Tier Server Machines
• Enabling and Configuring the Heartbeat Mechanism on Servers

11 Using the Engine Tier Cache

• Overview of Engine Tier Caching
• Configuring Engine Tier Caching
• Monitoring and Tuning Cache Performance

12 Configuring Coherence

• Overview of WebRTC Session Controller Coherence Implementation
• Configuring Coherence

13 Upgrading Production WebRTC Session Controller Software

• Overview of System Upgrades
• Requirements for Upgrading a Production System
• Upgrading to a New Version of WebRTC Session Controller
  • Configure the Load Balancer
  • Configure the New Engine Tier Cluster
  • Define the Cluster-to-Load Balancer Mapping
  • Duplicate the SIP Servlet and WebRTC Session Controller Configurations
  • Upgrade Engine Tier Servers and Target Applications to the New Cluster
• Applying Software Patches and Updates

Part II Monitoring and Troubleshooting

14 Logging SIP Requests and Responses

• Overview of SIP Logging
• Defining Logging Servlets in sip.xml
• Configuring the Logging Level and Destination
• Specifying the Criteria for Logging Messages
  • Using XML Documents to Specify Logging Criteria
  • Using Servlet Parameters to Specify Logging Criteria
• Specifying Content Types for Unencrypted Logging
• Enabling Log Rotation and Viewing Log Files
• trace-pattern.dtd Reference
• Adding Tracing Functionality to SIP Servlet Code
• Order of Startup for Listeners and Logging Servlets

15 Avoiding and Recovering From Server Failures

• Failure Prevention and Automatic Recovery Features
  • Overload Protection
  • Redundancy and Failover for Clustered Services
  • Automatic Restart for Failed Server Instances
  • Managed Server Independence Mode
  • Automatic Migration of Failed Managed Servers
  • Geographic Redundancy for Regional Site Failures
• Directory and File Backups for Failure Recovery
  • Enabling Automatic Configuration Backups
  • Storing the Domain Configuration Offline
  • Backing Up Server Start Scripts
  • Backing Up Logging Servlet Applications
  • Backing Up Security Data
    • Backing Up the WebLogic LDAP Repository
    • Backing Up SerializedSystemIni.dat and Security Certificates
  • Backing Up Additional Operating System Configuration Files
• Restarting a Failed Administration Server
  • Restarting an Administration Server on the Same System
  • Restarting an Administration Server on Another System
• Restarting Failed Managed Servers

16 Tuning JVM Garbage Collection for Production Deployments

• Goals for Tuning Garbage Collection Performance
• Modifying JVM Parameters in Server Start Scripts
• Tuning Garbage Collection with Oracle JDK

17 Avoiding JVM Delays Caused By Random Number Generation

• Avoiding JVM Delays Caused by Random Number Generation

Part III Reference

18 Engine Tier Configuration Reference (sipserver.xml)

• Overview of sipserver.xml
• Editing sipserver.xml
  • Steps for Editing sipserver.xml
• XML Schema
• Example sipserver.xml File
• XML Element Description
  • enable-timer-affinity
  • overload
    • Selecting an Appropriate Overload Policy
    • Overload Control Based on Session Generation Rate
    • Overload Control Based on Capacity Constraints
    • Two Levels of Overload Protection
  • message-debug
  • proxy—Setting Up an Outbound Proxy Server
  • t1-timeout-interval
  • t2-timeout-interval
  • t4-timeout-interval
  • timer-b-timeout-interval
  • timer-f-timeout-interval
  • max-application-session-lifetime
  • enable-local-dispatch
  • cluster-loadbalancer-map
  • default-behavior
  • default-servlet-name
  • retry-after-value
  • sip-security
  • route-header
  • engine-call-state-cache-enabled
  • server-header
  • server-header-value
  • persistence
  • use-header-form
  • enable-dns-srv-lookup
  • connection-reuse-pool
  • globally-routable-uri
  • domain-alias-name
  • enable-rport
  • image-dump-level
  • stale-session-handling
  • enable-contact-provisional-response

19 SIP Data Tier Configuration Reference (datatier.xml)

• Overview of datatier.xml
• Editing datatier.xml
• XML Schema
• Example datatier.xml File
• XML Element Description

20 Diameter Configuration Reference (diameter.xml)

• Overview of diameter.xml
• Graphical Representation
• Editing diameter.xml
  • Steps for Editing diameter.xml
• XML Schema
• Example diameter.xml File
• XML Element Description
  • configuration
  • target
  • host
  • realm
  • address
  • port
  • tls-enabled
  • sctp-enabled
  • debug-enabled
  • message-debug-enabled
  • application
    • class-name
    • param*
      • name
      • value
  • peer-retry-delay
  • allow-dynamic-peers
  • request-timeout
  • watchdog-timeout
  • include-origin-state-id
  • supported-vendor-id+
  • peer+
    • host
    • address
    • port
    • protocol
  • route
    • realm
    • application-id
    • action
    • server+
  • default-route
    • action
    • server+