This appendix provides the standard properties of Sun Cluster Geographic Edition heartbeats, heartbeat plug-in, partnerships, protection groups, and data replication device groups.
This appendix contains the following sections:
The property names and values, such as Query_interval, True, and False, are not case sensitive.
The following table describes the heartbeat properties that the Sun Cluster Geographic Edition software defines.
Table A–1 General Heartbeat Properties
Property Name |
Description |
---|---|
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 |
The following table describes the general heartbeat plug-in properties that the Sun Cluster Geographic Edition software defines.
Table A–2 General Heartbeat Plug-in Properties
Property |
Description |
---|---|
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. |
The following table describes the partnership properties that the Sun Cluster Geographic Edition software defines.
Table A–3 Partnership Properties
Property |
Description |
---|---|
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 |
The following table describes the protection group properties that the Sun Cluster Geographic Edition software defines.
Table A–4 General Properties of a Protection Group
Property |
Description |
---|---|
Description (string) |
Describes the protection group. Tuning recommendations: This property can be tuned at any time. Category: Optional Default: Empty string |
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:
Tuning recommendations: This property can be tuned only when the protection group is offline. Category: Optional Range: 20-1000000 seconds Default: 200 |