installation and reference guide HP MPIO Full Featured DSM for XP family of 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 XP DSM command line interface (CLI) . . HP MPIO XP DSM performance monitoring provider HP MPIO XP DSM persistent reservations clear utility hpprutil devices . . . . . . . . . . . . . .
Figures 1 MPIO Properties page with MPIO-ed Devices tab enabled . . . . . . . . . . . . . . 42 . . . . . . . . . . . . . 43 3 MPIO Properties page with DSM Install tab enabled . . . . . . . . . . . . . . . . . 44 4 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . . 45 5 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . . 46 6 Multi-Path Disk Device Properties page . . . . . . . . . . . . . . . . . . . . . . .
Tables 1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Pre-installation checklist 6 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 3 Notification strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 4 MPIO.SYS event log messages . . . . . . . . . . . . . . . . . . . . . . . . . . 37 5 HP MPIO XP DSM event log messages . . . . . . . . . . . . . . . . . . . . . . . 39 6 HP DSM equivalent load balance policies 46 . . . . .
About this guide This guide provides information about HP MPIO Full Featured Device Specific Module (DSM) for XP family of Disk Arrays (called the “HP MPIO XP DSM” throughout this guide), including: • • • • Installing, upgrading, and removing HP MPIO XP DSM Migrating from Secure Path to HP MPIO XP DSM Support for load balancing in Microsoft Cluster Server environments Managing HP MPIO XP DSM Intended audience This document is intended for users of HP MPIO XP DSM and users who are experienced with the foll
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 DSM for XP family of Disk Arrays HP MPIO Full Featured Device Specific Module (DSM) for XP family of Disk Arrays (HP MPIO XP DSM) provides multipathing support for HP StorageWorks XP family of 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 XP 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.
NOTE: In a cluster configuration, HP MPIO XP 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. c. Disable failback for all groups containing resources managed by the current node. 3.
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. c. Disable failback for all groups containing resources managed by the current node. 3. Upgrade HP MPIO XP DSM on the current node by following steps 2–6 from the procedure Upgrading HP MPIO XP DSM on stand-alone systems. 4. Using Cluster Administrator, resume the current cluster node. NOTE: Repeat steps 2–4 for all nodes in the cluster. 5.
NOTE: When the migration is complete, you can, if desired, remove the Secure Path Manager and Secure Path server from your system. NOTE: For more information about the option Enable Load Balancing in Cluster in the Configuration Settings window presented during the upgrade, see Support for load balancing in Microsoft Cluster Server environments.
2. Reboot the server. 3. Follow steps 2–9 from the procedure Migrating from Secure Path to HP MPIO XP DSM on stand-alone systems. Migrating from HP MPIO Basic Failover to HP MPIO XP DSM To migrate from HP MPIO basic failover for XP arrays to HP MPIO XP DSM, complete the steps below: 1. Uninstall HP MPIO basic failover for XP arrays from the server. 2. Reboot the server. 3. Follow steps 2–9 from the procedure Migrating from Secure Path to HP MPIO XP DSM on stand-alone systems.
• If the storage continues to be accessed by other servers still in multipath mode and by this server in single-path mode and it is on an XP system, use switch zoning to establish the single connection (path) from the server. NOTE: Make sure you perform step 1 and step 2 before proceeding further. 3. Select Start > Settings > Control Panel > Add or Remove Programs. 4. Select HP MPIO Full Featured DSM for XP family of Disk Arrays from the Remove Program dropdown list. 5.
Result Code Description 0 Success –1 General error –3 Required data not found in the setup.iss file –4 Not enough memory available –5 File does not exist –6 Cannot write to the response file –7 Unable to write to the log file –8 Invalid path to the InstallShield Silent response (.
5. If you want to avoid the automatic reboot feature, edit the setup.iss file as follows: a. In line 50, replace Result=6 with Result=1. b. In line 51, replace BootOption=3 with BootOption=0. Upgrading HP MPIO XP DSM To upgrade from a previous version of HP MPIO XP DSM to the current version, complete the steps below: 1. Make a copy of the update.iss file in the installation kit. 2. Rename this copy of the file as setup.iss 3.
3. The response file is created at the following location: %WINDDIR%\setup.iss, where, %WINDIR% is the Windows installation directory. 4. Use this setup.iss file to perform the same silent mode operation on multiple systems across the same platform. Setting up boot from SAN HP MPIO XP DSM can be set up to boot externally from a SAN that uses HP StorageWorks HBAs and RAID arrays. Booting externally offers the following advantages: • Optional elimination of server-based internal boot devices.
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. 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 environment 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 XP 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, move to step 2. 2. Navigate to the HP MPIO XP 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\hpxpdsm_pr_on.reg • For Windows Server 2003 (IA64): \IA64\hpxpdsm_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 environment for Windows Server 2003
4 Managing storage arrays using the HP MPIO XP DSM with the CLI utility The Command Line Interface utility (CLI) of HP MPIO XP DSM enables you to monitor and manage multipathing devices.
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.L ALB 1 HP OPEN-V 50 02747033C 2 SQST Disk 1 1.0.0.0 N/A Path# Controller Port# State HBA Slot# RTP P.B.T.L 1 3A Active 7 — 1.0.0.0 2 3A Active 6 — 4.0.2.0 Device# Device Name Serial No. Active Paths Policy Disk# P.B.T.
The hpdsm set device policy command sets the load balancing policy for device x or for all devices, depending on the input parameter specified, to one of the following: • No_Load_Balance (NLB) – All I/O requests are routed through a chosen active path. • Round_Robin (RR) – All I/O requests are distributed across all active paths to the device in a round robin manner. • Shortest_Queue_Requests (SQR) – Each I/O request is routed to the active path with the least number of outstanding requests.
hpdsm set device=1 path=1 Device Name : HP OPEN-K*2 Device Serial No. : 040076E1000A Controller Port No. : 1A 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 had failed.
Managing storage arrays using the HP MPIO XP DSM with the CLI utility
A Software components This appendix describes the following components of HP MPIO XP DSM: • Drivers • User mode components Drivers The HP MPIO XP 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 Device Specific Module (DSM) driver • HPXPDSM.SYS is the HP DSM driver for XP disk arrays.
To start the performance monitoring, complete the steps below: 1. Select Start > Programs > Hewlett-Packard > XP DSM > Path Performance. Alternatively, you can select Start > Run and run the command perfmon /wmi. 2. Select HP DSM High Performance Provider performance object and add the appropriate counters.
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 XP DSM drivers and provides a description of each message. The error log messages are written in the SYSTEM log file. This appendix provides information about the following event log messages: • MPIO.SYS event log messages • HP MPIO XP DSM event log messages MPIO.
Event ID Message Description Contents of the data dump 22 A fail-over on pseudo-LUN was attempted, however the attempt failed. The devices will be removed. A failover attempt on a pseudo-LUN has failed. This indicates that the DSM did not return a valid path after the call to InvalidatePath. N/A 23 All paths have failed. Pseudo-LUN will be removed. There are no available paths to the pseudo-LUN. The device has gone into total failure and will be removed.
HP MPIO XP DSM event log messages Table 5 lists the HP MPIO XP DSM event log messages and provides a description of each message. Table 5 HP MPIO XP 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.
Multipathing driver event log messages
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 XP family of 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 48 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 states 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 boot from SAN setting up, 20 C conventions text symbols, 8 D documentation HP web site, 7 drivers Multipathing bus, 33 replacement class, 33 H HP Subscriber’s choice web site, 9 I installation silent, 17 installing Multipathing software, 12 M Migrating from HP MPIO Basic Failover, 16 Migrating from Secure Path, 14 MPDEV.SYS, 33 MPIO.
