ViPR 2.2 - Add a Data Protection System using the ViPR REST API

Table of Contents

Overview

A system administrator can use POST /vdc/protection-systems to add a data protection system, such as EMC RecoverPoint to ViPR. ViPR also supports data protection using Symmetrix Remote Data Facility (SRDF)

After you add a data protection system to ViPR, you can select data protection when you create your block virtual pools. Any block volumes created from those block virtual pools will have their data protected by the selected data protection system.

This article is part of a series

A data protection system 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 a RecoverPoint data protection system

Add a RecoverPoint data protection system to ViPR using POST /vdc/protection-systems.

Before you begin

The following steps describe how to add a RecoverPoint data protection system to ViPR using the REST API. To use the ViPR UI to add a RecoverPoint data protection system to ViPR see the Add Data Protection Systems to ViPR article.

Procedure

  1. Add the RecoverPoint protection system by sending a POST<ViPR_VIP>:4443/vdc/protection-systems request with a system_type of rp.
    The request returns a task whose URI can be queried to determine the status of the task.
    Request
    POST https://<ViPR_VIP>:4443/vdc/protection-systems
    Content-Type: application/xml
    X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
    
    <protection_system_create>
       <name>rp_west1</name>
      <system_type>rp</system_type>
      <ip_address>192.168.0.0</ip_address>
      <port_number>7225</port_number>
      <user_name>admin</user_name>
      <password>admin</password>
    </protection_system_create>
    Response
    HTTP 202 Accepted
    Content-Type: application/xml
    
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <task>
         <creation_time>1423583101338</creation_time>
         <global>false</global>
         <id>urn:storageos:Task:5f7d64c9-28e8-4fef-87f3-15eb173bb5ad:vdc1</id>
         <inactive>false</inactive>
         <internal>false</internal>
         <link rel="self" href="/vdc/tasks/urn:storageos:Task:5f7d64c9-28e8-4fef-87f3-15eb173bb5ad:vdc1"/>
         <name>DISCOVER STORAGESYSTEM</name>
         <remote>false</remote>
         <tags/>
         <vdc>
              <id>urn:storageos:VirtualDataCenter:99c5c185-ebb0-468a-8fe7-3ea6e65b7b57:vdc1</id>
              <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:99c5c185-ebb0-468a-8fe7-3ea6e65b7b57:vdc1"/>
         </vdc>
         <associated_resources/>
         <description>discover a storage systems</description>
         <op_id>e95b27ef-ec82-4002-aae0-af046820af54</op_id>
         <progress>0</progress>
         <resource>
              <id>urn:storageos:ProtectionSystem:11865a28-5953-4d7a-84fa-2cceb1038d97:vdc1</id>
              <link rel="self" href="/vdc/protection-systems/urn:storageos:ProtectionSystem:11865a28-5953-4d7a-84fa-2cceb1038d97:vdc1"/>
              <name>rp_west1</name>
         </resource>
         <start_time>1423583101336</start_time>
         <state>pending</state>
    </task>
  2. Repeat the query of the add protection system task, using the task URI 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/tasks/urn:storageos:Task:5f7d64c9-28e8-4fef-87f3-15eb173bb5ad:vdc1
    Content-Type: application/xml
    X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
    Respone
    HTTP 200 OK
    Content-Type: application/xml
    
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <task>
         <creation_time>1423583101338</creation_time>
         <global>false</global>
         <id>urn:storageos:Task:5f7d64c9-28e8-4fef-87f3-15eb173bb5ad:vdc1</id>
         <inactive>false</inactive>
         <internal>false</internal>
         <link rel="self" href="/vdc/tasks/urn:storageos:Task:5f7d64c9-28e8-4fef-87f3-15eb173bb5ad:vdc1"/>
         <name>DISCOVER STORAGESYSTEM</name>
         <remote>false</remote>
         <tags/>
         <vdc>
              <id>urn:storageos:VirtualDataCenter:99c5c185-ebb0-468a-8fe7-3ea6e65b7b57:vdc1</id>
              <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:99c5c185-ebb0-468a-8fe7-3ea6e65b7b57:vdc1"/>
         </vdc>
         <associated_resources/>
         <description>discover a storage systems</description>
         <end_time>1423583873389</end_time>
         <message>Operation completed successfully</message>
         <op_id>e95b27ef-ec82-4002-aae0-af046820af54</op_id>
         <progress>100</progress>
         <resource>
              <id>urn:storageos:ProtectionSystem:11865a28-5953-4d7a-84fa-2cceb1038d97:vdc1</id>
              <link rel="self" href="/vdc/protection-systems/urn:storageos:ProtectionSystem:11865a28-5953-4d7a-84fa-2cceb1038d97:vdc1"/>
              <name>rp_west1</name>
         </resource>
         <start_time>1423583101336</start_time>
         <state>ready</state>
    </task>
Back to Top