Skip to main content
Version: 6.1

Adding a Node to a Cluster

This article describes how to add a new node to an SMRTC cluster.

First Node and Joining Nodes​

The first node forms a cluster by itself and does not wait for other nodes. At startup, a joining node connects to an existing running cluster and retrieves metadata from it.

This behavior is controlled by the parameters in the cluster section of the installer answer file:

  • IS_JOIN - n for the first node and y for a joining node
  • EXISTING_NODES - comma-separated addresses of existing nodes in ip:9910 format. Use the inter-node transport port, not public port 9919
  • NODE_IS_MASTER - specifies whether the node is a voting member of the metadata quorum
  • CLUSTER_NAME - cluster name, which must be the same on all nodes

Deployment Sequence​

Deploy the first node, and then deploy the joining nodes. At startup, a joining node queries the existing nodes and waits to receive the cluster configuration.

Adding a Second Node​

  1. On the first node, copy the certificate authority certificate and key to the second node
  2. On the second node, run sudo bash setup.sh install:
    • at the cluster settings step, enter y to join an existing cluster
    • specify the first node as an existing node using an address in the <first-node-ip>:9910 format
    • specify the same cluster name (CLUSTER_NAME) as on the first node
    • at the TLS settings step, provide the copied certificate authority certificate and key