Introduction

The Controller's journal holds information about scheduling objects such as workflows, jobs and orders:

• scheduling objects are deployed from JOC Cockpit to a Controller.
• orders are submitted to indicate the start time of workflows.

The Controller's journal is available from a number of files in the following location:

• Unix: /var/sos-berlin.com/js7/controller/state
• Windows: C:\ProgramData\sos-berlin.com\js7\controller\state
• Users can choose different locations when setting up a Controller.

When a Controller's journal is deleted or damaged then this indicates severe loss:

• Consider that loss of a Controller's journal includes that
  • any scheduling objects such as workflows have to be re-deployed,
  • any orders of the Daily Plan have to be re-submitted,
  • any currently running orders are lost and no information about orders and the execution status of jobs is available.
• See JS7 - FAQ - What happens to workflows in case of outage of a Controller?
• Use of a Controller cluster will leverage such a situation as the standby Controller instance operates a synchronized copy of the journal and will pick up operations immediately during fail-over after 3-5s. The failed Controller instance can be started later on and will automatically synchronize with the then active Controller instance.

Initial Operation

Find information from the JS7 - How to troubleshoot Controller Cluster Initial Operation article.

Ongoing Operation

Scenarios in this section apply after a Controller has been successfully registered with JOC Cockpit during JS7 - Initial Operation.

Loss of Controller Journal

• Problem: If initial operation is successfully completed for a Controller and due to some weird reason the Controller instance's journal later on is deleted then this requires to register the Controller once again from JOC Cockpit. 
• Solution: This problem can be resolved by restarting the Controller. The Controller will start a new journal. In the JOC Cockpit "Manage Controllers/Agents" page use the "Edit" action menu of the Controller and submit the same settings. This operation will connect JOC Cockpit to the Controller. Registration of existing Agents is automatically repeated. Then redeploy any scheduling objects to the Controller from the JOC Cockpit Configuration view.
• Implication: This operation includes to loose information about past job executions that have not yet been added to the JOC Cockpit history.

Damage to Controller Journal

There is no difference in troubleshooting to the situation of loss of a Controller journal except for the fact that users should remove the journal files from the JS7_CONTROLLER_DATA/state directory before starting the Controller instance.