Chapter 3. Migrating from Red Hat JBoss BPM Suite 6.x to a later version

3.1. Migrating from 6.1.x to 6.2

3.1.1. Migrating Client Application APIs from 6.1.x to 6.2

In this section we will discuss the migration steps that are specific to migrating from Red Hat JBoss BPM Suite 6.1.x to 6.2. While the majority of settings and API have remained the same the differences are highlighted below.

jBPM Executor (embedded mode)

The jBPM Executor has now been exposed as a public API available in the KIE API. In the event that the jbpm-executor service was in use previously, with embedded environments, it is recommended to now create the jBPM Executor using the API.

Deprecated methods

The TaskSummary.getPotentialOwners() is now deprecated and slated for removal.

Update IDs from primitive types

Many IDs were changed from the primtive long to the Object Long. While Java can perform auto-casting of these primitive types it is recommended to update any uses of the following methods to avoid potential issues: 
org.kie.api.task.model.Content.getId();
org.kie.api.task.model.TaskData.getOutputContentId();
org.kie.api.task.TaskService.addComment();

3.1.2. Migrating Business Central Project, Repository, and Artifacts from 6.1.x to 6.2

The recommended method of upgrading the Red Hat JBoss BPM Suite 6.1.x git projects (.niogit folder) and maven local dependencies (bin/repositories is to copy over these directories to the new installation. This process will copy over all projects and artifacts.

Procedure 3.1. Migrate the Git Repository

  1. Turn off JBoss BPM Suite 6.1.x and 6.2 instances.
  2. Navigate to the .niogit directory, found in the home directory of the JBoss BPM Suite 6.1 installation.
  3. Copy this directory, and any subdirectories, to the .niogit directory of the JBoss BPM Suite 6.2 installation: 
    cp -R ./ $BPM_6.2_INSTALLATION/.niogit/

Procedure 3.2. Migrate the Maven Repository

  1. Turn off JBoss BPM Suite 6.1.x and 6.2 instances.
  2. Navigate to the repositories directory, found in the home directory of the JBoss BPM Suite 6.1 installation.
  3. Copy this directory, and any subdirectories, to the repositories directory of the JBoss BPM Suite 6.2 installation: 
    cp -R ./ $BPM_6.2_INSTALLATION/repositories/

3.1.3. Upgrading the Database from 6.1.x to 6.2

Ensure the database has been upgraded as documented in Section 3.4, “Database Migration for 6.x Instances”.