Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### scstat

- monitor the status of an Oracle Solaris Cluster configuration

### Synopsis

    scstat [-DWginpqv [v]] [-h node]

## Description

Note - Oracle Solaris Cluster software includes an object-oriented command set. Although Oracle Solaris Cluster software still supports the original command set, Oracle Solaris Cluster procedural documentation uses only the object-oriented command set. For more information about the object-oriented command set, see the `Intro`(1CL) man page.

The `scstat` command displays the current state of Oracle Solaris Cluster components. Only one instance of the `scstat` command needs to run on any machine in the Oracle Solaris 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 IP network multipathing (IPMP) group and public network adapter

You need `solaris.cluster.device.read`, `solaris.cluster.transport.read`, `solaris.cluster.resource.read`, `solaris.cluster.node.read`, `solaris.cluster.quorum.read`, and `solaris.cluster.system.read` RBAC authorization to use this command without options. See `rbac`(5).

### 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 Resource Group Manager (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 nonzero or times out, then the state of the resource is `Stop_failed`.

Possible resource states include: `Online`, `Offline`, `Start_failed`, `Stop_failed`, `Monitor_failed`, `Online_not_monitored`, `Starting`, and `Stopping`.

Possible resource group states are: `Unmanaged`, `Online`, `Offline`, `Pending_online`, `Pending_offline`, `Error_stop_failed`, `Online_faulted`, and `Pending_online_blocked`.

In addition to resource state, the RGM also maintains a resource status that can be set by the resource itself by 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 that is printed after the status keyword.

Descriptions of possible values for a resource's status are as follows:

`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.

`OFFLINE`

  The resource is offline.

`ONLINE`

  The resource is online and providing service.

`UNKNOWN`

  The current status is unknown or is in transition.

### Device Groups

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

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

`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 standby 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.

`OFFLINE`

  The device group is offline. There is no primary node. The device group must be brought online before any of its devices can be used.

`ONLINE`

  The device group is online. There is a primary node, and devices within the group are ready for I/O.

`WAIT`

  The device group is between one status and another. This status might occur, for example, when a device group is going from offline to online.

### IP Network Multipathing Groups

IP network multipathing (IPMP) group status reflects the availability of the backup group and the adapters in the group.

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

`OFFLINE`

  The backup group failed. All adapters in the group are offline.

`ONLINE`

  The backup group is functional. At least one adapter in the group is online.

`UNKNOWN`

  Any other state than those listed before. This could result when an adapter is detached or marked as down by Solaris commands such as `if_mpadm` or `ifconfig`.

The following are possible values for IPMP adapter status and their descriptions:

`OFFLINE`

  The adapter failed or the backup group is offline.

`ONLINE`

  The adapter is functional.

`STANDBY`

  The adapter is on standby.

`UNKNOWN`

  Any other state than those listed before. This could result when an adapter is detached or marked as down by Solaris commands such as `if_mpadm` or `ifconfig`.

## Options

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

If more than one option is specified, the `scstat` command prints the status in the specified order.

The following options are supported:

`-D`

  Shows status for all disk device groups.

  You can use this option in the global zone.

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

`-g`

  Shows status for all resource groups.

  You can use this option in the global zone.

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

`-h` node

  Shows status for the specified node (node) and status of the disk device groups of which this node is the primary node. Also shows the status of the quorum devices to which this node holds reservations of the resource groups to which the node is a potential master, and holds reservations of the transport paths to which the node is attached.

  You need `solaris.cluster.device.read`, `solaris.cluster.transport.read`, `solaris.cluster.resource.read`, `solaris.cluster.node.read`, `solaris.cluster.quorum.read`, and `solaris.cluster.system.read` RBAC authorization to use this command option. See `rbac`(5).

`-i`

  Shows status for all IPMP groups and public network adapters.

  You can use this option only in the global zone.

`-n`

  Shows status for all nodes.

  You can use this option in the global zone.

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

`-p`

  Shows status for all components in the cluster. Use with `-v` to display more verbose output.

  You can use this option in the global zone.

  You need `solaris.cluster.device.read`, `solaris.cluster.transport.read`, `solaris.cluster.resource.read`, `solaris.cluster.node.read`, `solaris.cluster.quorum.read`, and `solaris.cluster.system.read` RBAC authorization to use `-p` with `-v`. See `rbac`(5).

`-q`

  Shows status for all device quorums and node quorums.

  You can use this option in the global zone.

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

`-v`[`v`]

  Shows verbose output.

`-W`

  Shows status for cluster transport path.

  You can use this option in the global zone.

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

## 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

The output that is displayed appears in the order in which the options are specified.

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

    % scstat -g

and

    % scstat -h host

## Exit Status

The following exit values are returned:

`0`

  The command completed successfully.

nonzero

  An error has occurred.

## Attributes

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

ATTRIBUTE TYPE | ATTRIBUTE VALUE
--- | ---
Availability | `ha-cluster/system/core`
Interface Stability | Evolving

## See Also

`Intro`(1CL), `cluster`(1CL), `if_mpadm`(1M), `ifconfig`(1M), `scha_resource_setstatus`(1HA), `scha_resource_setstatus`(3HA), `attributes`(5)

## 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 might not necessarily continue to be in a healthy enough state to contribute to the formation of quorum when quorum is reestablished. The current version of Oracle Solaris Cluster does not include a disk monitoring facility or regular probes to the quorum devices.

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |