ViPR 2.1 - Add EMC Isilon storage systems to ViPR using the REST API

Table of Contents

Overview

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 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:

Back to Top

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:
  • Pre-configuration and support requirements.
  • 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.

The following steps describe how to add an Isilon storage system to ViPR using the REST API. To use the ViPR UI to add an Isilon storage system to ViPR see the Add EMC Isilon Storage Systems to ViPR article.

Procedure

  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.
    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>192.168.0.0</ip_address>
  <port_number>8080</port_number>
  <user_name>rootid</user_name>
  <password>password</password>
</storage_system_create>
    Response 
    HTTP 202 Accepted
Content-Type: application/xml
<task>
  <associated_resources/>
  <description>DISCOVER_STORAGE_SYSTEM</description>
  <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"/>
  <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.
    Request 
    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>
    Response 
    HTTP 200 OK
Content-Type: application/xml
<task>
  <associated_resources/>
  <description>DISCOVER_STORAGE_SYSTEM</description>
  <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.
Back to Top

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.

Back to Top

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.

Back to Top