3.5.1 Matrix Server Command Reference

Chapter 1: Matrix Server Commands 24

paths on a per-server basis across the cluster. This is possible because

mxmpioʹs controls are server specific.

You can use the following command to specify either a particular HBA or a

PSD device. Matrix Server will then fail over the I/O to the path that includes

the specified device. In the command, PSD-device is specified by the base

name of the device path, such as psd2p1 (not /dev/psd/psd2p1).

# mxmpio active <target> <psddev>

target can be one of the following values:

With the exception of I (the array index), the value specified is converted to

the corresponding host adapter/channel before being used to select the target.

An example of changing the I/O path

In this example, we will change the target for a device. The mxmpio status -l

command identifies the path currently being used by each device. That path

is labeled “active.” The following output shows that device psd2p1 is active

on target 1.

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

MPIO Failover is globally enabled

Failover Timeout Targets

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

1. (08:90) scsi1/0/2/19

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

1. (08:91) scsi1/0/2/19 (active)

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

1. (08:92) scsi1/0/2/19

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

I A numerical index on the PSD device target array (0..).

M,m A decimal major/minor number identifying the host adapter.

M:m A hexadecimal major/minor number identifying the host

adapter.

scsiN/C A scsi bus ID. N is the scsi host adapter ID (0..) and C is the scsi

host channel number (0..) as defined in /proc/scsi/scsi and

/proc/scsi/*/[0-9]. If C is omitted, zero is assumed.

sdNsP A device node in /dev. The value is converted to a major/minor

number identifying the corresponding host adapter.