Solaris SAN Configuration and Multipathing Guide

Appendix C Multipathing Troubleshooting

This appendix provides solutions to potential problems that might occur while running the Sun StorageTek Traffic Manager software.

This appendix contains the following sections:

System Fails to Boot During stmsboot

During the reboot following stmsboot enable (-e), disable (-d), or update (-u) operations if the system fails to boot but lets you enter single user mode, perform the following to recover.

ProcedureTo Recover From Single User Mode

  1. Type the root password and enter single user mode.

  2. Restart the mpxio-upgrade service.


    # svcadm restart svc:/system/device/mpxio-upgrade:default
    

    If this command is not successful, follow the instructions in the next section to recover your original configuration.


    Note –

    Prior to the Solaris 10 Update 4 OS, this service was known as svc:/platform/sun4u/mpxio-upgrade:default.


System Crashes During stmsboot

During the reboot following stmsboot enable (-e), disable (-d), or update (-u) operations, if your system hangs, panics, or fails to boot, follow the instructions below to recover your original configuration.

ProcedureTo Recover from a System Crash

  1. Boot the system from another disk, CD, DVD, or over the network.

  2. Run the fsck your-root-device command where your-root-device is your original root device.


    # fsck your-root-device
    
  3. Mount your original root device.


    # mount your-root-device /mnt
    
  4. Restore your original fp.conf file (for FC multipathing) or mpt.conf (for SAS multipathing) as follows.

    • If you ran the stmsboot -e command or stmsboot -d command:

      • For SAS multipathing, type the command cp /mnt/etc/mpxio/mpt.conf /mnt/kernel/drv/mpt.conf

      • For FC multipathing, type the command cp /mnt/etc/mpxio/fp.conf /mnt/kernel/drv/fp.conf

    • If you ran the stmsboot -u command, and you modified either the fp.conf file or the mpt.conf undo the changes you made to this file by editing either the /mnt/kernel/drv/fp.conf or the /mnt/kernel/drv/mpt.conf files.

  5. Undo any other changes you made to the multipathing configuration prior to running the stmsboot command.

    For example, if you modified the scsi_vhci.conf file, undo the changes you made to this file by editing the /mnt/kernel/drv/scsi_vhci.conf file.

    If you modified the device settings of your storage arrays, restore their original settings.

  6. Restore your original /etc/vfstab file:


    # cp /mnt/etc/mpxio/vfstab /mnt/etc/vfstab
    

    The /mnt/etc/mpxio/vfstab file is a copy your original /etc/vfstab file that the stmsboot command saved prior to updating your vfstab file. A /mnt/etc/mpxio/vfstab file will not exist if the stmsboot command has not modified your vfstab file.

  7. If the system is running on a Solaris 10 Update 4 OS (or later) x86 based system, perform the following steps:

    1. Restore your original /boot/solaris/bootenv.rc file.


      # cp /mnt/etc/mpxio/bootenv.rc /mnt/boot/solaris/bootenv.rc
      

      The /mnt/etc/mpxio/bootenv.rc file is a copy your original /boot/solaris/bootenv.rc file that the stmsboot command saved prior to updating your bootenv.rc file. A /mnt/etc/mpxio/bootenv.rc file will not exist if the stmsboot command has not modified your bootenv.rc file.

    2. Update the boot archive.


      # bootadm update-archive -R /mnt
      
  8. Disable the mpxio-upgrade service:


    # /usr/sbin/svccfg -f /mnt/etc/mpxio/svccfg_recover
    
  9. Type sync to synchronize the file systems.

  10. Unmount the device.


    # umount /mnt
    
  11. Reboot the system.