Configuring and Managing WebLogic SIP Server

Overview of the WebLogic SIP Server Architecture

Goals of the WebLogic SIP Server Architecture

Load Balancer

Engine Tier

Data tier

Example Hardware Configuration

Alternate Configurations

Overview of WebLogic SIP Server Configuration and Management

Shared Configuration Tasks for WebLogic SIP Server and WebLogic Server

Engine and Data Tier Configuration Overview

Configuration Implementation

Startup Sequence for a WebLogic SIP Server Domain

Methods and Tools for Performing Configuration Tasks

Administration Console

Upgrade Utility

WebLogic Scripting Tool (WLST)

Additional Configuration Methods

Editing Configuration Files

Custom JMX Applications

Administration Server Best Practices

Adding threads to weblogic.admin.RMI and weblogic.admin.HTTP

Common Configuration Tasks

Configuring Data Tier Partitions and Replicas

Overview of Data Tier Configuration

datatier.xml Configuration File

Configuration Requirements and Restrictions

Best Practices for Configuring and Managing Data Tier Servers

Example Data Tier Configurations and Configuration Files

Data Tier with One Partition

Data Tier with Two Partitions

Data Tier with Two Partitions and Two Replicas

Monitoring and Troubleshooting Data Tier Servers

Configuring Engine Tier Container Properties

Overview of SIP Container Configuration

Using the Administration Console to Configure Container Properties

Locking and Persisting the Configuration

Configuring Container Properties Using WLST (JMX)

ConfigManagerRuntimeMBean Usage and Reference

Configuration MBeans for the SIP Servlet Container

Locating the WebLogic SIP Server MBeans

WLST Configuration Examples

Invoking WLST

WLST Template for Configuring Container Attributes

Creating and Deleting MBeans

Working with URI Values

Reverting to the Original Boot Configuration

Configuring NTP for Accurate SIP Timers

Capacity Planning for WebLogic SIP Server Deployments

Introduction to Capacity Planning

Determining Performance Goals

Basic Hardware Configuration and Throughput Values

Throughput Values for WebLogic SIP Server Instances

Sample Deployment Scenarios

Small Deployment

Medium Deployment

Large Deployment

Managing WebLogic SIP Server Network Resources

Overview of Network Configuration

Configuring Load Balancer Addresses

Multiple Load Balancers and Multihomed Load Balancers

Configuring Network Channels for SIP or SIPS

Reconfiguring an Existing Channel

Creating a New SIP or SIPS Channel

Configuring SIP Channels for Multi-Homed Machines

Configuring Engine Servers to Listen on Any IP Interface (0.0.0.0)

Configuring Unique Listen Address Attributes for Data Tier Replicas

Production Network Architectures and WebLogic SIP Server Configuration

Overview

Single-NIC Configurations with TCP and UDP Channels

Static Port Configuration for Outbound UDP Packets

Multihomed Server Configurations Overview

Multihomed Servers Listening On All Addresses (IP_ANY)

Multihomed Servers Listening on Multiple Subnets

Understanding the Route Resolver

IP Aliasing with Multihomed Hardware

Load Balancer Configurations

Single Load Balancer Configuration

Multiple Load Balancers and Multihomed Load Balancers

Network Address Translation Options

IP Masquerading Alternative to Source NAT

Overview of WebLogic SIP Server Security Features

Authentication for SIP Servlets

Authentication Providers

Overriding Authentication with Trusted Hosts

P-Asserted-Identity Support

Role Assignment for SIP Servlet Declarative Security

Security Event Auditing

Common Security Configuration Tasks

Configuring Digest Authentication

Overview of Digest Authentication

What Is Digest Authentication?

Digest Authentication Support in WebLogic SIP Server 2.1

Prerequisites for Configuring LDAP Digest Authentication

Steps for Configuring LDAP Digest Authentication

Configure the LDAP Server or RDBMS

Using Unencrypted Passwords

Using Precalculated Hash Values

Using Reverse-Encrypted Passwords

Reconfigure the DefaultAuthenticator Provider

Configure an Authenticator Provider

Configure a New Digest Identity Asserter Provider

Configure an LDAP Digest Identity Asserter Provider

