Query_interval (integer)

Specifies the delay in seconds between heartbeat status requests.  

Tuning recommendations: The value of this property is assigned at creation and can be tuned at runtime. 

Category: Optional  

Default: 120 seconds  

Plugin_properties (string)

Specifies a property string specific to the plug-in.  

Tuning recommendations: The value of this property is assigned at creation and can be tuned at runtime. 

Category: Optional 

Default: None except for heartbeats that use the default heartbeat plug-ins, tcp_udp_plugin and ping-plugin.

For the tcp_udp_plugin plug-in, the format of this string is predefined as remoteIPaddress/UDP/2084/ipsec, remoteIPaddress/TCP/2084/ipsec. The remote_IP_address argument specifies the IP address of the partner cluster. The optional ipsec argument specifies if the plug-in uses IPsec with a Boolean value of true or false.

For the ping-plugin, the format of this string is predefined as remote_IP_address, where remote_IP_address specifies the IP address of the partner cluster.

Query_cmd (string)

Specifies the path to the heartbeat status request command.  

Tuning recommendations: The value of this property is assigned at creation and can be tuned at runtime. 

Category: Required property if the plug-in does not specify a predefined plug-in. 

Default: None 

Requester_agent (string)

Specifies the absolute path to the requester agent.  

Tuning recommendations: The value of this property is assigned at creation and can be tuned at runtime. However, the Requester_agent property of the default plug-in should never need to be tuned except for testing purposes.

Category: Optional 

Default: None  

Responder_agent (string)

Specifies the absolute path to the responder agent. 

Tuning recommendations: The value is assigned at creation and can be tuned at runtime. However, the Responder_agent property of the default plug-in should never need to be tuned except for testing purposes.

Category: Optional 

Default: None 

Type (enum)

Designates the type of plug-in. Set to either primary or backup.

Tuning recommendations: The value of this property is assigned at creation and can be tuned at runtime. 

Category: Required 

Default: None, except for the default heartbeat that is named ping_plugin. If using this plug-in, the default value is backup.

Description (string)

Describes the partnership.  

Tuning recommendations: The value of this property is assigned at creation and can be tuned at runtime. 

Category: Optional 

Default: Empty string  

Notification_ActionCmd (string)

Provides the path to the action script that is triggered when heartbeat-loss notification is issued.  

Tuning recommendations: The value of this property is assigned at creation and can be tuned at runtime. 

Category: Optional 

Default: Empty string  

Notification_EmailAddrs (string array)

Lists the email addresses that are sent email when heartbeat-loss notification is issued. The list is comma delimited.  

Tuning recommendations: The value of this property is assigned at creation and can be tuned at runtime. 

Category: Optional 

Default: Empty string  

Description (string)

Describes the protection group. 

Tuning recommendations: This property can be tuned at any time. 

Category: Optional 

Default: Empty string 

External_Dependency_Allowed (Boolean)

Allow dependencies between resource groups and resources that belong to this protection group and resource groups and resources that do not belong to this protection group when set to true.

Tuning recommendations: This property can be tuned at any time. 

Category: Optional 

Default: false

RoleChange_ActionArgs (string)

Defines a string of arguments that are appended to the end of the command line when the role-change action command, RoleChange_ActionCmd, is run.

Tuning recommendations: This property can be tuned at any time. 

Category: Optional 

Default: Empty string 

RoleChange_ActionCmd (string)

Specifies the path to an executable command. This script is invoked during a switchover or takeover on the new primary cluster when the protection group is started on the new primary cluster. The script is invoked on the new primary cluster after the data replication role changes from secondary to primary and before the application resource groups are brought online. If the data replication role change does not succeed, then the script is not called.  

This path should be valid on all nodes of all partner clusters that can host the protection group.  

Tuning recommendations: This property can be tuned at any time. 

Category: Optional 

Default: Empty string 

Timeout (integer)

Specifies the timeout period for the protection group in seconds. The timeout period is the longest time Sun Cluster Geographic Edition waits for a response after you run a geopg command, such as geopg start, geopg stop, geopg switchover, and geopg takeover. If the command does not respond within the timeout period, the Sun Cluster Geographic Edition software reports the operation as timed out, even if the underlying command eventually completes successfully.

You should identify the amount of time required to perform a role-reversal of the data replication, and set the timeout value to 150% to 200% of that value to ensure enough time for the role-reversal to complete.  

To ensure that an operation has finished on the remote cluster, check system status after a timeout before attempting the operation again. For more information, see Troubleshooting Migration Problems.

The timeout period applies to operations on a per-cluster basis. An operation with a local scope times out if the operation does not complete after the specified timeout period.  

An operation with a global scope consists of an action on the local cluster and an action on the remote cluster. The local and remote action are timed separately so that an operation with a global scope times out during one of the following conditions: 

• The local operation does not complete after the specified timeout period.

• The remote operation does not complete after the specified timeout period.

Tuning recommendations: This property can be tuned only when the protection group is offline. 

Category: Optional  

Range: 20-1000000 seconds 

Default: 200