Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Minor changes

...

  • The Cluster Service is used to operate a passive cluster of JOC Cockpit instances and to perform fail-over operations and switch-over operations between cluster members.
  • Any All other JS7 - Services depend on the Cluster Service in order to be started for the active JOC Cockpit instance.

...

The switch-over operation is technically similar to the fail-over operation, however, switch-over is caused by the GUI or by the API and allows the Cluster Service to normally stop any running background services that are running.

Configuration

Location

  • The "Settings" menu is available from in the JOC Cockpit GUI.

Configuration Items

SectionSettingDefaultRequiredPurpose
clusterheart_beat_exceeded_interval60noThe duration in seconds to signal that heartbeats from an active cluster member to the database did not arrive in time and that fail-over to the next passive cluster member should occur.

polling_interval30noThe interval in seconds for between sending heartbeats to the database.

polling_wait_interval_on_error2noThe interval in seconds to continue polling after an error has occurred, e.g. due to transactional concurrency etc.

switch_member_wait_counter_on_success10noThe number of retries to wait for the answer from the last active cluster member after its deactivation/activation.

switch_member_wait_interval_on_success5no

The maximum number of seconds to wait for a cluster member to become active.

max wait time = switch_member_wait_counter_on_success * switch_member_wait_interval_on_success +  execution time


switch_member_wait_counter_on_error10noThe maximum number of retries in case of errors, e.g. due to transactional concurrency etc., to switch the cluster to a different member.

switch_member_wait_interval_on_error2no

The maximum number of seconds to wait for a cluster member to become active after an error.

max wait time = switch_member_wait_counter_on_error*switchMemberWaitIntervalOnError+ execution time


current_is_cluster_membertruenoEnable cluster to switch to this instance.

...

  • The Cluster Service logs general messages, warnings and errors to the joc.log file.
  • More detailed information in addition is logged to the Main Log service-cluster.log file.
  • In addition to the Main Log, detailed debug information is logged to the Debug Log service-cluster-debug.log file.
  • For details see JS7 - Log Files and Locations

...