CreateCluster
You can use the CreateCluster
method to initialize the node in a cluster that has ownership of the "mvip" and "svip" addresses. Each new cluster is initialized using the management IP (MIP) of the first node in the cluster. This method also automatically adds all the nodes being configured into the cluster. You only need to use this method once each time a new cluster is initialized.
After you log in to the master node for the cluster and run the GetBootStrapConfig method to get the IP addresses for the rest of the nodes that you want to include in the cluster, you can run the CreateCluster method against the master node for the cluster. |
Parameters
This method has the following input parameters:
Name | Description | Type | Default value | Required |
---|---|---|---|---|
acceptEula |
Indicate your acceptance of the End User License Agreement when creating this cluster. To accept the EULA, set this parameter to true. |
boolean |
None |
Yes |
attributes |
List of name-value pairs in JSON object format. |
JSON object |
None |
No |
enableSoftwareEncryptionAtRest |
Enable this parameter to use software-based encryption at rest. Defaults to false on all clusters. After software encryption at rest is enabled, it cannot be disabled on the cluster. |
boolean |
true |
No |
mvip |
Floating (virtual) IP address for the cluster on the management network. |
string |
None |
Yes |
nodes |
CIP/SIP addresses of the initial set of nodes making up the cluster. This node's IP must be in the list. |
string array |
None |
Yes |
orderNumber |
Alphanumeric sales order number. Required on software-based platforms. |
string |
None |
No (hardware-based platforms) Yes (software-based platforms) |
password |
Initial password for the cluster admin account. |
string |
None |
Yes |
serialNumber |
Nine-digit alphanumeric Serial Number. May be required on software-based platforms. |
string |
None |
No (hardware-based platforms) Yes (software-based platforms) |
svip |
Floating (virtual) IP address for the cluster on the storage (iSCSI) network. |
string |
None |
Yes |
username |
User name for the cluster admin. |
string |
None |
Yes |
Return values
This method has no return values.
Request example
Requests for this method are similar to the following example:
{ "method": "CreateCluster", "params": { "acceptEula": true, "mvip": "10.0.3.1", "svip": "10.0.4.1", "username": "Admin1", "password": "9R7ka4rEPa2uREtE", "attributes": { "clusteraccountnumber": "axdf323456" }, "nodes": [ "10.0.2.1", "10.0.2.2", "10.0.2.3", "10.0.2.4" ] }, "id": 1 }
Response example
This method returns a response similar to the following example:
{ "id" : 1, "result" : {} }