[AIX HP-UX Linux Solaris Windows]This topic applies only on the z/OS operating system.

Configuring SIP application routers

Use the Session Initiation Protocol (SIP) application router to select the order in which SIP applications are triggered. When configuring a SIP application router, you can either use the default application router or create a custom application router.

Before you begin

The CEA system application requires special consideration when enabled on the same server or cluster as a custom application router. To deploy an application router and still maintain the capabilities of the CEA system application, use one of the following two options:
  • Only enable CEA on an isolated server or cluster that includes no custom application router.
  • Make sure the custom application router routes all CEA specific messages to the CEA system application. To do this, the developer of the application router must check the mappings that are defined in the sip.xml file associated with the CEA system application. The sip.xml file associated with the CEA system application can be found in the directory path at app_server_root/feature_packs/cea/systemApps.

    The following information explains how to configure a custom application router to route to the commsvc system application. The examples show a custom application router configuration with and without the commsvc application.

    First, here is an example configuration without commsvc:

           INVITE: ("TestB2bua", "DAR:To", "NEUTRAL", "", "NO_ROUTE", "0")

    The first element after the INVITE is the display name of the test application, and this one-line application router routes b2bua calls to the application successfully. With the preceding application router configured on the SIP container, however, CEA Web collaboration attempts fail.
    To enable routing to the CEA system application, just clone the routing element and change the application name in the second element instance:

           INVITE: ("TestB2bua", "DAR:To", "NEUTRAL", "", "NO_ROUTE", "0"),("commsvc", "DAR:To", "NEUTRAL", "", "NO_ROUTE", "0")

    This action ensures that CEA messages are routed correctly.

About this task

The SIP container provides an application router component called the Default Application Router (DAR). The DAR component uses a configuration text file, similar to a Java™ properties file, that defines the order in which the application router sends SIP requests to applications.
Avoid trouble: Even though the administrative agent console navigation implies that you can specify SIP application router settings for the administrative agent, you must use either the administrative console or wsadmin commands for the managed server to specify SIP application router settings.gotcha
Restriction: WebSphere® Application Server has a default way of sorting the order of SIP applications invocation using the Startup behavior settings. The sorting order is based on the application weight. This weighting policy only applies if you do not specify a DAR configuration file, or if a custom application router has not been associated with the server or cluster.

You can either use the DAR or a custom application router to perform application routing, as described in the procedure.

[Feature Pack for CEA Fix Pack 5 or later] Attention: The Feature Pack for CEA includes a collection of wsadmin (Jython) procedures that can be used to simplify the development and testing of scripts that automate configuration changes. For further information, see the topic wsadmin (Jython) scripting procedures for CEA in the Feature Pack for Communications Enabled Applications (All Operating Systems) Information Center.

Use the following procedure to select the best method to implement the SIP application router for your configuration.

Procedure

Results

You have successfully configured a SIP application router.



Related concepts
SIP application router
Related information
SIP application router settings
SIP application router collection
Default application router rule collection
Default application router rule settings
SIP container custom properties
SIP Servlet Specification 1.1 (JSR 289)
Application routing order settings
Application startup order settings
Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 12:58:21 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v700cea&product=was-nd-mp&topic=tcea_sipapprouter_cfg
File name: tcea_sipapprouter_cfg.html