Add documentation for jBPM JMS provider adapter
-----------------------------------------------
Key: JBESB-3363
URL:
https://jira.jboss.org/browse/JBESB-3363
Project: JBoss ESB
Issue Type: Task
Security Level: Public (Everyone can see)
Components: Documentation
Affects Versions: 4.7 CP2
Reporter: Kevin Conner
Add the following text to the Administration Guide.
Using Remote JMS Providers
The JMS based Message and Scheduling services can reference remote JMS providers by
allowing the configuration of a Provider Adapter within local JNDI. The Provider Adapter
is an instance of the JMSProviderAdapter, as can be used within the standard application
server JCA inflow configurations.
The JMSProviderAdapter is configured through the addition of an MBean within a service.xml
file. This can either be specific to the jBPM integration, for example added to the
jbpm-service.xml, or can be shared with other JCA inflow configurations.
The following example creates a provider adapter which references a remote JMS provider
executing on the server located through the JNDI provider URL 192.168.1.1:1099, with the
contents of the Properties attribute being used to create the JNDI InitialContext.
<mbean code="org.jboss.jms.jndi.JMSProviderLoader"
name="jboss.messaging:service=JMSProviderLoader,name=RemoteProviderLoader">
<attribute name="ProviderName">RemoteProviderAdapter</attribute>
<attribute
name="ProviderAdapterClass">org.jboss.jms.jndi.JNDIProviderAdapter</attribute>
<attribute
name="QueueFactoryRef">XAQueueConnectionFactory</attribute>
<attribute
name="TopicFactoryRef">XATopicConnectionFactory</attribute>
<attribute name="Properties">
java.naming.provider.url=192.168.1.1:1099
</attribute>
</mbean>
The Provider Adapter is then be referenced within the JMSMessageServiceFactory and
JMSSchedulerServiceFactory configurations by specifying the JNDI location through the
providerAdapterJNDI field, an example of which is as follows.
<service name="message">
<factory>
<bean
class="org.jboss.soa.esb.services.jbpm.integration.msg.JmsMessageServiceFactory">
<field name="providerAdapterJNDI"><string
value="RemoteProviderAdapter"/></field>
</bean>
</factory>
</service>
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
https://jira.jboss.org/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira