This appendix provides solutions to potential problems that might occur while running the Sun StorageTek Traffic Manager software.
This appendix contains the following sections:
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.
Type the root password and enter single user mode.
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.
Prior to the Solaris 10 Update 4 OS, this service was known as svc:/platform/sun4u/mpxio-upgrade:default.
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.
Boot the system from another disk, CD, DVD, or over the network.
Run the fsck your-root-device command where your-root-device is your original root device.
# fsck your-root-device
Mount your original root device.
# mount your-root-device /mnt
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.
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.
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.
If the system is running on a Solaris 10 Update 4 OS (or later) x86 based system, perform the following steps:
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.
Update the boot archive.
# bootadm update-archive -R /mnt
Disable the mpxio-upgrade service:
# /usr/sbin/svccfg -f /mnt/etc/mpxio/svccfg_recover
Type sync to synchronize the file systems.
Unmount the device.
# umount /mnt
Reboot the system.