scstat(1M) (Sun Cluster 3.1 Reference Manual)

Sun Cluster 3.1 Reference Manual

scstat(1M)

NAME

scstat– monitor the status of Sun Cluster

SYNOPSIS

scstat

-DWginpv

-h

node

DESCRIPTION

The scstat utility displays the current state of Sun Cluster and its components. Only one instance of the scstat utility needs to run on any machine in the Sun Cluster configuration.

When run without any options, scstat displays the status for all components of the cluster. This display includes the following information:

A list of cluster members
The status of each cluster member
The status of resource groups and resources
The status of every path on the cluster interconnect
The status of every disk device group
The status of every quorum device
The status of every IPMP group and public network adapter

Resources and Resource Groups

The resource state, resource group state, and resource status are all maintained on a per-node basis. For example, a given resource has a distinct state on each cluster node and a distinct status on each cluster node.

The resource state is set by the RGM on each node, based only on which methods have been invoked on the resource. For example, after the stop method has run successfully on a resource on a given node, the resource's state will be offline on that node. If the stop method exits non-zero or times out, then the state of the resource will be stop_failed.

Possible resource states are: online, offline, start_failed, stop_failed, monitor_failed, or online_not_monitored.

Possible resource group states are: unmanaged, online, offline, pending_online, pending_offline, or error_stop_failed.

In addition to resource state, the RGM also maintains a resource status that can be set by the resource itself using the API. The field Status Message actually consists of two components:status keyword and status message. Status message is optionally set by the resource and is an arbitrary text string printed after the status keyword.

The following are possible values for resource status and their descriptions:

Online: The resource is online and providing service.
Degraded: The resource is online, but its performance or availability might be compromised in some way.
Faulted: The resource has encountered an error that prevents it from functioning.
Unknown: The current status is unknown or is in transition.
Offline: The resource is offline.

Device Groups

Device group status reflects on the availability of the devices in that group.

The following are possible values for device group status and their descriptions:

Online: The device group is online. There is a primary node and devices within the group are ready for I/O.
Degraded: The device group is online, but not all of its potential primaries (secondaries) are up. For two-node connectivity, this status basically indicates that a stand-by primary does not exist, which means a failure of the primary node will result in a loss of access to the devices in the group.
Wait: The device group is between statuses. This status might occur, for example, when a device goup is going from offline to online.
Offline: The device group is offline. There is no primary node. The device group must be brought online before any of its device can be used.

OPTIONS

You can specify command options to request the status for specific components.

If more than one option is specified, the scstat utility prints out the status in the specified order.

The following options supported:

-D: Show status for all disk device groups.
-g: Show status for all resource groups.
-h node: Show status for the specified node (node) and status of the disk device groups of which node is the primary node. Also show status of the quorum devices to which this node holds reservation, of the resource groups to which node is a potential master, and of the transport paths to which node is attached.
-i: Show status for all IPMP groups and public network adapters.
-n: Show status for all nodes.
-p: Show status for all components in the cluster. Use with -v[v] to display more verbose output.
-q: Show status for all device quorums and node quorums.
-v[v]: Show verbose output.
-W: Show status for cluster transport path.

EXAMPLES

Example 1 Using the scstat Command

The following command displays the status of all resource groups followed by the status of all components related to the specified host:

%  scstat -g -h host

These results are the same results you would see by typing the two commands:

% scstat -g

and

% scstat -h host

This is because, if more than one option is specified, scstat prints out the status in the specified order.

EXIT STATUS

The following exit values are returned:

0: Successful completion.
non-zero: An error has occurred.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

NOTES

An online quorum device means that the device was available for contributing to the formation of quorum when quorum was last established. From the context of the quorum algorithm, the device is online because it actively contributed to the formation of quorum. However, an online quorum device may not necessarily continue to be in a healthy enough state to contribute to the formation of quorum when quorum is re-established. The current version of Sun Cluster does not include a disk monitoring facility or regular probes to the quorum devices.

Sun Cluster 3.1 Last Revised 14 May 2002