HP MPIO Full Featured DSM for P6x00 family of Disk Arrays 4.02.00 installation and reference guide This document provides information about managing, installing, upgrading, and removing HP MPIO Full Featured Device Specific Module (DSM) for P6x00 family of Disk Arrays (called the HP MPIO EVA DSM throughout this document). This document also includes information on support for load balancing in Microsoft Cluster Server (MSCS)/Failover Cluster environments.
Legal and notice information © Copyright 2005, 2011 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 1 Installing the HP MPIO Full Featured DSM for P6x00 family of Disk Arrays ................................................................................................. 7 Preparing for installation .............................................................................................................. 7 Installing HP MPIO EVA DSM ....................................................................................................... 8 Installing HP MPIO EVA DSM on a stand-alone system ....
hpdsm cleanup device ............................................................................................................... hpdsm notify ............................................................................................................................ hpdsm help .............................................................................................................................. Commands to manage the HP EVA DSM parameters ..........................................................
Tables 1 Snapshot of pre-installation checklist ............................................................................ 8 2 Load balancing policies ........................................................................................... 23 3 Notification strings .................................................................................................. 34 4 Document conventions ............................................................................................. 38 5 MPIO.
1 Installing the HP MPIO Full Featured DSM for P6x00 family of Disk Arrays HP MPIO EVA DSM provides multipathing support for HP StorageWorks disk arrays on Windows platforms using the Microsoft Multipath Input-Output (MPIO) framework.
Table 1 lists the information you need before installing the HP MPIO EVA DSM. Table 1 Snapshot of pre-installation checklist Task Check the contents of the HP MPIO EVA DSM kit and the Fibre Channel hardware to ensure nothing is missing. If you are missing any component, contact your account representative, or call the HP Customer Service hotline at (800) 354-9000.
NOTE: For Microsoft Windows Server 2008 – Server Core (x86 and x64) and Microsoft Windows Server 2008 R2 – Server Core (IA64 and x64), you can run Launch.exe from the installation location, using the command prompt. Installing HP MPIO EVA DSM on a clustered system To install HP MPIO EVA DSM on a clustered system, complete the following steps: NOTE: On a clustered system, you must install HP MPIO EVA DSM on one node at a time. Repeat this on all the nodes in a cluster. 1.
1. Complete the pre-installation checklist (Table 1) and the pre-installation procedure, see Preparing for installation. 2. Run Launch.exe from the installation location. 3. In the launch window, click Install HP MPIO Full Featured DSM for P6x00 family of Disk Arrays. 4. Select the upgrade option. 5. Follow the on-screen instructions to complete the upgrade. 6. Reboot the system.
4. Double-click the batch file (depending on your operating system): • For Windows Server 2008 x86: \x86\Win2k8Upgrade.bat • For Windows Server 2008 IA64: \ia64\Win2k8Upgrade.bat • For Windows Server 2008 x64: \amd64\Win2k8Upgrade.bat NOTE: For more information on upgrading the operating system of a clustered system from Windows Server 2003 to Windows Server 2008, see http://support.microsoft.com/kb/935197.
6. Close the Add/Remove Programs window. NOTE: The LUNs may be inaccessible at this time. 7. Reboot the system. NOTE: For Windows Server 2008 – Server Core and Microsoft Windows Server 2008 R2 – Server Core, go to the installation location from the command prompt and run Launch.exe. Select Remove > Remove all installed components, to remove HP MPIO EVA DSM. Using silent installation You can execute the silent installation from the installation location on your computer or from a network drive.
–6 Cannot write to the response file –7 Unable to write to the log file –8 Invalid path to the InstallShield Silent response (.iss) file –51 Cannot create the specified folder –52 Cannot access the specified file or folder NOTE: The C: in /f1C: and /f2C: refers to a local drive on the system or a network drive which is used to obtain the response file and write the MPSInstallLog.txt (provided the directory has the write permission enabled).
Upgrading HP MPIO EVA DSM To upgrade from a previous version of HP MPIO EVA DSM to the current version, complete the following steps: 1. Make a copy of the setup.iss file in the installation location with the name setup.iss. 2. Choose one of the following options: • To upgrade the Microsoft MPIO Framework component along with the DSM component, use the renamed default setup.iss file.
NOTE: When selecting the response on each screen, do not click BACK and modify the selection. In such a case, the response file needs to be generated again. Use this setup.iss file to perform the same silent mode operation on multiple systems across the same platform. Setting up boot from SAN You can set up HP MPIO EVA DSM to boot externally from a SAN that uses HP StorageWorks HBAs and RAID arrays.
Installing the HP MPIO Full Featured DSM for P6x00 family of Disk Arrays
2 Support for load balancing in Failover Cluster Server environment for Windows Server 2008 and Windows Server 2008 R2 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 and Windows Server 2008 R2
3 Support for load balancing in Microsoft Cluster Server environments for Windows Server 2003 This section describes the following: • Enabling or disabling support for load balancing in MSCS environments • Recovering inaccessible disk devices By default, in HP MPIO EVA DSM, load balancing is enabled in Microsoft Cluster Server (MSCS) environments. The MSCS uses SCSI-2 reservations to synchronize access to the cluster-managed devices.
NOTE: You must repeat the following procedure on all nodes in the cluster, one at a time. 1. 2. 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. Run the following command: • To enable the support for load balancing in MSCS environments: hpdsm SetDefaultUsePR y device= • To disable the support for load balancing in MSCS environments: hpdsm SetDefaultUsePR n device= 3.
5. Follow the on-screen instructions and 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 Load balancing Load Balancing is used to distribute I/O request across multiple paths to a logic unit for optimal usage of paths and improve I/O performance. Depending on the load balancing policy set for a logic unit, an appropriate path is selected based on the statistics over that path. The DSM currently supports the following five load balance policies.
NOTE: • All devices that are part of the logical unit group, have the same subset setting. • The subset setting is not applicable for devices that have the No Load Balancing policy enabled. • The subset setting for a given LUN is persistent across Load Balance policies and host system reboots. • The paths that are part of the subset are reported as "Active" and other paths are reported as "Available".
NOTE: • All devices that are part of the Logical Unit Group, has the same ALB setting. • The ALB setting is not applicable for devices that have the No Load Balancing policy enabled. • The ALB setting for a given LUN is persistent across host system reboots. You can modify (enable or disable) the ALB setting for a given LUN either through the HP MPIO DSM Manager or HP DSM CLI. For more information, see Chapter 5. HP MPIO Full Featured DSM for P6x00 family of Disk Arrays 4.02.
Load balancing
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.
hpdsm devices 3 HP HSV210 600508B400101F6A000070001DA10000 9 RR— Subset Disk 3 4.0.1.3 Y 4 HP HSV210 600508B400101F6A000070001E160000 9 SQR Disk 4 3.0.2.4 Y 5 HP HSV210 600508B400101F6A000070001E1C0000 9 NLB Disk 5 2.0.2.5 N 6 HP HSV210 600508B400101F6A000070001E220000 9 NLB Disk 6 2.0.2.6 N 7 HP HSV210 600508B400101F6A000070001E280000 9 SQST— Subset Disk 7 3.0.2.7 N 8 HP HSV210 600508B400101F6A000070001E2E0000 9 SQST Disk 8 3.0.2.
Path# Device#:2 Device Name:HP HSV210 Serial No:6005008B400101F600018000 Active Paths: 2 Policy:SQST-Subset Disk 2 P.B.T.L:3.0.2.4 ALB:N Controller Port# State 1 P898DXAAQQO101U-2 Active 2 P898DXAAQQO101U-2 Available HBA Slot# RTP P.B.T.L 7 00010002 3.0.2.4 6 00010002 4.0.2.4 hpdsm paths device Syntax: hpdsm paths device=x The hpdsm paths device command displays information about the paths available for device x, as shown in the following example. NOTE: • The P.B.T.L.
8 P8398DXAAQQ013-4 Available 3 00020008 4.0.1.1 hpdsm set device policy Syntax: hpdsm set device=x policy=policy Syntax: hpdsm set device=all policy=policy The hpdsm set device policy command sets the load-balancing policy for device x or for all device, depending on the input parameter specified. The following example demonstrates the information displayed by the hpdsm set device policy command.
Example: hpdsm set device=1 subset=add path=all Device Name:HP HSV210 Device Serial No.:600508B400101F6A000070001D950000 Change Subset setting (y/n)? y Subset setting changed. Verify by using "hpdsm devices" command. Example: hpdsm set device=all subset=remove path=1 Successful for all the devices. Verify by using "hpdsm devices" command.
Example: hpdsm set device=all alb=y Successful for all the devices. Verify by using "hpdsm devices" command. hpdsm set device path Syntax: hpdsm set device=x path=y The hpdsm set device path command changes the preferred path for device x, as shown in the following example. NOTE: Use the hpdsm paths device command to view the available paths for the device. hpdsm set device=1 path=1 Device Name:HP HSV210 Device Serial No.:600508B400101F6A000070001D950000 Controller Port No.
Cleanup Succeeded. Verify by issuing "hpdsm devices" command. Example: hpdsm cleanup device=all Successful for all the devices. Verify by issuing "hpdsm devices" command. hpdsm notify Syntax: hpdsm notify event=notification_event_number time=number_of_minutes The hpdsm notify command defines user notification of events. The time attribute defines the number of minutes that elapses from the time the event occurs until the user is notified. The maximum value that can be entered is 35000 minutes.
Table 3 defines the selections for the notification command string. Table 3 Notification strings Notification string Notification_event_number 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.
HPDSM NOTIFY EVENT=7 TIME=5 TIME:7/4/2008,15:20:08:13) nl Received HPDSM_PATH_FAILOVER:600508B400101F6A000070001D950000;from hpeaadsm (TIME:7/4/2008,15:20:08:42) nl Received HPDSM_PATH_FAILOVER:600508B400101F6A000070001D9B0000;from hpeaadsm (TIME:7/4/2008,15:20:08:65) nl Received HPDSM_PATH_FAILOVER:600508B400101F6A000070001DA10000;from hpeaadsm (TIME:7/4/2008,15:20:08:88) nl Received HPDSM_PATH_FAILOVER:600508B400101F6A000070001E160000;from hpeaadsm (TIME:7/4/2008,15:20:08:114) nl Received HPDSM_DEVIC
• • • • • HPDSM HPDSM HPDSM HPDSM HPDSM GetDefaultLBPolicy device GetDefaultALBSetting device GetDefaultUsePR device GetDefaultDsmLoadOrder device ReStoreFactoryDefaults device For more information on using these commands run the hpdsm help command.
6 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.com/support/ Before contacting HP, collect the following information • Product model names and numbers • Technical support registration number (if applicable) • Product serial numbers • Error messages • Operating system type and revision level • Detailed questions For continuous quality improvement, calls may be recorded or monitored.
• http://www.hp.com/support/ • http://www.docs.hp.com Documentation feedback HP welcomes your feedback. To make comments and suggestions about product documentation, please send a message to storagedocsFeedback@hp.com. All submissions become the property of HP. Product feedback To make comments and suggestions about HP MPIO Full Featured DSM for P6x00 family of Disk Arrays 4.02.00, please send a message to multipathfeedback@hp.com.
IMPORTANT: Provides clarifying information or specific instructions. NOTE: Provides additional information. HP MPIO Full Featured DSM for P6x00 family of Disk Arrays 4.02.
Support and other resources
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 • HPEAADSM.SYS is the HP DSM driver for EVA disk arrays.
HP MPIO EVA DSM command line interface (CLI) The HP MPIO EVA DSM command line interface (HPDSM.EXE) enables you to monitor and manage HP DSMs in an MPIO environment. HP MPIO EVA DSM performance monitoring provider The HP MPIO EVA DSM performance monitoring provider (HpPerfProv.DLL) allows you to monitor the Input-Output (I/O) performance of a device path using the system monitor. To start the performance monitoring, complete the following steps: 1.
Example: hpprutil devices Device# Device Name SCSI Address Reservation NT Disk# 1 COMPAQ HSV210 3.0.2.1 PR Disk1 2 COMPAQ HSV210 3.0.2.2 PR Disk2 hpprutil clear device Syntax: hpprutil clear device=x Syntax: hpprutil clear device=m n The hpprutil clear device command clears the reservation present on device x, or clears the reservation present on devices starting from m to n (both inclusive), depending on the input parameter specified.
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 5 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 18 A Single Path Fail-Over is being attempted on pseudo-LUN. A pseudo-LUN has just one path, and DSM has requested a failover. The Path ID of the failing device 19 An operation failed on devicedue to lack of memory. Resource allocation failed during an attempted failover, and failover is not currently active. The Path ID of the failing device 20 A Path Verification request to a device on pseudoLUN that is controlled by DSM_namehas failed.
Event ID Message Description DSM_name failed to return a Path to pseudo-LUN. One of the following events occurred during failover: MPIO’s call to the DSMs InvalidatePath failed; DSM did not return a new path; DSM did not return a path when MPIO called the LBGetPath routine. N/A 33 DSM_name returned a bogus path todevice. MPIO is unable to find an operational device-path pair representation (device info) for the path that the DSM wants to use for the I/O to the device.
HP MPIO EVA DSM event log messages Table 6 lists the HP MPIO EVA DSM event log messages and provides a description of each message. Table 6 HP MPIO EVA DSM event log messages Event ID Message Description 101 Discovered a new multipath capable disk with serial number X; first path SCSI address Y. A new multipath disk has been discovered. X represents the serial number of the new disk. Y is the SCSI address of the first path to this disk.
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.
Event ID Message Description 308 An unrecoverable failure has occurred on multipath capable disk X. The data on this disk may be inaccessible. This event is logged when the DSM detects an unrecoverable failure of a multipath capable disk. Although the disk may be visible to the system, the data on the disk may not be accessible. Please check the status of the multipath capable disk at the array end. X represents the serial number of the disk.
C 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.
Solution: Re-scan the host by performing the following steps: 1. Go to Device Manager>Disk drives. 2. Right-click and select Scan for hardware changes. Problem: The vendor specific load balance policy (Shortest Queue Service Time) may not be displayed in the MPIO property sheet. Solution: Use HP DSM CLI or HP MPIO DSM Manager to set the vendor specific load balance policy.
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.
• Available — Path is currently available, but not used for device access. The path is only in this state when no load balancing policy has been selected for the LUN. • Standby — Intermediate state of the path before it is initialized (made ready for device access), normally will not be seen. • Failed — Path is currently unusable for the I/O stream. 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.
Index P B boot from SAN, 15 C commands for managing storage arrays, 27 components, software, 41 conventions, text symbols, 38 D disk devices, inaccessible, recovering, 17, 21 documentation HP website, 37 providing feedback, 38 drivers Multipathing bus, 41 replacement class, 41 E event log messages, 48 H HP Subscriber's choice website, 37 performance monitoring provider, 42 persistent reservation clear utility, 42 pre-installation, 7 products providing feedback, 38 R recovering inaccessible disk devic
