Managing Recoverable Process Instances

A checkpoint saves the state of a process instance at a given point in time. Checkpoints are used to restart or recover a process instance either when an engine fails or if the process instance fails by encountering an unhandled exception or by manual termination in TIBCO Administrator or TIBCO Hawk.

In the event of an engine failure, by default all process instances executing at the time of the failure are automatically restarted and begin executing from the last checkpoint. You can optionally specify that process instances should not be automatically restarted when the engine restarts. This allows you to handle any resource availability problems, such as a database or web server being down, and then later recover the process instances manually when the resource is available. To specify that checkpointed process instances should not automatically restart when a process engine restarts, set the custom property bw.engine.autoCheckpointRestart to false.

Normally, when a process instance fails, checkpoint data for the process instance is deleted. You can optionally specify that checkpoint data should be saved for terminated process instances so that the process instance can be recovered at a later time. You can enable failed process recovery by setting the custom property bw.engine.enableJobRecovery to true. For more information about setting custom properties, see Custom Engine Properties.

You can manage recoverable processes either through TIBCO Administrator, TIBCO Hawk, or programmatically using the Engine Command activity in a process instance. This section describes how to manage recoverable process instances using TIBCO Administrator.

For more information about using TIBCO Hawk microagent methods, see Performance Tuning .

For more information about using the Engine Command activity, see TIBCO ActiveMatrix BusinessWorks™ Palette Reference.

To manage and restart recoverable process instances, perform this procedure:

Procedure 

1. Under Application Management, select All Service Instances or go directly to a specific application and select All Service Instances.
2. Click a process engine name.
3. Click the BW Processes tab.
4. Select Recoverable Processes from the drop-down menu.
5. Check the box next to the process instances you wish to manage. Click the Restart button to restart the process instances or click the Remove button to remove the process instances from the list of recoverable processes.