Perform post-installation tasks

Contributors

After you install SolidFire eSDS, configure the cluster name on each SolidFire eSDS node. You can then create a SolidFire eSDS cluster.

About this task

Here is a high-level overview of the tasks that you should complete after you install SolidFire eSDS:

Note You can use the nar_solidfire_cluster_config Ansible role provided by NetApp to perform the post-installation steps. If you want to manually do it, see the steps outlined below.

Configure the cluster name

You should configure the cluster name on each SolidFire eSDS node before you can add the node to a cluster. You can do this using either the per-node UI or the Element API.

Important You cannot change the cluster name after the cluster is created.
Steps
  1. Choose from one of the following options:

    • Use the per-node UI:

      1. Open the per-node management node UI: https://<node_mip>:442.

      2. Select Cluster Settings and enter the cluster name.

      3. Select Apply Changes.

    • Use the SetClusterConfig API method.

      This method has the following input parameter:

      Name Description Type Default value Required

      cluster

      Configuration attributes that should be changed during this method call. Only the fields you want changed need to be added to this method as members in this parameter.

      cluster

      None

      No

      See the following request example:

      {
         "method": "SetClusterConfig",
         "params": {
            "cluster": {
               "name": "myhost",
               "mipi": "Bond10G"
            },
          "id" : 1
         }
      }

Set the license key

When you create a SolidFire eSDS cluster, you need the license key information. NetApp Support will also need the license key information for help with issue resolution. The license key for the SolidFire eSDS cluster consists of the cluster’s order number combined with the serial number, and activates the capacity term license model you have purchased.

About this task

You can use the SetLicenseKey method to set the license key for the SolidFire eSDS storage cluster. The SetLicenseKey method has the following input parameters:

Name Description Type Default value Required

orderNumber

The new sales order number for this storage cluster.

string

None

Yes

serialNumber

The new serial number for this storage cluster.

string

None

Yes

This method has the following return values:

Name Description Type

orderNumber

The new sales order number of the storage cluster.

string

serialNumber

The new serial number of the storage cluster.

string

Step
  1. Use the SetLicenseKey API method as shown in the following example:

    Requests for this method are similar to the following example:

    {
      "method": "SetLicenseKey",
      "params": {
        "orderNumber": "33601",
        "serialNumber": "30G56E3WV"   },
       "id" : 1
    }

    This method returns a response similar to the following example:

    {
       "id" : 1,
       "result" : {
          "serialNumber": "30G56E3WV",
          "orderNumber": "33601"
         }
       }
    }

Create a cluster

After you configure the cluster name on each SolidFire eSDS storage node, you can create a cluster using either the per-node UI or the Element API.

Important Software Encryption at Rest is enabled by default for SolidFire eSDS clusters. If you want to change the default, you should do so when you create the cluster by using the CreateCluster API method.
Steps
  1. Choose from one of the following options:

    • Use the per-node UI:

      1. Open the per-node management node UI: https://<node_mip>:442*.

      2. From the left-hand navigation, select Create Cluster.

      3. Select the checkboxes for the nodes. The SolidFire eSDS nodes will be displayed as SFc100.

      4. Enter the following information: username, password, management virtual IP (MVIP) address, storage virtual IP (SVIP) address, software order number, and serial number.

        Note You cannot change the MVIP and SVIP addresses after the cluster is created. Using the same IP addresses for MVIP and SVIP is not supported.
        Note You cannot change the initial cluster administrator user name.
        Important If you do not specify the order number and serial number, the create cluster operation will fail.
        Shows the per-node UI screen.
      5. Confirm that you have read the NetApp End User License Agreement.

      6. Select Create Cluster.

      7. To verify that cluster was created, log in to the cluster: http://mvip_ip.

      8. Verify that the clusterName, SVIP, MVIP, Node Count, and Element version are correct.

    • Use the CreateCluster API method.

      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 eSDS clusters. Defaults to false on all other clusters.

      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 SolidFire eSDS.

      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. Required on SolidFire eSDS.

      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

      See the following example request:

      {
        "method": "CreateCluster",
        "params": {
          "acceptEula": true,
          "mvip": "10.0.3.1",
          "svip": "10.0.4.1",
          "repCount": 2,
          "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
      }

For more information about this method, see CreateCluster.

Add drives to the cluster

You should add drives to your SolidFire eSDS cluster so that they can participate in the cluster. You can do this using either the Element UI or the APIs.

Steps
  1. Choose from one of the following options:

    • Use the Element UI:

      1. From the Element UI, select Cluster > Drives.

      2. Select Available to view the list of available drives.

      3. To add individual drives, select the Actions icon for the drive you want to add, and then select Add.

      4. To add multiple drives, select the check boxes for the drives to add, select Bulk Actions, and then select Add.

      5. Verify that the drives are added, and the cluster capacity is as expected.

    • Use the AddDrives API method.

      This method has the following input parameter:

      Name Description Type Default value Required

      drives

      Information about each drive to be added to the cluster. Possible values:

      • driveID: The ID of the drive to add (integer).

      • type: The type of drive to add (string). Valid values are "slice", "block", or "volume". If omitted, the system assigns the correct type.

      JSON object array

      None

      Yes (type is optional)

      Here is a request example:

      {
        "id": 1,
        "method": "AddDrives",
        "params": {
          "drives": [
            {
              "driveID": 1,
              "type": "slice"
            },
            {
              "driveID": 2,
              "type": "block"
            },
            {
              "driveID": 3,
              "type": "block"
            }
          ]
        }
      }

For more information about this API method, see AddDrives.