HP 3PAR Recovery Manager 2.0 Software for Microsoft Hyper-V User Guide Abstract This document provides information about using HP 3PAR Recovery Manager for Microsoft Hyper-V for experienced Microsoft™ Windows™ System Administrators managing databases.
© Copyright 2014 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 Online Help for HP 3PAR Recovery Manager Software for Microsoft Hyper-V........6 1 Introducing HP 3PAR Recovery Manager Software for Microsoft Hyper-V............7 System Requirements.................................................................................................................7 Windows Server Requirements...............................................................................................7 Windows Server 2008..............................................................
Restoring Virtual Machines From Virtual Copies......................................................................40 Removing Virtual Copies.....................................................................................................41 Mounting Virtual Copies.....................................................................................................41 Unmounting Virtual Copies..................................................................................................
Import-Repository....................................................................................................................83 Login-Rmh..............................................................................................................................84 Logout-Rmh............................................................................................................................85 Mount-vCopy..........................................................................................
Online Help for HP 3PAR Recovery Manager Software for Microsoft Hyper-V Welcome to the online help for HP 3PAR Recovery Manager Software for Microsoft Hyper-V. Searching the Online Help To search the online help, click Search in the navigation pane on the left. The Search feature supports: • Case-insensitivity If you search for host, the search displays topics containing host, Host, HOST, and so on.
1 Introducing HP 3PAR Recovery Manager Software for Microsoft Hyper-V HP 3PAR Recovery Manger for Microsoft Hyper-V is the latest addition to HP 3PAR Solutions portfolio and offers key management capabilities and facilitates the integration of HP 3PAR Virtual Copy and Microsoft Hyper-V Virtual Machine environment. System Requirements Windows Server Requirements Microsoft Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, or Windows Server 2012 R2.
Figure 1 HP 3PAR Recovery Manager for Microsoft Hyper-V Architecture Features of HP Recovery Manager Software for Microsoft Hyper-V HP 3PAR Recovery Manager for Microsoft Hyper-V can be installed on any client and used for automation.
• Accessing Powershell Cmdlet-based RMH Command Line Interface (CLI) ◦ Virtual Copy commands include analyze, create, remove, mount, unmount, restore, and show • Policy commands include creation and show • Connectivity commands include logging on and off of Hyper-V and multiple StoreServs and showing current connections Additional details of the new features for the software are included in the following table: Table 1 Features Included in Recovery Manager for Microsoft Hyper-V Feature Description
Table 2 RMH PowerShell Snap-in Cmdlets Command Description Add-HyperV Adds Hyper-V credentials for users Add-StoreServ Adding an additional HP 3PAR StoreServ credential Add-RemoteStoreServ This is used to add each HP 3PAR StoreServ credentials and is only required initially to set up the credentials.
About Virtual Copy Management HP 3PAR Recovery Manager for Microsoft Hyper-V features an essential Virtual Copy management tool with enhanced recovery commands that allow you to create and restore application consistent Virtual Copies of running Hyper-V Virtual Machines (VMs). When creating a VM Virtual Copy, Recovery Manager for Microsoft Hyper-V identifies all the underlying HP 3PAR volumes and creates Virtual Copies simultaneously for all volumes to ensure consistency.
Graphical User Interface Scheduling Tool You can automatically create Virtual Copies according to a specified schedule with RMH scheduling tool and add policies to new Virtual Copies. For more information, see “Using the Web Client Interface” (page 24).
2 Getting Started The following sections provide information about HP 3PAR Recovery Manager for Microsoft Hyper-V components, types of supported platforms and environments, and installation requirements.
Figure 2 Recovery Manager for Microsoft Hyper-V Configuration About Supported Operating Systems and Software Prerequisites Before you begin installing HP 3PAR Recovery Manager Software for Microsoft Hyper-V, make sure that you know the following requirements are satisfied: Operating Systems HP 3PAR Recovery Manager for Microsoft Hyper-V Agent • Microsoft Windows Server 2008 R2 SP1 (x64) (Full and Core version) • Windows Server 2012 or Windows Server 2012 R2 (x64) (Full and Core version) HP 3PAR OS Sof
Software Prerequisites HP 3PAR OS Licenses • HP 3PAR Virtual Copy • HP 3PAR Recovery Manager for Microsoft Hyper-V • HP 3PAR Virtual Lock (Optional) HP 3PAR Recovery Manager for Microsoft Hyper-V Agent/Server/Client • Microsoft .Net Framework 4.5 Full package (Installer for Windows 2008 R2 SP1 Full and Core version are different.
About Other Requirements Before you begin installing HP 3PAR Recovery Manager Software for Microsoft Hyper-V, make sure that you know the following requirements are satisfied. • HP 3PAR Recovery Manager for Microsoft Hyper-V license, HP 3PAR Virtual Copy license for Virtual Copy operation, and HP 3PAR Remote Copy license for Remote Copy operations. • Virtual Machines must have Hyper-V integration services enabled in order to perform VC operations with application consistency.
3 Installing HP 3PAR Recovery Manager for Microsoft Hyper-V Before you begin using HP 3PAR Recovery Manager for Microsoft Hyper-V (RMH), make sure that your system hardware and software are both correctly set up. Installing the Software The software installation process includes three components: server, agent, and client. All three components must be properly installed before using the software. NOTE: 1. 2. 3. RMH does not support Agent installation on Virtual Machines.
Figure 4 License Agreement dialog 5. Enter the following information and click Next. • User Name • Organization Figure 5 License Registration dialog 6. 18 Do one of the following: • Click Next to install this folder to the default location. • Click Change to install to a different folder location.
Figure 6 Setting Destination Folder dialog 7. Choose a type of setup: • Complete • Custom Select the feature to install: Agent, Client, or Server. NOTE: You must select one or more feature to continue the installation process. Click Next. Figure 7 Installation Setup Type dialog 8. Review the feature installation settings and click Install to begin the installation.
Figure 8 Feature Installation Settings dialog The process now initiates and provides status updates throughout the installation period. 9. Click Finish when the installation is complete. To review the Windows Installer log, check the option box before clicking Finish. Figure 9 Installation Complete dialog Upgrading to Recovery Manager 2.0 for RMH NOTE: RMH 2.0 does not support downgrade. The following method helps you upgrade the Hyper-V and Backup servers. 1.
Figure 10 File in Use NOTE: 4. • Before upgrading make sure all Hyper-V GUI and PowerShell windows are closed and there is no Hyper-V process running. • Reboot is required, if the user selects Do not close application option. Click Finish after the upgrade is complete. To review the Windows Installer log, select the option before clicking Finish.
3. Go to HKEY_LOCAL_MACHINE\SOFTWARE\HP\RMHand check if CurrentVersion is 2.0.0 to verify the registry key. Uninstalling the Software You can use either the Microsoft Windows Control Panel or RMH InstallShield Wizard to uninstall HP 3PAR Recovery Manager Software for Microsoft Hyper-V. Using Microsoft Windows 2008 Control Panel The 1. 2. 3. following method completely removes all components of RMH. Click Start→Control Panel→Programs→Programs and Features.
2. Choose Remove and click Next. Figure 13 Program Maintenance Options 3. Review the message dialog. Click Remove.
4 Using the Web Client Interface HP 3PAR Recovery Manager Software for Microsoft Hyper-V provides GUI-based administrative tools to monitor and manage the RMH server, RMH agents, and StoreServ. In addition, some of the application configuration settings can be customized by the user.
Figure 15 Recovery Manager Hyper-V Home Workspace View When you select a specific server on the Tree View pane, the following tabs becomes available: • The Summary tab provides a general system summary of a selected Hyper-V server. Figure 16 Hyper-V Server Summary Tab • The Virtual Machines tab lists all the Virtual Machines associated with a Hyper-V server.
Figure 17 Hyper-V Server Virtual Machines Tab Table 4 Hyper-V Server Virtual Machines Tab • Column Displays Name Name of Virtual Machine State Activity status of the Virtual Machine Health Current system condition of the Virtual Machine Clustered Associated clusters belonging to the server Using CSV Current condition of CSV System Root Path Full path of the system root path The Virtual Volumes tab provides a comprehensive summary of all Virtual Volumes associated with a Hyper-V server.
NOTE: Microsoft Internet Explorer version 8 will not display the pie charts. Use Microsoft Internet Explorer version 9 or above for the best view results.
• The Virtual Copies tab provides a list of all Virtual Copies created from Virtual Machines on the Hyper-V server.
Table 8 Hyper-V Server Virtual Copies Tab (continued) Column Displays Virtual Machine Name of the Virtual Machine the Virtual Copy was created for Table 9 Details of Virtual Copy Pane Column Displays Base Volume Name of base volume Base ID Base volume ID Virtual Copy Volume Name of Virtual Copy volume Virtual Copy ID Virtual Copy ID Status Status of the Virtual Copy Mounted Mounted or unmounted status Exported Host Name of the host receiving the exported Virtual Copy Expiry Date of expi
Figure 20 Virtual Machine Summary Tab • The Virtual Hard Disks tab lists connecting hard disks associated with the Virtual Machine.
Figure 22 Virtual Volumes Tab Table 13 Virtual Volumes Tab • Column Displays Virtual Volume Description of virtual volume World Wide Name Description of World Wide Name of virtual volume ID System ID Status Current status of virtual volume HP 3PAR StoreServ Name Name of HP 3PAR StoreServ associated with virtual volume Volume Type Type of volume Provision Type Type of provisioning Requested Size Size of storage space Used Current storage space usage The Virtual Copies tab provides a li
Figure 23 Virtual Copies Tab Table 14 Virtual Machine Control Bar Option Action Create Creates a Virtual Copy for the Virtual Machine Policy Sets the policy for the Virtual Machine Table 15 Virtual Copy Pane Column Displays Name Name of Virtual Copy Created Date/Time Date and time of Virtual Copy Creation Table 16 Details of Virtual Copy Pane 32 Column Displays Base Volume Name of base volume Base ID Base volume ID Virtual Copy Volume Name of Virtual Copy volume Virtual Copy ID Virtu
Table 17 Details of Virtual Volumes Pane Column Displays Path Path of virtual volume Mount Point Location to mount Virtual Copy In Saved State Status of virtual volume In Use Activity of virtual volume File Size Size of virtual volume Maximum Internal Size Maximum size of hard disk Table 18 Remote Copy Details • Column Displays Source Read and write of volume Target Read only volume Attribute The type of mode: ◦ Sync ◦ Periodic The Scheduler tab enables you to create a schedule t
Table 19 Scheduler tab (continued) Column Displays Expiry Expiration of scheduled policy run time Retention Retention of policy Last Run Status Result status of last policy run time Accessing the Web Client 1. 2. 3. Launch a preferred web browser. Type https://:5555/Server/Html5 in the address bar. Read the security certificate message before you continue. Click Continue to this website (not recommended).
2. Click Connect. Setting Up the Recovery Manager Web Client Connecting to Hyper-V Server If a Hyper-V server is not found in the repository, you can manually add a server. 1. Launch the Recovery Manager web client. 2. Type the required credentials: • Hyper-V server hostname or IP address • User name • Password Figure 27 Connect to Hyper-V Server Dialog Box 3. Click Connect.
1. From the menu bar, click Administrative Tools to open the drop-down menu. Figure 28 Installing Recovery Manager Agent Dialog Box 2. 3. Right-click context menu of the Hyper-V Servers tree node. Continue to follow the prompts. Uninstalling Recovery Manager Agent To uninstall HP 3PAR Recovery Manager agent from a Hyper-V server: 1. From the menu bar, click Administrative Tools to open the drop-down menu. 2.
Updating StoreServ Credentials To update HP 3PAR StoreServ login credentials: 1. From the Tree view pane, select the Hyper-V server node. 2. Click the Update HP 3PAR StoreServ Credential hyperlink located on the control bar. 3. Enter the new user name and password. 4. Click Update. Adding HP 3PAR StoreServ System Credentials To add HP 3PAR StoreServ system credentials: 1. From the Tree view pane, select the Hyper-V server. 2. Click the Add HP 3PAR StoreServ Credential hyperlink located on the control bar.
The application also provides the capability to perform a full restoration of any Virtual Machines to its original location from a point-in-time Virtual Copy or VSS aware Snapshot. Any existing configuration files and virtual hard disks are overwritten. Creating Virtual Copies NOTE: There are three options to create a Virtual Copy: • Select a Hyper-V Server from the tree and click the Virtual Machines tab then select one or more Virtual Machines and click Create Virtual Copy.
Figure 33 Create Virtual Copy 5. Click Create. NOTE: For more information about using the CLI feature to create a Virtual Copy, see HP 3PAR Command Line Interface Reference Setting Policy to Virtual Copies You can set expiration and retention policies to any newly created Virtual Copies. To set the Virtual Copy policy of one or more Virtual Machines: 1. From the Tree view pane, select the Hyper-V server. 2. Click the Virtual Machines tab and select one or more Virtual Machines.
Figure 35 Virtual Copy Policy Dialog Box 5. Click Save. Analyzing Virtual Copies Analyze command displays inconsistencies in all virtual copy records by matching virtual copies in the HP 3PAR StoreServ Storage System against records in HP 3PAR Recovery Manager for Hyper-V repository. Optionally, you can delete the virtual copies that are not found in HP 3PAR StoreServ Storage System. To analyze one or more Virtual Copies: 1. From the Tree view pane, select the Hyper-V server. 2.
2. Click the Virtual Copies tab and select a Virtual Copy. Figure 37 Restoring Virtual Machines from a Virtual Copy 3. Click Restore. Removing Virtual Copies To remove one or more Virtual Copies: 1. From the Tree view pane, select the Hyper-V server. 2. Click the Virtual Copies tab and select one or more Virtual Copies. Figure 38 Removing Virtual Copies 3. Click Remove.
Figure 39 Selecting a Virtual Copy and Virtual Volume 4. 5. Click Mount. Set the values for the following options: • Mount on cluster node • Mount on another Hyper-V server • Mount point prefix (optional) NOTE: Click the question mark for more details about the option. Figure 40 Mounting a Virtual Copy 6. 42 Click Mount.
Unmounting Virtual Copies When a Virtual Copy is under a Mounted state, use the following steps to unmount a Virtual Copy. 1. From the Tree view pane, select either a server or node cluster. 2. Click the Virtual Copy tab. 3. Select a Virtual Copy and then select one or more virtual volumes. Figure 41 Selecting a Virtual Copy and Virtual Volume 4. 5. Click Unmount.
6. Click Unmount. Scheduling Virtual Copy Creation Tasks You can schedule Virtual Copy creation tasks according to a specified schedule. To add a scheduled Virtual Copy creation task: 1. From the Tree view pane, select either a server or node cluster. 2. Click the Scheduler tab. Figure 43 Scheduler Tab 3. 4. 5. Click the Create Virtual Copies tab. Click Add. Follow the wizard to complete the scheduling tasks and click Next. Figure 44 Schedule Virtual Copy Task Wizard 6.
Figure 45 Schedule Virtual Copy Task Details 7. Set the values for the Schedule, Date, and Time and click Next. Figure 46 Schedule Virtual Copy Task Date and Time 8. Review the summary of task and click Save. Figure 47 Schedule Virtual Copy Creation Task Summary 9. If updating the schedule is necessary, select a schedule and click Update. Continue to follow the wizard to update the scheduling tasks. When the update is complete, click Refresh to update the data view of the selected tab.
Scheduling Virtual Copy Analysis Tasks You can schedule Virtual Copy analysis tasks according to a specified schedule. To add a scheduled Virtual Copy analysis task: 1. From the Tree view pane, select either a server or node cluster. 2. Click the Scheduler tab. 3. Click the Analyze All Virtual Copies tab. 4. Click Add. 5. Follow the wizard to complete the scheduling tasks and click Next. Figure 48 Schedule Virtual Copy Analysis Task Wizard 6.
Figure 50 Schedule Virtual Copy Analysis Task Date and Time 8. Review the summary of task and click Save. Figure 51 Schedule Virtual Copy Analysis Task Summary 9. If updating the schedule is necessary, select a schedule and click Update. Continue to follow the wizard to update the scheduling tasks. When the update is complete, click Refresh to update the data view of the selected tab.
Working with Remote Copies HP 3PAR Remote Copy Software helps you to safeguard against disasters that can occur at one location, by allowing you to keep copies of data on a separate server which can be placed at a remote location. For example, if there were a fire or earthquake at one location, all of the data stored there could be lost unless a backup copy can be recovered from a separate location not affected by the disaster.
Figure 54 Remote Recovery Manager Server 3. 4. Click the Virtual Machines tab and select one or more Virtual Machines. Click Create Virtual Copy.
5. Enable the check box Create Remote Virtual Copy and from the list select: • Sync • Periodic Figure 55 Create Remote Virtual Copy NOTE: While it is not possible to send partial data within a Remote Copy group across data sites. When there are multiple virtual machines configured to a same Remote Copy group from StoreServ, virtual machines will be backed up, even if one of the Virtual Machine is selected. Repository Backup Repository backup is vital for maintaining regular backups.
Figure 56 Save Repository on Network Path 3. 4. 5. Select the option Save to a network path using the following credential. By default this option is selected. Enter the required credentials: • Hyper-V server hostname or IP address • User name • Password • Network path Click Save to save the files on the network path. NOTE: The repository backup takes only few seconds. Hence, it is recommended that you avoid snapshot creation or mount/unmount operations while saving or importing repository.
Scheduling Repository Backup To schedule a repository backup on a network path: 1. From the menu bar, click Administrative Tools to open the drop-down menu. 2. Select Schedule Save Repository and click Add. Figure 58 Scheduling Repository Backup 3. Follow the wizard to complete the scheduling tasks and click Next. Figure 59 Schedule Task 4. 52 Set the values for the following applicable options and click Next: • Task name • Select the option Save to a network path using the following credential.
NOTE: The format of the location of the network path is: \\RemoteHost\\BackupRepository Figure 60 Schedule Task 5. 6. Set the values for the Schedule, Start time, Recur every , and click Next. Review the summary of task and click Save. Figure 61 Summary 7. If updating the schedule is necessary, select Save Repository and click Update. Continue to follow the wizard to update the scheduling tasks. When the update is complete, click Refresh to update the data view of the selected tab.
Importing Repository Backup To import a repository from a Network path: 1. From the menu bar, click Administrative Tools to open the drop-down menu. 2. Click Import Repository. Figure 63 Import Repository 3. 4. 5. 6. Select the option Import from a network path using the following credential. By default this option is selected. Enter the required credentials: • Windows hostname or IP address • User name • Password • Network path Select the option Refresh all servers after import is completed.
5 Using PowerShell Snap-in Command Line Interface HP 3PAR Recovery Manager for Hyper-V includes custom Powershell snap-in as the default client interface and provides essential command lines for administrative tasks. NOTE: For the list of all command used in Recovery Manager for Hyper-V, see “HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands” (page 73) Connecting to RMH Server Use the following command lines to establish a session with the Microsoft Hyper-V server.
Configuring RMH Server The section describes the command line usage and parameters for configuring Hyper-V servers. Add-HyperV Add-HyperV adds Hyper-V credentials for users. The command is used with each Microsoft Hyper-V (cluster or standalone host) credentials and managed by the application. Add-HyperV command completes when specifying \ format as username.
Preconditions • The user must first login with Login-Rmh. • HP 3PAR StoreServ name must not already exist for specified Microsoft Hyper-V Syntax Any optional parameters are enclosed in square brackets [ ] around them.
Table 24 Set-RmhPolicy parameters (continued) Parameter Optional/Required Description -Expiry Optional Integer value followed by letter h or d for Hours and Days respectively. Use 0 to reset. -Retention Optional Integer value followed by letter h or d for Hours and Days respectively. Use 0 to reset -SavedStateBackups Optional Disabled or enabled. Use reset to reset.
Table 26 Get-EncryptedLoginPassword parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -Verbose Optional Displays progress messages. Get-RmhPolicy The get-RmhPolicy retrieves the RMH policy settings of a Hyper-V Virtual Machine. An RMH policy object retains the set default values for Virtual Copies. You can customize the attributes of a Virtual Copy. Preconditions The user must first login with Login-Rmh.
Table 28 Get-VirtualMachine parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Select Hyper-V host/cluster to use. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported. -Verbose Optional Displays progress messages. The command returns multiple RMHirtualMachineInfo objects.
Create-vCopy -RmhServerName -HypervName -VmNamesUuids [-VcNamePrefix] [-Expiry] [-Retention] [-SavedStateBackups] [-Verbose] Table 30 Create-vCopy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Select Hyper-V host/cluster to use. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported.
Syntax Any optional parameters are enclosed in square brackets [ ] around them. Get-vCopy -RmhServerName -HypervName [-VcNamesUuids] [-VmNamesUuids] [-Timestamp] [-Verbose] Table 31 Get-vCopy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Select Hyper-V host/cluster to use. This is FQDN or IP address. Synonyms for Hyper-V are supported.
Table 32 Mount-vCopy parameters (continued) Parameter Optional/Required Description -VcNameUuid Required Select VC by name/uuid. -VmNameUuid Required Select name/uuid to filter VC selection by Virtual Machine. -Timestamp Optional Specify timestamp of VC to locate in the format mmddyyhhmmss. -MountPointPrefix Optional Mount point prefix where RMH will create a mount point for each Virtual Volume mounted using an appended mount point name in the format RMHv.wwn.partition.
Table 33 Restore-vCopyVm parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Optional Select Hyper-V host/cluster to use. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported. -VcNameUuid Required Select VC by name/uuid. -VmNameUuid Required Select name/uuid to filter VC selection by VM.
Table 34 Analyze-vCopy parameters (continued) Parameter Optional/Required Description -Cleanup Optional If specified, Analyze-vCopy will clean up the inconsistent VC by removing it. Removing the inconsistent VC will take the same action as the Remove-vCopy command. If there are no inconsistencies, the VC is not removed. Without this option, the same work is performed except no action is taken to remove the VC. Instead, the user will be given an error report.
Table 35 Unmount-vCopy parameters (continued) Parameter Optional/Required Description of the RMH Server is used fromLogin-Rmh. -Verbose Optional Displays progress messages.
6 Support and Other Resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
For information about: See: Migrating data from one HP 3PAR storage system to another HP 3PAR-to-3PAR Storage Peer Motion Guide 68 Configuring the Secure Service Custodian server in order to monitor and control HP 3PAR storage systems HP 3PAR Secure Service Custodian Configuration Utility Reference Using the CLI to configure and manage HP 3PAR Remote Copy HP 3PAR Remote Copy Software User’s Guide Updating HP 3PAR operating systems HP 3PAR Upgrade Pre-Planning Guide Identifying storage system compo
For information about: See: Planning for HP 3PAR storage system setup Hardware specifications, installation considerations, power requirements, networking options, and cabling information for HP 3PAR storage systems HP 3PAR 7200, 7400, and 7450 storage systems HP 3PAR StoreServ 7000 Storage Site Planning Manual HP 3PAR StoreServ 7450 Storage Site Planning Manual HP 3PAR 10000 storage systems HP 3PAR StoreServ 10000 Storage Physical Planning Manual HP 3PAR StoreServ 10000 Storage Third-Party Rack Physic
Typographic conventions Table 36 Document conventions Convention Element Bold text • Keys that you press • Text you typed into a GUI element, such as a text box • GUI elements that you click or select, such as menu items, buttons, and so on Monospace text • File and directory names • System output • Code • Commands, their arguments, and argument values • Code variables • Command variables Bold monospace text • Commands you enter into a command line interface • Syste
7 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
A Enabling JavaScript on Web Client The Web Client requires enabling JavaScript. If the page does not properly display, adjust the browser settings for Internet Explorer: 1. Click Start→Control Panel→Network and Internet→Internet Options. 2. Click the Security tab, and click Custom Level. Figure 64 Internet Options 3. Scroll to the Scripting section of the list. Select Prompt or Enable.
B HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands This section provides additional information about custom Powershell Commandlets for users performing administrative tasks. Add-HyperV Add-HyperV adds Hyper-V credentials for users. The command is used with each Microsoft Hyper-V (cluster or standalone host) credentials and managed by the application. Preconditions • User must first log on with Login-Rmh. • Hyper-V name (or synonym) does not already exist.
• Scenario 3: Login failure on Hyper-V host. RMH Server cannot authenticate with specified Hyper-V host. • Scenario 4: Storage System session credentials are invalid. Storage System session credentials provided are invalid. • Scenario 5: Storage System credentials is already specified. User is already logged in with specified Storage System. • Scenario 6: Cannot start RMH session. Failure occurred to start session. Reason displayed.
Table 38 Add-RemoteStoreServ parameters (continued) Parameter Optional/Required Description -RemoteRmhServerUsername Optional The user name of the Remote RMH Server. -RemoteRmhServerPassword Optional The password of the Remote RMH Server. CommonParameters Optional All the common parameters across the commands. Add-StoreServ Add-StoreServ is used for each HP 3PAR StoreServ credentials.
Success Paths • Scenario 1: Add Storage System is successful. Add Storage System is successful. Failure Paths • Scenario 1: Session owner is invalid. Every session command received on RMH Server is validated to originate from the same IP address that initiated the session. If IP does not match, the command fails. • Scenario 2: Storage System session credentials are invalid. Storage System session credentials provided are invalid.
Table 40 Analyze-vCopy parameters (continued) Parameter Optional/Required Description removed. Without this option, the same work is performed except no action is taken to remove the VC. Instead, the user will be given an error report. -Verbose Optional Displays progress messages. Success Paths • Scenario 1: No errors are found in database. The database repository is validated against Storage System and all Virtual Volumes are available. Failure Paths • Scenario 1: Session owner is invalid.
Table 41 Create-vCopy parameters (continued) Parameter Optional/Required Description -VcNamePrefix Optional The Virtual Copy name prefix. A unique timestamp will be generated for this new Virtual Copy and appended to this prefix. If not specified, the VC name will be vc-timestamp where timestamp is generated for this new Virtual Copy. -Expiry Optional Integer value followed by letter h or d for Hours and Days respectively Default: use the RMH Policy.
• Scenario 7: VM(s) are not running. VM(s) that are to be backed up must be running. • Scenario 8: License is missing for RMH. License is missing for RMH. • Scenario 9: License is missing for Storage System Virtual Copy. License is missing for Storage System Virtual Copy. • Scenario 10: VHD(s) are not on NTFS volumes. VHDs need to reside on NTFS volumes. • Scenario 11: VSS is not operational. VSS is not operational or not installed. • Scenario 12: VSS requestor fails.
Failure Paths • Scenario 1: Session owner is invalid. Every session command received on RMH Server is validated to originate from the same IP address that initiated the session. If IP does not match, the command fails. • Scenario 2: Unable to fetch Hyper-V. A Hyper-V is required to fetch cluster node names. Get-EncryptedLoginPassword Get-EncryptedLoginPassword retrieves a login password that may be use scripting. Preconditions The user must first login with Login-Rmh.
Table 44 Get-RmhPolicy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Select Hyper-V host/cluster to use. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported. -VmNameUuid Required Name/unique id of VM to set policy for Virtual Machine. -Verbose Optional Displays progress messages.
Syntax Any optional parameters require square brackets [ ] around them. Get-vCopy -RmhServerName -HypervName [-VcNamesUuids] [-VmNamesUuids] [-Timestamp] [-Verbose] Table 45 Get-vCopy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Select Hyper-V host/cluster to use. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported.
Syntax Any optional parameters require square brackets [ ] around them. Get-VirtualMachine -RmhServerName -HypervName [-Verbose] Table 46 Get-VirtualMachine parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Select Hyper-V host/cluster to use. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported.
Table 47 Import-Repository parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address -FromPath Required The path of the destination computer from where repository files need to be copied. -FromMachine Optional The name of the destination computer from where repository files need to be copied. -MachineUsername Optional The login user name of the computer. -MachinePassword Optional The login password of the computer.
Success Paths • Scenario 1: Login is successful. Login to a specified Hyper-V host is successful. Failure Paths • Scenario 1: Session owner is invalid. Every session command received on RMH Server is validated to originate from the same IP address that initiated the session. If IP does not match, the command fails. • Scenario 2: Cannot communicate with host. RMH Server cannot communicate with a specified Hyper-V host. • Scenario 3: Login failure on Hyper-V host.
Success Paths • Scenario 1: Logout is successful. Logout is successful. Failure Paths • Scenario 1: Session owner is invalid. Every session command received on RMH Server is validated to originate from the same IP address that initiated the session. If IP does not match, the command fails. • Scenario 2: Session is unavailable. Session specified is unavailable for logout. This means the session is previously closed by logout or timeout from RMH Server.
Table 50 Mount-vCopy parameters (continued) Parameter Optional/Required Description NOTE: If not specified, VVs will be exported to host by Storage System, but no mount points will be used. You will need to access VVs using their volume guid path (example: \\?\Volume(wwn)\). -Select Optional Specifies the virtual hard disk name, virtual volume name, or virtual volume WWN in a comma-separated list. For virtual hard disk name, this is the full filename with path, or just a partial name.
• Scenario 6: Storage System fails to export Virtual Volume. Storage System fails to export Virtual Volume on requested host. Reason is displayed. • Scenario 7: Assign mount points on Hyper-V host fails. An attempt to assign mount points for Virtual Volumes fails on host. • Scenario 8: Only one Virtual Copy may be mounted at a time Filtering of Virtual Copies using –VcNameUuid/-VmNameUuid does not result in only one Virtual Copy to mount.
Preconditions The user must first login with Login-Rmh. Syntax Any optional parameters require square brackets [ ] around them. Remove-RmhPolicy -RmhServerName [-HypervName] -VmNameUuid [-Verbose] Table 52 Remove-RmhPolicy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Optional Optionally select Hyper-V host/cluster to use. This is FQDN or IP address.
Table 53 Remove-StoreServ parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported. -StoreServName Required Synonyms for HP 3PAR StoreServ are supported. -Verbose Optional Displays progress messages. Success Paths • Scenario 1: Remove Storage System is successful. Remove operation is successful.
Table 54 Remove-vCopy parameters (continued) Parameter Optional/Required Description -VmNameUuid Required Select name/uuid to filter VC selection by VM. -Timestamp Optional Specify timestamp of VC to locate in the format mmddyyhhmmss. -Force Optional Bypass confirmation prompt. -Verbose Optional Displays progress messages. Success Paths • Scenario 1: Specified Virtual Copy is removed. Specified Virtual Copy is removed. Failure Paths • Scenario 1: Session owner is invalid.
Preconditions • User must first login using Login-Rmh. • Specified Microsoft Hyper-V credentials must already exist. Post Conditions HP 3PAR StoreServ credentials for this user are removed from the database. Syntax Any optional parameters require square brackets [ ] around them.
Table 56 Restore-vCopyVM parameters (continued) Parameter Optional/Required Description -Force Optional Bypass confirmation prompt. -RestartVm Optional If specified, VM will be restarted. -Verbose Optional Displays progress messages. Result with Description This command returns the location of restored Virtual Machine and host name. Success Paths • Scenario 1: VM(s) successfully restores. Specified VM(s) are successfully restored. Failure Paths • Scenario 1: Session owner is invalid.
Table 57 Set-RmhPolicy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address -HypervName Required Select Hyper-V host/cluster to use. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported. -VmNameUuid Required Name/unique id of VM used to set policy. -Expiry Optional Integer value followed by letter h or d for Hours and Days respectively. Use 0 to reset.
Syntax Any optional parameters require square brackets [ ] around them. Show-Connection -RmhServerName [-HypervName] [-ShowMissingStorageSystems] [-Verbose] Table 58 Show-Connection parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address -HypervName Optional If specified, the resulting connections shown will be for this Hyper-V. Synonyms for Hyper-V are supported. The localhost is not supported.
Table 59 Unmount-vCopy parameters (continued) Parameter Optional/Required Description -VcNameUuid Required Select VC by name/uuid. -VmNameUuid Required Select name/uuid to filter VC selection by Virtual Machine. -Timestamp Optional Specify timestamp of VC to locate in the format mmddyyhhmmss. -Select Optional Specifies the virtual hard disk name, virtual volume name, or virtual volume WWN in a comma-separated list.
• Scenario 6: Storage System fails to unexport Virtual Volume. Storage System fails to unexport Virtual Volume on requested host. Reason is displayed. • Scenario 7: Only one Virtual Copy can be unmounted at a time. Filtering of Virtual Copies using –VcNameUuid/-VmNameUuid does not result in only one Virtual Copy to be unmounted. Update-HyperV Update-HyperV updates Microsoft Hyper-V credentials already present in RMH database for user. Preconditions • User must first login using Login-Rmh.
Success Paths • Scenario 1: Update Hyper-V is successful Update Microsoft Hyper-V is successful. Failure Paths • Scenario 1: Session owner is invalid. Every session command received on RMH Server is validated to originate from the same IP address initiating the session. If IP does not match, the command fails. • Scenario 2: Microsoft Hyper-V session credentials are invalid. Microsoft Hyper-V session credentials provided are invalid. • Scenario 3: Microsoft Hyper-V credentials are already specified.
Success Paths • Scenario 1: Update HP 3PAR StoreServ is successful. Update HP 3PAR StoreServ is successful. Failure Paths • Scenario 1: Session owner is invalid. Every session command received on RMH Server is validated to originate from the same IP address that initiated the session. If IP does not match, the command fails. • Scenario 2: HP 3PAR StoreServ session credentials are invalid. HP 3PAR StoreServ session credentials provided are invalid.
Table 62 Update-StoreServ parameters (continued) Parameter Optional/Required Description -RemoteRmhServerPassword Optional The password of the Remote RMH Server. CommonParameters Optional All the common parameters across the commands. Save-Repository The following parameters explain how to save to a repository. Preconditions The user must first login with Login-Rmh. Syntax Any optional parameters require square brackets [ ] around them.
C Remote Copy for Recovery Manager for Hyper-V HP 3PAR Remote Copy Software helps you to safeguard against disasters that can occur at one location, by allowing you to keep copies of data on a separate server which can be placed at a remote location. For example, if there were a fire or earthquake at one location, all of the data stored there could be lost unless a backup copy can be recovered from a separate location not affected by the disaster.
Figure 65 Remote Copy Setup Figure 66 Remote Copy Setup with CLX Server Description Recovery Manager Server The RM server can be a standalone or clustered. After synchronization is complete, Recovery Manager creates a virtual copy (snapshot) on the remote system. Hyper-V Server (Agent) Operates on every Hyper-V host. Recovery Manager Remote Server The remote management server for RMH. Connectivity Both the Hyper-V Server and Remote RMH Server must be connected to Remote StoreServ.
Synchronous Long Distance The following table explains the feature of SLD (Synchronous Long Distance): Synchronous Long Distance Recovery Manager leverages the VSS framework to freeze the I/O at the application level and to take point in time snapshots. For SLD remote copy groups, the RVC (Remote Virtual Copy) creation and VC timestamp retention in local and remote RMH servers, depends upon target storeserv selected during RVC creation.
D Troubleshooting for HP 3PAR Recovery Manager for Microsoft Hyper-V About installing McAfee Antivirus Description Installing McAfee antivirus blocks all ports. Workaround/Action Use control panel to update firewalls settings. Port conflict on user site for port 5555 Description There is a port conflict on user site for 5555. Workaround/Action Make sure the same port is set for RMHyprt-V components, that are RMH servers, RMH clients and all Hyper-V servers (RMH agents).
Index A J About HP 3PAR Recovery Manager Software for Microsoft Hyper-V features, 8 Accessing the web client, 34 analyzing Virtual Copies, 40 JavaScript, 72 C M Command Line Interface, 55 Components of HP 3PAR Recovery Manager for Microsoft Hyper-V RMH Agent, 13 RMH Client, 13 RMH Server, 13 configuration for Hyper-V Virtual Machine, 15 connecting to Hyper-V server, 35 Recovery Manager server, 34 conventions text symbols, 70 managing Virtual Copies, 37 Microsoft Hyper-V servers disconnecting, 37 moun
about, 33 scheduling Virtual Copy creation tasks, 44 setting policy, 39 software prequisites required licenses, 15 StoreServ credentials adding, 37 updating, 37 Summary tab about, 29 supported platforms and environments, 15 operating systems, 14 software prerequisites, 14 supported system configurations standalone host, 15 supported web browsers, 24 symbols in text, 70 T text symbols, 70 Troubleshooting, 104 types of interfaces about, 24 Types of User Interface command line interface, 9 GUI, 9 U uninstall