Comment on page
Creating A Cluster User
Inter-node authentication takes place via HarperDB users. There is a special role type called
cluster_userthat exists by default and limits the user to only clustering functionality.
cluster_usermust be created and added to the
harperdb-config.yamlfile for clustering to be enabled.
All nodes that are intended to be clustered together need to share the same
cluster_usercredentials (i.e. username and password).
There are multiple ways a
cluster_usercan be created, they are:
- 1.Through the operations API by calling
When using the API to create a cluster user the
harperdb-config.yamlfile must be updated with the username of the new cluster user.
This can be done through the API by calling
set_configurationor by editing the
harperdb-config.yamlfile under the top-level
clusteringelement there will be a user element. Set this to the name of the cluster user.
Note: When making any changes to the
harperdb-config.yamlfile, HarperDB must be restarted for the changes to take effect.
- 2.Upon installation using command line variables. This will automatically set the user in the
Note: Using command line or environment variables for setting the cluster user only works on install.
harperdb install --CLUSTERING_USER cluster_account --CLUSTERING_PASSWORD letsCluster123!
- 3.Upon installation using environment variables. This will automatically set the user in the