HP StorageWorks EVA Hardware Providers administration guide Windows 2003 Part number: T1634-96054 Fourth edition: August 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring additional servers . Configuring the EVA disk array Adding VDS/VSS hosts . . Adding disk groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation procedures . . . . . . . . . . . . . . . .
Preface About this guide This guide provides information about: • HP EVA Hardware Providers version 4.01.00 for Microsoft VDS 1.1 and VSS.
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 StorageWorks EVA Hardware Providers (HWP) for Windows Server 2003 Enterprise Edition and explains how they operate with Microsoft’s operating system and applications. When you have read this chapter, you should have a functional understanding of the Hardware Providers that will prepare you to install the providers and get them working.
Simple overview HP StorageWorks EVA Hardware Providers for Windows Server 2003 are solutions that install on a Windows 2003 server connected to an HP disk array.
Detailed overview HP Hardware Providers enable Windows and its applications to use Microsoft VDS/VSS services to manage certain functions of the disk array. Virtual Disk Service (VDS) The VDS service provides the capability of Windows and Windows applications to recognize the HP disk array and perform basic and dynamic disk management functions. • Microsoft Management Console (MMC) Snap-in, Disk Manager and DiskPart command line interface use the VDS service.
Functional components The process of managing array volumes using VDS/VSS and HP HWP involves the following components: • • • • • • • • 12 Microsoft Windows Server 2003 OS Windows Disk Management Management Applications, such as HP’s Fast Recovery Solution (FRS) and third party programs Microsoft Command Line Utilities Windows Software Providers Windows VDS Service/VSS Service HP VDS/VSS Hardware Providers HP Disk Array System Overview
Microsoft Windows Server 2003 operating system The Windows Server 2003 OS includes Microsoft Virtual Disk Service (VDS) and Volume Shadow Copy Service (VSS). These services allow you to manage storage array disks and volumes and to perform data backup and restoration. The HP EVA Hardware Providers enable the VDS and VSS services to work with HP EVA disk arrays. The Microsoft Virtual Disk Service provides interfaces for managing storage devices. Windows Server 2003 included VDS 1.0.
HP Hardware Providers are not required in order for the Microsoft in-box or third party software providers to perform the tasks described above on the HP disk arrays. However, the HP HWPs extend the capabilities of various Windows providers and applications to do additional tasks that normally require the use of proprietary HP array management software. Such tasks include LUN and port management and more sophisticated volume copying.
There are two HP HWP installation executables for each HP disk array model, one installation executable for VDS and one for VSS. These installation executables are different for each HP disk array model. The HP Hardware Providers installation executables install the HWP files in your Windows Server file system. The files installed consist of special sets of HP DLLs and executables. These components extend the array management capabilities of Windows and its applications.
Shadow Copy Transport Using a server configured with suitable applications together with VSS and the HP HWP, you can create shadow copies and import them onto other servers connected to the same disk array. This enables multiple servers to make use of the same data, allowing data mining or testing on those servers. (However, shadow copies are read-only. If you need to write to a shadow copy, you must use a storage-management application that works with VDS/VSS to convert the copy to read/write.
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 HP Hardware Providers (HWP). You must complete the procedures in this chapter before you install HP HWP. IMPORTANT NOTE: The right combination of software versions is crucial to configuring a working system.
Required components The following illustration summarizes the hardware and software in a fully configured system. A second server is not needed for VDS and is optional for VSS, but it may be useful if you want to manage VSS data copies without burdening the primary server. Note that any firewall must be open between the HWP server(s) and the Command View workstation. Anything that slows down access to the CV workstation will cause VSS timeout failures.
Required hardware components • HP StorageWorks Disk Array: EVA disk array with a Windows workstation for running Command View EVA. If multiple EVA disk arrays are used with FRS, all must be managed from one Command View workstation. • Windows VDS/VSS Server with Windows Server 2003 OS for connecting to the array. This primary server manages your primary data and contains applications (such as Exchange or SQL), VSS/VDS, and HP HWP.
Required software components The following software is required to run HP HWP. IMPORTANT NOTE: The right combination of software versions is crucial to configuring a working system. Refer to the Release Notes accompanying the HP HWP installation files for information about compatible software versions and system configurations. Follow all configuration and installation instructions carefully.
Configuration procedures Physically configure the servers and software as described below and in the manuals for those products. See the overview diagram under the heading Required components. Your HP representative may perform some installation and configuration tasks. Configuration summary You will perform the following tasks during configuration: Windows CV workstation: • Install HP MPIO FF Failover Manager (if multipathing is required). • Use Command View EVA to activate the BC license.
Configuring the VDS/VSS Server Install and configure the VDS/VSS server as follows: 1. If it is not already present, install the Windows 2003 Enterprise Server OS on the host according to Microsoft’s installation instructions. 2. If multipathing is desired, install the HP MPIO Full-Featured software according to the documentation for that product. 3. Install a Fibre Channel host bus adapter (HBA) card into the server according to the HBA manufacturer’s instructions. 4.
Configuring the EVA disk array The following configuration steps are required for both VDS and VSS Hardware Providers. The current HWPs work with EVA Command View 6.0 or higher. 1. For the HWPs to access the CV server, you must create new user names and user groups at the operating system level on the CV server. In Windows, click Start > Control Panel > User Accounts. 2.
Configuration
Adding VDS/VSS hosts 1. Click the + symbol next to the EVA disk array in the left panel to expand the contents of the array and begin configuration. 2. Click the Hosts folder in the left panel. The Host Folder Properties window displays. 3. Click Add Host and fill in the host characteristics for the VDS/VSS server. Click Add Host to save the new host information. Repeat if you are adding a second server.
Adding disk groups Follow the steps below to add a snapclone disk group for use by VSS. Some applications, such as Exchange or SQL, may also require disk groups for data and logs. 1. Click the Disk Groups folder in the left panel. The Disk Groups Properties window displays. 2. Click the + next to the Disk Groups folder to expand Disk Groups. 3. Click Create disk group to begin creating a new disk group.
4. Enter Basic and Advanced Settings for the disk group, and click Create disk group. 5. An “operation succeeded” message indicates the disk group was added, and the new group appears in the left panel. Click OK. 6. Repeat the previous steps as required to add the disk groups needed for your application.
Configuration
3 Installation This chapter explains how to install Hardware Providers (HWP) and other required software. When you install HWP, all the features of VDS and VSS are enabled, including point-in-time copies of LUNs and storage virtualization management. If you have not already configured the server and the array as instructed in “Chapter 2 Configuration,” do so now before you install the HWP software. HWP will not work if the array and server have not been correctly configured before you install HWP.
Installation procedures The following procedures describe how to install the Hardware Providers. If you have not already configured the server and the array as instructed in “Uninstalling HWP,” do so now before you install the HWP software. HWP will not work if the array and server have not been correctly configured before you install HWP. For a summary of the configuration steps, see Configuration procedures.
Installing HWP Installation for VDS and VSS is very similar; therefore only VSS installation is described. However, each package must be installed individually. Install VDS first to provide disk management capability. If you also want to make data copies, install VSS second. 1. Before you start installation, use a ping command to test communication with the Command View EVA server. 2. Download and extract the HWP files from the HP VSS/VDS web page: http://www.hp.com/ support/HWPEVA 3.
5. Click “I accept...” to agree to the license terms, and click Next. The Destination Folder window appears. 6. Click Next to install VDS or VSS in the default location, or click Change to browse for a new location, and then click Next. The Ready to Install window appears.
7. Click Install to start the installation. A status window shows progress.
8. When installation is completed, click Finish. The VSS-VDS Configuration Utility opens.
Configuring VSS/VDS to access Command View: 1. In the Appliance IP Address text box, enter the IP address of the server where Command View is installed and click Logon. The Enter UserName and Password window pops up. 2. Enter the administrator’s User Name and Password to the Command View system. Click OK. A “loading...” message appears while the system authenticates the logon.
Selecting the disk group: 1. For VDS, click on a disk group in the Disk Group List, and click Add to List to add the group to the list of Selected Disk Groups available to VDS HWP. Then click OK. For VSS, click Snapclone and click Select Disk Group to open the list of disk groups (below). Select the disk group you created for VSS copies and click OK. If no disk groups are listed, make sure you created the disk groups and presented them to the server during configuration.
3. Click Finish. HWP installation is complete.
Adding disk groups using the VSS Configuration Utility After installation, if you need to add disk groups, increase storage in a disk group, or select a new Snapclone disk group, access the VSS Configuration Utility in the Windows Start/Programs menu: Hewlett-Packard/ Hardware Providers/Provider Configuration for EVA 1. To set the SnapClone disk group, check the SnapClone option to select the snapclone type, and then click Select Disk Group. The Select Disk Group window opens. 2.
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 the list of programs A simple way to verify successful installation of the HP HWPs is to make sure they are listed in the Add/Remove Programs Control Panel in Windows. To see the list of installed programs, click Windows Start, click Settings, click Control Panel, and double-click Add/Remove Programs.
Uninstalling HWP Before uninstalling VDS or VSS, issue a net stop command from the command line, as shown in these examples: net stop vds net stop vss net stop hpevavssprv Uninstalling HWP using Windows 1. In Windows, select Start > Settings > Control Panel. 2. Double-click Add/Remove Programs. 3. Select the program you want to remove (VDS or VSS). 4. Click Change/Remove. Windows removes the program. Uninstalling using HWP Installer You can also uninstall HP HWP by starting the HP HWP installer again.
4 Troubleshooting This chapter explains how to troubleshoot Hardware Providers (HWP) and also presents a list of VDS and VSS error messages and explanations.
Troubleshooting procedures The following instructions present typical problems and solutions. VDS/VSS HWP will not install The HP HWP installation works only on the Windows versions listed in the Configuration chapter of this guide and in the Release Notes supplied with the HP HWP. The installer will not install the software on other versions of Windows. CV authentication failure Smart Start v7.2 may cause login failures for applications such as HP HWP using the Command View EVA API.
4. Make sure you configured the VDS/VSS Configuration Utility as explained in Chapter 3 Installation. 5. Check configuration as explained in “Chapter 2 Configuration”: • Check LAN connectivity between all servers and the array. • Make sure the firewall is open between all servers and the array. • Check Command View server NIC bindings: the LAN that connects to the VDS/VSS server must be listed first. • Make sure you logged into all devices and software using administrator privileges.
than larger files may speed up overall operation and database copying. Saving transaction logs to a different volume than the database may also speed up performance. • Review the Windows application event log, Windows system event log, and VSS trace to locate errors in the snapshot process. See the Microsoft website and Windows help for information about the log and trace files.
Error messages The following tables list error messages and their meanings. VDS error messages Message Id MessageID Value (hex) Message Text VDS_E_NOT_SUPPORTED 0x80042400L The operation is not supported by the object, or there is inadequate disk space. 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_S_DISK_PARTIALLY_CLEANED 0x0004241AL The disk is not fully cleaned due to I/O error. VDS_E_DMADMIN_SERVICE_ CONNECTION_FAILED 0x8004241BL The provider failed to connect to the Logical Disk Management Administrative service. 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.
Message Id MessageID Value (hex) Message Text VDS_E_BOOT_PARTITION_NUMBER_CHANGE 0x80042436L The migration operation failed. The boot partition’s partition number will change as a result of the migration operation. VDS_E_NO_FREE_SPACE 0x80042437L The migration operation failed. The selected disk does not have enough free space to complete the operation. VDS_E_ACTIVE_PARTITION 0x80042438L The migration operation failed.
Message Id MessageID Value (hex) Message Text VDS_E_VOLUME_NOT_MOUNTED 0x8004244FL The volume is not mounted. VDS_E_PACK_NOT_FOUND 0x80042450L The pack was not found. VDS_E_IMPORT_SET_INCOMPLETE 0x80042451L Import failed. Attempt to import a subset of the disks in the foreign pack. VDS_E_DISK_NOT_IMPORTED 0x80042452L A disk in the import’s source pack was not imported. VDS_E_OBJECT_OUT_OF_SYNC 0x80042453L The system’s information about the object may not be up to date.
Message Id MessageID Value (hex) Message Text VDS_E_PLEX_NOT_REGENERATED 0x80042462L The operation failed. Cannot retain plex that has not regenerated. VDS_E_RETRY 0x80042463L The operation failed. Retry the operation. VDS_E_ONLINE_PACK_EXISTS 0x80042464L Create pack operation failed. An online pack already exists. Error Meaning Corrective Action VSS_E_BAD_STATE 0x80042301L A function call was invalid because of the state of either the backup extensions or the coordinator.
Error Meaning Corrective Action VSS_E_MAXIMUM_NUMBER_ OF_SNAPSHOTS_REACHED 0x80042317L AddToSnapshotSet was called on a volume that has already reached its maximum number. VSS_E_WRITER_INFRASTRUCTURE 0x80042318L The Writer infrastructure is not operating properly. Check that the Event Service and the Volume Snapshot Service are started and check for errors associated with these services in the error log. VSS_E_WRITER_NOT_RESPONDING 0x80042319L A writer did not respond to a GetWriterStatus call.
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 E additional servers configuring, 22 applications HWP, 15 VDS, 15 VSS, 15 array configuration, 17, 21 audience, 5 error messages, 41, 45 F fabric switch, 19 fibre cables, 19 files EVA.
O overview, 9 components, 12 detailed, 11 disk array, 15 HWP, 9, 14 simple, 10 VDS, 11, 14 VSS, 11, 14 Windows, 13 P passwords Enter CV Password field, 31 performance issues, 20 R related documentation, 5 S server configuration, 21 server, HWP configuring, 22 software components, 20 software providers, 13 Subscriber’s Choice, HP, 7 symbols in text, 6 T technical support HP, 7 service locator web site, 7 54 text symbols, 6 third party applications, 13 troubleshooting, 41, 42 U uninstalling HWP,