Go to main content

Oracle® Solaris Cluster 4.3 Geographic Edition System Administration Guide

Exit Print View

Updated: June 2017

Tuning the Heartbeat Properties

You can modify the properties of the default and custom heartbeats by using the geohb set-prop command. For more information about this command, refer to the geohb(1M) man page.

If you modify the default value of the Query_interval property, ensure that the interval is sufficiently long. An interval that is too short causes a timeout and heartbeat-loss event before the logical hostname resource is available. This failover should result in no more than two unanswered heartbeat requests. Setting a default Query_interval value of 120 seconds with the default heartbeat.retries parameter of 3 enables the peer cluster to be unresponsive for 6 minutes (120 * 3 ) without having a false failure declared.

The heartbeat.retries parameter is specified in the com.sun.cluster.agent.geocontrol.xml file. You should not change the heartbeat.retries value. If you want to change the default value of the heartbeat.retries property, contact an Oracle service representative.

If you adjust the delay setting of the Query_interval property, ensure that the following condition is met:

Query_interval > worst-case-logical-host-failover-time / 2

You must empirically determine the logical-host failover time for the cluster in question. The following must be true to avoid false failures:

Query_interval > worst-case-logical-host-failover-time / 3

How to Modify the Heartbeat Properties

Note -  You can also accomplish this procedure by using the Oracle Solaris Cluster Manager browser interface. Click Partnerships, click the partnership name to go to its page, click the heartbeat name to go to its page, click the Properties tab, and click Edit to access the listed properties for editing. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager in Oracle Solaris Cluster 4.3 System Administration Guide.

Before You Begin

You must be assigned the Geo Management rights profile to complete this procedure. For more information, see Securing Geographic Edition Software in Oracle Solaris Cluster 4.3 Geographic Edition Installation and Configuration Guide.

  1. Log in to a cluster node.
  2. Modify the heartbeat properties.
    # geohb set-prop -p property-setting [-p…] heartbeat-name
    –p property-setting

    Specifies the default properties of the heartbeat.

    A heartbeat property is assigned a value by a name=statement pair. Multiple properties can be set at one time by using multiple statements.

    For more information about the properties you can set, see Standard Geographic Edition Properties.

    For information about the names and values that are supported by the Geographic Edition framework, see Legal Names and Values of Geographic Edition Entities.


    Specifies an identifier for the heartbeat settings.

    For more information about the geohb command, refer to the geohb(1M) man page.

Example 15  Modifying the Properties of the Default Heartbeat

This example modifies the settings for the default heartbeat between cluster-paris and cluster-newyork.

# geohb set-prop -p Query_interval=60 hb_cluster-paris~cluster-newyork