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

Sun Cluster Reference Manual for Solaris OS

scdpm(1M)

NAME

scdpm– Disk-path monitoring administration command

SYNOPSIS

scdpm -m [node|all]:<[/dev/did/rdsk/]d- | [/dev/rdsk/]c-t-d- | all>
scdpm -u [node|all]:<[/dev/did/rdsk/]d- | [/dev/rdsk/]c-t-d- | all>
scdpm -p [-F] [node|all]:<[/dev/did/rdsk/]d- | [/dev/rdsk/]c-t-d- | all>
scdpm -f filename

DESCRIPTION

The scdpm command manages the disk-path monitoring daemon in a cluster environment. This command is used to monitor and unmonitor disk paths. You can also use the scdpm command to display the status of disk paths. All of the accessible disk paths in the cluster or on a specific node are printed to the standard output. The scdpm command must be run from a cluster node that is online in cluster mode.

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

OPTIONS

The following options are supported.

-m

Monitor the new disk path that is specified by node:disk path. If the node name is not specified, all is the default option.

-u

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

-p

Print the current status of a specified disk path from all the nodes that are attached to the storage. With the -F option, scdpm prints the faulty disk paths in the cluster. If the node name is not specified, all is the default option. The status can be Ok , Fail, Unmonitored, or Unknown.

Note –

You need solaris.cluster.device.read RBAC authorization to use this command with the -p option. See rbac(5).

-f file name

Read the list of disk paths to monitor or unmonitor for a specified file name. The file must list the command to monitor or unmonitor, node-name and disk-path name. The commands are m for monitor, and u for unmonitor. The command must be followed by a space. The node-name and disk-path name should be separated by a colon.

syntax in command file:
[u,m] [node|all]:<[/dev/did/rdsk/]d- | [/dev/rdsk/]c-t-d- | all>

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

Note –

You need solaris.cluster.device.admin RBAC authorization to use this command with the -m, -u and -f options. See See rbac(5).

EXIT STATUS

The following exit values are returned:

>0: An error occurred. Error messages are displayed on the standard error.
0: Successful completion.
1: Complete failure.
2: Partial failure.

Note –

The disk path is represented by a node name and a disk name. The node name must be the hostname or the word all to address all of the nodes in the cluster. The disk name must be the global disk name, a UNIX path name, or the word all to address all the disks in the node. The disk name can be either the full global path name or just the disk name, for example /dev/did/dsk/d3 or d3. The disk name can also be the full UNIX path name, for example /dev/rdsk/c0t0d0s0.

Disk-path status changes are logged by using the syslogd LOG_INFO facility level. All failures are logged by using LOG_ERR facility level.

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. In the following example, all nodes monitor /dev/did/dsk/d3 where this path is valid.

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

Example 3 Monitoring a Disk Path on a Single Node

The following command monitors a new path 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 the Status

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

# scdpm -p all:all
	     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 of the 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 for disks that are monitored on the schost-2 node.

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

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWscu

scdpm(1M)

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXIT STATUS

EXAMPLES

Example 1 Monitoring All Disk Paths in the Cluster Infrastructure

Example 2 Monitoring a New Disk Path

Example 3 Monitoring a Disk Path on a Single Node

Example 4 Printing All Disk Paths and the Status

Example 5 Printing All of the Failed Disk Paths

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

ATTRIBUTES

SEE ALSO