Naming a Cluster
A cluster can be named, by means of the REST API.
Establishes a name for the cluster. Either the Full Admin or the Cluster Admin role is required.
Once defined, the cluster name provides a convenient, verbal reference, which will never be used in programmatic or networked access. The name can be of any length, can make use of any symbols (for example: %, $, !, #), and can include spaces. The name can be changed at any time during the life of the cluster, irrespective of the cluster’s configuration.
curl -X POST http://<ip-address-or-domain-name>:8091/pools/default \ -d clusterName=<cluster-name> -u <username>:<password>
cluster-name argument is a string that is to be the name of the cluster.
Note that during the process of provisioning a single-node cluster,
password are required after the administrator has established credentials, as described in Establishing Credentials.
If a username and password have already been assigned, failure to authenticate returns
If the URI is incorrectly expressee,
404 Object Not Found is returned.
If the flag is incorrectly expressed,
400 Bad Request is returned, with an error message such as:
The following example establishes a name for the cluster.
curl -X POST http://10.144.220.101:8091/pools/default \ -d clusterName=MyNewCluster -u Administrator:password
The sequence of tasks divided into initialization and provisioning is explained in Cluster Initialization and Provisioning.
For general information on naming, see Naming Clusters and Nodes.
For further information on initialization and provisioning — using the UI, the CLI, and the REST API — see Manage Nodes and Clusters.