Setting a Cluster


  • A server will be in a Passive state in either one of the following:

    • When the server is started for the very first time
    • When the server is removed from an existing cluster
  • To make a server become part of a cluster you can do either of the following:

    1. Bootstrap Cluster
    2. Adding another node to this server cluster (will cause both to be part of the same cluster)
    3. Performing any RAFT command on the Passive server will make the server become part of a cluster, e.g.:
      • Adding a license
      • Creating a database on this server
  • In this page:


Bootstrap Cluster

Click 'Bootstrap Cluster' to make the current passive server a part of a cluster.
Note: This option is only available when the server is in the Passive state.

Figure 0. Click to add a new node

Add Another Node to the Cluster

Figure 1. Click to add a new node

Click to add a new node


Figure 2. Adding a new node

  1. Enter the server URL of the new node.
  2. You can optionally specify a tag of your choice for the new node. Use UPPER CASE letters only.
    If no tag is provided, the server will assign the new node the next available sequential letter.
  3. Decide whether to add the new node as a Member -or- a Watcher (difference explained here).
  4. Toggle whether to use all available cores on the machine for this node.
    • If you toggle Use available cores off, set a maximum number of cores that can be used by this node.
      Maximum number of cores
  5. Click Test connection to verify that your cluster can communicate with the server at the specified URL.
  6. When done, click Add to add this server as a node to the cluster.

This operation can also be done programatically. Read more here.

A Cluster with 2 nodes

Figure 3. Cluster with 2 nodes

A cluster with 2 nodes

Now your cluster contains 2 nodes:

  • The server running on localhost:8081 shows as Node A and is the Leader of the cluster.
  • The server running on localhost:8082 shows as Node B and is a Member of the cluster.

More nodes can be added as needed.