Installation instructions for SOA-P/jBPM 5 integration.
==================================================================== 

An automated installer `build.xml' is available to install the SOA-P/jBPM 5 integration.  To use it, run `ant` in this directory.  The file `build.properties' contains the settings for the automated installer.  If you run the automated installer, you should continue from step 5 in the "Creating and using a service repository" section.  Otherwise, for manual installation, follow all the steps below.


Manual Installation
================================================= 
1. Download soa-p-VERSION.jbpm5.zip, as well as a SOA-P distribution (soa-p-VERSION.zip) and the BRMS deployable distribution (brms-VERSION-deployable.zip)

2. Extract soa-p-VERSION.zip using the ZIP tool of your choice.

3. Install HornetQ

   cd SOA_ROOT/jboss-as/extras/hornetq
   ant

4. Extract the brms-VERSION-deployable.zip using the ZIP tool of your choice.   Five separate zip files should be extracted, giving you jboss-brms-engine.zip, jboss-brms-manager.zip, jboss-brms-console.zip, jboss-brms-engine.zip, and modeshape.zip.

5. Unzip the jboss-jbpm-console.zip using the ZIP tool of your choice.    Four WAR directories should be created - business-central.war, designer.war, business-central-server.war, and jbpm-human-task.war.    Only the business-central.war, business-central-server.war and the jbpm-human-task.war are required.     Install these three WARs by copying their directories into the server/<profile>/deploy directory of your application.

6. Edit the business-central-server.war/WEB-INF/jboss-web.xml and change the line :

   <security-domain>java:/jaas/brms</security-domain>

to

   <security-domain>java:/jaas/jmx-console</security-domain>

or, if you have a custom security-domain for your users and groups, please supply it here. 

7. Copy jbpm5.esb from the soa-p-VERSION-jbpm5.zip to server/<PROFILE>/deploy.

8. Copy the bpm5processor quickstart to SOA-ROOT/jboss-as/samples/quickstarts.     Follow the instructions in the bpm5processor readme to run the quickstart.
 

Creating and using a service repository
================================================= 
1.  The directions for creating and using a service repository assume that you have followed the directions above to create a SOA-P installation with the BRMS deployable installed.

2.  Create the repository :

    cd soa-jbpm5/repository/JBossESB

3.  Edit the build.properties file and change the soa-home property to match the location of your SOA-P installation.

    Example : 
    soa-home=/Users/tcunning/Downloads/jboss-soa-p-5/jboss-as
 
4.  Execute the ant script : 
    
    ant

5.  Follow the directions in the JBPM User Guide for importing from a Service Repository.    When doing a Configure->Import jBPM Services, use the soa-jbpm5/repository directory as your base repository directory.

6.  Add the newly-added JARs in lib to your classpath.

7.  Add the following files to src/main/resources of your project : 

    soa-jbpm5/repository/JBossESB/resources/jbossesb-properties.xml
    soa-jbpm5/repository/JBossESB/resources/META-INF/uddi.xml

8.  The JBossESB service should be available to you in the BPMN2 editor.
