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/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/7 (798)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/7 (878)
          Group 1:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/6 (790)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/6 (876)
          Group 2:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/5 (782)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/5 (874)
          Group 3:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/4 (774)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/4 (872)
          Group 4:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/3 (766)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/3 (870)
          Group 5:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/2 (758)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/2 (868)
          Group 6:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/1 (750)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/1 (866)
          Group 7:
            [ ] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/0 (748)
            [P] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/0 (858)

     The current primary path is indicated by a [P] in the right column. Each
     LUN is shown as an independent failover group with two paths. For all but
     LUN 0, the primary path is accessible through the SP (Storage Processor)
     connected to SCSI bus /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0. For
     LUN 0, the primary path is accessible through the SP connected to SCSI
     bus /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0.

     Initiating failover:

     The following example shows the initiation of failover of Group 5 (see
     above example). The primary path will migrate from the SP connected to
     SCSI bus /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0 to the SP
     connected to SCSI bus /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0. Note
     that the devscsi device will be used for initiating the failover.

          scsifo -s /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/2/scsi

          sample output:

          New primary path /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/2/scsi (869)

     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/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/7 (798)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/7 (878)
          Group 1:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/6 (790)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/6 (876)
          Group 2:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/5 (782)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/5 (874)
          Group 3:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/4 (774)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/4 (872)
          Group 4:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/3 (766)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/3 (870)
          Group 5:
            [ ] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/2 (758)
            [P] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/2 (868)
          Group 6:
            [P] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/1 (750)
            [ ] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/1 (866)
          Group 7:
            [ ] /hw/module/2/slot/io5/mscsi/pci/2/scsi_ctlr/0/target/1/lun/0 (748)
            [P] /hw/module/2/slot/io5/mscsi/pci/3/scsi_ctlr/0/target/2/lun/0 (858)
FILES
     /usr/sbin/scsifo
     /dev/rdsk/*
     /dev/dsk/*
     /dev/scsi/*
     /var/sysgen/master.d/failover


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 fo_auto_failover_on_start. See
     /var/sysgen/master.d/failover.