Skip to main content
Version: 4.5

Naming a Node

Node name is the name given to a node. It is how nodes are identified within the cluster and must be unique to the cluster.

The name cannot contain any of the following characters: .,*> . Dot, comma, asterisk, greater than, or whitespace.

The name is set in the harperdb-config.yaml file using the clustering.nodeName configuration element.

Note: If you want to change the node name make sure there are no subscriptions in place before doing so. After the name has been changed a full restart is required.

There are multiple ways to update this element, they are:

  1. Directly editing the harperdb-config.yaml file.
clustering:
  nodeName: Node1

Note: When making any changes to the harperdb-config.yaml file Harper must be restarted for the changes to take effect.

  1. Calling set_configuration through the operations API
{
	"operation": "set_configuration",
	"clustering_nodeName": "Node1"
}
  1. Using command line variables.
harperdb --CLUSTERING_NODENAME Node1
  1. Using environment variables.
CLUSTERING_NODENAME=Node1