Go to main content

Developing Data Services

Exit Print View

Updated: August 2018
 
 

Using Property Variables

You can also retrieve the values of selected Oracle Solaris Cluster resource type, resource, and resource group properties from the RGM framework by using property variables. Agent Builder scans your start, probe, or stop command strings for property variables and substitutes these variables with their values before Agent Builder executes the command.


Note - Property variables are not supported for use with Korn shell-based services.

List of Property Variables

This section lists the property variables that you can use. The Oracle Solaris Cluster resource type, resource, and resource group properties are described in Setting Standard Properties.

Resource Property Variables
  • HOSTNAMES

  • RS_CHEAP_PROBE_INTERVAL

  • RS_MONITOR_START_TIMEOUT

  • RS_MONITOR_STOP_TIMEOUT

  • RS_NAME

  • RS_NUM_RESTARTS

  • RS_RESOURCE_DEPENDENCIES

  • RS_RESOURCE_DEPENDENCIES_WEAK

  • RS_RETRY_COUNT

  • RS_RETRY_INTRVAL

  • RS_SCALABLE

  • RS_START_TIMEOUT

  • RS_STOP_TIMEOUT

  • RS_THOROUGH_PROBE_INTERVAL

  • SCHA_STATUS

Resource Type Property Variables
  • RT_API_VERSION

  • RT_BASEDIR

  • RT_FAILOVER

  • RT_INSTALLED_NODES

  • RT_NAME

  • RT_RT_VERSION

  • RT_SINGLE_INSTANCE

Resource Group Property Variables
  • RG_DESIRED_PRIMARIES

  • RG_GLOBAL_RESOURCES_USED

  • RG_IMPLICIT_NETWORK_DEPENDENCIES

  • RG_MAXIMUM_PRIMARIES

  • RG_NAME

  • RG_NODELIST

  • RG_NUM_RESTARTS

  • RG_PATHPREFIX

  • RG_PINGPONG_INTERVAL

  • RG_RESOURCE_LIST

Syntax of Property Variables

You include a percent sign (%) before a property name to indicate a property variable, as shown in this example:

/opt/network_aware/echo_server -t %RS_STOP_TIMEOUT -n %RG_NODELIST

Given the preceding example, Agent Builder might interpret these property variables and start the echo_server script with the following values:

/opt/network_aware/echo_server -t 300 -n phys-node-1,phys-node-2,phys-node-3

How Agent Builder Substitutes Property Variables

    Agent Builder interprets the types of property variables, as follows:

  • An integer is substituted with its actual value (300, for example).

  • A Boolean value is substituted with the string TRUE or FALSE.

  • A string is substituted with the actual string (phys-node-1, for example).

  • A list of strings is substituted with all members in the list, each string separated by a comma (phys-node-1,phys-node-2,phys-node-3, for example).

  • A list of integers is substituted with all members in the list, each integer separated by a comma (1,2,3, for example).

  • An enumerated type is substituted with its value, in string form.