PATCH NAME: RHPAM-4568
PRODUCT NAME: Red Hat Process Automation Manager
VERSION: 7.13.2
DESCRIPTION: One-off patch for RHPAM-4568:

• PIM tool allows to migrate process instances with different definitions from source migration plan https://issues.redhat.com/browse/RHPAM-4544
• kie-server rest API unable to use client certificates when not localhost- https://issues.redhat.com/browse/RHPAM-4389
• PIM integration with the upstream Quarkus File Vault - https://issues.redhat.com/browse/JBPM-10032

MANUAL INSTALL INSTRUCTIONS FOR ALL PLATFORMS:

1. Backup and remove the following jar:

kie-server-common-7.59.0.Final-redhat-00009.jar

from the following locations:

$SERVER_DEPLOYMENT_DIR/kie-server.war/WEB-INF/lib/
$SERVER_DEPLOYMENT_DIR/business-central/WEB-INF/lib/
$RHPAM_ENGINE/
$YOUR_OWN_APPLICATION_LIB/

3. Unzip the file jboss-rhba-7.12.1-RHPAM-4568.zip and copy:

RHPAM-4568/kie-server-common-7.59.0.Final-redhat-00009-RHPAM-4390.jar

to:

$SERVER_DEPLOYMENT_DIR/kie-server.war/WEB-INF/lib
$SERVER_DEPLOYMENT_DIR/business-central/WEB-INF/lib/
$RHPAM_ENGINE
$YOUR_OWN_APPLICATION_LIB

4. Backup and remove the process migration service zip file:
process-migration-service-7.59.0.Final-redhat-00009.zip

5. Replace it with the patched zip file:
process-migration-service-7.59.0.Final-redhat-00009-RHPAM-4568.zip

MANUAL INSTALL INSTRUCTIONS FOR MAVEN BASED PROJECTS:

1. Extract the attached zip (jboss-rhba-7.12.1-RHPAM-4568.zip) and change into the RHPAM-4568 directory

2. Run the following commands to install the patch binaries to the local maven repository:

mvn install:install-file -Dfile=kie-server-common-7.59.0.Final-redhat-00009-RHPAM-4390.jar -Dsources=kie-server-common-7.59.0.Final-redhat-00009-RHPAM-4390-sources.jar -DpomFile=kie-server-common-7.59.0.Final-redhat-00009-RHPAM-4390.pom -Dpackaging=jar

3. Override the original version of modified jars explicitly declaring them in <dependencyManagement> of your project pom.xml:

<dependency>
<groupId>org.kie.server</groupId>
<artifactId>kie-server-common</artifactId>
<version>7.59.0.Final-redhat-00009-RHPAM-4390</version>
</dependency>

ADDITIONAL INSTALL INSTRUCTIONS FOR ALL PLATFORMS:

Find and replace the files
kie-server-common-7.59.0.Final-redhat-00009.jar
process-migration-service-7.59.0.Final-redhat-00009.zip

with the patched files:
kie-server-common-7.59.0.Final-redhat-00009-RHPAM-4390.jar
process-migration-service-7.59.0.Final-redhat-00009-RHPAM-4568.zip

for all occurences of that file in your project.

HOW EXECUTION CHANGES

This patch can be verified with attached tester

tester for PIM tool filtering on process instances
Description
This reproducer shows new feature to filter process attempted to be migrated.

creates a kie server with two containers:

container1
human-task 1.0.0
other-human-task 1.0.0
container2
human-task 2.0.0
Then migrate human-task from version 1.0.0 to 2.0.0

Current behaviour
All process instances are try for migration

New behavious
Only process matching with source definition are migrated

Usage
run in one terminal:

postgres:
./run-postgres

kie server:
./run-kieserver 7.12.1

old PIM tool
./run-pim-tool-original.sh

Execute scripts:
$ ./create-process.sh
create instances human-task.human-task in container container1

created process instance: 1

create instances human-task.other-human-task in container container1

created process instance: 2

create instances human-task.human-task in container container2

created process instance: 3
```
$ ./migrate.sh

create migration plan

plan 1 created

running migration for 1

running 1 migration

show result for 1

{ "processInstanceId": 1, "status": true } { "processInstanceId": 2, "status": false } { "processInstanceId": 3, "status": false }

```

Stop old PIM tool and run new one:
./run-pim-tool-patched.sh

Execute scripts again:
```
$ ./create-process.sh
create instances human-task.human-task in container container1

created process instance: 4

create instances human-task.other-human-task in container container1

created process instance: 5

create instances human-task.human-task in container container2

created process instance: 6
$ ./migrate.sh

create migration plan

plan 1 created

running migration for 1

running 1 migration

show result for 1

{ "processInstanceId": 4, "status": true }

```

CREATOR:
Alberto Fanjul
DATE:
02-Nov-2022