stmsboot(1M) System Administration Commands stmsboot(1M)NAMEstmsboot - administration program for the Solaris I/O multipathing fea‐
ture
SYNOPSIS
/usr/sbin/stmsboot [[-D (fp | mpt | iscsi) ] -d | -e | -u]
| -L | -l controller_number]
DESCRIPTION
The Solaris I/O multipathing feature is a multipathing solution for
storage devices that is part of the Solaris operating environment. This
feature was formerly known as Sun StorEdge Traffic Manager (STMS) or
MPxIO.
The stmsboot program is an administrative command to manage enumeration
of multipath-capable devices with Solaris I/O multipathing. Solaris I/O
multipathing-enabled devices are enumerated under scsi_vhci(7D), pro‐
viding multipathing capabilities. Solaris I/O multipathing-disabled
devices are enumerated under the physical controller.
In the /dev and /devices trees, Solaris I/O multipathing-enabled
devices receive new names that indicate that they are under Solaris I/O
multipathing control. This means a device will have a different name
from its original name (after enabling) when it is under Solaris I/O
multipathing control. The stmsboot command automatically updates
/etc/vfstab and dump configuration to reflect the device names changes
when enabling or disabling Solaris I/O multipathing. One reboot is
required for changes to take effect.
OPTIONS
The following options are supported:
-e [ -D fp | mpt | iscsi ]
Enables Solaris I/O multipathing on all supported multipath-capable
controller ports, including fp(7D), mpt(7D), and iscsi(7D) port
drivers. Multipath-capable ports include fibre channel (fp(7D))
controller ports and SAS (mpt(7D)) controller ports. Following this
enabling, you are prompted to reboot. During the reboot, vfstab and
the dump configuration will be updated to reflect the device name
changes. Specifying either -D mpt or -D fp limits the enabling
operation to ports attached using the specified driver.
-d [ -D fp | mpt | iscsi ]
Disables Solaris I/O multipathing on all supported multipath-capa‐
ble controller ports, including fp(7D), mpt(7D), and iscsi(7D) port
drivers. Multipath-capable ports include fibre channel (fp(7D))
controller ports and SAS (mpt(7D)) controller ports. Following this
disabling, you are prompted to reboot. During the reboot, vfstab
and the dump configuration will be updated to reflect the device
name changes. Specifying either -D mpt or -D fp limits the dis‐
abling operation to ports attached using the specified driver.
-u [ -D fp | mpt | iscsi ]
Updates vfstab and the dump configuration after you have manually
modified the configuration to have Solaris I/O multipathing enabled
or disabled on specific fp(7D), mpt(7D), and iscsi(7D) controller
ports. This option prompts you to reboot. During the reboot, vfstab
and the dump configuration will be updated to reflect the device
name changes.
-L
Display the device name changes from non-Solaris I/O multipathing
device names to Solaris I/O multipathing device names for multi‐
path-enabled controller ports. If Solaris I/O multipathing is not
enabled, then no mappings are displayed.
-l controller_number
Display the device name changes from non-Solaris I/O multipathing
device names to Solaris I/O multipathing device names for the spec‐
ified controller. If Solaris I/O multipathing is not enabled, then
no mappings are displayed.
USAGE
The primary function of stmsboot is to control the enabling and dis‐
abling of Solaris I/O multipathing on the host. The utility automati‐
cally updates vfstab(4) and dumpadm(1M) configuration to reflect device
name changes. The system administrator is responsible for modifying
application configuration (for example, backup software, DBMS, and so
forth) to reflect updated device names.
The -L and -l options display the mapping between multipathed and non-
multipathed device names. These options function only after changes to
the Solaris I/O multipathing configuration have taken effect, that is,
following the reboot after invoking stmsboot-e.
ZFS datasets, including ZFS root datasets, are correctly handled by
stmsboot.
EXAMPLES
Example 1 Enabling Solaris I/O Multipathing
To enable Solaris I/O multipathing for all multipath-capable con‐
trollers, run:
# stmsboot-e
To enable Solaris I/O multipathing on multipath-capable mpt(7D) con‐
troller ports, enter:
# stmsboot-D mpt -e
To enable Solaris I/O Multipathing on multipath-capable fibre channel
controller ports, enter:
# stmsboot-D fp -e
To enable Solaris I/O Multipathing on multipath-capable iSCSI con‐
troller ports, enter:
# stmsboot-D iscsi -e
Example 2 Disabling Solaris I/O Multipathing
To disable Solaris I/O multipathing on all multipath-capable con‐
trollers, enter:
# stmsboot-d
To disable Solaris I/O multipathing on multipath-capable mpt(7D) con‐
troller ports, enter:
# stmsboot-D mpt -d
To disable Solaris I/O multipathing on multipath-capable iSCSI con‐
troller ports, enter:
# stmsboot-D iscsi -d
To disable Solaris I/O multipathing on multipath-capable fibre channel
controller ports, enter:
# stmsboot-D fp -d
Example 3 Enabling Solaris I/O Multipathing on Selected Ports
To enable Solaris I/O multipathing on specific fibre channel controller
ports and disable the feature on others, manually edit the /ker‐
nel/drv/fp.conf file. (Seefp(7D).) The following command will update
vfstab(4) and dumpadm(1M) configurations to reflect the changed device
names:
# stmsboot-u
A similar procedure involving the /kernel/drv/mpt.conf file should be
followed for devices attached by means of the mpt(7D) driver. For
devices attached by means of the iscsi(7D) driver, follow a similar
procedure that uses the /kernel/drv/iscsi.conf file.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcs, system/library │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Obsolete │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOdumpadm(1M), fsck(1M), mpathadm(1M), ufsdump(1M), zfs(1M), zpool(1M),
dumpdates(4), vfstab(4), emlxs(7D), fcp(7D), fp(7D), iscsi(7D),
mpt(7D), qlc(7D), scsi_vhci(7D)
Solaris SAN Configuration and Multipathing Guide (see
http://docs.sun.com)
Consult a particular storage product's system administrator's guide and
release notes for further information specific to that product.
NOTES
Solaris I/O multipathing is not supported on all devices. After
enabling Solaris I/O multipathing, only supported devices are placed
under Solaris I/O multipathing control. Non-supported devices remain
unchanged.
For Solaris releases prior to the current release, the -e and -d
options replace mpxio-disable property entries with a global mpxio-dis‐
able entry in fp.conf.
Enabling Solaris I/O Multipathing on a Sun StorEdge Disk Array
The following applies to Sun StoreEdge T3, 3910, 3960, 6120, and 6320
storage subsystems.
To place your Sun StorEdge disk subsystem under Solaris I/O multi‐
pathing control, in addition to enabling Solaris I/O multipathing, the
mp_support of the subsystem must be set to mpxio mode. The preferred
sequence is to change the subsystem's mp_support to mpxio mode, then
run stmsboot-e. If Solaris I/O multipathing is already enabled but the
subsystem's mp_support is not in mpxio mode, then change the mp_support
to mpxio mode and run stmsboot-u.
Refer to the Sun StorEdge Administrator's Guide for your subsystem for
more details.
Using ufsdump
The ufsdump(1M) command records details of filesystem dumps in
/etc/dumpdates (see dumpdates(4)). Among other items, the entries con‐
tain device names. An effect of the "active" stmsboot options (-e, -d,
and -u) is to change the device name of a storage device.
Because stmsboot does not modify dumpdates, entries will refer to obso‐
lete device names, that is, device names that were in effect before
Solaris I/O multipathing configuration changes were performed. In this
situation ufsdump will behave as if no previous dump of the filesystem
had been performed. A level 0 dump will be performed.
Procedure to Use stmsboot in Conjunction with Sun Cluster
If possible, invoke stmsboot-e before installing Sun Cluster software.
After executing stmsboot, install Sun Cluster software normally.
If Sun Cluster software is installed before executing stmsboot, follow
this procedure:
On each machine in the cluster where Solaris I/O multipathing is
required, execute:
# stmsboot-e
...and allow the system to reboot.
When the system comes up, enter the following two commands:
1. # /usr/cluster/bin/scdidadm -C
2. # /usr/cluster/bin/scdidadm -r
The preceding commands update did mappings with new device
names while preserving did instance numbers for disks that
are connected to multiple cluster nodes. did instance num‐
bers of the local disks might not be preserved. For this
reason, the did disk names for local disks might change.
3. Update /etc/vfstab to reflect any new did disk names for
your local disks.
4. Reboot the system.
To disable the Solaris multipathing feature, use stmsboot-d (instead
of stmsboot -e), then follow the procedure above.
To view mappings between the old and new device names, run stmsboot-L.
To view did device name mappings, run /usr/cluster/bin/scdidadm -L.
With active-passive storage arrays, it is possible that while your host
is rebooting the array controller could failover the path that a par‐
ticular target is using. In this scenario, fsck(1M) will fail to open
the physical path listed in /etc/vfstab. The svc:/system/filesys‐
tem/local:default SMF service will transition to a maintenance state as
a result. To rectify this, consult the documentation for your storage
array to failback the path. The mpathadm(1M) can assist with determin‐
ing the active and passive path(s).
LIMITATIONS
On x86 platforms, the current Solaris release does not support dis‐
abling Solaris I/O multipathing of boot devices attached by means of
fibre channel. Solaris I/O multipathing is always enabled for supported
fibre channel-attached boot devices. Disabling Solaris I/O multipathing
in this situation must be performed on a per-port basis. See fp(7D).
Executing devfsadm -C removes obsolete device entries that stmsboot
relies on. This will prevent correct operation of the -d option for
boot devices (regardless of platform type) and the -L option.
SunOS 5.11 24 Apr 2009 stmsboot(1M)