Sun Cluster Geographic Edition System Administration Guide

Appendix A Standard Sun Cluster Geographic Edition Properties

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:


Note –

The property values, such as True and False, are not case sensitive.


General Heartbeat Properties

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  

General Heartbeat Plug-in Properties

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.

Partnership Properties

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  

General Properties of a Protection Group

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  

Sun StorEdge Availability Suite 3.2.1 Properties

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  

Sun StorEdge Availability Suite 3.2.1 Properties That Should Not Be Changed

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:

Hitachi TrueCopy Properties

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 

Hitachi TrueCopy Properties That Should Not Be Changed

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: