Clustering Guidelines

Best practices for multiple node configuration.

When configuring multiple nodes in a cluster:
  • All nodes in a cluster require the same cache name and password to access the cache.
  • All nodes must have unique names specified in their cluster configuration files. Names are case-insensitive.
  • Define no more than one manager for every host, in every cluster.
  • Set a common base directory for projects. This allows all project log store files to save to a common location.
  • Set a common persistence directory across all managers in a cluster. If one manager node in a cluster is enabled for persistence, all managers must be enabled for persistence.
  • Reference common security files. All nodes must have the same security configuration. All nodes require a keystore, regardless of authentication mode. The keystore file must be shared among all nodes in the cluster.
    Note: When deploying a new user key, the node to which the deploy command is sent updates the keystore, and the other nodes then reload that file. To test if the deploy key is working properly, log in to the cluster with the new key, but through a different node.