Spectra Logic

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

Modify Data Path Backend

Description

Activate the data path or configure automatic data path activation. Setting the auto activation timeout to null disables auto activation. If a tape partition is connected to more than one BlackPearl gateway, for example, for failover purposes, it is critical that at most one gateway attached to the same tape partition, is active at a time. Otherwise, multiple gateways may issue conflicting requests to robots and tape drives. This can cause data corruption or data loss. If your configuration has only one BlackPearl gateway, it is safe to increase the auto activate timeout. If your configuration has multiple BlackPearl gateways attached to the same tape partition, consider modifying the auto activate timeout to null in order to guarantee that both gateways cannot be auto-activated at the same time.

Having two BlackPearl gateways connected to the same tape partition, active at the same time can cause database corruption or data loss.

Note:

If an optional request parameter is not included, the previous setting is retained.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/data_path_backend/[?activated=TRUE|FALSE]
[&auto_activate_timeout_in_mins={32-bit integer}] [&auto_inspect=NEVER|MINIMAL|DEFAULT] [&default_import_conflict_resolution_mode=ACCEPT_EXISTING| ACCEPT_IMPORT|ACCEPT_HIGHEST_VERSION|ACCEPT_MOST_RECENT|CANCEL] [&unavailable_media_policy=ALLOW|DISCOURAGED|DISALLOW]
[&unavailable_pool_max_job_retry_in_mins={32-bit integer}]
[&unavailable_tape_partition_max_job_retry_in_mins=
{32-bit integer}]

Request Parameters

Parameter	Description	Required
activated	Whether the BlackPearl gateway is allowed to send data to the data path backend (pool or tape partitions). Values: TRUE, FALSE	no
auto_activate_ timeout_in_mins	The number of minutes allowed for the data planner to take between when it is shut down and when it comes back up, and have the data path back end automatically activate. If the data planner remains shutdown for longer than this number of minutes, the data path backend will not automatically activate. If this parameter is null, the data path backend will never automatically activate. Default: 30 minutes	no
auto_inspect	Whether tape inspections are automatically scheduled whenever the data planner starts. Values: § DEFAULT — Tapes have inspections scheduled for them if an inspection is necessary given the tape's current state, as well as every time the data path starts up. § MINIMAL — Tapes have inspections scheduled for them if an inspection is necessary given the tape's current state. § NEVER — Tapes are not automatically scheduled for inspection.	no
default_import_ conflict_resolution_mode	How the data path backend handles object name conflicts. Values: § ACCEPT_EXISTING — Keep the file currently in the BlackPearl database. § ACCEPT_IMPORT — Keep the file currently being imported. § ACCEPT_HIGHEST_VERSION — Keep the file with the highest version number. § ACCEPT_MOST_RECENT — Keep the file with the most recent creation date. § CANCEL (default) — Cancel the import process.	no
unavailable_media_policy	Whether new job requests are allowed to use media that are currently unavailable. Values: § ALLOW —New job requests for unavailable media are allowed and will retry for the duration of the unavailable_pool_max_job_retry_in_mins or unavailable_tape_partition_max_job_retry_in_mins. § DISCOURAGE (default) — Unavailable partitions can be used, but only if no other media is available. § DISALLOW — New job requests for unavailable media will fail.	no
unavailable_pool_max_job_retry_in_mins	How long job requests using unavailable pools will retry before being re-chunked or failing if re-chunking cannot solve the problem. Default: 20 minutes	no
unavailable_tape_partition_max_job_retry_in_mins	How long job requests using unavailable tape partitions will retry before being re-chunked or failing if re-chunking cannot solve the problem. Default: 20 minutes	no

Responses

Response Elements

<Data>
   <Activated>TRUE|FALSE</Activated>
   <AutoActivateTimeoutInMins>
      {32-bit integer}
   </AutoActivateTimeoutInMins>
   <AutoInspect>DEFAULT|MINIMAL|NEVER</AutoInspect>
   <DefaultImportConflictResolutionMode>
      ACCEPT_EXISTING| ACCEPT_IMPORT|ACCEPT_HIGHEST_VERSION|
      ACCEPT_MOST_RECENT|CANCEL
   </DefaultImportConflictResolutionMode>
   <Id>{string}</Id>
   <LastHeartbeat>YYYY-MM-DDThh:mm:ss.xxxZ</LastHeartbeat>
   <UnavailableMediaPolicy>
       ALLOW|DISCOURAGED|DISALLOW
   </UnavailableMediaPolicy>
   <UnavailablePoolMaxJobRetryInMins>
      {32-bit integer}
   </UnavailablePoolMaxJobRetryInMins>
   <UnavailableTapePartitionMaxJobRetryInMins>
      {32-bit integer}
   </UnavailableTapePartitionMaxJobRetryInMins>
</Data>

where the response elements are defined as follows:

Parameter	Description
Data	The container for the response.
Activated	Whether the BlackPearl gateway is allowed to send to the data path backend (pool or tape partitions). Values: TRUE, FALSE
AutoActivate TimeoutInMins	The number of minutes allowed for the data planner to take between when it is shut down and when it comes back up, and have the data path back end automatically activate. If the data planner remains shutdown for longer than this number of minutes, the data path backend will not automatically activate. If this parameter is null, the data path backend will never automatically activate.
AutoInspect	Whether tape inspections are automatically scheduled whenever the data planner starts. Values: DEFAULT, MINIMAL, NEVER See auto_inspect.
DefaultImport ConflictResolution	How the data path backend handles object name conflicts. Values: ACCEPT_EXISTING, ACCEPT_IMPORT, ACCEPT_HIGHEST_VERSION, ACCEPT_MOST_RECENT, CANCEL See default_import_ conflict_resolution_mode.
Id	The UUID for the record. This is only useful to the gateway.
LastHeartbeat	The date and time that the gateway last sent a heartbeat in the format YYYY-MM-DDThh:mm:ss.xxxZ.
UnavailableMedia Policy	Whether new job requests are allowed to use partitions that are currently unavailable. Values: ALLOW, DISCOURAGE, DISALLOW See unavailable_media_policy.
UnavailablePool MaxJobRetryIn Mins	How long job requests using unavailable pools will retry before being re-chunked or failing if re-chunking cannot solve the problem.
UnavailableTape PartitionMaxJob RetryInMins	How long job requests using unavailable tape partitions will retry before being re-chunked or failing if re-chunking cannot solve the problem.

Example

Sample Request

This request activates the data path backend.

PUT http://blackpearl-hostname/_rest_/data_path_backend/?activated=TRUE HTTP/1.1

Sample Response

HTTP/1.1 200 OK
<Data>
   <Activated>TRUE</Activated>
   <AutoActivateTimeoutInMins>44</AutoActivateTimeoutInMins>
   <AutoInspect>DEFAULT</AutoInspect>
   <DefaultImportConflictResolutionMode>
      CANCEL
   </DefaultImportConflictResolutionMode>
   <Id>c9cebae2-a312-489e-b92c-84030957983a</Id>
   <LastHeartbeat>2016-01-21T18:53:55.000Z</LastHeartbeat>
   <UnavailableMediaPolicy>DISCOURAGED</UnavailableMediaPolicy>
   <UnavailablePoolMaxJobRetryInMins>
      20
   </UnavailablePoolMaxJobRetryInMins>
   <UnavailableTapePartitionMaxJobRetryInMins>
      20
   </UnavailableTapePartitionMaxJobRetryInMins>
</Data>