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
- Authenticate with the ViPR REST API
- Add physical assets to ViPR:
- Create
ViPR virtual assets:
- Create and configure a virtual array
- Create virtual pools:
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
- 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
- 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>
ResponseHTTP 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>
- 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>
ResponseHTTP 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.
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 TopImportant REST API calls to manage and configure storage systems
The table shows some important APIs that are used to manage and configure storage systems.