Search <book_title>...

InfoScale™ 9.0 Cluster Server Agent for EMC SRDF Configuration Guide - Windows

Last Published: 2025-04-13

Product(s): InfoScale & Storage Foundation (9.0)

Platform: Windows

Optional attributes for SRDF

Configuring these attributes is optional.

Table: Optional attributes

Attribute	Description
Name: SwapRoles Type-dimension: integer-scalar	Dynamic devices only Specifies whether the roles of the dynamic devices must be swapped at the time of failover or not: If set to 0, the agent does not swap the role. If set to 1, the agent checks whether the devices support role swapping. If the devices have the capability, the agent swaps the roles between the RDF1 and RDF2 devices. If set to 2, the agent does not check whether the devices support role swapping, and directly initiates the role swap between the RDF1 and RDF2 devices. Default: 1
Name: IsCompositeGroup Type-dimension: integer-scalar	Specifies whether the SRDF group is a composite group: If set to 0, the agent treats it as device group. If set to 1, the agent treats it as composite group. Default: 0
Name: SymHome Type-dimension: string-scalar	Path to the bin directory that contains the Symmetrix command line interface. Default: `C:\Program Files\EMC\SMYCLI\bin`
Name: DevFOTime Type-dimension: integer-scalar	Average time in seconds that is required for each device or composite group to fail over. This value helps the agent to determine whether it has adequate time for the online operation after waiting for the other devices or the composite groups to fail over. If the online operation cannot be completed in the remaining time, the failover does not proceed. Default: 2 (seconds per device)
Name: AutoTakeover Type-dimension: integer-scalar	Determines whether the agent performs a symrdf rw_enable operation on the partitioned devices at the secondary site: If set to 1, the agent fails over the service group at the DR site even when the replication is in the Partitioned state. If set to 0, the agent waits for consent from an administrator to proceed with the failover. Default: 0 Note: A Partitioned state occurs when the replication link is broken, which means that the secondary devices are not in sync with the primary devices, or that the secondary devices may have invalid data. Hence, the default value of the AutoTakover attribute set to 0, so that the failover can proceed only with the admin consent. For details, refer to the Dell EMC SRDF documentation.
Name: SplitTakeover Type-dimension: integer-scalar	Determines whether the agent permits a failover to the R2 devices in the Split state: If set to 0, the agent does not permit a failover to the R2 devices in the Split state. If set to 1, the agent permits a failover to the R2 devices in the Split state if the devices are read-write enabled. Recommendation: Set the attribute to 0 to minimize the risk of data loss in case of a failover to devices that may not be in sync. Default: 0 Note: The attribute has no effect on the failover operations to a host to which R1 devices are attached.
Name: LinkMonitor	Determines whether the agent should check the status of the replication link while bringing the resource online: If set to 1, the agent checks the status of the replication link. If the replication is in the Synchronized or the Consistent state, the agent brings the resource online. Otherwise, the resource remains offline and results in a service group fault. If set to 0, the agent brings the resource online regardless of the status of the replication link. Other values of the attribute are reserved for future use by the agent. Default: 0 Note: This attribute is of importance only at the primary site where the role of the device group is RDF1 and all the devices in the device group are read-write enabled.
Name: Mode Type-dimension: string-scalar	Determines which commands to use to fail over the service group to the other site. The values for this attribute can be Asynchronous or Synchronous. Default: No default value Note: If the value is not specified, the agent assumes that the mode is Synchronous. If the devices are set up to replicate in the Asynchronous mode, you must set this attribute to Asynchronous.
Name: AdvancedOpts Type-dimension: string-association	Determines whether the agent executes a custom script during the monitor cycle for the resource. Use the ExtendMonitor key with this attribute - set its value to the absolute path of the script that should be executed during the monitor cycle. To disable the execution of the custom script, set ExtendMonitor to null, or remove the key from the AdvancedOpts attribute. Example: AdvancedOpts{} = { ExtendMonitor=null }
Name: ConfValidate Type-dimension: integer-scalar	Specifies whether the agent should check the state of the EMC device group configuration before it brings the resource online: If set to 1, the agent compares the number of standard devices on the remote site and on the local site. If the numbers match, the agent brings the resource online; otherwise, it faults the resource. If set to 0, the agent brings the resource online regardless of the state of the EMC device group configuration. Default: 0 Example: 1
Name: SymcliDbFile Type-dimension: string-scalar	Absolute path to the custom `symapi` database file. Default: No default value - the path value of the standard `symapi` database file is considered to perform the symrdf operations. Note: Do not modify the value of this attribute if you do not plan to use a customized database for your storage devices.

