HP MSA2000 Family VDS and VSS Hardware Providers installation guide

Transcription

1 HP MSA2000 Family VDS and VSS Hardware Providers installation guide Part number: Second edition: February, 2009

2 Legal and notice information Copyright 2009 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied, reproduced, or translated into another language without the prior written consent of Hewlett-Packard. The information is provided as is without warranty of any kind and is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.

3 CHAPTER 1 Installing the MSA2000 Family VDS Hardware Provider The Microsoft Windows Server operating systems provide enhanced services for managing storage area networks, including Virtual Disk Service (VDS), an API that enables storage management applications to manage heterogeneous disk arrays from a single point of control. VDS is a single storage management interface that enables you to configure your mixed storage environment without having to use individual storage management tools. The MSA2000 Family VDS Hardware Provider implements the VDS 1.1 API. After the MSA2000 Family VDS Hardware Provider is installed, DiskRaid and Storage Manager for SANs from Microsoft or VDS client utilities from other third-party vendors can be used to configure and manage your array. Installation Requirements The MSA2000 Family VDS Hardware Provider requires the following software: MSA2000 Family MPIO DSM 2.5 or later only if you have multiple paths to your storage (Windows Server 2003 only) A supported operating system: Microsoft Windows Server 2003 R2 x86 Edition with Service Pack 2 Microsoft Windows Server 2003 R2 x64 Edition with Service Pack 2 Microsoft Windows Server 2008 x86 Edition with Service Pack 1 Microsoft Windows Server 2008 x64 Edition with Service Pack 1 For Windows Server 2003 R2 with Service Pack 2, the following hotfixes are recommended: KB (VDS & VSS) KB (VDS) KB (VSS) KB (VDS) MSA2000 Family CAPI Proxy 2.5 3

4 Storage Manager for SANs Storage Manager for SANs is a Microsoft Management Console snap-in that helps you create and manage volumes on disk drive subsystems that support VDS. For more information about and instructions for installing the Storage Manager for SANs, go to the following web site and search for Storage Manager for SANs: Downloading the MSA2000 Family VDS Hardware Provider Download the MSA2000 Family VDS Hardware Provider software bundle from Select MSA SAN Arrays, select your product, and go to Related Products. From VDS/VSS Hardware Providers, select the download option corresponding to your product and operating system. Installing the MSA2000 Family CAPI Proxy This section describes how to install the MSA2000 Family CAPI Proxy. Note If you have already installed the MSA2000 Family CAPI Proxy 2.5 or later (with the VSS installation package), you need not reinstall it. If you have an older version installed, you must upgrade it to 2.5. Install the downloaded software in the following order: MSA2000 Family CAPI Proxy MSA2000 Family VDS Hardware Provider MSA2000 Family VSS Hardware Provider MSA2000 Family CAPI Proxy is prerequisite for VDS, and is recommended for use with VSS. Install the MSA2000 Family CAPI Proxy as shown: 1. Run the executable downloaded from the HP website to begin the installation. 2. Follow the onscreen prompts to install the software. On 32-bit operating systems, the program is installed in: C:\Program Files\Hewlett-Packard\HardwareProviders\ MSA2000\CAPI 4 Installing the HPMSA2000 Family VDS and VSS Hardware Providers July 2008

5 On 64-bit operating systems, the program is installed in: C:\Program Files(x86)\Hewlett-Packard\HardwareProviders\ MSA2000\CAPI If a previous version of the MSA2000 Family CAPI Proxy is already installed, you are prompted to either overwrite the existing MSA2000 Family CAPI Proxy by selecting Continue, or to exit the installation by selecting Abort. Installing the MSA2000 Family VDS Hardware Provider This section describes how to install the MSA2000 Family VDS Hardware Provider. Note that there are two different versions of the provider: one supports iscsi devices only, and the other supports Fibre Channel and SAS devices. Both can be installed at the same time, if you have a mix of iscsi and non-iscsi devices. 1. Run the executable downloaded from the HP website to begin the installation. 2. Follow the onscreen prompts to install the software. On 32-bit operating systems, the program is installed in: C:\Program Files\Hewlett-Packard\HardwareProviders\ MSA2000\VDS On 64-bit operating systems, the program is installed in: C:\Program Files(x86)\Hewlett-Packard\HardwareProviders\ MSA2000\VDS If a previous version of the same MSA2000 Family VDS Hardware Provider is already installed, you are prompted to either overwrite the existing MSA2000 Family VDS Hardware Provider by selecting Continue, or to exit the installation by selecting Abort. Chapter 1 Installing the MSA2000 Family VDS Hardware Provider 5

