Skip to main content
Cloud Volumes ONTAP
All cloud providers
  • Amazon Web Services
  • Google Cloud
  • Microsoft Azure
  • All cloud providers

Manage data-serving storage VMs for Cloud Volumes ONTAP in Azure

Contributors netapp-manini netapp-driley
PDFs

A storage VM is a virtual machine running within ONTAP that provides storage and data services to your clients. You might know this as an SVM or a vserver. Cloud Volumes ONTAP is configured with one storage VM by default, but you can create additional storage VMs when running Cloud Volumes ONTAP in Azure.

To create and manage additional data-serving storage VMs in Azure, you should use the BlueXP APIs. This is because the APIs automate the process of creating the storage VMs and configuring the required network interfaces. When creating the storage VMs, BlueXP configures the required LIF services, as well as an iSCSI LIF that's required for outbound SMB/CIFS communications from the storage VM.

Supported number of storage VMs

Beginning with Cloud Volumes ONTAP 9.9.0, based on your license, multiple storage VMs are supported with specific configurations. Refer to the Cloud Volumes ONTAP Release Notes to verify the supported number of storage VMs for your version of Cloud Volumes ONTAP.

All versions of Cloud Volumes ONTAP prior to 9.9.0 support one data-serving storage VM and one destination storage VM used for disaster recovery. You can activate the destination storage VM for data access if there's an outage on the source storage VM.

Create a storage VM

Based on your configuration and license type, you can create multiple storage VMs on a single node system or in a high-availability (HA) configuration by using the BlueXP APIs.

About this task

When you create storage VMs using the APIs, along with configuring the required network interfaces, BlueXP also modifies the default-data-files policies on the data storage VMs by removing the following services from the NAS data LIF and adding them to the iSCSI data LIF that's used for outbound management connections:

  • data-fpolicy-client

  • management-ad-client

  • management-dns-client

  • management-ldap-client

  • management-nis-client

Before you begin

The Connector requires specific permissions to create storage VMs for Cloud Volumes ONTAP. The required permissions are included in the policies provided by NetApp.

Single node system

Use the following API call to create a storage VM on a single node system.

POST /azure/vsa/working-environments/{workingEnvironmentId}/svm

Include the following parameters in the request body:

{ "svmName": "myNewSvm1"
   "svmPassword": "optional, the API takes the cluster password if not provided"
   "mgmtLif": "optional, to create an additional management LIF, if you want to use the storage VM for management purposes"}
JSON
Copy

HA pair

Use the following API call to create a storage VM on an HA pair:

POST /azure/ha/working-environments/{workingEnvironmentId}/svm

Include the following parameters in the request body:

{ "svmName": "NewSvmName"
   "svmPassword": "optional value, the API takes the cluster password if not provided"
   "mgmtLif": "optional value, to create an additional management LIF, if you want to use the storage VM for management purposes"}
JSON
Copy

Manage storage VMs on single node systems and HA pairs

Using the BlueXP APIs, you can rename and delete storage VMs in both single node and HA configurations.

Before you begin

The Connector requires specific permissions to manage storage VMs for Cloud Volumes ONTAP. The required permissions are included in the policies provided by NetApp.

Rename a storage VM

To rename a storage VM, you should provide the names of the existing storage VM and new storage VM as parameters.

Steps

  • Use the following API call to rename a storage VM on a single node system:

    PUT /azure/vsa/working-environments/{workingEnvironmentId}/svm

    Include the following parameters in the request body:

    {
  "svmNewName": "NewSvmName",
  "svmName": "OldSvmName"
}
    JSON
    Copy

  • Use the following API call to rename a storage VM on an HA pair:

    PUT /azure/ha/working-environments/{workingEnvironmentId}/svm

    Include the following parameters in the request body:

    {
  "svmNewName": "NewSvmName",
  "svmName": "OldSvmName"
}
    JSON
    Copy

Delete a storage VM

In a single node or HA configuration, you can remove a storage VM if it doesn't have any active volumes.

Steps

  • Use the following API call to delete a storage VM on a single node system:

    DELETE /azure/vsa/working-environments/{workingEnvironmentId}/svm/{svmName}

  • Use the following API call to delete a storage VM on an HA pair:

    DELETE /azure/ha/working-environments/{workingEnvironmentId}/svm/{svmName}