The purpose of this document is to show how to deploy Camel Stardust component on a JBoss server.
Before starting, you have to perform some prerequisites to setup the Stardust Portal and the process engine in JBoss. These are described in chapter JBoss of the Deployment Guide.
After you have configured your environment accordingly, change the jndi-name entry in the
ipp-jcr-ds.xml file located in folder
%JBOSS_HOME%/server/<server-name>/deploy as follows:
<jndi-name>jcr/jackrabbit<jndi-name>
Once the environment is installed, we can use the Maven archetype template provided by Stardust. To prepare a WAR deployment for JBoss 7.1, use the corresponding archetype:
Please refer to chapter Creating a Runtime Environment with Apache Maven in the Installation Guide section Other Archetypes of our Stardust Wiki Maven/Basic Setup page for details on how to retrieve this archetype.
The following Maven command example demonstrates how to create a new Maven project with the provided JBoss archetype:
mvn archetype:generate -DarchetypeGroupId=com.infinity.bpm.archetypes -DarchetypeArtifactId=ipp-archetype-jb71-ipp-portal-war -DarchetypeVersion=8.1.0 -DgroupId=com.infinity.test -DartifactId=ipp-portal -Dversion=1.0-SNAPSHOT
Perform the following modification to the file WEB-INF/config/ipp/spring/jackrabbit-jcr-context.xml:
org.eclipse.stardust.vfs.jcr.spring.JcrSpringSessionFactory
java:jcr/jackrabbit
In your web.xml file change the following:
<context-param> <param-name>carnot.login.MODEL_REQUIRED</param-name> <param-value>false</param-value>> </context-param>
Perform the following steps to log into the Process Portal:
%JBOSS_HOME%/server/<server-name>/deploy

Figure: Logged into the Portal
In this section we will deploy a simple model using a Camel Trigger which intercept information from a file and put them in structured data.
The model:

Figure: Example Model
Note that from Camel 2.8 onwards there is no longer the need for using the Camel-JBoss component as Camel is now capable of loading type converters without package scanning.
However if you are using a Camel version prior to 2.8, and before deploying the model there are some changes in the Portal war file that must be performed:
camel-context.xml file in folder WEB-INF/config/ipp/springcamel-context.xml file. Please see the Camel online
documentation http://camel.apache.org/camel-jboss.html
for more details.
<bean id="jbossResolver" class="org.apache.camel.jboss.JBossPackageScanClassResolver"/>
WEB-INF/lib.Run the server and deploy the model from the Administrator perspective in the Portal. Please refer to chapter Deploying Workflow Models in the End User Handbook for details.
Once you provide a file for the Camel file trigger, the Camel Trigger loads it and sends the data to Stardust.