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

Search Scope:

- This Document
- Entire Library

### scdpm

- manage disk path monitoring daemon

### Synopsis

    scdpm [-a] {node | all}

    scdpm -f filename

    scdpm -m {[node | all][:/dev/did/rdsk/]dN | [:/dev/rdsk/]cNtXdY | all}

    scdpm -n {node | all}

    scdpm -p [-F] {[node | all][:/dev/did/rdsk/]dN | [/dev/rdsk/]cNtXdY | all}

    scdpm -u {[node | all][:/dev/did/rdsk/]dN | [/dev/rdsk/]cNtXdY | all}

## 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 `scdpm` command manages the disk path monitoring daemon in a cluster. You use this command to monitor and unmonitor disk paths. You can also use this command to display the status of disk paths or nodes. All of the accessible disk paths in the cluster or on a specific node are printed on the standard output. You must run this command on a cluster node that is online and in cluster mode.

You can specify either a global disk name or a UNIX path name when you monitor a new disk path. Additionally, you can force the daemon to reread the entire disk configuration.

You can use this command only in the global zone.

## Options

The following options are supported:

`-a`

  Enables the automatic rebooting of a node when all monitored disk paths fail, provided that the following conditions are met:

  - All monitored disk paths on the node fail.

  - At least one of the disks is accessible from a different node in the cluster.

  You can use this option only in the global zone.

  Rebooting the node restarts all resource and device groups that are mastered on that node on another node.

  If all monitored disk paths on a node remain inaccessible after the node automatically reboots, the node does not automatically reboot again. However, if any monitored disk paths become available after the node reboots but then all monitored disk paths again fail, the node automatically reboots again.

  You need `solaris.cluster.device.admin` role-based access control (RBAC) authorization to use this option. See `rbac`(5).

`-F`

  If you specify the `-F` option with the `-p` option, `scdpm` also prints the faulty disk paths in the cluster. The `-p` option prints the current status of a node or a specified disk path from all the nodes that are attached to the storage.

`-f` filename

  Reads a list of disk paths to monitor or unmonitor in filename.

  You can use this option only in the global zone.

  The following example shows the contents of filename.

      u schost-1:/dev/did/rdsk/d5
      m schost-2:all

  Each line in the file must specify whether to monitor or unmonitor the disk path, the node name, and the disk path name. You specify the `m` option for monitor and the `u` option for unmonitor. You must insert a space between the command and the node name. You must also insert a colon (:) between the node name and the disk path name.

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

`-m`

  Monitors the new disk path that is specified by node`:`diskpath.

  You can use this option only in the global zone.

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

`-n`

  Disables the automatic rebooting of a node when all monitored disk paths fail.

  You can use this option only in the global zone.

  If all monitored disk paths on the node fail, the node is not rebooted.

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

`-p`

  Prints the current status of a node or a specified disk path from all the nodes that are attached to the storage.

  You can use this option only in the global zone.

  If you also specify the `-F` option, `scdpm` prints the faulty disk paths in the cluster.

  Valid status values for a disk path are `Ok`, `Fail`, `Unmonitored`, or `Unknown`.

  The valid status value for a node is `Reboot_on_disk_failure`. See the description of the `-a` and the `-n` options for more information about the `Reboot_on_disk_failure` status.

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

`-u`

  Unmonitors a disk path. The daemon on each node stops monitoring the specified path.

  You can use this option only in the global zone.

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

## Examples

Example 1 Monitoring All Disk Paths in the Cluster Infrastructure

The following command forces the daemon to monitor all disk paths in the cluster infrastructure.

    # scdpm -m all

Example 2 Monitoring a New Disk Path

The following command monitors a new disk path. All nodes monitor `/dev/did/dsk/d3` where this path is valid.

    # scdpm -m /dev/did/dsk/d3

Example 3 Monitoring New Disk Paths on a Single Node

The following command monitors new paths on a single node. The daemon on the `schost-2` node monitors paths to the `/dev/did/dsk/d4` and `/dev/did/dsk/d5` disks.

    # scdpm -m schost-2:d4 -m schost-2:d5

Example 4 Printing All Disk Paths and Their Status

The following command prints all disk paths in the cluster and their status.

    # scdpm -p
         schost-1:reboot_on_disk_failure  enabled
         schost-2:reboot_on_disk_failure  disabled
         schost-1:/dev/did/dsk/d4         Ok
         schost-1:/dev/did/dsk/d3         Ok
         schost-2:/dev/did/dsk/d4         Fail
         schost-2:/dev/did/dsk/d3         Ok
         schost-2:/dev/did/dsk/d5         Unmonitored
         schost-2:/dev/did/dsk/d6         Ok

Example 5 Printing All Failed Disk Paths

The following command prints all of the failed disk paths on the `schost-2` node.

    # scdpm -p -F all
         schost-2:/dev/did/dsk/d4         Fail

Example 6 Printing the Status of All Disk Paths From a Single Node

The following command prints the disk path and the status of all disks that are monitored on the `schost-2` node.

    # scdpm -p schost-2:all
         schost-2:reboot_on_disk_failure   disabled
         schost-2:/dev/did/dsk/d4          Fail
         schost-2:/dev/did/dsk/d3          Ok

## Exit Status

The following exit values are returned:

`0`

  The command completed successfully.

`1`

  The command failed completely.

`2`

  The command failed partially.

Note - The disk path is represented by a node name and a disk name. The node name must be the host name or `all`. The disk name must be the global disk name, a UNIX path name, or `all`. The disk name can be either the full global path name or the disk name: `/dev/did/dsk/d3` or `d3`. The disk name can also be the full UNIX path name: `/dev/rdsk/c0t0d0s0`.

Disk path status changes are logged with the `syslogd` `LOG_INFO` facility level. All failures are logged with the `LOG_ERR` facility level.

## Attributes

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

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

## See Also

`Intro`(1CL), `cldevice`(1CL), `clnode`(1CL), `attributes`(5)

Oracle Solaris Cluster System Administration Guide

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