Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Attribute

Description

nodes

The list of OpenSpecimen nodes in the cluster.

  1. The name attribute identifies the node (same as that specified in openspecimen.properties).

  2. The URL attribute specifies the HTTP URL of the node's Tomcat to use for sending the cluster related events/notifications.

secret

A secret known only to the OpenSpecimen nodes. Used for trusted communication between the nodes in the cluster.

notifTimeout

Max. amount of time, in seconds, that a node waits for receiving the acknowledgement from the other nodes in the cluster for its broadcast event.

notifErrorRcpts

Comma separated list of email IDs to whom the cluster error notifications are sent.

Startup Sequence

The preferred way to startup the nodes in cluster is to start one node at a time, ensure the node is up and functional, and then move on to the next node in the cluster. Do not attempt to start all nodes of the cluster at the same time.

Upgrading

A small amount of downtime is required for smooth upgrade of OpenSpecimen. When upgrading, bring down all the nodes. Upgrade one node at a time, ensure the node is up and functional, and then move on to upgrade the next node in the cluster. Do not attempt to run multiple version of OpenSpecimen against the same database schema. The behaviour is unspecified.