Network configuration jBPM5.4 (with Bug Fixes)

Version 2

    To enable network access to jBPM 5.4, you must perform the following steps:

     

    • Validate properly installed Java JDK+1.5 and Ant+1.7
    • Download jbpm-5.4.0.Final-installer-full.zip (from JBoss jBPM Site)
    • unzip folder
    • Enter to folder /jbpm-installer
    • Edit file standalone.xml (modified to make red-labeled)
      • <subsystem xmlns="urn:jboss:domain:web:1.1" default-virtual-server="default-host" native="false">
        <connector name="http" protocol="HTTP/1.1" scheme="http" socket-binding="http"/>
        <virtual-server name="default-host" enable-welcome-root="true">
        <alias name="0.0.0.0"/>
        </virtual-server>
        </subsystem>
      • <subsystem xmlns="urn:jboss:domain:webservices:1.1">
        <modify-wsdl-address>true</modify-wsdl-address>
        <wsdl-host>${jboss.bind.address:0.0.0.0}</wsdl-host>
        <endpoint-config name="Standard-Endpoint-Config"/>
        <endpoint-config name="Recording-Endpoint-Config">
        <pre-handler-chain name="recording-handlers" protocol-bindings="##SOAP11_HTTP ##SOAP11_HTTP_MTOM ##SOAP12_HTTP ##SOAP12_HTTP_MTOM">
        <handler name="RecordingHandler" class="org.jboss.ws.common.invocation.RecordingServerHandler"/>
        </pre-handler-chain>
        </endpoint-config>
        </subsystem>
      • <interfaces>
        <interface name="management">
        <inet-address value="${jboss.bind.address.management:0.0.0.0}"/>
        </interface>
        <interface name="public">
        <inet-address value="${jboss.bind.address:0.0.0.0}"/>
        </interface>
        <interface name="unsecure">
        <inet-address value="${jboss.bind.address.unsecure:0.0.0.0}"/>
        </interface>
        </interfaces>
    • Edit file build.xml (with bug corrections Definition persistence configuration)
      • <property name="jboss.bind.address" value="0.0.0.0" />
      • <!-- Install gwt-console -->
        <target name="install.jBPM-gwt-console.into.jboss" depends="download.db.driver,download.jBPM.gwt-console">
        <antcall target="install.jBPM-gwt-console.into.jboss5" />
        <antcall target="install.jBPM-gwt-console.into.jboss7" />
        </target>
        <target name="install.jBPM-gwt-console.into.jboss7" depends="check.jboss.version" if="jboss.version.is.7">
        <!-- download reporting -->
        <antcall target="download.birt.as7" />
        <!-- gwt-console -->
        <mkdir dir="${install.home}/target"/>
        <mkdir dir="${install.home}/target/jbpm-gwt-console-server-war"/>
        <unzip src="${install.home}/lib/jbpm-gwt-console-server-${jBPM.version}-${deployment.version}.war"
        dest="${install.home}/target/jbpm-gwt-console-server-war"/>
        <copy todir="${install.home}/target/jbpm-gwt-console-server-war/WEB-INF/lib" overwrite="true">
        <fileset dir="${install.home}/db/driver"/>
        </copy>
        <!-- Other configuration like work item handlers -->
        <copy todir="${install.home}/target/jbpm-gwt-console-server-war/WEB-INF/classes" overwrite="true">
        <fileset dir="${install.home}/conf"/>
        </copy>
        <!-- copy user defined persistence configuration if exists -->
        <copy tofile="${install.home}/target/jbpm-gwt-console-server-war/WEB-INF/classes/META-INF/persistence.xml" overwrite="true"
        file="${install.home}/db/jbpm-persistence-JPA2.xml" failonerror="false"/>
        <copy tofile="${install.home}/target/jbpm-gwt-console-server-war/WEB-INF/classes/META-INF/ProcessInstanceInfoMapping.xml" overwrite="true"
        file="${install.home}/db/ProcessInstanceInfoMapping.xml" failonerror="false"/>
      • <!-- install reporting -->
        <antcall target="install.reporting.into.jboss7" />
        <!-- install dependencies -->
        <antcall target="install.dependencies" />
        <zip basedir="${install.home}/target/jbpm-gwt-console-server-war"
        destfile="${install.home}/target/jbpm-gwt-console-server-${jBPM.version}.war"/>
        <copy file="${install.home}/target/jbpm-gwt-console-server-${jBPM.version}.war"
        tofile="${jboss.server.deploy.dir}/jbpm-gwt-console-server.war"
        overwrite="true" />
        <copy file="${install.home}/lib/jbpm-gwt-console-${jBPM.version}.war"
        tofile="${jboss.server.deploy.dir}/jbpm-gwt-console.war"
        overwrite="true" />
        <delete dir="${install.home}/target"/>
        <copy file="${install.home}/standalone.xml"
        tofile="${jboss.home}/standalone/configuration/standalone.xml"
        overwrite="true" />
        <!-- authentication configuration -->
        <copy file="${install.home}/auth/users.properties"
        tofile="${jboss.server.conf.dir}/users.properties"
        overwrite="true" />
        <copy file="${install.home}/auth/roles.properties"
        tofile="${jboss.server.conf.dir}/roles.properties"
        overwrite="true" />
        </target>
        <target name="install.jBPM-gwt-console.into.jboss5" depends="check.jboss.version,install.transport.lib" unless="jboss.version.is.7">
        <!-- download reporting -->
        <antcall target="download.birt.as5" />
        <!-- gwt-console -->
        <mkdir dir="${install.home}/target"/>
        <mkdir dir="${install.home}/target/jbpm-gwt-console-server-war"/>
        <unzip src="${install.home}/lib/jbpm-gwt-console-server-${jBPM.version}-${deployment.version}.war"
        dest="${install.home}/target/jbpm-gwt-console-server-war"/>
        <!-- Other configuration like work item handlers -->
        <copy todir="${install.home}/target/jbpm-gwt-console-server-war/WEB-INF/classes" overwrite="true">
        <fileset dir="${install.home}/conf"/>
        </copy>
        <!-- copy user defined persistence configuration if exists -->
        <copy tofile="${install.home}/target/jbpm-gwt-console-server-war/WEB-INF/classes/META-INF/persistence.xml" overwrite="true"
        file="${install.home}/db/jbpm-persistence-JPA2.xml" failonerror="false"/>
        <copy tofile="${install.home}/target/jbpm-gwt-console-server-war/WEB-INF/classes/META-INF/ProcessInstanceInfoMapping.xml" overwrite="true"
        file="${install.home}/db/ProcessInstanceInfo.hbm.xml" failonerror="false"/>
      • <!-- Install jbpm human task war -->
        <target name="install.ht.war.into.jboss7" if="jboss.version.is.7">
        <mkdir dir="${install.home}/target"/>
        <mkdir dir="${install.home}/target/jbpm-human-task-war"/>
        <unzip src="${install.home}/lib/jbpm-human-task-war-${jBPM.version}-${deployment.version}.war" dest="${install.home}/target/jbpm-human-task-war" />
        <copy file="${install.home}/task-service/resources/war/web.xml"
        tofile="${install.home}/target/jbpm-human-task-war/WEB-INF/web.xml"
        overwrite="true" />
        <!-- copy user defined persistence configuration if exists -->
        <copy tofile="${install.home}/target/jbpm-human-task-war/WEB-INF/classes/META-INF/persistence.xml" overwrite="true"
        file="${install.home}/db/task-persistence-JPA2.xml" failonerror="false"/>
        <copy tofile="${install.home}/target/jbpm-human-task-war/WEB-INF/classes/META-INF/ProcessInstanceInfoMapping.xml" overwrite="true"
        file="${install.home}/db/Taskorm-JPA2.xml" failonerror="false"/>
        <zip basedir="${install.home}/target/jbpm-human-task-war"
        destfile="${install.home}/target/jbpm-${jBPM.version}-human-task-war.war" />
        <copy file="${install.home}/target/jbpm-${jBPM.version}-human-task-war.war"
        tofile="${jboss.server.deploy.dir}/jbpm-human-task-war.war"
        overwrite="true" />
        <delete dir="${install.home}/target" />
        </target>
    • Enter to folder /conf
    • Edit file default.jbpm.console.properties
      • jbpm.console.server.host=0.0.0.0
        jbpm.console.server.port=8080
        jbpm.console.task.service.strategy=HornetQ
        jbpm.console.task.service.host=0.0.0.0
        jbpm.console.task.service.port=5153
        jbpm.console.directory=
        guvnor.protocol=http
        guvnor.host=0.0.0.0:8080
        guvnor.subdomain=drools-guvnor
        guvnor.usr=admin
        guvnor.pwd=admin
        guvnor.packages=
        guvnor.connect.timeout=10000
        guvnor.read.timeout=10000
        guvnor.snapshot.name=LATEST
    • Edit file guvnor.preferences.propierties
      • #Designer configuration
        designer.url=http://0.0.0.0:8080
        #Do not change this unless you know what are you doing
        designer.context=designer
        designer.profile=jbpm
        #FormBuilder configuration
        #Do not change this unless you know what are you doing
        formbuilder.url=http://0.0.0.0:8080
        formbuilder.context=jbpm-form-builder
        formbuilder.profile=guvnor
    • Back to folder /jbpm-installer
    • run command: ant install.demo.noeclipse
    • run command: ant start.demo.noeclipse
    • Verify access URL: http://0.0.0.0:8080
    • Access jBPM console: http://0.0.0.0:8080/jbpm-console/app.html
    • Access Drools-Guvnor: http://0.0.0.0:8080/drools-guvnor/

    Done.