Move the running instances of a process application from one snapshot to another on IBM Business Automation Workflow - the REST
replacement of BPMMigrateInstances / BPMCheckOrphanTokens for traditional BAW and CP4BA (no wsadmin). A process application built
from out-of-the-box building blocks only (UI Toolkit, client-side human service, business objects, Ajax service flows on the Operations
REST API /ops and the Process REST API v2 /bpm; no scripts in the views, no third-party toolkit), on the REST machinery of
Process Tools REST.
| Tab | Content | Actions |
|---|---|---|
| Snapshots | the snapshots of an application (named snapshots of every track and the track tips) with their running / suspended / failed instance counts; the instances of the selected snapshot | Lookup, Instances of snapshot, Use as source, Use as target, Export CSV |
| Migrate | application, source and target snapshot; URL, status and result of the queued operation | Check orphans (the orphan token policy as XML), Migrate instances (confirmation), Refresh status |
How it works. GET /ops/std/bpm/containers/{acr}?optional_parts=branches,versions and GET /ops/std/bpm/processes/count build
the snapshot table; GET /bpm/processes?containers=&versions=&states=running,suspended,stopped lists a snapshot's instances;
POST /ops/std/bpm/containers/check_orphans returns the orphan token policy; POST /ops/std/bpm/containers/migrate is sent as
multipart/form-data with that policy file (the server requires the part) and answers the URL of the queued operation, followed with
GET /ops/system/queue/{id}. The migration moves running, suspended and failed instances and deactivates the source snapshot.
| File | Target | Notes |
|---|---|---|
packages/Instance-Migration-Console-1.0.twx |
traditional BAW / IBM BPM 8.6.x and later | process app Instance Migration Console (IMIGR) 1.0 |
packages/Triage-Sample-1.0.twx, 1.1 |
any | test fixture Triage Sample (TRGSMP): import both snapshots, activate them, start instances in 1.0 over REST (POST /rest/bpm/wle/v1/process?action=start&bpdId=&snapshotId=¶ms={"orderId":"1","amount":"50","failure":""}), migrate to 1.1 |
Dependencies: System Data and UI Toolkit only. The same files are attached to the releases. Verified on BAW 8.6.2 /
20.0.0.1 (Process Center, /ops 8.6.1.18002); the /ops resources are the same on BAW 24 and CP4BA - set the /bas context paths there.
- Import the package (Process Center console > Import Process App; CP4BA: Business Automation Studio > Business automations > Import).
- Environment variables:
serverBaseURL,restAuthUser/restAuthPassword(technical user of the server-side REST calls; the password ships empty - set it after the import),restTrustAllCertificates,opsHost/opsContextPath,bpmHost/bpmContextPath,csrfLoginPath,policyFileDirectory(server-side directory for the orphan policy file, default/tmp),appTitle,logoURL. - Expose the dashboard Instance Migration Console to the administrators.
docs/DESIGN.md - function, every REST call with the server's quirks (multipart migration, Accept header of the orphan check, tip snapshots, paging), environment variables. docs/TEST-LAB-8.6.2.md - the automated playback test (three fresh instances in the source snapshot, lookup, counts, instances, source / target pick, orphan check, migration, queue status, verification of the target snapshot over REST, CSV); screenshots in docs/screenshots.
The package is generated from a declarative build in a private workspace of Dosvak LLC; the design document mentions its tools by name.
Apache License 2.0 - see LICENSE and NOTICE. You may use, modify and redistribute this software, including in commercial products, provided the copyright notice, the license and the NOTICE file stay with every copy (attribution to Dosvak LLC).