6 3. To verify the installation, run the list providers command, and make sure that the MSA2000 Family VDS Hardware Provider is displayed in the list of providers. C:\>diskraid Microsoft Diskraid version Copyright (c) 2003 Microsoft Corporation DISKRAID> list providers Prov ### Name Version Type Prov 0 HP StorageWorks MSA2000 Family VDS Provider 2.5 FC Prov 1 HP StorageWorks MSA2000 Family iscsi VDS Pro 2.5 iscsi If the MSA2000 Family VDS Hardware Provider does not appear in the list of providers, reboot the host to reinitialize the VDS subsystem. Supported Microsoft DiskRaid Commands DiskRaid is a command-line utility from Microsoft that enables you to configure and manage your storage after the MSA2000 Family VDS Hardware Provider is installed. This section contains a list of supported Microsoft DiskRaid commands. ASSOCIATE Specifies which controller owns a vdisk by associating a LUN to a port. The following rules apply when using this command: The vdisk has only one volume The volume is not yet mapped You must specify all controller ports. For example, to assign the vdisk to controller 0 with 2 ports, you must specify the following: associate port 0-0,0-1 CREATE LUN <TYPE> [SIZE=<N>] [DRIVES= <N>,<N>[,..]][STRIPESIZE=<N>][NOERR] Creates a new vdisk or creates a volume on an existing vdisk. <TYPE> can be simple, stripe, mirror, raid (NRAID, RAID0, RAID1/10, RAID5). STRIPESIZE is ignored. DELETE LUN Deletes a volume on an existing vdisk. If the volume is the last one on the vdisk, the vdisk itself is also deleted. DETAIL Displays the detailed information of the specified device. EXTEND LUN size=<n> Increases the size of the volume by the specified value. 6 Installing the HPMSA2000 Family VDS and VSS Hardware Providers July 2008

7 EXTEND LUN DRIVES=<N>,<N>[,.] Adds drives to the vdisk on which the volume resides. After the drives are added to the vdisk, the selected LUN is expanded by the value specified in the size parameter; if no size is specified, the LUN is expanded to fill the entire available size in the vdisk. Caution Virtual disk expansion cannot be stopped and can take days to complete, depending on drive type, RAID level, and other factors. Use the Storage Management Utility (SMU) to view information about the vdisk size and the expansion s progress (vdisk-name > View > Overview). FLUSHCACHE CONTROLLER Flushes the cache of all the volumes on the selected controller. LBPOLICY Sets the load balance policy, weight, and primary path of the LUN. LIST Lists the provider, subsystem, controller, port, drive, and LUN. MAINTENANCE DRIVE BLINK [COUNT=<N>] Blinks the selected drive. NAME SUBSYSTEM Changes the subsystem (controller s) name. NAME LUN Changes the volume s name. REENUMERATE Determines that a new array has been added. REFRESH Refreshes the subsystem. SELECT Selects the provider, subsystem, controller, port, drive, and LUN. SETFLAG Assigns/unassigns the global spare disk drive. UNMASK Creates or deletes the normal map or filter map. Chapter 1 Installing the MSA2000 Family VDS Hardware Provider 7

8 Troubleshooting This section contains troubleshooting information for the MSA2000 Family VDS Hardware Provider. Table 1-1 Troubleshooting the MSA2000 Family VDS Hardware Provider Issue The VDS Provider is not working and either of the following conditions apply: DiskRaid exits abnormally. An application error in the Windows event log states: ssproxy needs a 128-Kbyte buffer. You might need to set the MaximimSGList to a value of 33 or higher Cannot view paths for the LUN in some commands. Description You must terminate the vds.exe and dllhost.exe process manually using Task Manager before you start DiskRaid again. If there are multiple dllhost.exe processes running, and you re not sure which one to terminate, you can use Microsoft s Process Explorer application, which you can access by going to: sysinternals/utilities/processexplorer.mspx In the Process Explorer main window, double-click a process, select the Threads tab, and examine the Start Address column for entries that begin with capihwprv.dll. If you find a match, switch to the Image tab and select Kill Process to terminate the process. The MSA2000 Family CAPI Proxy requires the maximum data for the CAPI command to be 128 Kbyte; therefore, you need to create a MaximumSGList registry entry if it does not already exist, or set it to a value of 33 or larger if it hasn t already been set. To set the registry for Qlogic cards, double-click qla2300.reg in the CAPI Proxy s installation directory (for example, C:\Program Files\ Hewlett-Packard\HardwareProviders\ MSA2000\CAPI\qla2300.reg). After a LUN is assigned to the host, you might need to execute a rescan operation in Device Manager to view the paths for the LUN in some commands, such as detail lun. 8 Installing the HPMSA2000 Family VDS and VSS Hardware Providers July 2008

