UpgradeProcess

A Guide to Version Upgrade of a Process Being Executed

RunaWFE Free Workflow System (BPMS) Version 4.5.0

© 2003 - 2015, Consulting Group Runa

© 2015 - 2024, "Process Technologies" Ltd, this document is available under GNU FDL license. RunaWFE Free is an open source system distributed under a LGPL license (http://www.gnu.org/licenses/lgpl.html).

# General Information

Upgrade of a version of an executing process to another version may be useful, for example, for correcting blocking errors. However, pay attention to the following note:

Version upgrade may cause unpredictable errors in case a new process definition differs greatly from the current one..

The parameter responsible for this feature - 'upgrade.process.to.definition.version.enabled is in the system.properties general settings file and since RunaWFE version 4.3.0 is set as true. So, in version 4.3.0 this feature is turned on by default.

# An illustration of upgrading one specific BP example to another version of process definition

Go to process definition properties, in the “Version” field the current version of the BP example is shown. Next to it there is an “Upgrade to definition version” link for version upgrade.

If you click the link, a table with the information on the available BP versions, which you can upgrade the current example to.

Select the necessary version and press “Ok”. On the screenshot below you can see that the current version of the BP example is “7”. The administrator chose version “5” to upgrade to.

If the upgrade is successful, the user will receive a corresponding message.

# An illustration of upgrading all examples of specific BP version being executed to another version

Open “Start process” menu entry, go to BP definition properties.

In the “Process definition” section the current version of the definition is shown. In the example above it is “8”.

In the “Process name” field there is a “History” link, which allows to open a page with detailed information on uploaded versions of this BP definition.

The table has “Name”, “Version”, “Description”, “Process type”, “Create date”, Created by”, “Update date”, “Updated by” and “Processes count” columns.

In the “Processes count” column “number of unfinished”/”total number” of BP examples having this version is shown.

To go to definition properties of a specific version use the “Properties” link of the corresponding string.

Let us consider an example of upgrade of all the “Action” BP examples being executed with version “2” to a new definition version.

Open BP definition history, go to version “2” properties. The “Redeploy process definition” section is designed for uploading a new BP version.

Press “Browse” and select a *.par process file. Enable the “Upgrade current version” option. It will allow you to upgrade the definition of the selected version (in this case version “2”) instead of uploading it as a next new version.

Press “Redeploy process definition”.

The definitions of all the “Action” BP examples with version “2” being executed will be upgraded.