NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | SEE ALSO
The scha_resource_get command accesses information about a resource that is under the control of the Resource Group Manager (RGM) cluster facility. The resource information that can be accessed includes properties of the resource's type.
scha_resource_get is intended to be used in shell script implementations of the callback methods for resource types that represent services controlled by the cluster's RGM. It provides the same information as the scha_resource_get(3HA) C function.
Information is output by the command to stdout in formatted strings as described in scha_cmds(1HA). Output is a string or several strings output on separate lines. The output may be stored in shell variables and parsed using shell facilities or awk(1) for further use by the script.
The following options are supported:
The name of the resource group in which the resource has been configured. Although this argument is optional, the command will run more efficiently if it is included, so it is recommended.
The optag argument indicates the information to be accessed. Depending on the optag, an additional operand may be needed to indicate the cluster node for which information is to be retrieved. Case is not considered in recognition of the optag arguments.
The following Optag values supported:
The following optags retrieve the corresponding resource properties. The value of the named property of the resource is output. The RESOURCE_STATE, STATUS, NUM_RG_RESTARTS, and NUM_RESOURCE_RESTARTS properties refer to the value on the node where the command is executed (see r_properties(5)).
R_DESCRIPTION TYPE ON_OFF_SWITCH MONITORED_SWITCH RESOURCE_STATE CHEAP_PROBE_INTERVAL THOROUGH_PROBE_INTERVAL RETRY_COUNT RETRY_INTERVAL FAILOVER_MODE RESOURCE_DEPENDENCIES RESOURCE_DEPENDENCIES_WEAK NETWORK_RESOURCES_USED SCALABLE PORT_LIST LOAD_BALANCING_POLICY LOAD_BALANCING_WEIGHTS AFFINITY_TIMEOUT WEAK_AFFINITY UDP_AFFINITY STATUS START_TIMEOUT STOP_TIMEOUT VALIDATE_TIMEOUT UPDATE_TIMEOUT INIT_TIMEOUT FINI_TIMEOUT BOOT_TIMEOUT MONITOR_START_TIMEOUT MONITOR_STOP_TIMEOUT MONITOR_CHECK_TIMEOUT PRENET_START_TIMEOUT POSTNET_STOP_TIMEOUT NUM_RG_RESTARTS NUM_RESOURCE_RESTARTS TYPE_VERSION RESOURCE_PROJECT_NAME |
Requires an unflagged argument that names a node. Outputs the value of the resource's STATUS property for the named node.
Requires an unflagged argument that names a node. Outputs the value of the resource's RESOURCE_STATE property for the named node.
Requires an unflagged argument that names an extension of the resource. Outputs the type of the property followed by its value, on successive lines. Shell scripts might need to discard the type to obtain the value, as shown in EXAMPLE below.
Outputs on successive lines the names of all extension properties of the resource.
Outputs the name of the resource group into which the resource is configured.
The following optags retrieve the corresponding resource type properties. The value of the named property of the resource's type is output. For descriptions of resource type properties, see rt_properties(5).
RT_DESCRIPTION RT_BASEDIR SINGLE_INSTANCE INIT_NODES INSTALLED_NODES FAILOVER API_VERSION RT_VERSION PKGLIST START STOP VALIDATE UPDATE INIT FINI BOOT MONITOR_START MONITOR_STOP MONITOR_CHECK PRENET_START POSTNET_STOP IS_LOGICAL_HOSTNAME IS_SHARED_ADDRESS RESOURCE_PROJECT_NAME |
The name of a resource that is being managed by the cluster RGM facility.
The following script is passed -R and -G arguments giving the needed resource name and resource group name, as well as resource type. Next, the scha_resource_get command accesses the Retry_count property of the resource and the enum-type LogLevel extension property of the resource.
#!/bin/sh while getopts R:G: opt do case $opt in R) resource="$OPTARG";; G) group="$OPTARG";; esac done retry_count=`scha_resource_get -O Retry_count -R $resource -G $group` printf "retry count for resource %s is %d\n" $resource $retry_count LogLevel_info=`scha_resource_get -O Extension -R $resource -G $group LogLevel` # Get the enum value that follows the type information # of the extension property. Note that the preceding assignment # has already changed the newlines separating the type and the value # to spaces for parsing by awk. loglevel=`echo $LogLevel_info | awk '{print $2}'` retry_count=`scha_resource_get -O Retry_count -R $resource -G $group` printf "retry count for resource %s is %d\n" $resource $retry_count
The following exit values are returned:
Successful completion.
An error occurred.
Failure error codes are described in scha_calls(3HA).
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Availability |
SUNWscdev |
Interface Stability |
Evolving |
awk(1), sh(1), scha_cmds(1HA), scha_calls(3HA), scha_resource_get(3HA), attributes(5), r_properties(5), rt_properties(5)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | SEE ALSO