9 Table 1-1 Troubleshooting the MSA2000 Family VDS Hardware Provider (Continued) Issue When uninstalling the CAPI Proxy, the following message is displayed: ssproxy.exe cannot be removed RAID 6 volumes are indistinguishable from RAID 5 volumes Description The CAPI Proxy is automatically stopped during the uninstall process. If the CAPI Proxy is not stopped for some reason, manually stop it by running the following command: taskkill /F /IM ssproxy.exe /T You can also stop ssproxy.exe by using the Task Manager. After stopping the process manually, choose Retry to remove ssproxy.exe. RAID 6 volumes are not supported by Microsoft s VDS 1.1 infrastructure, and as a result, they are indistinguishable from RAID 5 volumes in VDS clients, and can only be created using the management controller s user interfaces. Chapter 1 Installing the MSA2000 Family VDS Hardware Provider 9

10 Uninstalling the MSA2000 Family VDS Hardware Provider and the MSA2000 Family CAPI Proxy To uninstall the MSA2000 Family VDS Hardware Provider, perform the following steps. 1. Choose Start > Control Panel > Add/Remove Programs. 2. Depending on which version you are uninstalling, choose HP StorageWorks MSA2000 Family VDS Provider or HP StorageWorks MSA2000 Family iscsi VDS Provider and click Change/Remove. 3. Respond appropriately to the prompts. 4. If the MSA2000 Family VSS Hardware Provider is not running the CAPI proxy, you can select HP StorageWorks MSA2000 Family CAPI Proxy from the Add Remove Programs list and uninstall it now. To uninstall the MSA2000 Family VSS Hardware Provider, see Uninstalling the MSA2000 Family VSS Hardware Provider and the MSA2000 Family CAPI Proxy on page Installing the HPMSA2000 Family VDS and VSS Hardware Providers July 2008

11 CHAPTER 2 Installing the MSA2000 Family VSS Hardware Provider The Microsoft Windows Server operating systems provide enhanced services for managing storage area networks, including Volume Shadow Copy Service (VSS). VSS, with its standard set of extensible APIs, provides the backup infrastructure for Windows Server, as well as a mechanism for creating consistent point-in-time copies of data known as shadow copies. VSS provides interfaces to ensure that volume shadow copies are in a consistent state. The MSA2000 Family VSS Hardware Provider installs on a server running Windows Server and enables VSS to create hardware-resident shadow copies on any array attached to the server. With the MSA2000 Family VSS Hardware Provider and VSS, you can create a shadow copy of the source data volume on one server and then import the shadow copy onto another server (or back to the same server). Note By default, the MSA is shipped with zero (0) snapshots enabled. To use the product s snapshot feature, the snapshot license must be installed. Supported Features The MSA2000 Family VSS Hardware Provider supports the following features supported by the Windows VSS subsystem: Creating shadow copies/snapshots Exporting shadow copies/snapshots: prepare for use in another Windows Server system Importing snapshots: prepare for local use after export from another Windows Server system Determining when snapshots can be deleted and deleting them 11

