scdpm(1M) (Sun Cluster Reference Manual for Solaris OS)

Sun Cluster Reference Manual for Solaris OS

scdpm(1M)

NAME

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 –

Beginning with the Sun Cluster 3.2 release, Sun Cluster software includes an object-oriented command set. Although Sun Cluster software still supports the original command set, Sun 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	SUNWsczu
Stability	Evolving

scdpm(1M)

NAME

Synopsis

Description

Options

Examples

Example 1 Monitoring All Disk Paths in the Cluster Infrastructure

Example 2 Monitoring a New Disk Path

Example 3 Monitoring New Disk Paths on a Single Node

Example 4 Printing All Disk Paths and Their Status

Example 5 Printing All Failed Disk Paths

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

Exit Status

Attributes

See Also