Get Data Source

Applies To: Opalis 6.3

The Get Data Source object retrieves information about Data Sources from either a production server (a computer that has the Data Protection Manager Protection Agent installed) or from a protection group (a named entity that holds the backup policy for a workload). A data source is a workload that is currently protected or will be protected by Data Protection Manager. When the Get Data Source object is used in a protection scenario, you select a production server which becomes the default. When this object is used in a recovery scenario, you will select a protection group or the production Server.

The common filters for this object are as follows:

  • Name contains or matches a pattern

  • Protected - True or False

This object returns the Data Source ID (DataSourceId) which is used in all activities except Get DPM Server Capacity.

For the procedure to configure this object, see: Configuring the Get Data Source Object.

The following tables list the properties and published data for this object. The object publishes all the data from the required and optional properties into published data.

Get Data Source Properties

Element Description

Data Source Location

Production Server or Protection Group

Name

The name of the target for this object

Get Data Source Filters

Element Type

ActivelyProtectedByDatasourceId

GUID

CanDbFilesBeRecoveredToAlternateLocation

Boolean

CloudReplicaAllocationRequired

Boolean

CurrentlyProtected

Boolean

CustomFormatOption

Boolean

DatasourceId

GUID

Data Source Location

String

DatasourceName

String

DatasourceSize

Long

DiskAllocation

String

DisplayPath

String

FirstAddedTime

DateTime

ID

GUID

InactiveDiskAllocation

String

Instance

String

IsAutoCCEnabled

Boolean

IsAutoGrowEnabled

Boolean

IsBatchableOnSizeInquiry

Boolean

IsCloudProtectable

Boolean

IsCollocateable

Boolean

IsCollocated

Boolean

IsCustomAllocation

Boolean

IsDiskInactive

Boolean

IsDPMDatabase

Boolean

IsDPMDatasource

Boolean

IsExternalDatasource

Boolean

IsInstanceProtected

Boolean

IsLocalDPMDatabase

Boolean

IsMirroredDatabase

Boolean

IsOnlineInactive

Boolean

IsOwnerOfAssociatedReplica

Boolean

IsPresentOnCloud

Boolean

IsReferentialDatasource

Boolean

IsTapeInactive

Boolean

LastAddedToCurrentPG

DateTime

LatestRecoveryAllowed

Boolean

LatestRecoveryPoint

DateTime

LogicalPath

String

MinimumReplicaSizeAllowed

Long

MirroredServerInstance

String

MirroredServerName

String

Name

String

NeedsDiskAllocationModification

Boolean

NumberOfExcludedObjects

Integer

NumberOfProtectedObjects

Integer

OldestRecoveryPoint

DateTime

OptimizedSize

Long

OptimizedSizeOnDC

Long

OptimizedSizeOnReplica

Long

PrimaryDPMDatasourceId

GUID

PrincipalServerInstance

String

PrincipalServerName

String

ProductionServerName

String

Protected

Boolean

ProtectedOnCloud

Boolean

ProtectionGroupId

GUID

ProtectionGroupName

String

ReAllocationRequired

Boolean

RecoveryRangeInDays

Integer

ReferentialDatasourceId

GUID

ReferentialProtectionGroupId

GUID

ReplicaAssociationChanged

Boolean

ReplicaPath

String

ReplicaResizeRequired

Boolean

ReplicaSize

Long

ReplicaUsedSpace

Long

RequiredReplicaSize

Long

RequiredShadowCopyAreaSize

Long

ShadowCopyAreaSize

Long

ShadowCopySizeAfterMaxShrink

Long

ShadowCopySizeAfterMinShrink

Long

ShadowCopyUsedSpace

Long

SourceDPMServer

String

SqlScratchSpace

String

StopSQLServiceForRecovery

Boolean

SupportsIncremental

Boolean

TotalRecoveryPoints

Integer

Type

String

UnderActiveProtectionFromDPM

Boolean

UnderActiveProtectionFromPS

Boolean

UsnJournalLogSize

Long

Get Data Source Published Data

Element Type

ActivelyProtectedByDatasourceId

GUID

CanDbFilesBeRecoveredToAlternateLocation

Boolean

CloudReplicaAllocationRequired

Boolean

CurrentlyProtected