12 Note Before you can create shadow copies, you must first create a snap pool and enable shadow copies for a master volume by using your configuration management tool. Installation Requirements The MSA2000 Family VSS Hardware Provider requires the following software: A supported operating system: Microsoft Windows Server 2003 R2 x86 Edition with Service Pack 2 Microsoft Windows Server 2003 R2 x64 Edition with Service Pack 2 Microsoft Windows Server 2008 x86 Edition with Service Pack 1 Microsoft Windows Server 2008 x64 Edition with Service Pack 1 For Windows Server 2003 R2 with Service Pack 2, the following hotfixes are recommended: KB (VDS & VSS) KB (VDS) KB (VSS) KB (VDS) MSA2000 Family CAPI Proxy 2.5 Downloading the MSA2000 Family VSS Hardware Provider Download the MSA2000 Family VSS Hardware Provider software bundle from Select MSA SAN Arrays, select your product, and go to Related Products. From VDS/VSS Hardware Providers, select the download option corresponding to your product and operating system. Installing the MSA2000 Family CAPI Proxy This section describes how to install the MSA2000 Family CAPI Proxy. Note If you have already installed the MSA2000 Family CAPI Proxy 2.5 or later (with the VDS installation package), you do not need to reinstall it. If you have an older version installed, you must upgrade it to Installing the HPMSA2000 Family VDS and VSS Hardware Providers July 2008

13 Install the downloaded software in the following order: MSA2000 Family CAPI Proxy MSA2000 Family VDS Hardware Provider MSA2000 Family VSS Hardware Provider MSA2000 Family CAPI Proxy is prerequisite for VDS, and is recommended for use with VSS. Install the MSA2000 Family CAPI Proxy as shown: 1. Run the executable downloaded from the HP website to begin the installation. 2. Follow the onscreen prompts to install the software. On 32-bit operating systems, the program is installed in: C:\Program Files\Hewlett-Packard\HardwareProviders\ MSA2000\CAPI On 64-bit operating systems, the program is installed in: C:\Program Files(x86)\Hewlett-Packard\HardwareProviders\ MSA2000\CAPI If a previous version of the MSA2000 Family CAPI Proxy is already installed, you are prompted to either overwrite the existing MSA2000 Family CAPI Proxy by selecting Continue, or to exit the installation by selecting Abort. Installing the MSA2000 Family VSS Hardware Provider This section describes how to install the MSA2000 Family VSS Hardware Provider. Note In a cluster environment the MSA2000 Family VSS Hardware Provider cannot be installed unless a Microsoft Distributed Transaction Coordinator (MS DTC) cluster resource is configured. Refer to for instructions on configuring MS DTC. 1. Run the executable downloaded from the HP website to begin the installation. 2. Follow the onscreen prompts to install the software. On 32-bit operating systems, the program is installed in: Chapter 2 Installing the MSA2000 Family VSS Hardware Provider 13

14 C:\Program Files\Hewlett-Packard\HardwareProviders\ MSA2000\VSS On 64-bit operating systems, the program is installed in: C:\Program Files(x86)\Hewlett-Packard\HardwareProviders\ MSA2000\VSS If a previous version of the MSA2000 Family VSS Hardware Provider is already installed, you are prompted to either overwrite the existing MSA2000 Family VSS Hardware Provider by selecting Continue, or to exit the installation by selecting Abort. 3. To verify the installation, run the list providers command, and make sure that the MSA2000 Family VSS Hardware Provider is displayed in the list of providers. >vssadmin list providers vssadmin Volume Shadow Copy Service administrative command-line tool (C) Copyright 2001 Microsoft Corp. Provider name: Microsoft Software Shadow Copy provider 1.0 Provider type: System Provider ID: {b b9f-4925-af80-51abd60b20d5} Version: Provider name: HP StorageWorks MSA2000 Family VSS Provider Provider type: Hardware Provider ID: {bd04cbf9-212c ea5-c5bfb05ccc8f} Version: 2.5 Creating Shadow Copies VSS functionality includes creating, deleting, and managing shadow copies. However, to create a shadow copy, you must first use SMU to create a snap-pool, and then either convert an existing standard volume to a master volume (enable the volume for shadow copies) or to create a new master volume. Refer to the reference guide for more information. 14 Installing the HPMSA2000 Family VDS and VSS Hardware Providers July 2008

