3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3PAR Inc. 4209 Technology Drive Fremont, CA 94538 USA Part No.
Revision Notice This is the first release of this manual. A complete revision history is provided at the end of this manual. Changes The material in this document is for information only and is subject to change without notice. While reasonable efforts have been made in the preparation of this document to assure its accuracy, 3PAR Inc. assumes no liability resulting from errors or omissions in this document or from the use of the information contained herein.
PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table of Contents 1 Introduction 1.1 Audience 1.1 1.2 Related Documents 1.2 1.3 Organization 1.3 1.4 Typographical Conventions 1.4 1.5 Advisories 1.5 2 Overview 2.1 Microsoft VSS 2.1 2.2 Operation of 3PAR VSS Provider for Microsoft Windows 2.2 2.2.1 3PAR VSS Provider for Microsoft Windows Aware Components 2.3 2.3 Host System Requirements 2.4 2.4 3PAR InServ Requirements 2.4 2.5 Support for Multiple InServ Connections 2.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3.4 Upgrading from a Previous Version 3.12 3.5 Removing the 3PAR VSS Provider For Microsoft Windows 3.13 3.6 System Registry 3.15 3.7 Using the Command Line Interface to Set Up or Modify an InServ Connection 3.18 4 Features and Considerations 4.1 Features 4.1 4.2 Special Considerations 4.3 5 Diagnostics 5.1 Volume Shadow Copy Service Trace 5.1.1 Contents of the vsstrace.reg File 5.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 1 Introduction In this chapter 1.1 Audience 1.1 1.2 Related Documents 1.2 1.3 Organization 1.3 1.4 Typographical Conventions 1.4 1.5 Advisories 1.5 This user’s guide provides the information you need to install and use the 3PAR™ VSS (Volume Shadow Copy Service) Provider for Microsoft Windows. 1.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 1.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 1.3 Organization This guide is organized as follows: ■ This chapter provides an overview of this guide, including intended audience, related documentation, typographical conventions, and advisories. ■ Chapter 2, Overview, provides an overview and information regarding supported components and system requirements for 3PAR VSS Provider for Microsoft Windows.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 1.4 Typographical Conventions The following typographical conventions are used in this guide: Typeface Meaning Example ABCDabcd Used for dialog box Enter your system name in the elements such as titles and Value box and click OK. button labels. ABCDabcd ABCDabcd Used for file names, paths, and screen output, and for Found < 12 > 73G disks. Enter cli at the Windows text you are to enter. command prompt.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 1.5 Advisories To avoid injury to people or damage to data and equipment, be sure to observe the cautions and warnings in this guide. Always be careful when handling any electrical equipment. NOTE: Notes are reminders, tips, or suggestions that supplement the procedures included in this guide. CAUTION: Cautions alert you to actions that can cause damage to equipment, software, or data.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 1.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 2 Overview In this chapter 2.1 Microsoft VSS 2.1 2.2 Operation of 3PAR VSS Provider for Microsoft Windows 2.2 2.3 Host System Requirements 2.4 2.4 3PAR InServ Requirements 2.4 This chapter provides an overview of supported components and system requirements for 3PAR VSS Provider for Microsoft Windows. 2.1 Microsoft VSS Microsoft includes VSS in the Windows 2003 and 2008 operating systems to simplify the enterprise’s storage environment.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 2.2 Operation of 3PAR VSS Provider for Microsoft Windows 3PAR VSS Provider for Microsoft Windows (Figure 2-1) communicates with the operating system and applications, and temporarily freezes computing tasks to allow for the creation of and removal of snapshots. The freeze function allows for the creation of a snapshot that reflects the state of application data at a given point in time.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 2.2.1 3PAR VSS Provider for Microsoft Windows Aware Components To ensure absolute data integrity for all volumes, especially those that are interrelated, the application, the backup program, and the backup device should be “VSS aware”. This means that the components participating in the backup must be specifically programmed to work with 3PAR VSS Provider for Microsoft Windows.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 2.3 Host System Requirements ■ Microsoft Windows Server 2003 (x86 and x64) or 2008 (x86 and x64). For the latest system service pack requirements, refer to the appropriate 3PAR InForm OS Configuration Matrix (PN 320-200099) which can be accessed through the 3PAR Document Control System (DCS). ■ 3PAR InForm CLI installation.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 2.5 Support for Multiple InServ Connections The current version of 3PAR VSS Provider for Microsoft Windows supports multiple InServ connections to the same host server where 3PAR VSS Provider for Microsoft is installed. This allows VSS hardware snapshots to be managed from a host that is connected to multiple InServ Storage Servers via HBA or iSCSI.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 2.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3 Installation, Upgrade and Deinstallation In this chapter 3.1 System Setup 3.2 3.2 Installing 3PAR VSS Provider for Microsoft Windows 3.3 3.3 Verifying the Installation 3.10 3.4 Upgrading from a Previous Version 3.12 3.5 Removing the 3PAR VSS Provider For Microsoft Windows 3.13 3.6 System Registry 3.15 3.7 Using the Command Line Interface to Set Up or Modify an InServ Connection 3.18 Installation, Upgrade and Deinstallation 3.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3.1 System Setup 3PAR VSS Provider for Microsoft Windows serves as a communication bridge between Microsoft VSS and 3PAR InServ Storage Servers during the creation and removal of a volume shadow copy (snapshot). To set up the system for 3PAR VSS Provider for Microsoft Windows: 1 Log on as System Administrator. As the Windows System Administrator, you will need a user name and password for VSS.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3.2 Installing 3PAR VSS Provider for Microsoft Windows NOTE: Prior to installing 3PAR VSS Provider for Microsoft Windows, the host server must have 3PAR InForm CLI installed and configured. All corresponding InServ Storage Servers need to have a Virtual Copy license and a VSS Provider for Microsoft Windows license enabled. For instructions on installing and configuring 3PAR InForm CLI, please refer to System Setup on page 3.2.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide To install 3PAR VSS Provider for Microsoft Windows: On Windows 2003 1 Log-in as System Administrator. 2 Insert the 3PAR VSS Provider for Microsoft Windows CD into the CD-ROM drive. 3 Click Start > My Computer to expand the CD-ROM drive directory. 4 Click the VSSProvider directory. 5 Click the Setup_2k3.exe command as seen for x86 (32-bit) platform. As an alternative, you can select Setup_2k3_x64.exe for the x64 (64-bit) platform.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 6 Follow the instructions in the 3PAR VSS Provider for Microsoft Windows installer window (Figure 3-1). Figure 3-1. Installer Window NOTE: The Disk Cost button analyzes the amount of available storage space and compares it to the amount required for the 3PAR VSS Provider for Microsoft Windows installation. The default options to install for Everyone will create a Windows service for everyone who has access to the system.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 7 Enter the appropriate information for the InServ Connection from the InServ Storage System Connection Configuration window. Figure 3-2. InServ Storage System Connection Configuration Window Fill in the fields in the InServ Connection Configuration window with the following values: ` System Name: InServ Storage Server name or IP address.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Figure 3-3. Operation Success Window Explanations for the categories shown on this window are as follows: ■ License In InServ Storage System -- This column shows the list of licenses on the InServ Storage Server. ■ Status -- This column indicates the state of the license on the InServ Storage Server. 3.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide NOTE: A red cross icon indicates that InServ Storage Server does not have either a Virtual Copy or 3PAR VSS Provider for Microsoft Windows license enabled. Installation will be terminated at this point. NOTE: A warning icon indicates that InServ Storage Server does not have Recovery Manager for Exchange, Recovery Manager for SQL or a Remote Copy license available which are essential to Recovery Manager related products.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Figure 3-4. Windows Command Prompt NOTE: After using the Remote Desktop Connection to install 3PAR VSS Provider for Microsoft Windows, you must log out of the session and re-connect to refresh the connection after the installation has completed. You can then activate the Remote Desktop Connection. 3.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3.3 Verifying the Installation To verify the 3PAR VSS Provider for Microsoft Windows installation: On Windows 2003 1 Log on as System Administrator. 2 Verify Windows service registration: a Click Start. b Right-click My Computer. c Click Manage. d Expand the Services and Applications tree node. e Click Services. On Windows 2008 1 Log on as System Administrator. 2 Verify Window service registration: a Click Start.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3 For both, Windows 2003 and 2008, verify that 3PAR VSS Provider is listed as a service that is currently running. 4 You can verify the Provider registration to 3PAR VSS Provider for Microsoft Windows from a command line prompt by entering the vssadmin list providers command as shown in the following example: C:\>vssadmin list providers vssadmin 1.1 - Volume Shadow Copy Service administrative command-line tool (C) Copyright 2001 Microsoft Corp.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3.4 Upgrading from a Previous Version WARNING: Make sure that no backup jobs are running in the background prior to upgrading 3PAR VSS Provider for Microsoft Windows. This version of 3PAR VSS Provider for Microsoft Windows does not support a direct upgrade from a previous version. If you already have a previous version of 3PAR VSS Provider for Microsoft Windows installed on your system, please uninstall it before proceeding with the installation.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3.5 Removing the 3PAR VSS Provider For Microsoft Windows To remove the 3PAR VSS Provider for Microsoft Windows: On Windows 2003 1 Log on as System Administrator. 2 Click Start > Control Panel. 3 Click Add or Remove Programs. Result: The Add or Remove Programs window appears. 4 Select 3PAR VSS Provider For Microsoft Windows. 5 Click Remove. On Windows 2008 1 Log on as System Administrator. 2 Click Start > Control Panel.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 6 For both versions of Windows, verify the deinstallation procedure by viewing the 3parprov.log file located in the %SYSTEMROOT% directory. The deinstallation entry in the log file should indicate that the application has been successfully removed. 3.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3.6 System Registry After installing 3PAR VSS Provider for Microsoft Windows, a 3par->HWPRV registry key is created under HKEY_LOCAL_MACHINE->Software. CAUTION: DO NOT edit the registry key value unless asked to do so by your local service provider for support purposes. NOTE: For tracking purposes, you may need to modify the value for LogLevel to a higher number in order to record more detailed information to a file.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Valid registry values for 3PAR VSS Provider for Microsoft Windows are shown in Table 3-1. Table 3-1. Registry Values for 3PAR VSS Provider for Microsoft Windows. Name Value CurrentVersion The current release version for 3PAR VSS Provider for Microsoft Windows. InstallDir The directory where 3PAR VSS Provider for Microsoft Windows is installed. LogLevel The trace level that is set for the log file in the directory specified by LogPath.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 3-1. Registry Values for 3PAR VSS Provider for Microsoft Windows. (continued) Name Value EnableSSL Specifies whether an SSL connection is to be used: 0 Disable use of SSL for CLI connection. 1 Enable use of SSL for CLI connection. This entry is under the InServConfig sub-key. ProductID Identification information for the registered InServ Storage Server. This entry is under the InServConfig sub-key.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 3.7 Using the Command Line Interface to Set Up or Modify an InServ Connection This section describes the ProvCfg command that can be accessed from the Command Line Interface to quickly list details and modify the configuration setup for 3PAR VSS Provider for Microsoft Windows. 3.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide COMMAND ProvCfg DESCRIPTION The ProvCfg command is used to view or modify the configuration settings. SYNTAX ProvCfg InServ|Conn|Log [options ] SUBCOMMANDS InServ Used to view or modify the communication setup for the InServ Storage Server. Conn Used to view or modify the connection settings. Log Used to view or modify the log level.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide -detail Shows additional license and connection information. -default Sets as default entry. ■ The following options can be used with the Conn subcommand: -timeout Specifies the timeout value in seconds to wait for a response from the InServ Storage Server. -retry Specifies the number of retries after a response timed out from InServ Storage Server.
3PAR VSS Provider for Microsoft Windows 1.
3PAR VSS Provider for Microsoft Windows 1.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 4 Features and Considerations In this chapter 4.1 Features 4.1 4.2 Special Considerations 4.3 4.1 Features The following features are included in 3PAR VSS Provider for Microsoft Windows: ■ Atomic Shadow Copy creation. Supports up to 64 shadow copies per volume (snapshots to a volume) within a shadow copy set. ■ Writable Snapshot Volume.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide ■ Recovery Manager for Exchange. Provides the capability to take a non-destructive virtual copy from Microsoft Exchange 2003 and 2007 for backup and fast recovery. ■ Recovery Manager for SQL. Provides the capability to take a non-destructive virtual copy from Microsoft SQL Server for backup and fast recovery. ■ Veritas NetBackup. Support for Veritas NetBackup through the VSS snapshot method. ■ Transportable shadow copy.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 4.2 Special Considerations ■ Auto-Import Shadow Copies are not supported on Windows Cluster service. Windows Cluster service cannot accommodate LUNs with duplicate signatures and partition layout. The shadow copy LUNs must be transported to a host outside the cluster, or the original volume must be dismounted before the shadow copy can be imported. This is a limitation of the Window Cluster service.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide The following shadow copy attributes are not supported in the current release of 3PAR VSS Provider for Microsoft Windows: ■ ◆ All shadow copies are created with a copy-on-write mechanism. ◆ All shadow copies are hidden. Taking a snapshot on a System Drive is not supported. With the additional System Writer involved on the System Drive, taking snapshots on a database where its physical location is on the System Drive is not supported.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 5 Diagnostics In this chapter 5.1 Volume Shadow Copy Service Trace 5.1 5.2 Application Event Log 5.3 5.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide The file vsstrace.reg is located under the 3PAR VSS Provider for Microsoft Windows installation directory. Since VSS logging is volume based, the log file cannot be on the volume as part of the shadow copy set. The default location for the TraceFile is set to: c:\vsstrace.txt. Modify it to fit into your system if necessary. Use Windows Explorer to locate the vsstrace.reg file. Double-click on this file to make it active.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide 5.1.1 Contents of the vsstrace.reg File Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\VSS\Debug\Tracing] "TraceFile"="c:\vsstrace.txt" "TraceLevel"=dword:ffffffff "TraceEnterExit"=dword:00000001 "TraceToFile"=dword:00000001 "TraceToDebugger"=dword:00000000 "TraceFileLineInfo"=dword:00000001 "TraceForceFlush"=dword:00000000 5.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide To view the message from Window Application Event Viewer: On Windows 2003 1 Click Start. 2 Right-click My Computer. 3 Click Manage. 4 Expand on the System Tools tree node from the left panel. 5 Click Event, and then Application. Result: The Application Event log appears on the right panel. (Figure 5-1). On Windows 2008 1 Click Start.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 5-1provides descriptions and actions for the various application events. The Description subsection for each message describes the problem. The Action subsection suggests possible solutions. Table 5-1. Application Events Event ID Description Action 5000 3PAR VSS Provider for None Microsoft Windows OnLoad was successful. 3PAR VSS Provider for Microsoft Windows has loaded the provider’s DLL on demand.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 5-1. Application Events Event ID Description Action 5020 Snapshot ID None prepared. Internal logging, . is a unique identifier. 5040 SnapshotSet None created. Indicates the SnapshotSet request has been fulfilled. 5041 Exec: None Internal logging, which records the task from the 3PAR VSS Provider for Microsoft Windows to the 3PAR InServ Storage Server.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 5-1. Application Events Event ID Description Action 5043 Virtual Copy None removed. The exported snapshot disk has been removed from the host. 5050 Unsupported feature The request is . unsupported by the current release. Contact The 3PAR VSS Provider for your local service provider Microsoft Windows for a future release. received an unsupported request through the VSS framework.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 5-1. Application Events Event ID Description Action 5052 Could not allocate Insufficient memory is memory. available to allow 3PAR VSS Provider for Microsoft Internal error, failed to Windows to operate allocate memory during normally. Shutdown some computing. of the idle applications that are still running and resume the previously failed task. 5053 Could not communicate See System Setup on with InForm CLI. page 3.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 5-1. Application Events Event ID Description Action 5055 : Invalid token. Set the LogLevel to ‘4’ to show the detail error 5056 Internal error. The output message to log file, and format does not match. retry. Could not open the Set the LogLevel to ‘4’ and volume mapping file: look for vvmap as . Failed to from open the mapping file that the 3parprov.log.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 5-1. Application Events Event ID Description Action 5061 IOCTL inquiry call failed. Check the Window Disk Manager and the 3PAR Failed on SCSI inquiry to InServ Storage Server to the storage device through verify that the device is an IOCTL call. active and functioning properly. 5062 Could not query the Check for the existence of register key value for the key name . from the register database.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 5-1. Application Events Event ID Description Action 5064 Could not open the The registry key was register key for 3PAR VSS created by the installer Provider for Microsoft program during the 3PAR Windows. VSS Provider for Microsoft Windows installation. Failed to open register key Check to see if the [HKEY_LOCAL_MACHINE\SO installation was successful.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Table 5-1. Application Events Event ID Description Action 5067 The destination LUN could Turn on VSS logging and not be identified. reproduce the problem to collect VSS trace data for 3PAR VSS Provider for Microsoft Product Support Microsoft Windows failed Service. to provide the information of the destination LUN from the interface. 5068 Could not retrieve device Check both the Window descriptor .
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide Revision History .............. Release level Revision summary 320-200148 Rev A First release of this document under part number 320-200148 Rev A August 2009 for version 1.6. This document was previously published under part number 320-200110. Revision History RH.
3PAR VSS Provider for Microsoft Windows 1.6 User’s Guide RH.