scha_resourcetype_get

- access resource type information

Synopsis

scha_resourcetype_get  -O optag -T type [-Z zoneclustername]

Description

The scha_resourcetype_get command accesses information about a resource type that is registered with the Resource Group Manager (RGM).

Use this command in shell script implementations of the callback methods for resource types that represent services that are controlled by the RGM. This command provides the same information as the scha_resourcetype_get(3HA) C function.

Information is output by this command to the standard output (stdout) in formatted strings, as described in the scha_cmds(1HA) man page. Output is a string or several strings that are output on separate lines. You can store the output in shell variables. You can also parse the output by using the awk(1) command or other shell commands for further use by the script.

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

Authorized users can issue privileged Oracle Solaris 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 Oracle Solaris Cluster commands that are assigned to the Oracle Solaris 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 Oracle Solaris Cluster commands.

Options

The following options are supported:

-O optag

Indicates the information to be accessed.

---

Note - optag options, such as API_VERSION and BOOT, are not case sensitive. You can use any combination of uppercase and lowercase letters when you specify optag options.

---

The following optag values retrieve the corresponding resource type properties. The value of the named property of the resource's type is output.

API_VERSION

BOOT

FAILOVER

FINI

GLOBAL_ZONE

INIT

INIT_NODES

INSTALLED_NODES

IS_LOGICAL_HOSTNAME

IS_SHARED_ADDRESS

MONITOR_CHECK

MONITOR_START

MONITOR_STOP

PKGLIST

POSTNET_STOP

PRENET_START

PROXY

RESOURCE_LIST

RT_BASEDIR

RT_DESCRIPTION

RT_SYSTEM

RT_VERSION

SINGLE_INSTANCE

START

STOP

UPDATE

VALIDATE

-T type

Is the name of a resource type that is registered for use by the RGM cluster facility.

-Z zoneclustername

Specifies the cluster in which the resource group exists and on which you want to operate. This option is applicable when the command is executed in the global zone but needs to operate on a specified zone cluster. It cannot be used within a zone cluster to access a different zone cluster.

zoneclustername

Specifies that the query is to be performed in the zone cluster named zoneclustername.

If the -Z option is omitted, the query is performed in the cluster in which the command is executed.

Exit Status

The following exit values are returned:

0

The command completed successfully.

nonzero

An error occurred.

Failure error codes are described scha_calls(3HA).

Attributes

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

See Also

awk(1), scha_cmds(1HA), scha_calls(3HA), scha_resourcetype_get(3HA), attributes(5), rt_properties(5)