Attribute

Description

Name: SwapRoles

Type-dimension: integer-scalar

Dynamic devices only

Specifies whether the roles of the dynamic devices must be swapped at the time of failover or not:

If set to 0, the agent does not swap the role.
If set to 1, the agent checks whether the devices support role swapping. If the devices have the capability, the agent swaps the roles between the RDF1 and RDF2 devices.
If set to 2, the agent does not check whether the devices support role swapping, and directly initiates the role swap between the RDF1 and RDF2 devices.

Default: 1

Name: IsCompositeGroup

Type-dimension: integer-scalar

Specifies whether the SRDF group is a composite group:

If set to 0, the agent treats it as device group.
If set to 1, the agent treats it as composite group.

Default: 0

Name: SymHome

Type-dimension: string-scalar

Path to the bin directory that contains the Symmetrix command line interface.

Default: C:\Program Files\EMC\SMYCLI\bin

Name: DevFOTime

Type-dimension: integer-scalar

Average time in seconds that is required for each device or composite group to fail over. This value helps the agent to determine whether it has adequate time for the online operation after waiting for the other devices or the composite groups to fail over. If the online operation cannot be completed in the remaining time, the failover does not proceed.

Default: 2 (seconds per device)

Name: AutoTakeover

Type-dimension: integer-scalar

Determines whether the agent performs a symrdf rw_enable operation on the partitioned devices at the secondary site:

If set to 1, the agent fails over the service group at the DR site even when the replication is in the Partitioned state.
If set to 0, the agent waits for consent from an administrator to proceed with the failover.

Default: 0

Note:

A Partitioned state occurs when the replication link is broken, which means that the secondary devices are not in sync with the primary devices, or that the secondary devices may have invalid data. Hence, the default value of the AutoTakover attribute set to 0, so that the failover can proceed only with the admin consent.

For details, refer to the Dell EMC SRDF documentation.

Name: SplitTakeover

Type-dimension: integer-scalar

Determines whether the agent permits a failover to the R2 devices in the Split state:

If set to 0, the agent does not permit a failover to the R2 devices in the Split state.
If set to 1, the agent permits a failover to the R2 devices in the Split state if the devices are read-write enabled.

Recommendation: Set the attribute to 0 to minimize the risk of data loss in case of a failover to devices that may not be in sync.

Default: 0

Note:

The attribute has no effect on the failover operations to a host to which R1 devices are attached.

Name: LinkMonitor

Determines whether the agent should check the status of the replication link while bringing the resource online:

If set to 1, the agent checks the status of the replication link. If the replication is in the Synchronized or the Consistent state, the agent brings the resource online. Otherwise, the resource remains offline and results in a service group fault.
If set to 0, the agent brings the resource online regardless of the status of the replication link.
Other values of the attribute are reserved for future use by the agent.

Default: 0

Note:

This attribute is of importance only at the primary site where the role of the device group is RDF1 and all the devices in the device group are read-write enabled.

Name: Mode

Type-dimension: string-scalar

Determines which commands to use to fail over the service group to the other site.

The values for this attribute can be Asynchronous or Synchronous.

Default: No default value

Note:

If the value is not specified, the agent assumes that the mode is Synchronous. If the devices are set up to replicate in the Asynchronous mode, you must set this attribute to Asynchronous.

Name: AdvancedOpts

Type-dimension: string-association

Determines whether the agent executes a custom script during the monitor cycle for the resource.

Use the ExtendMonitor key with this attribute - set its value to the absolute path of the script that should be executed during the monitor cycle.

To disable the execution of the custom script, set ExtendMonitor to null, or remove the key from the AdvancedOpts attribute.

Example: AdvancedOpts{} = { ExtendMonitor=null }

Name: ConfValidate

Type-dimension: integer-scalar

Specifies whether the agent should check the state of the EMC device group configuration before it brings the resource online:

If set to 1, the agent compares the number of standard devices on the remote site and on the local site. If the numbers match, the agent brings the resource online; otherwise, it faults the resource.
If set to 0, the agent brings the resource online regardless of the state of the EMC device group configuration.

Default: 0

Example: 1

Name: SymcliDbFile

Type-dimension: string-scalar

Absolute path to the custom symapi database file.

Default: No default value - the path value of the standard symapi database file is considered to perform the symrdf operations.

Note:

Do not modify the value of this attribute if you do not plan to use a customized database for your storage devices.