...

• Initial Operation is performed after installation of JS7 Controller, Agent and JOC Cockpit as described in the JS7 - Initial Operation article.
• In the event of issues while registering the Controllers, the Controller will not be able to submit the job-related configurations to Agents. In addition, the execution of workflows that include jobs running on a number of Agents will not be possible, as the switching of Agents during workflow execution is performed by the customer and forwarded by the controllerController.

Troubleshooting

After registering the Controller its status can be checked from the JS7 - Dashboard. When registering a Controller a number of misconfigurations can occur.

...

• Problem: If the Secondary Controller instance is not configured for use with a Cluster but runs as a standalone instance then the Primary Controller instance's logs include error messages such as:
  • 2022-01-27T00:00:08,669 WARN js7.cluster.ClusterCommon - 'ClusterStartBackupNode' command failed with HTTP 400 Bad Request: POST http://example.com:4444/controller/api/command => ClusterNodeIsNotBackup: The cluster node to be appointed is not configured as a backup node
  • This error message will also be noted in the JOC Cockpit's log file, e.g. in the JS7_JOC_DATA/logs/joc.log file - see the JS7 - Log Files and Locations article.
• Solution: The Secondary Controller is missing the following setting in its JS7_CONTROLLER_DATA/config/controller.conf file - see the JS7 - Initial Operation for Controller Cluster, chapter: Check Cluster Settings article: 
  • js7.journal.cluster.node.is-backup=yes
  • Due to the missing setting the Secondary Controller now is acting as a standalone instance which is a different operating mode. To initialize the Secondary Controller instance for cluster operation apply the following steps:
    • Shutdown the Secondary Controller instance.
    • Delete the contents of the Secondary Controller instance's JS7_CONTROLLER_DATA/state directory.
    • Start the Secondary Controller instance.
    • In the JOC Cockpit GUI navigate to the User Menu->Manage Controllers/Agents page. Edit the Controller entry, check the connection status from the available buttons and submit. As a result the JOC Cockpit will forward this information to both Controller instances.
    • IF If the Controller instances are not coupled after approx. 120s then:
      • Shut down the Primary Controller instance.
      • Delete the contents of the Secondary Controller instance's JS7_CONTROLLER_DATA/state directory.
      • Shut down the Cluster Watch Agent.
      • Delete the contents of the Cluster Watch Agent's JS7_AGENT_DATA/state directory.
      • Start the Cluster Watch Agent.
      • Start the Primary Controller instance.
      • Coupling of Controller instances should occur within 60s.

...