Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ././../../../../../../usr/man/man8/stmsboot.8
Real path: /usr/share/man/man8/stmsboot.8
Zurück

'\" te .\" Copyright (c) 2008, 2021, Oracle and/or its affiliates. .TH stmsboot 8 "11 May 2021" "Oracle Solaris 11.4" "System Administration Commands" .SH NAME stmsboot \- administration program for the Oracle Solaris I/O multipathing feature .SH SYNOPSIS .LP .nf \fB/usr/sbin/stmsboot\fR [[\fB-D\fR (fp | lsc | mpt | mpt_sas | pmcs | iscsi) ] \fB-d\fR | \fB-e\fR | \fB-u\fR] | \fB-L\fR | \fB-l\fR \fIcontroller_number\fR] .fi .SH DESCRIPTION .sp .LP The Oracle Solaris I/O multipathing feature is a multipathing solution for storage devices that is part of the Oracle Solaris operating system. This feature was formerly known as Sun StorEdge Traffic Manager (STMS) or MPxIO. .sp .LP The \fBstmsboot\fR program is an administrative command to manage enumeration of multipath-capable devices with Oracle Solaris I/O multipathing. The Oracle Solaris I/O multipathing-enabled devices are enumerated under \fBscsi_vhci\fR(4D), providing multipathing capabilities. Oracle Solaris I/O multipathing-disabled devices are enumerated under the physical controller. .sp .LP In the \fB/dev\fR and \fB/devices\fR trees, the Oracle Solaris I/O multipathing-enabled devices receive new names that indicate that they are under the Oracle Solaris I/O multipathing control. This means a device will have a different name from its original name (after enabling) when it is under Oracle Solaris I/O multipathing control. The \fBstmsboot\fR command automatically updates \fB/etc/vfstab\fR and dump configuration to reflect the device names changes when enabling or disabling Oracle Solaris I/O multipathing. One reboot is required for changes to take effect. .SH OPTIONS .sp .LP The following options are supported: .sp .ne 2 .mk .na \fB\fB-e\fR [ \fB-D\fR \fBfp | mpt | mpt_sas | iscsi\fR ]\fR .ad .br .sp .6 .RS 4n Enables Oracle Solaris I/O multipathing on all supported multipath-capable controller ports, including \fBfp\fR(4D), \fBmpt\fR(4D), \fBmpt_sas\fR(4D), and \fBiscsi\fR(4D) port drivers. Multipath-capable ports include Fibre Channel (\fBfp\fR(4D)) controller ports and SAS (\fBmpt\fR(4D) or \fBmpt_sas\fR(4D)) controller ports. Following this enabling, you are prompted to reboot. During the reboot, \fBvfstab\fR and the dump configuration will be updated to reflect the device name changes. Specifying \fB-D\fR \fBmpt\fR, \fB-D\fR \fB mpt_sas\fR, or \fB-D\fR \fBfp\fR limits the enabling operation to ports attached using the specified driver. .RE .sp .ne 2 .mk .na \fB\fB-d\fR [ \fB-D\fR \fBfp | mpt | mpt_sas | iscsi\fR ]\fR .ad .br .sp .6 .RS 4n Disables Oracle Solaris I/O multipathing on all supported multipath-capable controller ports, including \fBfp\fR(4D), \fBmpt\fR(4D), \fBmpt_sas\fR(4D), and \fBiscsi\fR(4D) port drivers. Multipath-capable ports include Fibre Channel (\fBfp\fR(4D)) controller ports and SAS (\fBmpt\fR(4D) or \fBmpt_sas\fR(4D)) controller ports. Following this disabling, you are prompted to reboot. During the reboot, \fBvfstab\fR and the dump configuration will be updated to reflect the device name changes. Specifying \fB-D\fR \fBmpt\fR, \fB-D\fR \fB mpt_sas\fR, or \fB-D\fR \fBfp\fR limits the disabling operation to ports attached using the specified driver. .RE .sp .ne 2 .mk .na \fB\fB-u\fR [ \fB-D\fR \fBfp | mpt | mpt_sas | iscsi\fR ]\fR .ad .br .sp .6 .RS 4n Updates \fBvfstab\fR and the dump configuration after you have manually modified the configuration to have Oracle Solaris I/O multipathing enabled or disabled on specific \fBfp\fR(4D), \fBmpt\fR(4D), \fBmpt_sas\fR(4D), and \fBiscsi\fR(4D) controller ports. This option prompts you to reboot. During the reboot, \fBvfstab\fR and the dump configuration will be updated to reflect the device name changes. .RE .sp .ne 2 .mk .na \fB\fB-L\fR\fR .ad .br .sp .6 .RS 4n Display the device name changes from non-Solaris I/O multipathing device names to Oracle Solaris I/O multipathing device names for multipath-enabled controller ports. If Oracle Solaris I/O multipathing is not enabled, then no mappings are displayed. .RE .sp .ne 2 .mk .na \fB\fB-l\fR \fIcontroller_number\fR\fR .ad .br .sp .6 .RS 4n Display the device name changes from non-Solaris I/O multipathing device names to Oracle Solaris I/O multipathing device names for the specified controller. If the Oracle Solaris I/O multipathing is not enabled, then no mappings are displayed. .RE .sp .LP Note that \fBmpt_sas\fR(4D) has MPxIO turned on by default. This means that when using the \fB-L\fR or \fB-l\fR option with \fB-D\fR \fBmpt_sas\fR, \fBstmsboot\fR does not display any non-multipathed and multipathed device names. .SH USAGE .sp .LP The primary function of \fBstmsboot\fR is to control the enabling and disabling of the Oracle Solaris I/O multipathing on the host. The utility automatically updates \fBvfstab\fR(5) and \fBdumpadm\fR(8) 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. .sp .LP The \fB-L\fR and \fB-l\fR options display the mapping between multipathed and non-multipathed device names. These options function only after changes to the Oracle Solaris I/O multipathing configuration have taken effect, that is, following the reboot after invoking \fBstmsboot\fR \fB-e\fR. .sp .LP ZFS datasets, including ZFS root datasets, are correctly handled by \fBstmsboot\fR. .SH EXAMPLES .LP \fBExample 1\fR Enabling Oracle Solaris I/O Multipathing .sp .LP To enable Oracle Solaris I/O multipathing for all multipath-capable controllers, run: .sp .in +2 .nf # \fBstmsboot -e\fR .fi .in -2 .sp .sp .LP To enable Oracle Solaris I/O multipathing on multipath-capable \fBmpt\fR(4D) controller ports, enter: .sp .in +2 .nf # \fBstmsboot -D mpt -e\fR .fi .in -2 .sp .sp .LP To enable Oracle Solaris I/O multipathing on multipath-capable \fBmpt_sas\fR(4D) controller ports, enter: .sp .in +2 .nf # \fBstmsboot -D mpt_sas -e\fR .fi .in -2 .sp .sp .LP To enable Oracle Solaris I/O Multipathing on multipath-capable Fibre Channel controller ports, enter: .sp .in +2 .nf # \fBstmsboot -D fp -e\fR .fi .in -2 .sp .sp .LP To enable Oracle Solaris I/O Multipathing on multipath-capable iSCSI controller ports, enter: .sp .in +2 .nf # \fBstmsboot -D iscsi -e\fR .fi .in -2 .sp .LP \fBExample 2\fR Disabling Oracle Solaris I/O Multipathing .sp .LP To disable Oracle Solaris I/O multipathing on all multipath-capable controllers, enter: .sp .in +2 .nf # \fBstmsboot -d\fR .fi .in -2 .sp .sp .LP To disable Oracle Solaris I/O multipathing on multipath-capable \fBmpt\fR(4D) controller ports, enter: .sp .in +2 .nf # \fBstmsboot -D mpt -d\fR .fi .in -2 .sp .sp .LP To disable Oracle Solaris I/O multipathing on multipath-capable \fBmpt_sas\fR(4D) controller ports, enter: .sp .in +2 .nf # \fBstmsboot -D mpt_sas -d\fR .fi .in -2 .sp .sp .LP To disable Oracle Solaris I/O multipathing on multipath-capable iSCSI controller ports, enter: .sp .in +2 .nf # \fBstmsboot -D iscsi -d\fR .fi .in -2 .sp .sp .LP To disable Oracle Solaris I/O multipathing on multipath-capable fibre channel controller ports, enter: .sp .in +2 .nf # \fBstmsboot -D fp -d\fR .fi .in -2 .sp .LP \fBExample 3\fR Enabling Oracle Solaris I/O Multipathing on Selected Ports .sp .LP To enable Oracle Solaris I/O multipathing on specific Fibre Channel controller ports and disable the feature on others, manually edit the \fB/etc/driver/drv/fp.conf\fR file. (See \fBfp\fR(4D).) The following command will update \fBvfstab\fR(5) and \fBdumpadm\fR(8) configurations to reflect the changed device names: .sp .in +2 .nf # \fBstmsboot -u\fR .fi .in -2 .sp .sp .LP A similar procedure involving the \fB/etc/driver/drv/mpt.conf\fR file should be followed for devices attached by means of the \fBmpt\fR(4D) driver. For devices attached by means of the \fBiscsi\fR(4D) driver, follow a similar procedure that uses the \fB/etc/driver/drv/iscsi.conf\fR file. .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Availability system/device-administration _ Interface Stability Obsolete .TE .sp .SH SEE ALSO .sp .LP \fBemlxs\fR(4D), \fBfcp\fR(4D), \fBfp\fR(4D), \fBiscsi\fR(4D), \fBmpt\fR(4D), \fBmpt_sas\fR(4D), \fBqlc\fR(4D), \fBscsi_vhci\fR(4D), \fBufsdump\fR(5), \fBvfstab\fR(5), \fBdumpadm\fR(8), \fBfsck\fR(8), \fBmpathadm\fR(8), \fBufsdump\fR(8), \fBzfs\fR(8), \fBzpool\fR(8) .sp .LP \fIManaging SAN Devices and I/O Multipathing in Oracle Solaris 11.4\fR .sp .LP Consult a particular storage product's system administrator's guide and release notes for further information specific to that product. .SH NOTES .sp .LP The Oracle Solaris I/O multipathing is not supported on all devices. After enabling the Oracle Solaris I/O multipathing, only supported devices are placed under the Oracle Solaris I/O multipathing control. Non-supported devices remain unchanged. .sp .LP For Oracle Solaris releases prior to the current release, the \fB-e\fR and \fB-d\fR options replace \fBmpxio-disable\fR property entries with a global \fBmpxio-disable\fR entry in \fBfp.conf\fR. .SS "Using \fBufsdump\fR" .sp .LP The \fBufsdump\fR(8) command records details of filesystem dumps in \fB/etc/dumpdates\fR (see \fBufsdump\fR(5)). Among other items, the entries contain device names. An effect of the "active" \fBstmsboot\fR options (\fB-e\fR, \fB-d\fR, and \fB-u\fR) is to change the device name of a storage device. .sp .LP Because \fBstmsboot\fR does not modify \fBdumpdates\fR, entries will refer to obsolete device names, that is, device names that were in effect before the Oracle Solaris I/O multipathing configuration changes were performed. In this situation \fBufsdump\fR will behave as if no previous dump of the filesystem had been performed. A level 0 dump will be performed. .SS "Procedure to Use \fBstmsboot\fR in Conjunction with Oracle Solaris Cluster" .sp .LP If possible, invoke \fBstmsboot\fR \fB-e\fR before installing Oracle Solaris Cluster software. After executing \fBstmsboot\fR, install Oracle Solaris Cluster software normally. .sp .LP If Oracle Solaris Cluster software is installed before executing \fBstmsboot\fR, follow this procedure: .LP Note - .sp .RS 2 .sp .LP Complete all steps on a single node before beginning any of the steps on a second node. .RE .RS +4 .TP .ie t \(bu .el o On each machine in the cluster where Oracle Solaris I/O multipathing is required, execute the following steps on one cluster node at a time and allow the system to reboot. .sp .in +2 .nf # \fBstmsboot -e\fR .fi .in -2 .sp .RE .RS +4 .TP .ie t \(bu .el o When the system comes up, enter the following two commands: .RS +4 .TP 1. # \fB/usr/cluster/bin/scdidadm -C\fR .RE .RS +4 .TP 2. # \fB/usr/cluster/bin/scdidadm -r\fR .sp The preceding commands update \fBdid\fR mappings with new device names while preserving \fBdid\fR instance numbers for disks that are connected to multiple cluster nodes. \fBdid\fR instance numbers of the local disks might not be preserved. For this reason, the \fBdid\fR disk names for local disks might change. .sp The remaining steps are required only if local \fBdid\fR number changes require editing of \fB/etc/vfstab\fR. If such editing is not required, run \fB/usr/cluster/bin/scgdevs\fR command and then \fB/usr/cluster/bin/clquorum status\fR command from the cluster node to complete the procedure on this node. .RE .RE .RS +4 .TP .ie t \(bu .el o Update \fB/etc/vfstab\fR to reflect any new \fBdid\fR disk names for your local disks. .RE .RS +4 .TP .ie t \(bu .el o Reboot the system. .RE .sp .LP To disable the Oracle Solaris multipathing feature, use \fBstmsboot\fR \fB-d\fR (instead of \fBstmsboot\fR \fB-e\fR), then follow the procedure above. .sp .LP To view mappings between the old and new device names, run \fBstmsboot\fR \fB-L\fR. To view \fBdid\fR device name mappings, run \fB/usr/cluster/bin/scdidadm\fR \fB-L\fR. .sp .LP With active-passive storage arrays, it is possible that while your host is rebooting the array controller could failover the path that a particular target is using. In this scenario, \fBfsck\fR(8) will fail to open the physical path listed in \fB/etc/vfstab\fR. The \fBsvc:/system/filesystem/local:default\fR 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 \fBmpathadm\fR(8) can assist with determining the active and passive path(s). .SH LIMITATIONS .sp .LP On x86 platforms, the current Oracle Solaris release does not support disabling the Oracle Solaris I/O multipathing of boot devices attached by means of fibre channel. The Oracle Solaris I/O multipathing is always enabled for supported fibre channel-attached boot devices. Disabling the Oracle Solaris I/O multipathing in this situation must be performed on a per-port basis. See \fBfp\fR(4D). .sp .LP Executing \fBdevfsadm\fR \fB-C\fR removes obsolete device entries that \fBstmsboot\fR relies on. This will prevent correct operation of the \fB-d\fR option for boot devices (regardless of platform type) and the \fB-L\fR option.