installation and reference guide HP MPIO Full Featured DSM for MSA1000/1500 (Active-Active) Disk Arrays 3.00.
Legal and notice information © Copyright 2006, 2008 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice.
Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . Intended audience . . . . . . . Related documentation . . . . . Document conventions and symbols HP technical support . . . . . . HP-authorized reseller . . . . . Helpful web sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
hpprutil devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . hpprutil clear devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . hpprutil help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 29 29 B Multipathing driver event log messages . . . . . . . . . . . . . . . . 31 C Managing MPIO devices using Microsoft-provided interfaces on Windows Server 2008 . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 MPIO.
Figures 1 MPIO Properties page with MPIO-ed Devices tab enabled . . . . . . . . . . . . . . 36 . . . . . . . . . . . . . 37 3 MPIO Properties page with DSM Install tab enabled . . . . . . . . . . . . . . . . . 38 4 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . . 39 5 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . . 40 6 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . .
Tables 1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Pre-installation checklist 6 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3 Notification strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 4 HP MPIO DSM manager GUI files . . . . . . . . . . . . . . . . . . . . . . . . . 27 5 MPIO.SYS event log messages . . . . . . . . . . . . . . . . . . . . . . . . . . 31 6 HP MPIO MSA DSM event log messages . . . . . . . . . .
About this guide This guide provides information about HP MPIO Full Featured DSM for MSA1000/1500 (Active-Active) Disk Arrays (called the “HP MPIO MSA DSM” throughout this guide), including: • Installing HP MPIO MSA DSM software • Managing HP MPIO MSA DSM Intended audience This document is intended for customers of HP MPIO MSA DSM and users who are experienced with the following: • • • • • Microsoft Windows Server 2003 (x86, IA64 and x64) MSA1000/1500 (Active-Active) Disk Array Microsoft Cluster Server (M
Document conventions and symbols Table 1 Document conventions Convention Element Medium blue text: Related documentation Cross-reference links and email addresses Medium blue, underlined text (http://www.hp.
HP technical support Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support/. Collect the following information before calling: • • • • • • Technical support registration number (if applicable) Product serial numbers Product model names and numbers Applicable error messages Operating system type and revision level Detailed, specific questions For continuous quality improvement, calls may be recorded or monitored.
About this guide
1 Installing the HP MPIO Full Featured Device Specific Module (DSM) for MSA1000/1500 (Active-Active) Disk Arrays software HP MPIO Full Featured DSM for MSA1000/1500 (Active-Active) Disk Arrays (HP MPIO MSA DSM) provides multipathing support for HP StorageWorks disk arrays on Windows platforms using the Microsoft Multipath Input-Output (MPIO) framework.
Table 2 Pre-installation checklist Task Check the contents of the HP MPIO MSA DSM kit and the Fibre Channel hardware to make sure nothing is missing. If you are missing any component, contact your account representative, or call the HP Customer Service hotline at (800) 354-9000.
Installing HP MPIO MSA DSM on cluster configurations To install HP MPIO MSA DSM on each member of a cluster configuration: NOTE: In a cluster configuration, HP MPIO MSA DSM must be installed on one cluster at a time. 1. Complete the pre-installation checklist (Table 2) and the pre-installation procedure. 2. Using Cluster Administrator: • Move all cluster shared storage to one server. • Pause cluster node A. • Disable failback for all groups containing resources managed by MSCS. 3.
Upgrading HP MPIO MSA DSM on cluster configurations To upgrade HP MPIO MSA DSM from a previous version on each member of a cluster configuration, complete the steps below: NOTE: In a cluster configuration, HP MPIO MSA DSM must be upgraded on one node at a time for all the nodes in the cluster. 1. Complete the pre-installation checklist (Table 2) and the pre-installation procedure. 2. Using Cluster Administrator: a. Move all cluster resources owned by the current node to another node in the cluster. b.
Removing HP MPIO MSA DSM software To remove the HP MPIO MSA DSM software you must re-configure the SAN and reboot your server. CAUTION: Removing multipathing software from a multipath hardware configuration can cause data loss or corruption. Be sure to disconnect the server from multipath storage or eliminate all but one path to that storage from the server prior to removing the HP MPIO MSA DSM software.
This section describes how to use silent installation to perform a new installation or to remove an existing installation, including: • • • • Installing HP MPIO MSA DSM Upgrading HP MPIO MSA DSM Removing HP MPIO MSA DSM Creating response files for silent mode operations Syntax :\MPInstall\setup.exe /s /f1"C:\setup.iss" /f2"C:\MPSInstallLog.txt" The refers to the drive which contains the installation media. The setup.
Installing HP MPIO MSA DSM To perform a silent installation of HP MPIO MSA DSM: 1. Make a copy of the new.iss file in the installation kit. 2. Rename this copy of the file as setup.iss 3. Choose one of the following options: • To install into the default directory for 64 bit systems, in lines 27 and 32 of the setup.iss file, replace C:\Program Files\Hewlett-Packard\HP MPIO DSM\MSA DSM with C:\Program Files (x86)\Hewlett-Packard\HP MPIO DSM\MSA DSM.
Creating response files for silent mode operations The package contains the following response files (.iss files): new.iss, uninstall.iss and update.iss that are used for silent mode installation and uninstallation respectively. In addition to these, you can create your own customized response files for operations (such as modify/repair) with different combinations of the components selected/unselected. Customized response files can be created by running the setup.
2 Support for load balancing in Failover Cluster Server environment for Windows Server 2008 By default, the load balancing for the cluster devices is enabled and cannot be turned OFF in Windows Server 2008. • Recovering inaccessible disks Recovering inaccessible disks If there is a stray reservation on a disk device, the device becomes inaccessible to the host systems connected to it. This is because the strong reservation type (persistent resevations) supports load balancing in clusters.
Support for load balancing in Failover Cluster Server environment for Windows Server 2008
3 Managing storage arrays using the HP MPIO MSA DSM with the CLI utility The Command Line Interface utility (CLI) for HP MPIO MSA DSM provides the ability to monitor and manage multipathing devices.
hpdsm devices all Syntax: hpdsm devices all The hpdsm devices all command displays information of the device, followed by their path information as shown in the following example. If there are no devices, the following message is displayed: No devices found. NOTE: See hpdsm set device policy for a definition of the policies. The P.B.T.L. column shows the device port, bus, target, and LUN. Example: hpdsm devices all Device# Device Name Serial No. Active Paths Policy Disk# P.B.T.
hpdsm paths device=1 Path# Controller Port# State HBA Slot# RTP P.B.T.L 1 P56350FX3Q5006-1 Available 4 00010001 3.1.3.1 2 P56350GX3RI0F6-1 Available 4 00020002 4.1.3.
hpdsm set device=1 path=1 Device Name : HP MSA_VOLUME Device Serial No. : 600508B300912160AF87D3596705001B Controller Port No. : P56350FX3Q5006 Change Load Balance policy (y/n)? Preferred Path changed. y Verify by issuing "hpdsm paths device=" command.
Table 3 Notification strings Notification_ event_ number Notification string Notifies the user when DSM: HPDSM_NEW_DEVICE 1 Detects a new device. HPDSM_ADDITIONAL_PATH 2 Detects a redundant path to an existing device. HPDSM_MAX_PATH_REACHED 3 Determines that a device configuration contains the maximum number of supported paths. HPDSM_LAST_PATH_FAILURE 4 Detects that the last path to the device is removed.
Managing storage arrays using the HP MPIO MSA DSM with the CLI utility
A Software components This appendix describes the HP MPIO MSA DSM software components, including: • Drivers • User mode components Drivers The HP MPIO MSA DSM software components include the following multipath drivers: • Microsoft Framework Drivers • MPIO.SYS is the Multipathing bus driver. • MPDEV.SYS is the replacement class driver. It communicates with MPIO.SYS. • MPSPFLTR.SYS is a port driver filter (HBA upper filter). • HP Device Specific Module (DSM) driver • HPMAADSM.
File Description SpNotifier.dll Used by the SpMonitor.exe to send E-mail notifications. SpEditCfg.exe Creates and modifies the configuration file for E-mail notifications. SpMonitor.exe Sends E-mail notifications using the configuration information specified in the file SPNotificationConfig.xml. BlankSPNotificationConfig.xml Used as a blank template file used by the SpEditCfg.exe to create the actual configuration file for E-mail notifications. SPNotificationConfig.xml Generated by SpEditCfg.
hpprutil devices Syntax: hpprutil devices The hpprutil devices command displays details of reservations on the devices as shown below in the following example. If there are no devices present, the following message is displayed: No devices found. Example: hpprutil devices Device# Device Name SCSI Address Reservation NT Disk# 1 HP MSA_VOLUME 3.0.0.12 SCSI Disk 1 2 HP MSA_VOLUME 3.0.0.13 SCSI Disk 2 3 HP MSA_VOLUME 3.0.0.
Software components
B Multipathing driver event log messages This appendix lists event log messages for HP MPIO MSA DSM drivers and provides a description of each message. The error log messages are written to the SYSTEM log file. This appendix provides information about the following event log messages: • MPIO.SYS event log messages • HP MPIO MSA DSM event log messages MPIO.
Event ID Message Description Contents of the data dump 20 A Path Verification request to a device on pseudo-LUN that is controlled by DSM_name has failed. This may indicate a path failure. A call to a DSM’s PathVerify routine to a pseudo-LUN has failed. This event occurs during final initialization after PathVerify has checked whether the device can be reached through a newly found path. N/A 21 The internal state of device_object is inconsistent. This indicates potential failures in this support.
Event ID Message Description Contents of the data dump 37 DSM_name is attempting an operation on pseudo-LUN. The Type is noted in the dump data. DSM_name has called DSMNotification on a pseudo-LUN. The type of notification called by DSM 38 A device under pseudo-LUN, being controlled by DSM_name was removed, but the DSM failed the operation. An MPIO call to DSM’s RemoveDevice operation failed.
Event ID Message Description 304 An unrecoverable path failure occurred on SCSI address Y. Disk X is still accessible over redundant path(s). A redundant path to an existing multipath disk has failed. X represents the serial number of the disk. Y is the SCSI address of the path that failed. 309 The DSM cannot manage multipath capable disk X (SCSI address Y) due to an internal error. The DSM cannot manage multipath capable disk X (SCSI address Y) due to an internal error.
C Managing MPIO devices using Microsoft-provided interfaces on Windows Server 2008 This appendix describes how to manage MPIO devices using the Microsoft-provided interfaces on Windows Server 2008. Beginning with Microsoft Windows Server 2008, Multipath I/O (earlier called MPIO framework) is provided as an operating system feature. Along with the feature, a few interfaces are provided to enable you to manage the MPIO framework and devices.
Figure 1 MPIO Properties page with MPIO-ed Devices tab enabled To manually add support for new devices, complete the following steps: 1. Click Add in the MPIO Properties page. The Add MPIO Support page displays. 2. Enter the Vendor ID and Product ID for the new devices. All devices with this Device Hardware ID are handled by a DSM (either a vendor-supplied DSM or MS DSM). To manually disable support for a device, select a Device Hardware ID and click Remove.
Figure 2 MPIO Properties page with Discover Multi-Paths tab enabled To enable multipath support for the listed devices, select a Device Hardware ID, and click Add. All devices with this hardware ID are handled by a DSM (either a vendor-supplied DSM or MS DSM). DSM Install In the MPIO Properties page, click the DSM Install tab. This tab enables you to install a vendor-supplied DSM. While installing a DSM, you must specify the driver path, the INF file name, and the DSM Hardware ID.
Figure 3 MPIO Properties page with DSM Install tab enabled NOTE: If the vendor-supplied DSM and MS DSM exist on the same system, the vendor-supplied DSM is always given priority. Managing multipath disk devices Microsoft provides a generic user interface to manage the disk devices that are controlled by MPIO. This interface, which can be accessed through the Multi-Path Disk Device Properties page, under the MPIO tab, enables you to perform basic disk and path management.
Figure 4 Multi-Path Disk Device Properties page 3. Select the MPIO tab. The Properties page displays all information about the selected device (such as Load Balance Policy, DSM Name, number of paths, and path-related information). You can modify the Load Balance Policy of the device by selecting the appropriate policy from the drop-down menu. Figure 5 displays the load balancing policies for HP DSM. HP MPIO Full Featured DSM for MSA1000/1500 (Active-Active) Disk Arrays 3.00.
Figure 5 Multi-Path Disk Device Properties page NOTE: • HP DSM does not support all the load balance policies listed in the drop-down menu. • The names of the load balance policies as listed in the drop-down menu may differ from that used by the HP DSM CLI and HP MPIO DSM Manager. Table 7 lists the HP DSM equivalent load balance policies.
Figure 6 Multi-Path Disk Device Properties page 5. Modify the MPIO Timer Counters associated with DSM, if required, and click OK. NOTE: Modifying the timer counters for the DSM may result in unexpected system behavior. HP recommends that you do not modify these counters before consulting the HP Service personnel. 6. To change the path state, select the path and click Edit. The MPIO Path Details page for the path displays. Figure 7 shows the MPIO Path Details page. 7.
Figure 7 MPIO Path Details page 42 Managing MPIO devices using Microsoft-provided interfaces on Windows Server 2008
D Troubleshooting This appendix discusses some of the common problems that you may encounter while using the HP MPIO DSM. It also describes how to troubleshoot these problems. Problem: HP MPIO DSM fails to load and displays a yellow-bang in the Device Manager screen. Solution: To troubleshoot this problem, complete one of the following: • Verify if the Multi-path I/O feature is enabled. If not, enable the Multi-path I/O feature.
Troubleshooting
Glossary This glossary defines the terms used in this guide or related to this product. It is not a comprehensive glossary of computer terms. controller A hardware device that facilitates communication between a host and one or more LUNs organized as an array. DSM Device Specific Module fabric A network that contains high-speed fiber connections resulting from the interconnection of switches and devices. A fabric is an active and intelligent non-shared interconnect scheme for nodes.
state An attribute that describes the current operational condition of an object. The possible state include: • Good: The multipathing device can be accessed on at least one path. • Degraded: One or more paths are failed to the storage unit. target The definition of target depends on the environment: • For parallel SCSI configurations, the target is the actual target number assigned to a device.
Index B MPIO.