HP StorageWorks EVA Hardware Providers administration guide Windows 2003 Part number: T1634-96052 Third edition: February 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 . . . . . . . Other HP web sites . . . . . . . 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Required software components . . . . . EVA disk array with CV workstation: VDS/VSS Server . . . . . . . . . Secondary Server (optional) . . . . Important configuration notes . . . . . Important performance notes . . . . . Configuration procedures . . . . . . . . . Configuration summary . . . . . . . . Windows CV workstation: . . . . Configuring the array CV workstation . . Configuring the VDS/VSS Server . . . . Configuring additional servers . . . . . Configuring the EVA disk array . . . .
Index . . . . . . . . . . . . . . . . . . . . . . . . .
Preface About this guide This guide provides information about: • EVA Hardware Providers version 3.
You can find these documents on the storage web site: http://h18006.www1.hp.com/storage/arraysystems.html Document conventions and symbols Convention Element Blue text Cross-reference links and email addresses Bold • Keys that are pressed • Text typed into a GUI element, such as a box • GUI elements that are clicked or selected, such as menu and list items, buttons, tabs, and check boxes • Literal values typed exactly as shown Italics Text emphasis and book titles Blue, underlined: www.hp.
HP technical support In North America, call technical support at 1-800-633-3600, available 24 hours a day, 7 days a week. Outside North America, call technical support at the location nearest you. Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support. From this web site, select your country.
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 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 Third party management applications, such as HP StorageWorks Fast Recovery Solution (FRS), work with the Microsoft VDS and VSS services to allow you to manage array disks and volumes and to perform data backup and restoration. For more information about FRS, see the HP StorageWorks FRS XP Administration Guide.
Other Windows software providers (not shown) are the in-box providers, such as the Windows Backup utility and Windows Microsoft Software Shadow Copy Provider. These providers allow individual users to back up and recover user volumes and files. 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.
Copy terminology Understanding how Microsoft VSS terminology corresponds to standard IT industry terms for data copying makes it easier to understand what VSS does. The following paragraphs explain the terminology. Microsoft generally refers to a VSS copy as a “volume shadow copy.” When created using HP FRS and HWP, this type of copy is a static replica of an original volume’s contents. It is keyed with a GUID to allow identification of the parts of a shadow copy set that span multiple volumes.
HP EVA arrays and VSS The HP EVA VSS Hardware Provider works with EVA arrays to enable Microsoft VSS to perform snapclone setup and management. During HP VSS HWP installation you specify an EVA disk group to hold the copies. HP HWP typical applications The following examples demonstrate typical applications of the Hardware Providers when used with the Microsoft VDS, and VSS software components. Many more scenarios are possible.
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.) You can also use VSS and HP HWP to create and transport shadow copies from the primary server onto a backup server, and then back up the shadow copy volumes to tape. The advantage of this solution is that it relieves the primary server of backup traffic.
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 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 README files accompanying the HP HWP installation files for information about compatible software versions and system configurations. Follow all configuration and installation instructions carefully.
Important configuration notes The following notes will help ensure a successful configuration: • Using multiple servers is optional. However, if you use multiple servers, they must be in the same Ethernet domain so that the DCOM communication process can communicate between servers. • Administrator privileges are required for all devices and software. If you do not have administrator privileges, the software and hardware will not communicate properly.
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 array CV workstation Configure the disk array Command View server as explained below. VDS only requires that you do step 1. All other steps support VSS: 1. If desired, connect the corporate Ethernet LAN to the CV workstation through a firewall. Make sure the firewall is open between the CV workstation and the VDS/VSS server(s). 2. If multipathing is desired, verify existing or install HP MPIO Full-Featured Failover Manager as explained in the documentation for that product. 3.
Configuring the EVA disk array The following configuration steps are required only if you will use VSS to make volume shadow copies. If you are only using VDS and will not use VSS, you can skip these configuration steps. • Log into Command View as an administrator (the default administrator user name and password is administrator). 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.
Adding disk groups Add a snapclone disk group using the steps below. 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. Select 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 a name for the new disk group, and click Advanced options. 5. Select a disk type, enter the number of disks to use for this disk group, and click Next step.
6. Select a drive failure protection level, and click Next step. 7. Accept the occupancy alarm level and select Finish.
8. A message indicates the disk group was added, and the new group appears in the left panel. Click OK. 9. Repeat the previous steps as required to add the disk groups needed for your application.
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 nearly identical; 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. [http://www.hp.
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 finishes, 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. (The default username and password is “administrator”.) Click OK. A “loading...” message appears while the system authenticates the logon.
If the name of the array does not appear, the logon is incorrect or a communication problem has occurred with the CV workstation. Check your logon and password and check connectivity (for example, a firewall may be interfering with communication). Also refer to “Chapter 4 Troubleshooting” for troubleshooting information. 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.
2. For VSS, check that the disk group you selected is displayed. Then click OK. The InstallShield Wizard Completed window appears.
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.
One such program is Microsoft’s vshadow utility, which comes with the VSS Software Developer’s Kit. Test the HWP installation by making a shadow copy of the array volumes containing production data. Then check whether a copy of the production data appears on the snapclone volumes of the array. If the copy is not successful, see “Chapter 4 Troubleshooting.
Installation
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 README file 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.
1. Do the array volumes appear in the Disk Management tool? To check, in the Windows menu bar select Start > Control Panels > Administrative Tools > Computer Management > Storage > Disk Management. If array LUNs are not visible, click Action > Refresh and Action > Scan Disks. 2. Do the array volumes appear when you use the DiskPart utility? At the Run command line, type diskpart.exe. Type list disk to see a list of disk devices present. (Type “help” to see a list of commands.
5. 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. 6. Use a process of elimination to determine which components are not working. You can do this by testing components individually: • Test VSS and the array by using the Microsoft vshadow utility available in the Microsoft VSS Software Developer’s Kit to create snapshots.
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. 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_NOT_ENOUGH_DRIVE 0x80042410L Not enough drives are specified to complete this operation. VDS_E_BAD_COOKIE 0x80042411L The cookie is not found. VDS_E_NO_MEDIA 0x80042412L There is no media in the device. VDS_E_DEVICE_IN_USE 0x80042413L The device is in use. VDS_E_DISK_NOT_EMPTY 0x80042414L The disk is not empty. VDS_E_INVALID_OPERATION 0x80042415L Invalid operation. VDS_E_PATH_NOT_FOUND 0x80042416L The path is not found.
Message Id MessageID Value (hex) Message Text VDS_E_DMADMIN_CORRUPT_NOTIFICATION 0x80042424L A corrupt notification was sent from the Logical Disk Manager Administrative service. VDS_E_INCOMPATIBLE_FILE_SYSTEM 0x80042425L The file system is incompatible. VDS_E_INCOMPATIBLE_MEDIA 0x80042426L The media is incompatible. VDS_E_ACCESS_DENIED 0x80042427L Access is denied. VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L The media is write protected.
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_INTERNAL_ERROR 0x80042448L Check the event log for errors. VDS_S_ACCESS_PATH_NOT_DELETED 0x000042449L The access paths on the volume may not be deleted. VDS_E_PROVIDER_TYPE_NOT_SUPPORTED 0x8004244AL The method call is not supported for the specified provider type. VDS_E_DISK_NOT_ONLINE 0x8004244BL The repair operation failed. The disk is already in use by the volume. VDS_S_IN_PROGRESS 0x0004244DL The asynchronous operation is in progress.
Message Id MessageID Value (hex) Message Text VDS_E_IA64_BOOT_MIRRORED_TO_MBR 0x8004245AL Not Used! You have mirrored your boot volume on a GPT disk, to an MBR disk. You will not be able to boot your machine from the secondary plex. VDS_S_IA64_BOOT_MIRRORED_TO_MBR 0x0004245AL You have mirrored your boot volume on a GPT disk, to an MBR disk. You will not be able to boot your machine from the secondary plex.
VSS error messages 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. For example calling AddToSnapshot set prior to calling StartSnapshotSet. VSS_E_PROVIDER_ALREADY_REGISTERED 0x80042303L Calling RegisterProvider. VSS_E_PROVIDER_NOT_REGISTERED 0x80042304L Calling UnregisterProvider. VSS_E_PROVIDER_VETO 0x80042306L Calling DoSnapshotSet.
Error Meaning Corrective Action VSS_E_SNAPSHOT_SET_IN_PROGRESS 0x80042316L StartSnapshotSet was called when another snapshot set in in the process of being created. 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.
Error Meaning Corrective Action VSS_E_WRITERERROR_RETRYABLE 0x800423F3L Indicates that the writer failed due to an error that might not occur if another snapshot is created. VSS_E_WRITERERROR_NONRETRYABLE 0x800423F4L Indicates that the writer failed due to an error that most likely would occur if another snapshot were created. VSS_E_WRITERERROR_RECOVERY_FAILED 0x800423F5L Indicates that auto recovery of the snapshot volume failed.
Troubleshooting
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.
MSA HP StorageWorks Modular Smart Array. plex A Microsoft term denoting a full copy of data that has been split off from the original and is no longer being updated. Synonymous with “split mirror.” PVOL Primary volume. Typically the volume where application data is stored. RAID Redundant array of independent disks. SVOL Secondary volume. The volume that receives backup copies of data.
volume shadow copy See “shadow copy.” VSC Volume Size Configuration, a feature of HP disk arrays that allows creation of logical volumes custom-sized according to user requirements. VSS Microsoft Volume Shadow Copy Service, the Windows service that creates data copies. Works through HP HWP to make copies of disk array volumes. XP HP StorageWorks XP Disk Array.
Glossary
Index A additional servers configuring, 25 applications HWP, 16 VDS, 16 VSS, 16 array configuration, 19, 24 audience, 6 B Business Copy, 22 C command line utilities, 13 Command View, 22 configuration for HWP, 25 Command View management station, 21 components, 12 hardware, 21 HWP, 11 required, 20 software, 22 configuration, 19 additional servers, 25 array, 19 array and server, 24 disk array, 26 important notes, 23 summary, 24 configuration diagram, 20 conventions, document, 7 D disk array, 21 configu
installing, 33 uninstalling, 43 HWP overview, 15 HWP server configuring, 25 I installation, 31 disk group, 38 HWP, 33 summary, 32 upgrade, 32 verifying, 42 M management applications, 13 MPIO, 22 N network interface cards, 21 O server configuration, 24 server, HWP configuring, 25 software components, 22 software providers, 13 Subscriber’s Choice, HP, 8 symbols in text, 7 T technical support HP, 8 text symbols, 7 third party applications, 13 troubleshooting, 45, 46 U uninstalling HWP, 43 upgrade i