naming-a-node.md

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.

2. Calling set_configuration through the operations API

{
    "operation": "set_configuration",
    "clustering_nodeName":"Node1"
}

3. Using command line variables.

harperdb --CLUSTERING_NODENAME Node1

4. Using environment variables.

CLUSTERING_NODENAME=Node1