Attributes for DiskGroupSnap agent

Table: Required attributes

Required attribute

Description

TargetResName

The name of the DiskGroup resource from the application service group.

Type-dimension: string-scalar

Example: "dgres"

FDType

Specifies the configuration to be used for the fire drill. The possible values for this attribute are:

  • Bronze

  • Gold (default)

The Bronze configuration uses the local host's VxVM site name as the site to be detached from the DiskGroup. This action leaves the DiskGroup vulnerable to site disaster since a copy of the production volume might not be available when the fire drill is in progress.

In the Gold configuration there are at least three copies of the parent volume available on different sites, hence, even after detaching one site the volume is not vulnerable to site disaster while the fire drill is in progress.

Table: Optional attributes

Optional attribute

Description

FDSiteName

The unique VxVM site name tag for the fire drill disks. The value of this attribute is used in conjunction with the FDType attribute and it must be set to one of the sites registered in the main DiskGroup.

  • When FDType is set to the Bronze configuration, the value of FDSiteName should either be empty or the name of the local host VxVM site for the fire drill host.

  • When FDType is set to the Gold configuration, FDSiteName identifies a site in the DiskGroup to detach as a part of the fire drill. If FDSiteName is left blank, the agent will choose a site to detach based on the DiskGroup configuration. The agent chooses a site name from the DiskGroup which is neither the production server's site name nor the fire drill host's site name.

    Table: Example FDType configurations shows the possible values of the attributes FDType and FDSiteName and the decision taken by the agent.

Consider a configuration where the Production DiskGroup contains three sites: A, B, and C, and the Application service group is online on a node with local VxVM site ID is A. Fire drill is being done on another node Application service group is online on a node where local VxVM site ID is B.

Table: Example FDType configurations

FDType

Bronze

Gold/Empty

FDSitename

Empty

B

C

Empty

B

C

Result

Use B as the site to detach and proceed

Detach site B from DiskGroup

Error

Check if there is another site other than A and B and select it. Else, it is an error

Error

Detach site C from the DiskGroup

Table: Internal attribute

Internal attribute

Description

NumThreads

Number of threads used within the agent process for managing resources. This number does not include threads used for other internal purposes.

Do not modify this attribute for this agent.

Setting this attribute to a higher value may result in agent function timeouts due to serialization of underlying commands.

Type and dimension: integer-scalar

Default: 1