15 To create a shadow copy: 1. Use SMU to create a snap-pool and to either convert a standard volume to a master volume (enable the volume for shadow copies) or to create a new master volume. The VSS Provider will attempt to automatically allocate a snap-pool, and convert a standard volume into a master volume. However, using the SMU to perform these steps ahead of time enables more control over the allocation of storage, and provides better feedback in case an operation does not succeed. 2. If necessary, create a Windows file system using Windows Disk Management to create a partition or file system on the RAID partition that you want to use for shadow copy. Make sure the volume is mapped with a drive letter or assigned to a mount point. 3. Create the shadow copy using a software product that supports the VSS requestor protocol. The MSA2000 Family VSS Hardware Provider is automatically invoked by backup utilities that support VSS, which includes the backup utility provided in Windows Server. Note The MSA2000 Family VSS Hardware Provider takes shadow copies quickly (less than 5 seconds), but the Microsoft VSS subsystem can take a long time to recognize and import the new shadow copies. Typically it takes about 90 seconds to create and import a shadow copy. It takes longer if more RAID partitions are included in the same shadow copy set. Chapter 2 Installing the MSA2000 Family VSS Hardware Provider 15

16 Troubleshooting This section contains troubleshooting information for the MSA2000 Family VSS Hardware Provider. Table 2-2 Troubleshooting the MSA2000 Family VSS Hardware Provider Issue The VSS Provider cannot create a snapshot. The following error is reported: VSS_E_PROVIDER_VETO The shadow copy does not exist on the controller. Description The system might not have a license certificate file installed. To enable use of VSS, you must obtain and install a license certificate file for the purchased option. The maximum number of snapshots allowed by the snapshot license has already been created. The storage system has failed to execute the commands from the VSS Provider, or the communication between the VSS Provider and the system is broken due to any of the following conditions: The LUN that will be used to create the snapshot is not a master volume. The serial number cannot be obtained for the controller owning the master volume partition. The snapshot cannot be found in the VSS Provider s snapshot list. The partition is not a snapshot. The LUN assignment to the newly created snapshot failed. The snapshot that will be deleted is not a HP snapshot. The backup utility automatically deletes the shadow copy when the backup is complete. You might have used the Windows Explorer shadow copy shell extension context menu to create a shadow copy, which is to be used for creating a Windows software shadow copy, not hardware shadow copies. Make sure you have created the shadow copy using the persistent (-p) attribute. 16 Installing the HPMSA2000 Family VDS and VSS Hardware Providers July 2008

17 Table 2-2 Troubleshooting the MSA2000 Family VSS Hardware Provider (Continued) Issue Shadow copy creation failed or the following error message is displayed in the system application event log: SCSI bus # supports maximum SCSI I/O length #, but VSS needs # It is taking a long time to create the shadow copy. Description If you use the Vssadmin tool from Microsoft to create shadow copies, MSA2000 Family VSS Hardware Provider is not used. Vssadmin create shadow only works with the Microsoft software shadow copy provider built into Windows. The MaximumSGList registry entry must be set to a value of 33 or larger. To set the registry for Qlogic cards, double-click qla2300.reg in the MSA2000 Family VSS Hardware Provider s installation directory (for example, C:\Program Files\Hewlett-Packard\ HardwareProviders\MSA2000\VSS\ qla2300.reg. You might have exceeded the limit allowed for shadow copies on the controller, which varies depending on the model of the array. Refer to the documentation for your array. There are insufficient resources available to create the shadow copy, which can happen if you create and delete shadow copies too quickly. Wait for the controller to make resources available, and then try again. The MSA2000 Family VSS Hardware Provider takes shadow copies quickly (less than 5 seconds), but the Microsoft VSS subsystem can take a long time to recognize and import the new shadow copies. Typically, it takes about 90 seconds to create and import a shadow copy. It takes longer if more RAID partitions are included in the same shadow copy set. Chapter 2 Installing the MSA2000 Family VSS Hardware Provider 17

18 Uninstalling the MSA2000 Family VSS Hardware Provider and the MSA2000 Family CAPI Proxy To uninstall the MSA2000 Family VSS Hardware Provider, perform the following steps. 1. Choose Start > Control Panel > Add/Remove Programs. 2. Choose HP StorageWorks MSA2000 Family VSS Provider and click Change/Remove. 3. Respond appropriately to the prompts. 4. If the MSA2000 Family VDS Hardware Provider is not running the CAPI proxy, you can select HP StorageWorks MSA2000 Family CAPI Proxy from the Add Remove Programs list and uninstall it now. To uninstall the MSA2000 Family VDS Hardware Provider, see Uninstalling the MSA2000 Family VDS Hardware Provider and the MSA2000 Family CAPI Proxy on page Installing the HPMSA2000 Family VDS and VSS Hardware Providers July 2008