Workflow Engine Migration Guide

Default Workflows

All default Workflows are automatically migrated to the new Matrix42 Worker workflow engine and delivered out-of-the-box with the Product Update to 10.1.1. In this case, no additional license certificate or configuration is required.

Custom Workflows

For custom Workflows, the "Set Execution Engine" action needs to be executed. When the Matrix42 Worker engine proves its reliability in all possible scenarios and AppFabric will be finally removed from the Product (approx. in version 11), then all Workflows that are present in the Product will be marked automatically as executed on Worker.

Action "Set Execution Engine" for the Workflow

By default, all the Workflows present in the Workflow Repository run on the AppFabric engine. But an Administrator is able to define the execution for the specific Workflow(s).

In the Workflow Management area, select one or several workflow definitions and start the "Set Execution Engine" action:

Custom Workflow with default Activities

To migrate a custom Workflow that uses default Workflow Activities to Matrix42 Workers technology:

1. Open Administration application;
2. Proceed to Services & Processes Navigation Item → Workflows → Manage Workflows;
3. Filter by custom Workflows: all Workflows that were not shipped by default with DWP are marked as System=False:
   

4. Choose the custom Workflow that still runs on AppFabric:
   

5. Run Set Execution Engine action:
   

6. Mark the Workflow as Worker Compatible:
   

7. Workflow Engine was successfully changed:
   

In case the Matrix42 Worker engine is set, the System checks the selected Workflows and proves that all the Workflow Activities used in Workflows are compatible with the Matrix42 Worker.

Custom Workflow with non-default Activities

To migrate a custom Workflow that uses custom Workflow Activities to Matrix42 Workers technology repeat the same steps as described in the previous section for the custom Workflow that uses default Workflow Activities and additionally migrate the incompatible Workflow Activities:

1. Open Administration application;
2. Proceed to Services & Processes Navigation Item → Workflows → Manage Workflows;
3. Filter by custom Workflows: all Workflows that were not shipped by default with DWP are marked as System=False;
4. Choose the custom Workflow that still runs on AppFabric;
5. Run Set Execution Engine action;
6. Mark the Workflow as Worker Compatible.

   In case at least one Activity is incompatible, the set engine operations for such workflows are rejected and mentioned activities need to be reworked, and the compatible flag for the activity set:

   

7.  Migrate incompatible Workflow Activities as described in Workflow Activities Migration Guide.

8.  Run Set Execution Engine action once again to change the Workflow with migrated Workflow Activities to Worker Compatible.

9. Test the Workflow.