Update from 7.0 to 7.1

Reading the Guide

This guide uses a number of variables to denote common path names and constants:

*$DATABASE expresses the target database platform, e.g., DB2, MySql, etc. *$DISTRIBUTION_PATH represents the path of the downloaded pre-packaged Camunda 7 distribution, e.g., camunda-bpm-tomcat-$PLATFORM_VERSION.zip or camunda-bpm-tomcat-$PLATFORM_VERSION.tar.gz for Tomcat etc. *$PLATFORM_VERSION denotes the version of Camunda 7 you want to install, e.g., 7.1.0.

Migrate Your Database

For migration from Camunda 7.0 to Camunda 7.1, the provided update scripts that match your database have to be executed. With a pre-packaged distribution, the update scripts are located in the folder $DISTRIBUTION_PATH/sql/upgrade.

Check for available database patch scripts for an overview of available sql patch scripts to see if there are any for your current version.

Regardless of the version you are migrating from, the main update script is $DATABASE_engine_7.0_to_7.1.sql and has to be executed next.

Migrate Your Process Application

To migrate your process application from Camunda 7.0 to Camunda 7.1, you need to follow these steps:

  • If you use @Inject with TaskForm, you have to add a @Named("...") annotation to the @Inject annotation due to backward-compatibility of camunda.taskForm. There you have two choices: If you are using camunda.taskForm in your process application and don’t want to update all your jsf pages and beans you should use @Named("camunda.taskForm"), otherwise you should use @Named("camundaTaskForm"). Your application server should write an error or a warning if you use the wrong one. So be careful! However, we recommend that you use the annotation @Named("camundaTaskForm").

Migrate the Server

JBoss AS 7.1.3 to 7.2.0

Update the JBoss Application Server

Camunda 7.1 ships with a new version of the JBoss AS 7, namely, 7.2.0. The preferred update steps are:

  • copy all your custom modules / subsystems to the new JBoss server directory
  • re-add all your custom modifications from the existing $CAMUNDA_HOME/standalone/configuration/standalone.xml to the new one located in the new JBoss server directory.
  • copy all deployed datasources to the new JBoss server directory
  • undeploy all process applications and copy them to the new JBoss server directory for redeployment

On this Page: