JBoss.orgCommunity Documentation
The RA implementation uses the Mobicents 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 Mobicents 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.LoadBalancerHeartBeatingServiceClassName | 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 |
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>