Spectra Logic

1-800-833-1132 : 1-303-449-6400

Convert a Storage Domain to a BlackPearl Target

Description

Convert a storage domain to a BlackPearl target so that permanent persistence rules become permanent replication rules. This is used if data is initially written to multiple tape storage domains on different tape libraries connected to one BlackPearl system, and then one of the tape libraries is physically transferred to another site and connected a to different BlackPearl system. At least one permanent persistence rule must remain after the conversion.

Note:

Once a storage domain is converted to a BlackPearl target, it cannot be converted back to a storage domain.

The process is as follows:

1.	Discontinue data transfer operations to the original BlackPearl system.

2.	Wait for all jobs to complete. (Confirm using Get Active Jobs.)

3.	Make a database backup on the original BlackPearl system. See “Database Backup & Restore” in the BlackPearl User Guide.

4.	Move the tape library to its new physical location and connect it to the second BlackPearl system (“BlackPearl #2”).

5.	Power on BlackPearl #2.

6.	Restore the database backup from Step 3 onto BlackPearl #2.

Restoring the database from BlackPearl #1 to BlackPearl #2 deletes all of the data on BlackPearl #2. Only do this if BlackPEarl #2 is newly installed and does not contain data.

7.	Reset the instance id on BlackPearl #2. Restoring the database backup also restores the instance id so that BlackPearl #2 has the same id as BlackPearl #1. The instance id must be unique, so you need to reset the instance id for BlackPearl #2. See Reset Instance Identifier.

8.	Register BlackPearl #2 as a target on the original BlackPearl system (optionally, using pair-back) (See Register DS3 Target and Pair Back Registered DS3 Target.)

9.	Issue this command to convert the now-remote storage domain to a BlackPearl target on each BlackPearl system.

10.	Unquiesce and activate each BlackPearl system. It does not matter which is done first. See Modify Azure Target.

Converting a storage domain to a BlackPearl target does the following.

1.	The storage domain no longer exists on either BlackPearl system.

2.	Any blobs stored in the tapes, pools, etc. for that storage domain are updated to be stored on the replication target.

3.	Any permanent persistence rules targeting the storage domain are converted to permanent replication rules targeting the BlackPearl target.

4.	Any temporary or retired persistence rules targeting the storage domain are deleted.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/storage_domain/{storage domain UUID, name, or other unique attribute}​?convert_to_ds3_target={string}/

To determine the UUID for a storage domain, see Get Storage Domains.

Request Parameters

Parameter	Description	Required
convert_to_ds3_ target	BlackPearl target UUID, name, or other unique attribute. Note: To determine the UUID for a BlackPearl target, see Get DS3 Targets.	yes

Responses

Response Elements

The operation returns status only.

Notable status codes:

§	204: No Content (success)

§	403: Access Denied

§	404: Not Found

Example

Sample Request

This request converts the storage domain with the name sd1 to a BlackPearl target with the UUID f36cb73e-d4e6-4cc4-9ac1-5f666e99eb3e.

PUT http[s]://blackpearl-hostname/_rest_/storage_domain/sd1​?convert_to_ds3_target=f36cb73e-d4e6-4cc4-9ac1-5f666e99eb3e HTTP/1.1

Sample Response

HTTP/1.1 204 No Content