The scha_resourcegroup_get command accesses information about a resource group that is under the control of the Resource Group Manager (RGM) cluster facility.

This command is intended to be used in shell script implementations of the callback methods for resource types. These resource types represent services that are controlled by the cluster's RGM. This command provides the same information as the scha_resourcegroup_get(3HA) C function.

Information is output by the command to standard output in formatted strings as described in scha_cmds(1HA). Output is a string or several strings on separate lines. The output can be stored in shell variables and parsed using shell facilities or awk(1) for further use by the script.

You need solaris.cluster.resource.read RBAC authorization to use this command. See rbac(5).

You must also be able to assume a role to which the Sun Cluster Commands rights profile has been assigned to use this command. Authorized users can issue privileged Sun Cluster commands on the command line from the pfsh(1), pfcsh(1), or pfksh(1) profile shell. A profile shell is a special kind of shell that enables you to access privileged Sun Cluster commands that are assigned to the Sun Cluster Commands rights profile. A profile shell is launched when you run su(1m) to assume a role. You can also use pfexec(1) to issue privileged Sun Cluster commands.

The following options are supported:

-G group

Is the name of the resource group.

-O optag

Indicates the information that is to be accessed. Depending on the optag, an additional operand might be needed to indicate the cluster node for which information is to be retrieved. The case of optag arguments does not matter.

The following optags retrieve the corresponding resource group properties. The value of the named property of the resource group is output. The RG_STATE property refers to the value on the node where the command is executed.

AUTO_START_ON_NEW_CLUSTER DESIRED_PRIMARIES FAILBACK GLOBAL_RESOURCES_USED IMPLICIT_NETWORK_DEPENDENCIES MAXIMUM_PRIMARIES NODELIST PATHPREFIX PINGPONG_INTERVAL RESOURCE_LIST RG_DEPENDENCIES RG_DESCRIPTION RG_IS_FROZEN RG_MODE RG_PROJECT_NAME RG_STATE RG_STATE_NODE RG_SYSTEM

The following exit values are returned:

0

The command completed successfully.

nonzero

An error occurred.

Failure error codes are described scha_calls(3HA).

See attributes(5) for descriptions of the following attributes:

awk(1), scha_cmds(1HA), scha_calls(3HA), scha_resourcegroup_get(3HA), attributes(5)