|
|
The following sections describe guidelines and issues related to porting existing applications based on the SIP Servlet v1.0 specification to Oracle Communications Converged Application Server and the SIP Servlet v1.1 specification:
The SIP Servlet v1.1 specification describes a formal application selection and composition process, which is fully implemented in Oracle Communications Converged Application Server. Use the SIP Servlet v1.1 techniques, as described in Porting Existing Applications to Oracle Communications Converged Application Server, for all new development. Application composition techniques described in earlier versions of WebLogic SIP Server are now deprecated.
Oracle Communications Converged Application Server provides backwards compatibility for applications using version SIP Servlet 1.0 composition techniques, provided that:
The SipSession and SipApplicationSession interfaces are no longer serializable in the SIP Servlet v1.1 specification. Oracle Communications Converged Application Server maintains binary compatibility for the earlier v1.0 specification, so any compiled applications that treat these interfaces as serializable objects will continue to work. However, you must modify the source code of such applications before you can recompile them with Oracle Communications Converged Application Server.
Version 1.0 Servlets that stored the SipSession as a serializable info object using the TimerService.createTimer API can achieve similar functionality by storing the SipSession ID as the serializable info object. On receiving the timer expiration callback, applications should use the SipApplicationSession and the serialized ID object returned by the ServletTimer to find the SipSession within the SipApplicationSession using the retrieved ID. See the
SIP Servlet v1.1 API JavaDoc for more information.
SipServletResponse.setCharacterEncoding() no longer throws UnsupportedEncodingException. If you have an application that explicitly catches UnsupportedEncodingException with this method, the existing, compiled application can be deployed to Oracle Communications Converged Application Server unchanged. However, the source code must be modified to not catch the exception before you can recompile.
SIP Servlet v1.1 acknowledges that SipServletRequest and SipServletResponse objects always belong to a SIP transaction. The specification further defines the conditions for committing a message, after which no application can modify or re-send the message. See 5.2 Implicit Transaction State in the
SIP Servlet Specification v1.1 for a list of conditions that commit SIP messages.
As a result of this change, any attempt to modify (set, add, or remove a header) or send a committed message now results in an IllegalStateException. Ensure that any existing code checks for the committed status of a message using SipServletMessage.isCommitted() before modifying or sending a message.
SIP Servlet v1.1 introduces a new javax.servlet.sip.Parameterable interface for accessing, creating, and modifying parameters in various SIP headers. Note that the system header parameters described in Table 2-1 are immutable and cannot be modified using this new interface.
The SIP Servlet v1.1 specification requires that a Proxy is always transactionally stateful. Stateless proxying is supported only for v1.0 applications.
For v1.1 applications in Oracle Communications Converged Application Server, the Proxy.setStateful() and Proxy.getStateful() methods are redundant: Proxy.getStateful() always returns true, and Proxy.setStateful() performs no operation.
Oracle Communications Converged Application Server automatically detects precompiled, v1.0 deployments and alters the SIP container behavior to maintain backward compatibility. The sections that follow describe differences in behavior that occur when deploying v1.0 SIP Servlets to Oracle Communications Converged Application Server.
The SIP Servlet v1.1 specification requires more strict validation of Servlet deployments than the previous specification. In the following cases, v1.0 SIP Servlets can be successfully deployed to Oracle Communications Converged Application Server, but a warning message will be displayed at deployment:
listener-class element of a v1.0 deployment descriptor but the corresponding class does not implement the EventListener interface, a warning is displayed during deployment. (Version 1.1 SIP Servlets that declare a listener must implement EventListener, or the application cannot be deployed).servlet-class element of a v1.0 deployment descriptor, but the corresponding class does extend the SipServlet abstract class, a warning is displayed. (Version 1.1 SIP Servlets must extend SipServlet, or the application cannot be deployed).
The SIP Servlet v1.1 specification now recommends that the SIP container throw an IllegalStateException if an application attempts to modify a committed message. To maintain backward compatibility, Oracle Communications Converged Application Server throws the IllegalStateException only when a version 1.1 SIP Servlet deployment modifies a committed message.
The SIP Servlet v1.1 specification now defines the Path header as a system header, which cannot be modified by an application. Version 1.0 SIP Servlets can still modify the Path header, but a warning message is generated. Version 1.1 SIP Servlets that attempt to modify the Path header fail with an IllegalArgumentException.
In Oracle Communications Converged Application Server, SipServletResponse.createPrack() can throw Rel100Exception only for version 1.1 SIP Servlets. createPrack() does not throw the exception for version 1.0 SIP Servlets to maintain backward compatibility.
For version 1.1 SIP Servlets, Oracle Communications Converged Application Server throws an IllegalStateException if a version 1.1 SIP Servlet specifies a duplicate branch URI with Proxy.proxyTo(uri) or Proxy.proxyTo(uris). To maintain backward compatibility, Oracle Communications Converged Application Server ignores the duplicate URIs (and throws no exception) if a version 1.0 SIP Servlet specifies duplicate URIs with these methods.
SIP Servlet v1.1 makes several protocol changes that effect the behavior of proxy branching for both sequential and parallel proxying.
For sequential proxying, the v1.1 specification requires that Oracle Communications Converged Application Server start a branch timer using the maximum of the sequential-search-timeout value, which is configured in sip.xml, or SIP protocol Timer C (> 3 minutes). Prior versions of Oracle Communications Converged Application Server always set sequential branch proxy timeouts using the value of sequential-search-timeout; this behavior is maintained for v1.0 deployments.
For parallel proxying, the v1.1 specification provides a new proxyTimeout value that controls proxying. The specification requires that Oracle Communications Converged Application Server reset a branch timer using the configured proxyTimeout value, rather than using the Timer C value as required in the SIP Servlet v1.0 specification. The Timer C value is still used for v1.0 deployments.
Earlier versions of WebLogic SIP Server provided proprietary APIs to support functionality and RFCs that were not supported in the SIP Servlet v1.0 specification. The SIP Servlet v1.1 specification adds new RFC support and functionality, making the proprietary APIs redundant. Table 2-2 shows newly-available SIP Servlet v1.1 methods that should be used in place of now-deprecated WebLogic SIP Server methods. The deprecated methods are still available in this release to provide backward compatibility for v1.0 applications.
Previous versions of the Oracle Communications Converged Application Server SNMP MIB definition did not follow the WebLogic MIB naming convention. Specifically, the MIB table column name label did not begin with the table name. Oracle Communications Converged Application Server changes the SNMP MIB definition to prepend labels with sipServer in order to comply with the WebLogic naming convention and provide compatibility with WebLogic tools that generate the metadata file.
For example, in version 3.x the SipServerEntry MIB definition was:
SipServerEntry ::= SEQUENCE {
sipServerIndex DisplayString,
t1TimeoutInterval INTEGER,
t2TimeoutInterval INTEGER,
t4TimeoutInterval INTEGER,
....
}In Oracle Communications Converged Application Server, the definition is now:
SipServerEntry ::= SEQUENCE {
sipServerIndex DisplayString,
sipServerT1TimeoutInterval Counter64,
sipServerT2TimeoutInterval INTEGER,
sipServerT4TimeoutInterval INTEGER,
.....
}
This change in the MIB may cause backwards compatibility issues if an application or script uses the MIB table column name labels directly. All hard-coded labels, such as iso.org.dod.internet.private.enterprises.bea.wlss.sipServerTable.t1TimeoutInterval must be changed to prepend the table name (iso.org.dod.internet.private.enterprises.bea.wlss.sipServerTable.sipServerT1TimeoutInterval).
| Notes: | Client-side SNMP tools generally load a MIB and issue commands to retrieve values based on the loaded MIB labels. These tools are unaffected by the above change. |
| Note: | The complete Oracle Communications Converged Application Server MIB file is installed as $WLSS_HOME/server/lib/wlss/BEA-WLSS-MIB.asn1. |
The diagnostic monitors and diagnostic actions provided in Oracle Communications Converged Application Server are now prefixed with occas/. For example, the SIP Server 3.1 Sip_Servlet_Before_Service monitor is now named occas/Sip_Servlet_Before_Service. You must update any existing diagnostic configuration files or applications that reference the non-prefixed names before they can work with Oracle Communications Converged Application Server.
See Using the WebLogic Server Diagnostic Framework (WLDF) in the Operations Guide.
|