Configure an RDBMS Digest Identity Asserter Provider

Sample Digest Authentication Configurations

Oracle Internet Directory Server

WebLogic SIP Server Embedded LDAP

Store User Password Information in the Description Field

Set the Embedded LDAP Password

Configure the Digest Identity Asserter Provider

Configuring Client-Cert Authentication

Overview of Client-Cert Authentication

Configuring SSL and X509 for WebLogic SIP Server

Configuring the Default Identity Asserter

Configuring the LDAP X509 Identity Asserter

Configuring WebLogic SIP Server to Use WL-Proxy-Client-Cert

Supporting Perimeter Authentication with a Custom IA Provider

Configuring P-Asserted-Identity Assertion

Understanding Trusted Host Forwarding with P-Asserted-Identity

Overview Strict and Non-Strict P-Asserted-Identity Asserter Providers

Configuring a P-Asserted-Identity Assertion Provider

Logging SIP Requests and Responses

Overview of SIP Logging

Using the Template Logging Servlet

Deploying the Template Logging Application

Using the Logging Servlet Implementation in Other Applications

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

Managing Logging Performance

Enabling Log Rotation and Viewing Log Files

trace-pattern.dtd Reference

Adding Tracing Functionality to SIP Servlet Code

Configuring SNMP

Overview of WebLogic SIP Server SNMP

Browsing the MIB

Configuring SNMP

SNMP Port Binding for WebLogic SIP Server

Understanding and Responding to SNMP Traps

Files for Troubleshooting

Trap Descriptions

sipAppDeployed

sipAppUndeployed

sipAppFailedToDeploy

overloadControlActivated, overloadControlDeactivated

licenseLimitExceeded

serverStopped

dataTierServerStopped

replicaAddedToPartition

replicaRemovedFromPartition

connectionLostToPeer

connectionReestablishedToPeer

Upgrading Software and Applications in a Production Environment

Overview of System and Application Upgrades

Requirements for Upgrading a Production System

Upgrading to a New Version of WebLogic SIP Server

Configure the Load Balancer

Configure the New Engine Tier Cluster

Define the Cluster-to-Load Balancer Mapping

Duplicate the SIP Servlet Container and Data Tier Configuration

Upgrade Engine Tier Servers and Target Applications to the New Cluster

Upgrade Data Tier Servers

Upgrading a Deployed Production Application (Compatible Session Data)

Upgrading a Deployed Production Application (Incompatible Session Data)

Configure the Load Balancer

Configure the New Engine Tier Cluster

Define the Cluster-to-Load Balancer Mapping

Migrate Engine Tier Servers and Target Applications to the New Cluster

Applying Patches Using InstallPatch

Overview of the InstallPatch Utility

Required Environment for the InstallPatch Utility

Syntax for Invoking the InstallPatch Utility

Example InstallPatch Commands

Editing the MANIFEST Classpath in GUI Mode

Upgrading a WebLogic SIP Server 2.0.x Configuration to Version 2.1

About the Upgrade Program

Steps for Upgrading an Existing Configuration

Required Environment for the UpgradeConfig Utility

wlss.UpgradeConfig Reference

Engine Tier Configuration Reference (sipserver.xml)

Overview of sipserver.xml

Graphical Representation

Editing sipserver.xml

Steps for Editing sipserver.xml

XML Schema

Example sipserver.xml File

XML Element Description

overload

Overload Control Based on Session Generation Rate

Overload Control Based on Execute Queue Length

Two Levels of Overload Protection

message-debug

proxy—Setting Up an Outbound Proxy Server

t1-timeout-interval

t2-timeout-interval

t4-timeout-interval

timerB-timeout-interval

timerF-timeout-interval

max-application-session-lifetime

enable-local-dispatch

cluster-loadbalancer-map

default-behavior

sip-security

Data Tier Configuration Reference (datatier.xml)

Overview of datatier.xml

Editing datatier.xml

XML Schema

Example datatier.xml File

XML Element Description

Tuning JVM Garbage Collection for Production Deployments

Goals for Tuning Garbage Collection Performance

Tuning Garbage Collection with JRockit

Tuning Garbage Collection with Sun JDK

Avoiding JVM Delays Caused by Random Number Generation