A P P E N D I X  C

Multipathing Troubleshooting

This appendix provides solutions to potential problems that may occur while running the Solaris FC and Storage Multipathing 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.

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

2. Restart the mpxio-upgrade service.


# svcadm restart svc:/platform/sun4u/mpxio-upgrade:default

If it doesn't work follow the instructions in the next section to recover your original configuration.


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.

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 by performing one of the following steps:

If you ran stmsboot -e or -d:


# cp /mnt/etc/mpxio/fp.conf /mnt/kernel/drv/fp.conf
 
The /mnt/etc/mpxio/fp.conf file is a copy of your original fp.conf
file that stmsboot command saved prior to updating your fp.conf file.

If you ran the stmsboot -u command, and you modified the fp.conf file prior to running the stmsboot command, undo the changes you made to this file by editing /mnt/kernel/drv/fp.conf file.

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. Disable the mpxio-upgrade service:


# /usr/sbin/svccfg -f /mnt/etc/mpxio/svccfg_recover

8. Unmount the device.


# umount /mnt

9. Reboot.