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 Platform distribution, e.g.,
camunda-bpm-tomcat-$PLATFORM_VERSION.tar.gz for Tomcat etc.
$PLATFORM_VERSION denotes the version of the Camunda Platform you want to install, e.g.,
Migrate Your Database
For migration from Camunda Platform 7.0 to Camunda Platform 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
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 Platform 7.0 to Camunda Platform 7.1, you need to follow these steps:
- If you use
@Injectwith TaskForm, you have to add a
@Named("...")annotation to the
@Injectannotation due to backward-compatibility of
camunda.taskForm. There you have two choices: If you are using
camunda.taskFormin 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
Migrate the Server
JBoss AS 7.1.3 to 7.2.0
Update the JBoss Application Server
Camunda Platform 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.xmlto 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