Add EMC Isilon storage systems to ViPR using the REST API




This article provides ViPR System Administrators the ViPR support requirements, and prerequisite information to prepare EMC Isilon storage systems for ViPR integration, and the steps to add the storage to ViPR using the REST API.

This article also describes how the storage is discovered, and registered after it is added to ViPR, and the important REST API calls to manage and configure the storage after it has been added, and discovered in ViPR.

This article applies to EMC ViPR 2.0.

This article is part of a series

You can add a storage system to ViPR at anytime. If, however, you are setting up the ViPR Controller virtual data center for the first time, before you continue to provision storage, complete the following steps.
  1. Authenticate with the ViPR REST API
  2. Add physical assets to ViPR:
  3. Create ViPR virtual assets:
    1. Create and configure a virtual array
    2. Create virtual pools:


Isilon Storage System Support

Note Image
For the most recent version support requirements refer to the EMC ViPR Support Matrix on the EMC Community Network (
Supported Versions Supported Protocol
OneFS versions:
Note Image
Snapshot restore is not supported for Isilon storage systems.


Collect Isilon information

The following information is needed to configure the storage and add it to ViPR.


Preconfiguration requirements

Before adding EMC Isilon storage to ViPR, configure the storage as follows.


Add an Isilon storage system

When you add an Isilon to ViPR, the array is automatically added to the ViPR discovery queue. If the credentials are correct, the array is automatically discovered and registered. Storage system discovery adds the storage pools and storage ports to ViPR. Storage systems that are registered are available to be used and managed by ViPR.

Before you begin

You need the following information:
  • System Type - Isilon.
  • SmartConnect IP Address - Direct the discovery request to the Isilon SmartConnect host IP.
  • Port Number - 8080.
  • User credentials with Isilon storage system administrator privileges. The Isilon user is independent of the currently authenticated ViPR user. All ViPR operations, which you perform on an Isilon storage system, are executed as this Isilon user.
  • Authenticate with the ViPR REST API as a user with the System Administrator role.
  • The EMC ViPR REST API Reference provides a description and complete list of parameters for the REST API methods used in this article.


  1. Add an Isilon by sending a POST /vdc/storage-systems request.
    The request returns a task whose URI can be queried to determine the status of the task such as completion state, any failures, and the time of the task request.

    POST https://<ViPR_VIP>:4443/vdc/storage-systems Content-Type: application/xml X-SDS-AUTH-TOKEN: <AUTH_TOKEN> <storage_system_create> <name>isilon1</name> <system_type>isilon</system_type> <ip_address></ip_address> <port_number>8080</port_number> <user_name>rootid</user_name> <password>password</password> </storage_system_create>


    HTTP 202 Accepted Content-Type: application/xml <task> <associated_resources/> <op_id>63719ec8-211e-41ae-a0a6-2a7a9c3a97e8</op_id> <resource> <id>urn:storageos:StorageSystem:473d0990-742b-4035-b360-933f3f189ba8:vdc1</id> <link href="/vdc/storage-systems/{StorageSystem_urn}" rel="self"/> <name>isilon1</name> </resource> <link href="/vdc/storage-systems/{StorageSystem_urn}/tasks/63719ec8-211e-41ae-a0a6-2a7a9c3a97e8" rel="self"/> <start_time>1387486656968</start_time> <state>pending</state> </task>

  2. Query the Isilon create task, using the task URL from the response body of the POST request, until the message attribute of the task is Operation completed successfully.

    GET https://<ViPR_VIP>:4443/vdc/storage-systems/{StorageSystem_urn}/tasks/63719ec8-211e-41ae-a0a6-2a7a9c3a97e8 Content-Type: application/xml X-SDS-AUTH-TOKEN: <AUTH_TOKEN>


    HTTP 200 OK Content-Type: application/xml <task> <associated_resources/> <end_time>1387486658727</end_time> <message>Operation completed successfully</message> <op_id>63719ec8-211e-41ae-a0a6-2a7a9c3a97e8</op_id> <resource> <id>urn:storageos:StorageSystem:473d0990-742b-4035-b360-933f3f189ba8:vdc1</id> <link href="/vdc/storage-systems/urn:storageos:StorageSystem:473d0990-742b-4035-b360-933f3f189ba8:vdc1" rel="self"/> <name>isilon1</name> </resource> <link href="/vdc/storage-systems/urn:storageos:StorageSystem:473d0990-742b-4035-b360-933f3f189ba8:vdc1/tasks/63719ec8-211e-41ae-a0a6-2a7a9c3a97e8" rel="self"/> <start_time>1387486656968</start_time> <state>ready</state> </task>

    Once the task is complete, this storage system is automatically discovered by ViPR.

Network configuration requirements for storage

After the storage system is added to ViPR, create the IP networks to include in the virtual array, and be sure to add the necessary storage and host ports to use to provision the storage to the hosts.

ViPR can discover the ports of IP connected storage systems and hosts, but it cannot discover the paths between then, so it is necessary to create IP networks, and then add the host, and storage system ports, which will be provisioned together, to the same IP network.

Refer to Create and configure a ViPR virtual array using the ViPR REST API for more details.


Important REST API calls to manage and configure storage systems

The table shows some important APIs that are used to manage and configure storage systems.