CreateCluster

Contributors netapp-mwallis netapp-dbagwell ntap-bmegan Download PDF of this page

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 true on SolidFire Enterprise SDS clusters. Defaults to false on all other 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" : {}
}