Update a WildFly / JBoss EAP Installation from 7.22 to 7.23

The following steps describe how to update the ASEE Flow artifacts on a WildFly/JBoss EAP in a shared process engine scenario. Throughout the procedure, refer to the update guide. If not already done, download accordingly:

• For WildFly / JBoss EAP 8 - the ASEE Flow WildFly distribution.
• For JBoss EAP 7 - the camunda-wildfly26-modules.

The update procedure takes the following steps:

1. Update the ASEE Flow modules.
2. Update optional ASEE Flow modules.
3. Update ASEE Flow web applications.

Whenever the instructions are to replace a module, delete the previous version of the module first to avoid orphan jars.

​

1. Update the ASEE Flow modules

Replace the following modules from the folder $WILDFLY_HOME/modules/ with the new versions from the folder $WILDFLY_DISTRIBUTION/modules/:

• org/camunda/bpm/camunda-engine
• org/camunda/bpm/wildfly/camunda-wildfly-subsystem
• org/camunda/bpm/model/camunda-bpmn-model
• org/camunda/bpm/model/camunda-cmmn-model
• org/camunda/bpm/model/camunda-dmn-model
• org/camunda/bpm/model/camunda-xml-model
• org/camunda/bpm/dmn/camunda-engine-dmn
• org/camunda/bpm/dmn/camunda-engine-feel-api
• org/camunda/bpm/dmn/camunda-engine-feel-juel
• org/camunda/bpm/dmn/camunda-engine-feel-scala
• org/camunda/bpm/juel/camunda-juel
• org/camunda/template-engines/camunda-template-engines-freemarker
• org/camunda/commons/camunda-commons-logging
• org/camunda/commons/camunda-commons-typed-values
• org/camunda/commons/camunda-commons-utils
• org/camunda/connect/camunda-connect-core
• org/camunda/connect/camunda-connect-http-client
• org/camunda/connect/camunda-connect-soap-http-client
• org/camunda/feel/feel-engine
• org/apache/httpcomponents/httpclient
• org/apache/httpcomponents/httpcore
• org/freemarker/freemarker
• org/mybatis/mybatis
• commons-codec/commons-codec
• org/graalvm/js/js
• org/graalvm/js/js-scriptengine
• org/graalvm/regex/regex
• org/graalvm/sdk/graal-sdk
• org/graalvm/truffle/truffle-api
• com/ibm/icu/icu4j

​

2. Update optional ASEE Flow modules

In addition to the core modules, there may be optional artifacts in $WILDFLY_HOME/modules/ for LDAP integration, ASEE Flow Connect, ASEE Flow Spin, Groovy and Graal scripting. If you use any of these extensions, the following update steps apply:

​

LDAP integration

Replace the following module from the folder $WILDFLY_HOME/modules/ with its new version from the folder $WILDFLY_DISTRIBUTION/modules/, if present:

• org/camunda/bpm/identity/camunda-identity-ldap

​

ASEE Flow Connect plugin

Replace the following modules from the folder $WILDFLY_HOME/modules/ with the new versions from the folder $WILDFLY_DISTRIBUTION/modules/, if present:

• org/camunda/bpm/camunda-engine-plugin-connect

​

ASEE Flow Spin

Replace the following modules from the folder $WILDFLY_HOME/modules/ with the new versions from the folder $WILDFLY_DISTRIBUTION/modules/, if present:

• org/camunda/spin/camunda-spin-core
• org/camunda/spin/camunda-spin-dataformat-json-jackson
• org/camunda/spin/camunda-spin-dataformat-xml-dom-jakarta
  • Heads-up: add this module only for WildFly / JBoss EAP 8.
• org/camunda/spin/camunda-spin-dataformat-xml-dom
  • Heads-up: add this module only for JBoss EAP 7.
• org/camunda/bpm/camunda-engine-plugin-spin

Additionally, replace the following dependent modules:

• com/fasterxml/jackson/core/jackson-annotations
• com/fasterxml/jackson/core/jackson-core
• com/fasterxml/jackson/core/jackson-databind
• com/jayway/jsonpath/json-path
• net/minidev/accessors-smart
• net/minidev/json-smart

​

GraalVM JavaScript

Replace the following modules from the folder $WILDFLY_HOME/modules/ with the following modules from the folder $WILDFLY_DISTRIBUTION/modules/, if present:

• com/ibm/icu/icu4j
• org/graalvm/js/js
• org/graalvm/js/js-scriptengine
• org/graalvm/regex/regex
• org/graalvm/sdk/graal-sdk
• org/graalvm/truffle/truffle-api

​

Groovy

Replace the following modules from the folder $WILDFLY_HOME/modules/ with the following modules from the folder $WILDFLY_DISTRIBUTION/modules/, if present:

• org/codehaus/groovy/groovy-all
• org/codehaus/groovy/groovy
• org/codehaus/groovy/groovy-jsr223
• org/codehaus/groovy/groovy-json
• org/codehaus/groovy/groovy-xml
• org/codehaus/groovy/groovy-templates

​

3. Update ASEE Flow web applications

​

Update REST API

The following steps are required to update the ASEE Flow REST API on a JBoss/WildFly instance:

1. Undeploy an existing web application with a name like camunda-engine-rest.
2. Download the REST API web application archive from our Maven Artifactory. Alternatively, switch to the private repository for the enterprise version (credentials from license required).
   • For WildFly / JBoss EAP 8, the name of the artifact is $PLATFORM_VERSION/camunda-engine-rest-jakarta-$PLATFORM_VERSION-wildfly.war.
   • For JBoss EAP 7, the name of the artifact is $PLATFORM_VERSION/camunda-engine-rest-$PLATFORM_VERSION-wildfly.war.
3. Deploy the web application archive to your JBoss/WildFly instance.

​

Update Cockpit, Tasklist, and Admin

The following steps are required to update the ASEE Flow web applications Cockpit, Tasklist, and Admin on a JBoss/WildFly instance:

1. Un-deploy an existing web application with a name like camunda-webapp.
2. Download the ASEE Flow web application that contains the web applications from our Maven Artifactory. Alternatively, switch to the private repository for the enterprise version (credentials from license required).
   • For WildFly / JBoss EAP 8, the name of the artifact is $PLATFORM_VERSION/camunda-webapp-wildfly-$PLATFORM_VERSION.war.
   • For JBoss EAP 7, the name of the artifact is $PLATFORM_VERSION/camunda-webapp-jboss-$PLATFORM_VERSION.war.
3. Deploy the web application archive to your JBoss/WildFly instance.