Skip to main content Skip to complementary content

Activating the graceful reboot process of Remote Engine

Activate graceful reboot to help appropriately terminate orphan Job processes of a task run after an engine crash.

An engine crash often leads to uncontrolled termination of task runs, leaving sub-processes of these task runs in an orphaned state, in which they continue to run indefinitely.

The graceful reboot helps correctly identify and kill these orphaned processes, when the crashed engine is restarted.

Before you begin

  • Your Remote Engine version must be v2.12.14 onwards.

About this task

To activate graceful reboot, do the following:

Procedure

  1. Stop the engine. See Running the graceful shutdown process of Remote Engine for more details.
  2. In the <RE_installation>/etc/system.properties configuration file, change the value of handle.engine.restart from false to true.
    handle.engine.restart = true
  3. Restart the engine.

Results

If your engine crashes, when it is restarted, it proceeds to identify the orphaned execution processes to terminate them and write logs of the related operations in <RE_installation>/data/log/engine-post-restart-script.log.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here