Clustering Guidelines

Best practices for multiple node configuration.

When configuring multiple nodes in a cluster:
  • Set the same cache name and password for all nodes in a cluster to access the cache.
  • Specify unique names for all nodes in their cluster configuration files.
  • 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. All manager nodes in a cluster share common configuration files, including keystore files, LDAP, Kerberos, and RSA files. These common files must reside in a shared location that all nodes in the cluster can access.
    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.