Command Reference Guide

Chapter 1: Matrix Server Commands 24

Display Status Information

The status command displays MPIO status information, including the

timeout value, whether MPIO is enabled (globally and per-device), and any

targets specified with the active command. Use the -l option to display more

information about the targets, as in the above example.

$ mxmpio status

In contrast with the earlier example, this example shows output for a system

that is not MPIO:

# /opt/polyserve/sbin/mxmpio status -l

MPIO Failover is globally enabled

Failover Timeout Targets

psd1 enabled 30000 0. (41:50) scsi2/0/2/19

psd1p1 enabled 10000 0. (41:51) scsi2/0/2/19

psd1p2 enabled 30000 0. (41:52) scsi2/0/2/19

psd2 enabled 30000 0. (41:10) scsi2/0/1/20

psd2p1 enabled 10000 0. (41:11) scsi2/0/1/20

psd2p2 enabled 30000 0. (41:12) scsi2/0/1/20

Set the Timeout Value

The default timeout period for PSD devices is 30 seconds. If you need to

modify this value for a particular PSD device, use the following command.

value is in milliseconds; however, the smallest unit is 10 milliseconds. A value

of zero disables timeouts.

# mxmpio timeout value [PSD-device]

Show Number of Transient Errors

The mpiostat command lists the number of transient errors for each target

and shows the number of failovers and fatal errors for each device. Values

represent the number of respective events since the device was bound. If

devices have not been rebound since boot, then this represents the number of

events since boot.

Show Load Statistics

The mpioload command shows the load (number of pending I/Os, both total

and raw) for each target (SCSI command I/Os) and total for the PSD device

(block layer I/Os), number of failovers, and fatal errors for each device.