|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Administration Commands stmsboot(1M)
NAME
stmsboot - administration program for the Solaris I/O mul-
tipathing feature
SYNOPSIS
/usr/sbin/stmsboot [-d | -e | -u | -L |
-l controller_number]
DESCRIPTION
The Solaris I/O multipathing feature is a multipathing solu-
tion for storage devices that is part of the Solaris operat-
ing 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 fibre channel devices under Solaris I/O mul-
tipathing. Solaris I/O multipathing-enabled devices are
enumerated under scsi_vhci(7D), providing multipathing capa-
bilities. 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
(following installation) when it is under Solaris I/O mul-
tipathing 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. A reboot is required for changes to take
effect.
OPTIONS
The following options are supported:
-e
Enables Solaris I/O multipathing on all fibre channel
(fp(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.
-d
Disables Solaris I/O multipathing on all fibre channel
(fp(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.
SunOS 5.10 Last change: 3 Mar 2005 1
System Administration Commands stmsboot(1M)
-u
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) con-
troller 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.
-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 specified controller.
USAGE
Along with its primary function of enabling or disabling
Solaris I/O multipathing, the stmsboot command is used to
update vfstab and the dump configuration to reflect device
name changes. For a system to function properly, you must
configure the applications that consume the devices by old
names to use the new names.
The -L and -l options display the mapping between the old
and new device names. These options work after the changes
made to the Solaris I/O multipathing configuration have
taken effect. For example, you can use these options follow-
ing the reboot after invoking stmsboot -e. The old device
names must exist in order to display the mappings.
EXAMPLES
Example 1: Enabling Solaris I/O Multipathing Following OS
Upgrade
To enable Solaris I/O multipathing on all fibre channel
(fp(7D)) controller ports run:
# stmsboot -e
SunOS 5.10 Last change: 3 Mar 2005 2
System Administration Commands stmsboot(1M)
Example 2: Disabling Solaris I/O Multipathing
To disable Solaris I/O multipathing on all fibre channel
(fp(7D)) controller ports, run:
# stmsboot -d
Example 3: Enabling Solaris I/O Multipathing on Selected
Ports
You want to enable Solaris I/O multipathing on some fibre
channel controller ports and disable the feature on the
rest. You edit the fp.conf file (see fp(7D)) to enable or
disable Solaris I/O multipathing on specific controller
ports. You then run the following command to have vfstab and
the dump configuration updated to reflect the new device
names:
# stmsboot -u
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Architecture | SPARC |
|_____________________________|_____________________________|
| Availability | SUNWcsu, SUNWcslr |
|_____________________________|_____________________________|
| Interface Stability | Obsolete |
|_____________________________|_____________________________|
SEE ALSO
dumpadm(1M), ufsdump(1M), dumpdates(4), vfstab(4), fcp(7D),
fctl(7D), fp(7D), qlc(7D), scsi_vhci(7D)
Consult the Sun StorEdge Disk Tray [or Subsystem]
Administrator's Guide for the T3, 3910, 3960, 6120, and 6320
storage subsystems.
Sun StorEdge Traffic Manager Installation and Configuration
Guide
NOTES
Solaris I/O multipathing is not supported on all devices.
After enabling Solaris I/O multipathing, only those devices
that Solaris I/O multipathing supports are placed under
SunOS 5.10 Last change: 3 Mar 2005 3
System Administration Commands stmsboot(1M)
Solaris I/O multipathing control. Non-supported devices
remain as before.
For Solaris releases prior to the current release, the -e
and -d options remove the mpxio-disable property entries
from fp.conf file (see fp(7D)) and add a global mpxio-
disable entry to fp.conf.
The current release of the Solaris operating system does not
support the mpxio-disable property. Solaris I/O multipathing
is always enabled. If you want to disable multipathing, you
must use the mechanisms provided by the HBA drivers. See
fp(7D).
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
multipathing 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.
ufsdump Users
The ufsdump command keeps records of the filesystem dumps in
/etc/dumpdates (see dumpdates(4)). Among other items, the
records contain device names. An effect of the "active"
stmsboot options (-e, -d, and -u) is to change the device
name of a storage device. The stmsboot command does not
modify the dumpdates file. Because of this, the dumpdates
records will refer to the old device names, that is, the
device names that were in effect before you ran stmsboot.
The effect of this device name-dumpdates disagreement is
that, following use of stmsboot, ufsdump will be processed
as if no previous dump had ever been made, thus dumping the
entire filesystem (effectively, a level 0 dump).
Procedure to Use stmsboot in Sun Cluster Environment
If possible, use stmsboot -e before you start installing Sun
Cluster software. After you run stmsboot, you install Sun
Cluster software as you normally would.
If you install Sun Cluster software before running stmsboot,
you must use the following procedure.
SunOS 5.10 Last change: 3 Mar 2005 4
System Administration Commands stmsboot(1M)
On each machine in the cluster on which you want to enable
the Solaris multipathing feature, enter:
# 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 dev-
ice names while preserving did instance numbers for
disks that are connected to multiple cluster nodes. did
instance numbers 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.
SunOS 5.10 Last change: 3 Mar 2005 5
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:26:41 GMT 2007
|
Your favourite pages:
No pages logged yet... Top 10 most popular pages:
prstat man page (24355 hits)
(Solaris 10 11_06)
netcat man page (17577 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (13442 hits)
(Solaris 10 11_06)
signal man page (12532 hits)
(Suse Linux 10.1)
startproc man page (11929 hits)
(Suse Linux 10.1)
raidctl man page (11285 hits)
(Solaris 10 11_06)
adv_cap_autoneg man page (10224 hits)
(Solaris 10 11_06)
sqlite3 man page (9706 hits)
(openSUSE 10.2)
CPAN man page (8917 hits)
(Suse Linux 10.1)
BusyBox man page (7623 hits)
(Suse Linux 10.1)
|
Man Pages 
