installation and reference guide HP MPIO Full Featured DSM for EVA3000/5000 VCS 4.xxx 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
hpdsm help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A Software components . . . . . . . . . . . . . . . . . . . . . . Drivers . . . . . . . . . . . . . . . . . . . . . . User mode components . . . . . . . . . . . . . . . HP MPIO DSM manager GUI . . . . . . . . . . HP MPIO EVA DSM command line interface (CLI) . . HP MPIO EVA DSM performance monitoring provider HP MPIO EVA DSM persistent reservations clear utility hpprutil devices . . . . . . . . . . . . . .
Figures 1 MPIO Properties page with MPIO-ed Devices tab enabled . . . . . . . . . . . . . . 44 . . . . . . . . . . . . . 45 3 MPIO Properties page with DSM Install tab enabled . . . . . . . . . . . . . . . . . 46 4 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . . 47 5 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . . 48 6 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . .
Tables 1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Pre-installation checklist 6 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3 Notification strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 4 MPIO.SYS event log messages . . . . . . . . . . . . . . . . . . . . . . . . . . 39 5 HP MPIO EVA DSM event log messages . . . . . . . . . . . . . . . . . . . . . . 41 6 HP DSM equivalent load balance policies 48 . . . . .
About this guide This guide provides information about HP MPIO Full Featured Device Specific Module (DSM) for EVA3000/5000 VCS 4.
Document conventions and symbols Table 1 Document conventions Convention Element Medium blue text: Related documentation Cross-reference links and e-mail 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 DSM for EVA3000/5000 VCS 4.xxx Disk Arrays HP MPIO Full Featured Device Specific Module (DSM) for EVA3000/5000 VCS 4.xxx Disk Arrays (HP MPIO EVA DSM) provides multipathing support for HP StorageWorks EVA 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 EVA 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. Obtain and review the most current versions of the following documents: • HP MPIO Full Featured DSM for EVA3000/5000 VCS 4.
Installing HP MPIO EVA DSM on cluster configurations To install HP MPIO EVA DSM on each member of a cluster configuration, complete the steps below: NOTE: In a cluster configuration, HP MPIO EVA DSM must be installed on one node at a time for all nodes of 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. Pause the current cluster node.
Upgrading HP MPIO EVA DSM on cluster configurations To upgrade HP MPIO EVA DSM from a previous version on each member of a cluster configuration, complete the steps below: NOTE: In a cluster configuration, HP MPIO EVA DSM must be upgraded on one node at a time for all 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 EVA DSM To remove the HP MPIO EVA DSM, 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. You must disconnect the server from the multipath storage or eliminate all but one path to that storage from the server prior to removing the HP MPIO EVA DSM. To remove HP MPIO EVA DSM, complete the steps below: 1. Back up all user data on multipath storage. 2.
• Upgrading HP MPIO EVA DSM • Removing HP MPIO EVA 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.iss is the response file from which information is taken for silent installation. The MPSInstallLog.txt file records information about the silent installation. The ResponseResult section of the MPSInstallLog.
• 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\EGL DSM with C:\Program Files (x86)\Hewlett-Packard\HP MPIO DSM\EGL DSM. • To install into the user specified directory for both 32 and 64 bit systems, in lines 27 and 32 of the setup.iss file, replace szDir = with szDir = . 4.
Customized response files can be created by running the setup.exe in the record mode on one of the systems. This response file can then be used for doing the same silent mode operation across multiple systems. To create response file, complete the following steps: 1. At the command prompt, type the following command: setup.exe /r, where /r option enables the record mode. 2. This results to run the GUI installation in the record mode.
2 Support for load balancing in Failover Cluster Server environment for Windows Server 2008 The load balancing for the cluster devices is enabled by default and cannot be turned OFF. This section describes the following: • Recovering inaccessible disk devices Recovering inaccessible disk devices If there is a stray reservation on a disk device, the device becomes inaccessible to the host systems connected to it.
Support for load balancing in Failover Cluster Server environment for Windows Server 2008
3 Support for load balancing in Microsoft Cluster Server environments for Windows Server 2003 This section describes the following: • Enabling support for load balancing in MSCS environments • Disabling support for load balancing in MSCS environments • Recovering inaccessible disk devices By default, HP MPIO EVA DSM supports the No Load Balancing policy in Microsoft Cluster Server (MSCS) environments. This is because MSCS uses SCSI-2 reservations to synchronize access to the cluster-managed devices.
1. If MSCS is installed on your system, move all cluster resources owned by the current node to another node in the cluster. If this is not applicable, proceed to step 2. 2. Navigate to the HP MPIO EVA DSM installation directory on the current node using Windows Explorer. 3. Double-click the registry file (depending upon the operating system you are using): • For Windows Server 2003 (32-bit): \x86\hpegldsm_pr_on.reg • For Windows Server 2003 (IA64): \IA64\hpegldsm_pr_on.
4. Follow the on-screen instructions. 5. Reboot the system for the new registry parameter to take effect. IMPORTANT: During the process of enabling or disabling of load balance in an MSCS environment (for a cluster with more than two nodes), you may have a set of nodes using SCSI-3 persistent reservations along with another set of nodes using SCSI-2 reservations.
Support for load balancing in Microsoft Cluster Server environments for Windows Server 2003
4 Adaptive Load Balance The HP MPIO EVA DSM implements array specific load balancing algorithms that utilize certain features supported by the disk arrays, to deliver better performance for host I/O requests. The Adaptive Load Balance (ALB) setting is supported on a per logical unit basis and works in conjunction with the load balancing policies supported by the DSM, which includes Round Robin, Shortest Queue Requests, Shortest Queue Bytes, and Shortest Queue Service Time.
Adaptive Load Balance
5 Managing storage arrays using the HP MPIO EVA DSM with the CLI utility The command line interface utility (CLI) of HP MPIO EVA DSM enables you to monitor and manage multipathing devices.
7 COMPAQ HSV111_(C)COMPAQ 600508B4000149B50002800000410000 8 RR Disk7 3.0.3.7 N 8 COMPAQ HSV111_(C)COMPAQ 600508B4000149B50002800000470000 8 SQR Disk8 3.0.3.8 N 9 COMPAQ HSV111_(C)COMPAQ 600508B4000149B500028000004D0000 8 SQR Disk9 3.0.3.9 N hpdsm devices all Syntax: hpdsm devices all The hpdsm devices all command displays the information of the device, followed by their path information as shown in the following example.
NOTE: • The P.B.T.L. column shows the device port, bus, target, and LUN. • The RTP column shows the target port information as defined by SCSI-3 specification. • The Controller Port# column shows the controller serial number followed by target port number. hpdsm paths device=1 Path# Controller Port# State HBA Slot# RTP P.B.T.L 1 P4889B59IM501F-1 Active 4 00010001 5.0.0.1 2 P4889B59IM501F-2 Active 4 00010002 5.0.1.1 3 P4889B59IM5024-1 Active 4 00020003 5.0.3.
hpdsm set device=1 policy=sqst Device Name : COMPAQ HSV111_(C)COMPAQ Device Serial No. : 600508B4000149B500028000001D0000 Change Load Balance policy (y/n)? Load Balance policy changed. y Verify by issuing "hpdsm devices" command. Example: hpdsm set device=all policy=rr Successful for all the devices. Verify by issuing "hpdsm devices" command.
hpdsm paths device=x set device=1 path=1 Device Name : COMPAQ HSV111_(C)COMPAQ Device Serial No. : 600508B4000149B500028000001D0000 Controller Port No. : P4889B59IM501F 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.
Received Received Received Received HPDSM_NEW_DEVICE HPDSM_NEW_DEVICE HPDSM_NEW_DEVICE HPDSM_NEW_DEVICE : : : : 600508B4000149B500028000003B0000;(2.0.0.6);from 600508B4000149B50002800000410000;(2.0.0.7);from 600508B4000149B50002800000470000;(2.0.0.8);from 600508B4000149B500028000004D0000;(2.0.0.9);from hpegldsm hpegldsm hpegldsm hpegldsm hpdsm help Syntax: hpdsm help The hpdsm help command displays help information for the CLI. HP MPIO Full Featured DSM for EVA3000/5000 VCS 4.xxx Disk Arrays 3.00.
Managing storage arrays using the HP MPIO EVA DSM with the CLI utility
A Software components This appendix describes the following components of HP MPIO EVA DSM: • Drivers • User mode components Drivers The HP MPIO EVA DSM components include the following multipath drivers: • Microsoft MPIO 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 DSM driver • HPEGLDSM.SYS is the HP DSM driver for EVA3000/5000 VCS 4.xxx disk arrays.
To start the performance monitoring, complete the steps below: 1. Select Start > Programs > Hewlett-Packard > EGL DSM > Path Performance. Alternatively, you can select Start > Run and execute the command perfmon /wmi. 2. Select HP DSM High Performance Provider performance object and add the appropriate counters.
Example: hpprutil clear device=1 The requested operation is in progress. Please wait. HPPRUTIL will attempt to clear the reservation on device 1. Are you sure you want to continue (y/n)? y Attempting to clear the reservation on device 1... reservation on device. Successfully cleared the hpprutil clear device=1 2 The requested operation is in progress. Please wait. HPPRUTIL will attempt to clear the reservation on device 1 to 2.
Software components
B Multipathing driver event log messages This appendix lists the event log messages for HP MPIO EVA DSM drivers and provides a description of each message. The error log messages are written in the SYSTEM log file. This appendix describes the following event log messages: • MPIO.SYS event log messages • HP MPIO EVA DSM event log messages MPIO.SYS event log messages Table 4 lists MPIO driver event log messages, an explanation of each message, and a description of the data that accompanies the message.
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 112 The removal event notifications for multipath capable disk X have been enabled upon request. This event is logged when generation of removal event notifications (Event IDs 304, 302 and 108) for the multipath capable disk with serial number X has been enabled upon request in the DSM. 113 The multipath capable disk X has been disconnected from the system.
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 EVA3000/5000 VCS 4.xxx 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 6 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 50 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. ALB Adaptive Load Balance (ALB) is a feature provided by the EVA DSM that utilizes certain features supported by the array, to deliver better performance for host I/O requests. controller A hardware device that facilitates communication between a host and one or more LUNs organized as an array.
port A The relative number of an HBA. A specific port number is determined according to its order of discovery by the Windows operating system. HBA’s include SCSI, Fibre Channel, and IDE adapter types. SAN Storage Area Network. A configuration of networked devices for storage. state An attribute that describes the current operational condition of an object. The possible states include: • Good: The multipathing device can be accessed on at least one path.
Index B M boot from SAN, 18 C commands for managing storage arrays, 27 components, software, 35 conventions, text symbols, 8 D disk devices, inaccessible, recovering, 19, 23 documentation, HP web site, 7 drivers Multipathing bus, 35 replacement class, 35 E event log messages, 41 H HP Subscriber’s choice web site, 9 HP helpful web sites, 9 messages, event log, 41 MPDEV.SYS, 35 MPIO.SYS, 35 MPIO.
