scsifo(1m) scsifo(1m)
NAME
scsifo - Show Failover status and initiate Failover.
SYNOPSIS
The command line syntax of scsifo takes two flavors depending on the use.
scsifo -d
scsifo -s device name
DESCRIPTION
The first form is used to dump failover status, while the second is used
to initiate failover. The device name required when performing a failover
should be that of the a disk (raw or block) or a devscsi device
associated with the primary path of the group the failover is being
attempted on.
EXAMPLES
Dumping the current failover status:
The following example shows a single SCSI RAID configured with 8 LUNs.
scsifo -d
sample output:
Group 0:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/7 (587) (sc4d2l7)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/7 (790) (sc5d2l7)
Group 1:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/6 (579) (sc4d2l6)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/6 (782) (sc5d2l6)
Group 2:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/5 (571) (sc4d2l5)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/5 (774) (sc5d2l5)
Group 3:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/4 (563) (sc4d2l4)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/4 (766) (sc5d2l4)
Group 4:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/3 (555) (sc4d2l3)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/3 (758) (sc5d2l3)
Group 5:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/2 (547) (sc4d2l2)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/2 (750) (sc5d2l2)
Group 6:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/1 (539) (sc4d2l1)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/1 (742) (sc5d2l1)
Group 7:
[ ] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/0 (531) (sc4d2l0)
[P] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/0 (734) (sc5d2l0)
Page 1
scsifo(1m) scsifo(1m)
The current primary path is indicated by a [P] in the left column. Each
LUN is shown as an independent failover group with two paths. For all but
LUN 0, the primary path is accessible via SCSI bus
/hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0. For LUN 0, the primary
path is accessible via /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0.
The devscsi name is displayed at the end of each name. This name can be
used to initiate failover.
Initiating failover:
The following example shows the initiation of failover of Group 5 (see
above example). The primary path will migrate from SCSI bus
/hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0 to SCSI bus
/hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0. Note that the devscsi
device name will be used for initiating the failover. It is possible to
initiate failover using the full canonical name, e.g.,
/hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/2/scsi.
scsifo -s sc4d2l2
sample output:
New primary path /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/2/scsi (869) (sc5d2l2)
Another dump of the failover status shows that LUN 2 (group 5) has in
fact migrated.
scsifo -d
sample output:
Group 0:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/7 (587) (sc4d2l7)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/7 (790) (sc5d2l7)
Group 1:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/6 (579) (sc4d2l6)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/6 (782) (sc5d2l6)
Group 2:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/5 (571) (sc4d2l5)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/5 (774) (sc5d2l5)
Group 3:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/4 (563) (sc4d2l4)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/4 (766) (sc5d2l4)
Group 4:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/3 (555) (sc4d2l3)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/3 (758) (sc5d2l3)
Group 5:
[ ] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/2 (547) (sc4d2l2)
[P] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/2 (750) (sc5d2l2)
Group 6:
[P] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/1 (539) (sc4d2l1)
[ ] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/1 (742) (sc5d2l1)
Page 2
scsifo(1m) scsifo(1m)
Group 7:
[ ] /hw/module/1/slot/io3/mscsi/pci/2/scsi_ctlr/0/target/2/lun/0 (531) (sc4d2l0)
[P] /hw/module/1/slot/io3/mscsi/pci/3/scsi_ctlr/0/target/2/lun/0 (734) (sc5d2l0)
FILES
/usr/sbin/scsifo
/dev/rdsk/*
/dev/dsk/*
/dev/scsi/*
/etc/init.d/failover
/etc/failover.conf
/var/sysgen/master.d/failover
SEE ALSO
failover(7M).
NOTES
On bootup, if only a single path is found for a failover group and it's
not the primary, auto failover may be performed depending on the setting
of the kernel tunable variable foautofailoveronstart. See
/var/sysgen/master.d/failover. This does not apply to devices defined
within the /etc/failover.conf configuration file.
Page 3