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 topics:
The property values, such as 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 remote-IP-address/UDP/2084/ipsec, remote-IP-address/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 command is run when the cluster designated as primary for a protection group changes. 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 a geopg command is executed, such as start, stop, switchover, and takeover. If the command does not respond within the timeout period, Sun Cluster Geographic Edition reports the operation as timed out, even if the underlying command that was executed eventually completes successfully. 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, an operation with a global scope times out if the local operation does not complete after the specified timeout period or if 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 |
The following table describes the Sun StorEdge Availability Suite 3.2.1 properties that the Sun Cluster Geographic Edition software defines.
Table A–5 Sun StorEdge Availability Suite 3.2.1 Properties
Property |
Description |
---|---|
Data Replication Property: Nodelist (string array) |
Lists the host names of the machines that can be primary for the device group in the protection group. Device groups in the protection group must share the same ordered nodelist. This list is comma delimited. Tuning recommendations: This property can be tuned only when the protection group is offline. Category: Optional Default: All the nodes in the cluster |
Device Group Property: Enable_volume_set (Boolean) |
Defines whether the volume sets that are defined in the file (/var/cluster/geo/avs/<AVS-device-group-name>-volset.ini) are enabled when the device group is added. Set to either true or false. Tuning recommendations: This property cannot be tuned after it has been successfully validated during creation, replication, or synchronization. Category: Optional Default: false |
Device Group Property: Local_logical_host (string) |
Defines the local logical hostname that is used for the replication of the device group. Do not use an underscore (_) character in the logical hostname. Tuning recommendations: This property cannot be tuned after it has been successfully validated during creation, replication, or synchronization. Category: Required Default: None |
Device Group Property: Remote_logical_host (string) |
Defines the remote logical hostname that is used for the replication of the device group. Do not use an underscore (_) character in the logical hostname. Tuning recommendations: This property cannot be tuned after it has been successfully validated during creation, replication, or synchronization. Category: Required Default: None |
Some data replication properties that Sun Cluster Geographic Edition software changes internally must not be edited manually.
For Sun StorEdge Availability Suite 3.2.1, do not edit the following properties:
Network_resources_used
Device_group
Remote_logical_host
Role
The following table describes the Hitachi TrueCopy properties that the Sun Cluster Geographic Edition software defines.
Table A–6 Hitachi TrueCopy Properties
Property |
Description |
---|---|
Data Replication Property: Cluster_dgs (string array) |
Lists the device groups where the data is written. The list is comma delimited. Only applications that belong to the protection group should write to these device groups. Tuning recommendations: This property can only be tuned when the protection group is offline. Category: Optional Default: Empty |
Data Replication Property: Nodelist (string array) |
Lists the host names of the machines that can be primary for the replication mechanism. This list is comma delimited. Tuning recommendations: This property can be tuned at any time. Category: Optional Default: All the nodes in the cluster |
Device Group Property: Fence_level (enum) |
Defines the fence level that is used by the device group. The fence level determines the level of consistency among the primary and secondary volumes for that device group. Possible values are Never and Async. To use the data or status fence levels, contact your Sun representative. For more information about setting this property, see How to Add a Data Replication Device Group to a Hitachi TrueCopy Protection Group Tuning recommendations: This property can only be tuned when the protection group is offline. Category: Required Default: None |
Some data replication properties that Sun Cluster Geographic Edition software changes internally must not be edited manually.
For Hitachi TrueCopy, do not edit the following properties:
dev_group
replication_role