ViPR 2.1 - Add EMC XtremIO Storage 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 XtremIO 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

Storage systems can be added 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 EMC XtremIO storage system

When you add EMC XtremIO to ViPR, the array is automatically added to the EMC XtremIO discovery queue. If the credentials are correct, the array is automatically discovered. 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

To successfully complete this procedure, you need the following information:
  • Pre-configuration and support requirements.
  • System Type - xtremio.
  • IP Address - Direct the discovery request to the EMC XtremIO IP.
  • Port Number - The port used to connect to the XtremIO storage system host. The default is 443.
  • user_name - Name of the root account on the XtremIO array.
  • password - Password of the root account on the XtremIO array.

Authenticate with the ViPR REST API as System Administrator.

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 XtremIO storage to ViPR using the REST API. To use the ViPR UI to add XtremIO storage to ViPR see the Add EMC XtremIO Storage to ViPR article.

Procedure

  1. Add the XtremIO storage system 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.
    Request
    POST https://<ViPR_VIP>:4443/vdc/storage-systems
    Content-Type: application/xml
    X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
    
    <storage_system_create>
      <name>XtremIO1</name>
      <system_type>xtremio</system_type>
      <ip_address>192.168.0.0</ip_address>
      <port_number>443</port_number>
      <user_name>root</user_name>
      <password>password1</password>
    </storage_system_create>
    
    Response
    HTTP 202 Accepted
    Content-Type: application/xml
    <?xml version="1.0" encoding="UTF-8"?>
    <task>
        <associated_resources />
        <description>DISCOVER_STORAGE_SYSTEM</description>
        <op_id>6af4c8af-5875-411c-8491-aaf41c59e165</op_id>
        <resource>
            <id>urn:storageos:StorageSystem:248978e9-b0bf-4c25-ae05-fd0b68cfe0e8:vdc1</id>
            <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:248978e9-b0bf-4c25-ae05-fd0b68cfe0e8:vdc1" />
            <name>XtremIO1</name>
        </resource>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:248978e9-b0bf-4c25-ae05-fd0b68cfe0e8:vdc1/tasks/6af4c8af-5875-411c-8491-aaf41c59e165" />
        <state>pending</state>
    </task>
    
    
  2. Query the XtremIO create task, using the task URL from the response body of the POST request. When the message attribute of the task is Operation completed successfully, the operation has completed.
    Request
    GET https://<ViPR_VIP>:4443/vdc/storage-systems/{StorageSystem_urn}/tasks/6af4c8af-5875-411c-8491-aaf41c59e165
    Content-Type: application/xml
    X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
    Response
    HTTP 200 OK
    Content-Type: application/xml
    <?xml version="1.0" encoding="UTF-8"?>
    <task>
        <associated_resources />
        <description>DISCOVER_STORAGE_SYSTEM</description>
        <end_time>1409693011983</end_time>
        <message>Operation completed successfully</message>
        <op_id>6af4c8af-5875-411c-8491-aaf41c59e165</op_id>
        <resource>
            <id>urn:storageos:StorageSystem:248978e9-b0bf-4c25-ae05-fd0b68cfe0e8:vdc1</id>
            <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:248978e9-b0bf-4c25-ae05-fd0b68cfe0e8:vdc1" />
            <name>XtremIO1</name>
        </resource>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:248978e9-b0bf-4c25-ae05-fd0b68cfe0e8:vdc1/tasks/6af4c8af-5875-411c-8491-aaf41c59e165" />
        <start_time>1409693010345</start_time>
        <state>ready</state>
    </task>
    
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