HP Modular Smart Array FC VDS Hardware Provider administration guide Part number: T1634-96072 Second edition: May 2006
Legal and notice information © Copyright 2005-2006 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 Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About this guide . . . . . . . . . Intended audience . . . . . . . . Disk arrays . . . . . . . . . . . Related documentation . . . . . . Document conventions and symbols HP technical support . . . . . . . Subscription service . . . . . . . HP web sites . . . . . . . . . . Documentation feedback . . . . . Other HP web sites . . . . . . . 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstalling the HP Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling the HP Provider using Windows . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling using the HP Provider installer . . . . . . . . . . . . . . . . . . . . . . . . . 4 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . Troubleshooting procedures . VDS will not install . . . Cannot manage the array VDS error messages . . . . . . . . . . . . . . . . . . using Provider . . . . . .
Preface About this guide This guide provides information about: • The HP MSA FC VDS Hardware Provider version 4.00.00 for VDS 1.0 and 1.1. The Provider for VDS 1.1 supports Windows 2003 R2.
Document conventions and symbols Convention Element Blue text: Document conventions and symbols Cross-reference links and e-mail addresses 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 Error messages Operating system type and revision level Detailed questions For continuous quality improvement, calls may be recorded or monitored.
Preface
1 Overview This chapter describes the HP MSA FC VDS Hardware Provider for Windows 2003 and explains how it operates with Microsoft’s operating system and applications. When you have read this chapter, you should have a functional understanding of the Provider that will prepare you to install it and get it working.
Simple overview The HP MSA VDS Provider is a solution that installs on a Windows 2003 server connected to an HP disk array. The Provider works with the Microsoft Virtual Disk Service (VDS) to enable the Windows OS and applications to manage the MSA disk array.
Detailed overview The HP VDS Hardware Provider expands on the capability of Windows and Windows applications to manage the HP disk array. Through the HP VDS Provider, Windows and Windows applications can perform disk array LUN and port management tasks normally performed using proprietary array control software.
Functional components The process of managing array volumes using VDS and the HP Provider involves the following components: • • • • • • • • Microsoft Windows 2003 SP1 for VDS 1.0 or Windows 2003 R2 for VDS 1.1 Windows Disk Management Third Party Management Applications Microsoft Command Line Utilities Windows Software Providers Windows Virtual Disk Service HP MSA FC VDS Provider HP MSA Disk Array System The following pages describe each component of the preceding illustration.
Third party management applications Third party management applications control the Microsoft VDS service to manage array disks and volumes. Microsoft command line interfaces Microsoft offers two command line utilities: DiskPart and DiskRaid. These interfaces enable you to script disk management tasks so you can automate configuration of multiple storage disks. The DiskPart utility, which comes standard with Windows XP and Windows Server 2003, manages disks, volumes, and partitions.
Microsoft Virtual Disk Service (VDS) Microsoft VDS provides an interface for managing volumes and logical units. Administrators can identify, configure, and monitor supported HP disk array volumes from the Windows Server 2003 Microsoft Management Console (MMC). • Provides the capability of Windows and Windows applications to recognize the HP disk array and perform basic and dynamic disk management functions.
HP MSA FC VDS Hardware Provider The HP MSA FC VDS Hardware Provider consists of special HP DLLs and executables that install on the Windows server. These components extend the capability of Windows and Windows applications to communicate with and manage the disk array. Hardware Providers typical applications The advantage of VDS and the HP MSA FC VDS Provider is that they allow you to manage the HP disk array using the Windows interface.
Overview
2 Configuration This chapter lists required hardware and software components and explains how to configure the disk array and Windows 2003 servers for use with the HP MSA FC VDS Hardware Provider. You must complete the procedures in this chapter before you install the Provider. IMPORTANT NOTE: The right combination of software versions is crucial to configuring a working system.
Components The following hardware and software components are used with the HP Provider and an HP MSA disk array. See the Read Me file and contact HP Support for HP tested and approved components. Hardware components • HP StorageWorks MSA1000/1500 Disk Array • Windows 2003 Server: This server contains the Microsoft VDS Service and HP VDS Hardware Provider. • Fibre Channel Host bus adapter (HBA): Installs in the VDS Provider server to provide FC connection to the MSA array.
Software components IMPORTANT NOTE: The right combination of software versions is crucial to configuring a working system. Refer to the the README files accompanying the HP Provider installation files for information about compatible software versions and system configurations. Follow all configuration and installation instructions carefully. The following components and configurations enable you to use the HP MSA FC VDS Provider with the MSA.
Configuration procedures Physically install and configure the disk array and the server as described below and in the manuals for those products. Refer to the diagram under Components for an overview of interconnections. Configuration summary You will perform the following tasks during configuration: VDS Provider Windows 2003 server: • • • • • Install Windows 2003 Server OS. Install FC Host Bus Adapter and driver. Connect the server HBA to the array using a FC switch and set up zoning (if required).
Configuring the HP Provider server Install and configure the Windows 2003 server that will run the HP VDS Provider software as follows: 1. If it is not already present, install the Windows 2003 Server OS on the server that will run the HP Provider software. 2. Install a Fibre Channel host bus adapter (HBA) card into the server according to the HBA manufacturer’s instructions. 3. Install the HBA driver and utility software onto the server according to the HBA manufacturer’s instructions.
Configuration
3 Installation This chapter explains how to install the Provider and other required software. When you install the Provider, the extended storage management features of VDS are enabled. IMPORTANT NOTE: The right combination of software versions is crucial to configuring a working system. Refer to the README files accompanying the HP Provider installation files for information about compatible software versions and system configurations.
Installation procedures The following procedures describe how to install the Hardware Providers on a Windows 2003 server. If you have not already configured the server and the array as instructed in “Chapter 2 Configuration,” do so now before you install the HP Provider software. The HP Provider will not work if the array and server have not been correctly configured before you install the Provider.
NOTE: If you have not removed a previous version of the Provider, the following message pops up. Click OK to end installation. Before you can install, you must first remove the old Provider using the Windows Add or Remove Programs Control Panel. Then try the installation again. 2. In the Welcome window, click Next. The License Agreement window appears. 3. Click “I accept...” to agree to the license terms.
4. Click Next. The Destination Folder window appears. 5. Click Next to install VDS in the default location, or click Change to browse for a new location, and then click Next. The Ready to Install window appears.
6. Click Install to start the installation process. A status window appears to show progress. 7. When installation finishes, the InstallShield Wizard Completed window appears.
8. Click Finish. HP MSA FC VDS Provider installation is complete. 9. At the command line, issue stop and start commands to VDS as follows: net stop vds net start vds 10. If all other applications have been installed, this is a good time to install the Microsoft QFEs (quick fixes). The QFEs are required to fix problems in the Microsoft OS that have not yet been released in a service pack. For information about QFEs that are currently needed for the Provider, see the Provider README file.
Verifying installation To verify installation, perform the following tests. If you have any trouble with installation or with verifying installation, see Chapter 4 “Troubleshooting” in this guide. Checking visibility of the disk array If you configured the disk array and server properly, the array LUNs should be visible in the Disk Management window on the VDS server. Click the Windows Start menu, click Administrative Tools, click Computer Management and click Disk Management.
Uninstalling the HP Provider Before uninstalling the HP VDS Provider, issue a net stop command from the command line, as shown below: net stop vds Uninstalling the HP Provider using Windows 1. In Windows, select Start > Settings > Control Panel. 2. Double-click Add/Remove Programs. 3. Select the HP MSA VDS Hardware Provider program for removal. 4. Click Change/Remove. Windows removes the program.
4 Troubleshooting This chapter explains how to troubleshoot the HP Provider and includes a list of error messages and explanations.
Troubleshooting procedures The following instructions present typical problems and solutions. VDS will not install The HP VDS Provider installation works only on the Windows versions listed in the README file supplied with the HP Provider. The installer will not install the software on other versions of Windows.
VDS error messages The following table lists VDS error messages and their meanings. Message Id MessageID Value (hex) Message Text VDS_E_NOT_SUPPORTED 0x80042400L The operation is not supported by the object. VDS_E_INITIALIZED_FAILED 0x80042401L The service failed to initialize. VDS_E_INITIALIZE_NOT_CALLED 0x80042402L The initialization method is not called. VDS_E_ALREADY_REGISTERED 0x80042403L The provider is already registered.
Message Id MessageID Value (hex) Message Text VDS_E_PROVIDER_INITIALIZATION_ FAILED 0x8004241CL The provider failed to initialize. VDS_E_OBJECT_EXISTS 0x8004241DL The object already exists. VDS_E_NO_DISKS_FOUND 0x8004241EL No disks were found on the target machine. VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL The provider’s cache has become corrupt. VDS_E_DMADMIN_METHOD_CALL_FAILED 0x80042420L A method call to the Logical Disk Management Administrative service failed.
Message Id MessageID Value (hex) Message Text VDS_E_ACTIVE_PARTITION 0x80042438L The migration operation failed. An active partition was detected on the selected disk, and it is not the active partition used to boot the currently running OS. VDS_E_PARTITION_OF_UNKNOWN_TYPE 0x80042439L The migration operation failed. Cannot read partition information. VDS_E_LEGACY_VOLUME_FORMAT 0x8004243AL The migration operation failed. A partition with an unknown type was detected on the selected disk.
Message Id MessageID Value (hex) Message Text VDS_E_OBJECT_OUT_OF_SYNC 0x80042453L The system’s information about the object may not be up to date. VDS_E_MISSING_ 0x80042454L Operation failed. The disk is missing. VDS_E_DISK_PNP_REG_CORRUPT 0x80042455L The provider’s list of Pnp registered disks has become corrupt. VDS_E_LBN_REMAP_ENABLED_FLAG 0x80042456L The provider does not support the LBN REMAP ENABLED volume flag.
Glossary This glossary defines acronyms and terms used in this guide or related to this product and is not a comprehensive glossary of computer terms. API Application Programming Interface, an interface that allows a software application to connect to and work with a third party software application. clone A full copy of a volume, usable by an application. CV HP StorageWorks CommandView, a browser-based interface that allows management of an HP disk array.
shadow copy A Microsoft term describing a point-in-time copy of an original volume. The original volume continues to change as the process continues, but the shadow copy of the volume remains constant. snapclone An HP EVA disk array term denoting a full copy of a volume that becomes immediately usable by an application. Created much faster than ordinary clones by taking a snapshot and updating to a full copy in the background.
Index A HP storage web site, 7 technical support, 7 array configuration, 20 audience, 5 I C installation provider, 24 summary, 24 verifying, 29 command line utilities, 13 components, 12 provider, 11 required, 18 software, 19 configuration, 17 array and server, 20 diagram, 18 important notes, 20 summary, 20 conventions text symbols, 6 conventions, document, D M management applications, 13 O disk array overview, 15 disk management, 12 DiskPart, 13 DiskRaid, 13 document conventions, documentation pr
third party applications, 13 troubleshooting, 31, 32 U uninstalling provider, 30, 30 V VDS overview, 14 verifying installation, 29 40 W web sites, 5 HP, 7 HP documentation, 7 HP storage, 7 HP Subscriber’s Choice for Business, 7 Windows overview, 12