Boolean

CustomFormatOption

Boolean

DatasourceId

GUID

DatasourceName

String

DatasourceSize

Long

DiskAllocation

String

DisplayPath

String

FirstAddedTime

DateTime

ID

GUID

InactiveDiskAllocation

String

Instance

String

IsAutoCCEnabled

Boolean

IsAutoGrowEnabled

Boolean

IsBatchableOnSizeInquiry

Boolean

IsCloudProtectable

Boolean

IsCollocateable

Boolean

IsCollocated

Boolean

IsCustomAllocation

Boolean

IsDiskInactive

Boolean

IsDPMDatabase

Boolean

IsDPMDatasource

Boolean

IsExternalDatasource

Boolean

IsInstanceProtected

Boolean

IsLocalDPMDatabase

Boolean

IsMirroredDatabase

Boolean

IsOnlineInactive

Boolean

IsOwnerOfAssociatedReplica

Boolean

IsPresentOnCloud

Boolean

IsReferentialDatasource

Boolean

IsTapeInactive

Boolean

LastAddedToCurrentPG

DateTime

LatestRecoveryAllowed

Boolean

LatestRecoveryPoint

DateTime

LogicalPath

String

MinimumReplicaSizeAllowed

Long

MirroredServerInstance

String

MirroredServerName

String

Name

String

NeedsDiskAllocationModification

Boolean

NumberOfExcludedObjects

Integer

NumberOfProtectedObjects

Integer

OldestRecoveryPoint

DateTime

OptimizedSize

Long

OptimizedSizeOnDC

Long

OptimizedSizeOnReplica

Long

PrimaryDPMDatasourceId

GUID

PrincipalServerInstance

String

PrincipalServerName

String

ProductionServerName

String

Protected

Boolean

ProtectedOnCloud

Boolean

ProtectionGroupId

GUID

ProtectionGroupName

String

ReAllocationRequired

Boolean

RecoveryRangeInDays

Integer

ReferentialDatasourceId

GUID

ReferentialProtectionGroupId

GUID

ReplicaAssociationChanged

Boolean

ReplicaPath

String

ReplicaResizeRequired

Boolean

ReplicaSize

Long

ReplicaUsedSpace

Long

RequiredReplicaSize

Long

RequiredShadowCopyAreaSize

Long

ShadowCopyAreaSize

Long

ShadowCopySizeAfterMaxShrink

Long

ShadowCopySizeAfterMinShrink

Long

ShadowCopyUsedSpace

Long

SourceDPMServer

String

SqlScratchSpace

String

StopSQLServiceForRecovery

Boolean

SupportsIncremental

Boolean

TotalRecoveryPoints

Integer

Type

String

UnderActiveProtectionFromDPM

Boolean

UnderActiveProtectionFromPS

Boolean

UsnJournalLogSize

Long

Configuring the Get Data Source Object

To configure the Get Data Source object

  1. From the Objects window, drag a Get Data Source object to the active policy window. Double-click the Get Data Source object icon.

  2. On the Properties tab, click the ellipsis button (...), and select the Name of the Data Protection Manager computer that you want to connect to for this object.

  3. In the Properties section, select the Data Source Location that you want to use for this object, and enter the Name of the target that you want to query.

  4. By default, all data sources including Hyper-V, SharePoint, SQL, and System Protection are returned. To filter the returned data sources, click the Filters tab. In the Filters section, click Add. In the Name box, click the down arrow and select an item from the list that you want to use to define this policy.

  5. In the Relation box, click the down arrow and select a relationship descriptor for the filter.

  6. In the Value box, click the ellipsis button (...) and select a value to be applied to this filter. If the ellipsis button does not appear for the filter you have selected, enter the value you want to use, and then click OK.

    If applicable, to automatically populate the value for a filter from the data published by any previous object in the workflow, right-click the Value box, Point to Subscribe, and then click Published data. Click the published data element you want to use, and then click OK.

  7. Add additional filters as needed.

  8. To make changes to a filter, click the filter and then click Edit. Make the necessary changes, and then click OK. To remove a filter, click the filter and then click Remove.

  9. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for all Objects.

  10. Click Finish.

Other Objects

The Integration Pack for Data Protection Manager contains the following additional objects: