JBoss.orgCommunity Documentation
The RA implementation uses the JBoss Communications JAIN SIP HA stack, an extension of the JAIN SIP Reference Implementation which provides high availability and fault tolerance. The stack is the result of the work done by JBoss Communications JAIN SLEE and SIP Servlets development teams, and source code is provided in all releases.
The Resource Adaptor supports configuration only at Resource Adaptor Entity creation time. The following table enumerates the configuration properties:
Table 3.1. Resource Adaptor's Configuration Properties
| Property Name | Description | Property Type | Default Value |
|---|---|---|---|
| javax.sip. IP_ADDRESS | the IP address to which the SIP stack should attach - if value is not specified the RA will use the underlying Java EE container's bind address address | java.lang.String | |
| javax.sip. OUTBOUND_PROXY | sets the outbound proxy of the SIP Stack. The format for this string is "ipaddress:port/transport" i.e. 129.1.22.333:5060/UDP. This property is optional | java.lang.String | |
| javax.sip. PORT | the port to which the SIP stack should listen | java.lang.Integer | 5060 |
| javax.sip. TRANSPORT | the list of supported transports, separated with "," | java.lang.String | UDP |
| org.mobicents. ha.javax.sip. BALANCERS | the list of SIP balancers, in the form of "HOST:PORT", separated by ";", it is only used if the heart beat service property is defined | java.lang.String | |
| org.mobicents. ha.javax.sip. LoadBalancer HeartBeating ServiceClassName | the name of the class responsible for the heart beats exchanged with the platform's SIP Balancer - if not specified the JAIN SIP HA stack won't use such feature | java.lang.String | |
| org.mobicents. javax.sip. LOOSE_DIALOG _VALIDATION | controls validation of CSeq number for dialog messages. Set to true allows out of sequence messages to be accepted. | java.lang.Boolean |
Spaces where introduced in Property Name column values, to correctly render the table. Please remove them when using copy/paste.
JAIN SLEE 1.1 Specification requires values set for properties without a default value, which means the configuration for those properties are mandatory. Otherwise the Resource Adaptor Entity creation will fail.
There is a single Resource Adaptor Entity created when deploying the Resource Adaptor, named SipRA. The SipRA entity uses the default Resource Adaptor configuration, specified in Section 3.1, “Configuration”.
The SipRA entity is also bound to Resource Adaptor Link Name SipRA. To use it in an SBB, add the following XML to its descriptor:
<resource-adaptor-type-binding>
<resource-adaptor-type-ref>
<resource-adaptor-type-name>
JAIN SIP
</resource-adaptor-type-name>
<resource-adaptor-type-vendor>
javax.sip
</resource-adaptor-type-vendor>
<resource-adaptor-type-version>
1.2
</resource-adaptor-type-version>
</resource-adaptor-type-ref>
<activity-context-interface-factory-name>
slee/resources/jainsip/1.2/acifactory
</activity-context-interface-factory-name>
<resource-adaptor-entity-binding>
<resource-adaptor-object-name>
slee/resources/jainsip/1.2/provider
</resource-adaptor-object-name>
<resource-adaptor-entity-link>
SipRA
</resource-adaptor-entity-link>
</resource-adaptor-entity-binding>
</resource-adaptor-type-binding>
Each Resource Adaptor Entity uses a single JAIN SLEE 1.1 Tracer, named SipResourceAdaptor. The related Log4j Logger category, which can be used to change the Tracer level from Log4j configuration, is javax.slee.RAEntityNotification[entity=SipRA].