Naming the Cluster

The setup script prompts you to enter a name for the OpenSearch cluster.

If you are performing a manual installation of OpenSearch, you need to enter a value for the cluster.name parameter in the opensearch.yml file.

A cluster is identified by a unique name. This name is important because a node can only be part of a cluster if the node is set up to join the cluster by its name. Make sure that you don’t reuse the same cluster names in different environments, otherwise you might end up with nodes joining the wrong cluster. For instance you could use logging-dev, logging-stage, and logging-prod for the development, staging, and production clusters.

Oracle PeopleSoft recommends a cluster with three nodes for high availability and to prevent a split-brain scenario. Then, depending on the hardware, memory availability, and search performance, you may add nodes to the existing cluster.

It is recommended to avoid having only two master-eligible nodes, since a quorum of two is two. Therefore, a loss of either master-eligible node will result in an inoperable cluster. To prevent the split-brain scenario, PeopleSoft recommends an odd number of nodes in the cluster, so configure the majority of nodes (total number of master-eligible nodes/ 2 + 1).