Adding a New Node to an Existing Cluster

As determined by your business requirements for high availability and disaster recovery, you will need to determine the number of nodes appropriate for your installation. In addition to high availability and disaster recovery, system CPU and memory limitations may require addition of nodes to meet performance requirements. This section discusses how to add a node to your existing cluster.

To add a new node to an existing OpenSearch cluster, you should complete the following steps:

  1. Install OpenSearch on a separate machine using the instructions provided for your operating system in the PeopleSoft Deployment Packages Installation for Search Components for the current release.

    • For the cluster name prompt, ensure that you enter the name of the existing cluster to which you want to add this node.

    • For the host names of existing nodes, ensure that you enter the host names of the existing nodes so that the new node will discover the other nodes in the cluster.

    Complete the OpenSearch installation by following the steps described in PeopleSoft Deployment Packages Installation for Search Components for the current release. After completing the installation, verify the cluster and node setup.

  2. Open the opensearch.yml configuration file of the existing nodes in the cluster and edit the following parameters.

    Field or Control

    Description

    discovery.seed_hosts

    Add the host of the new node to the existing list of hosts. OpenSearch nodes will find each other via unicast. Ensure that you enter the address in the correct format: ["host1", "host2"].

    See List of Host Names where OpenSearch will be Installed or is Installed.

  3. The opensearch.yml files of the existing nodes is updated with the host of the new node so that, in the future, whenever any of the nodes is restarted, the restarted node will be able to discover other nodes in the cluster.

    Note: An .yml file uses space indentation, so ensure that you edit the file properly and save it.

  4. On PeopleSoft Search Framework, add the details of the new node to the OpenSearch search instance on the Search Instance Properties page.

    See Working With Search Instances.