HP 3PAR Recovery Manager 1.1.0 Software for Microsoft Hyper-V User Guide Abstract This document provides information about using HP 3PAR Recovery Manager Microsoft Hyper-V for experienced Microsoft™ Windows™ System Administrators managing databases.
© Copyright 2013 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 1 Introducing HP 3PAR Recovery Manager Software for Microsoft Hyper-V............6 About HP 3PAR Recovery Manager Software for Microsoft Hyper-V.................................................6 Features of Recovery Manager Software for Microsoft Hyper-V........................................................7 Types of User Interface..............................................................................................................7 Web Browser Graphical User Interface....................
5 Using PowerShell Snap-in Command Line Interface.......................................44 Connecting to RMH Server......................................................................................................44 Login-Rmh.........................................................................................................................44 Logout-Rmh.......................................................................................................................44 Configuring RMH Server.....
C Troubleshooting for HP 3PAR Recovery Manager for Microsoft Hyper-V...........89 About installing McAfee Antivirus ............................................................................................89 Port conflict on user site for port 5555.......................................................................................89 Index.........................................................................................................
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 3PAR Virtual Copy and Microsoft Hyper-V Virtual Machine environment.
Features of 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.
Web Browser Graphical User Interface The web client is accessible from any host and provides administrative tools to perform tasks such as searching, viewing, managing, and scheduling tasks for Hyper-V servers, agents, Virtual Machines, and HP 3PAR Virtual Volumes. For more details about using the web client interface to perform administrative tasks, see “Using the Web Client Interface” (page 20).
Table 2 RMH PowerShell Snap-in Cmdlets (continued) Command Description Remove-StoreServ Removes HP 3PAR StoreServ credentials associated with a RMH user Remove-vCopy Removes a Virtual Copy Restore-vCopyVm Initiates a full restore or recovery of virtual machines Show-Connection Shows connection information for current login RMH user name Unmount-vCopy Unmounts currently mounted Virtual Copy volume(s) for the specified Virtual Copy and virtual machine name Update-HyperV Updates Microsoft Hyper-V
In Recovery Manager for Microsoft Hyper-V, the Virtual Copy policy contains the following attributes: • Enable expirable Virtual Copies allows you to specify that created Virtual Copies are removed according to a specified schedule and are not affected by the maximum count. • Retain Virtual Copy Set supports the number of hours and days of a Virtual Copy set being retained. NOTE: The Retain Virtual Copy Set option requires a HP 3PAR Virtual Lock™ license.
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.
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: Recovery Manager for Microsoft Hyper-V supports the following configurations for Hyper-V Virtual Machine and host: 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 (x64) (Full and Cor
• VHDs and VM metadata on a HP 3PAR volume (full restore only) • Application consistent backups through child VM Snapshot method must use Microsoft Windows OS with NTFS file system Hyper-V Stand-Alone Host Configuration • Windows 2008 R2 , 2012 and Hyper-V R2 • Full installation and Server core installation • Standalone Hyper-V Host • Hyper-V Clusters with Cluster Shared Volumes (CSV) • All Hyper-V hosts/clusters under SCVMM management are individually supported NOTE: An SCVMM configuration i
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.
Figure 4 License Agreement dialog 5. Enter the following information and click Next. • User Name • Organization Figure 5 License Registration dialog 6. 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. 16 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 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 RMH InstallShield Wizard When using the RMH InstallShield Wizard, you have the option to customize and remove specific component features for RMH. 1. Launch the RMH InstallShield Wizard and click Next. Figure 10 RMH InstallShield Wizard dialog 2. Choose Remove and click Next.
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.
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 14 Hyper-V Server Summary Tab • The Virtual Machines tab lists all the Virtual Machines associated with a Hyper-V server. For quick access, the tab provides Create Virtual Copy and Virtual Copy Policy tools to create Virtual Copies and modify Virtual Copy policies of selected Virtual Machines.
• The Virtual Volumes tab provides a comprehensive summary of all Virtual Volumes associated with a Hyper-V server. Figure 16 Hyper-V Server Virtual Volumes Tab 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.
Column Displays Base Volume Name of base volume Base ID Base ID Virtual Copy Volume Name of Virtual Copy volume Virtual Copy ID Virtual Copy ID Status Status Mounted Mounted or unmounted status Exported Host Name of the host receiving the exported Virtual Copy Expiry Date of expiration Retention Date of retention Table 10 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 I
Figure 18 Virtual Machine Summary Tab • The Virtual Hard Disks tab lists connecting hard disks associated with the Virtual Machine.
• The Virtual Volumes tab displays a comprehensive summary of all Virtual Volumes associated with the Virtual Machine.
Figure 21 Virtual Copies Tab Table 13 Virtual Machine Control Bar Option Action Create Creates a Virtual Copy for the Virtual Machine Policy Sets the policy for the Virtual Machine Table 14 Virtual Copy Pane Column Displays Name Name of Virtual Copy Created Date/Time Date and time of Virtual Copy Creation Table 15 Details of Virtual Copy Pane Column Displays Base Volume Name of base volume Base ID Base ID Virtual Copy Volume Name of Virtual Copy volume Virtual Copy ID Virtual Copy ID
Table 16 Details of Virtual Volumes Pane (continued) • Column Displays 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 The Scheduler tab enables you to create a schedule to create a Virtual Copy or analyze all Virtual Copes.
Figure 23 Last Run Output 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). Figure 24 Security Certificate of Website NOTE: The Web Client requires enabling JavaScript. If the page does not properly display on your web browser, adjust the internet settings of the browser.
Connecting to Recovery Manager Server When you establish a connection, a logon dialog box appears. 1. Type your user name and password. Figure 25 Connect to Recovery Manager Server Dialog Box 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.
1. From the menu bar, click Administrative Tools to open the drop-down menu. Figure 27 Installing Recovery Manager Agent Dialog Box 2. 3. Right-click content 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.
Figure 28 Uninstall Recovery Manager Agent Dialog Box 3. 4. 5. Right-click context menu of the Hyper-V Servers tree node. Select the Hyper-V server in tree view pane. Click the Uninstall Agent hyperlink. 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 StoreServ Credential hyperlink located on the control bar. 3. Enter the new user name and password. 4. Click Update.
1. 2. From the Tree pane view, select the Hyper-V server. Click Disconnect. Figure 30 Disconnecting a Microsoft Hyper-V Server Working with Virtual Copies Recovery Manager for Microsoft Hyper-V provides essential tools to create, browse, and manage VSS aware application consistent Virtual Copies of Microsoft Hyper-V and HP 3PAR StoreServ system environments. The Virtual Copies are policy-based and its retention and expiration values can be set at the time of creation.
Figure 31 Virtual Machines Tab 3. 4. Click Create Virtual Copy. If applicable, set the values for the following options: • Virtual Copy name prefix (optional) • Set Virtual Copy expiration • Set Virtual Copy retention • Enable saved state backup NOTE: Click the question mark for more details about the option. Figure 32 Create Virtual Copy 5. Click Create.
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 33 Virtual Machines Tab NOTE: When a single Virtual Machine is selected, RMH retrieves policy of the Virtual Machine from the repository and displays the information. If multiple Virtual Machines are selected, RMH only displays the default policy settings. 3. 4. Click Virtual Copy Policy.
5. Click Save. Analyzing Virtual Copies To analyze one or more Virtual Copies: 1. From the Tree view pane, select the Hyper-V server. 2. Click the Virtual Copy tab and select one or more Virtual Copies. 3. Click Analyze when a single Virtual Copy is selected or Analyze All Virtual Copies when multiple Virtual Copies are selected. The following output provides an analytical summary of all selected Virtual Copies.
Figure 36 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 Copy tab and select one or more Virtual Copies. Figure 37 Removing Virtual Copies 3. Click Remove. Mounting Virtual Copies When a Virtual Copy is created, you can mount the Virtual Copy to a node cluster or Microsoft Hyper-V server.
Figure 38 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 prefix (optional) NOTE: Click the question mark for more details about the option. Figure 39 Mounting a Virtual Copy 6. Click Mount. Unmounting Virtual Copies When a Virtual Copy is under a Mounted state, use the following steps to unmount a Virtual Copy. 1.
5. Select the values for the following options: • Unmount on cluster node • Unmount on another Hyper-V server NOTE: Click the question mark for more details about the option. Figure 41 Unmounting a Virtual Copy 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 Schedule Virtual Copy Task Wizard 6. Set the values for the following applicable options and click Next: • Task name • Create Virtual Copy Virtual Copy name prefix (optional) ◦ Set Virtual Copy expiration ◦ Set Virtual Copy retention ◦ Enable saved state backup Figure 44 Schedule Virtual Copy Task Details 7. 40 Set the values for the Schedule, Date, and Time and click Next.
Figure 45 Schedule Virtual Copy Task Date and Time 8. Review the summary of task and click Save. Figure 46 Schedule Virtual 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.
Figure 47 Schedule Virtual Copy Analysis Task Wizard 6. Set the values for the following applicable options: • Task name • Analyze and clean up all Virtual Copies Figure 48 Schedule Virtual Copy Analysis Task Details 7. Set the values for the Schedule, Date, and Time and click Next. Figure 49 Schedule Virtual Copy Analysis Task Date and Time 8. 42 Review the summary of task and click Save.
Figure 50 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. Logging Off From Session To log off from the Recovery Manager Server: 1. From the menu bar, click Logon\Administrator. 2. Click Logout.
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. Connecting to RMH Server Use the following command lines to establish a session with the Microsoft Hyper-V server. Login-Rmh Log on to RMH Server using Windows RMH account. The optional login-Rmh enables the user to log on to Recovery Manager for Hyper-V.
Table 19 Logout-Rmh parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -Remove Optional If specified, RMH user along with Hyper-V host/cluster and Storage System credentials will be removed from RMH credentials repository. 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.
Add-StoreServ Add-StoreServ is used for each HP 3PAR StoreServ credentials. • HP 3PAR StoreServ credentials are associated to a specific Microsoft Hyper-V • This command is only required to initially set up credentials. The command is persisted by RMH Server until the user removes it. • The user can Add/Remove/Update HP 3PAR StoreServ credentials at any time during the session Preconditions • The user must first login with Login-Rmh.
Table 22 Set-RmhPolicy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Optionally select Hyper-V host/cluster to use. If not specified, Hyper-V host/cluster must be selected using Select-Hyperv. 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.
Preconditions The user must first login with Login-Rmh. Syntax Any optional parameters require square brackets [ ] around them. Get-EncryptedLoginCredentials -RmhServerName [-Verbose] Table 24 Get-EncryptedLoginCredentials 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-VirtualMachine -RmhServerName -HypervName [-Verbose] Table 26 Get-VirtualMachine parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Optionally select Hyper-V host/cluster to use. If not specified, Hyper-V host/cluster must be selected using Select-Hyperv. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported.
Create-vCopy The create-vCopy Cmdlet creates a new Virtual Copy of a VM and includes the following supported parameters. The first five parameters are for user authentication and is optional if a successful Login-Rmh and/or login-InServ Cmdlets are executed previously. Preconditions The user must first login with Login-Rmh. Syntax Any optional parameters require square brackets [ ] around them.
• Detailed error message(s) when operation fails • An instance of an object of type RMHirtualcopySet describing created Virtual Copy set. (create a link for the following: See Get-vCopySet Cmdlet for details of this object) Get-vCopy Get-vCopy is used to retrieve existing Virtual Copies details of a Virtual Machine from the Recovery Manager Hyper-V Repository of a specified Hyper-V server. This command has many filters to reduce the number of Virtual Copies during retrieving process.
Syntax Any optional parameters require square brackets [ ] around them. Mount-vCopy -RmhServerName -HypervName -VcNameUuid -VmNameUuid [-Timestamp] [-MountPointPrefix] [-Select] [-HypervHostName] [-HypervUsername] [-HypervPassword] [-Verbose] Table 30 Mount-vCopy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address.
Table 30 Mount-vCopy parameters (continued) Parameter Optional/Required Description -HypervPassword Optional Hyper-V user name. If not specified, HypervUsername is used from Login-Rmh. -Verbose Optional Displays progress messages.
Analyze-vCopy The Analyze-vCopy analyzes Virtual Copies for errors. When any Virtual Copy records contain a volume missing on storage system, the Virtual Copy with an error is flagged. The user can use the option to analyze and repair inconsistent Virtual Copies. Preconditions The user must first login with Login-Rmh. Syntax Any optional parameters require square brackets [ ] around them.
Syntax Any optional parameters require square brackets [ ] around them. Unmount-vCopy -RmhServerName -HypervName -VcNameUuid -VmNameUuid [-Timestamp] [-Select] [-HypervHostName] [-HypervUsername] [-HypervPassword] [-Verbose] Table 33 Unmount-vCopy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address. -HypervName Required Optionally select Hyper-V host/cluster to use.
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 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 components
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 34 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. 1. Click Start→Control Panel→Network and Internet→Internet Options. 2. Click the Security tab, and click Custom Level. Figure 51 Internet Options 3. Scroll to the Scripting section of the list. Select Prompt or Enable. NOTE: When selecting the Prompt option in the security settings, the user may see a warning message when launching the Web Client.
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.
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 37 Analyze-vCopy parameters (continued) Parameter Optional/Required Description 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. -Verbose Optional Displays progress messages. Success Paths • Scenario 1: No errors are found in database.
Table 38 Create-vCopy parameters (continued) Parameter Optional/Required Description supported. The localhost is not supported. -VmNamesUuids Required Comma separated VM names (or UUIDs) . For best practice, if more than one VM name specified, ensure all VMs use the same Storage System volume. -VcNamePrefix Optional The Virtual Copy name prefix. A unique timestamp will be generated for this new Virtual Copy and appended to this prefix.
• Scenario 4: Cannot communicate with the VMs. VM is specified, but RMH Server cannot communicate with specified VMs. • Scenario 5: Expiry is invalid. Expiry specified is invalid. Valid: 1-43800h, 1-1825d. • Scenario 6: Retention is invalid. Retention specified is invalid. Valid: 1-336h, 1-14d. • 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.
Result with Description • List of node names. List of Hyper-V node names for cluster. Empty list if Hyper-V specified is not a cluster. Success Paths • Scenario 1: Hyper-V cluster node names are fetched. At least one Hyper-V cluster node name is returned. • Scenario 2: Hyper-V specified is not a cluster. Successful without Hyper-V cluster node names returned. Failure Paths • Scenario 1: Session owner is invalid.
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. Syntax Any optional parameters require square brackets [ ] around them.
• Scenario 3: VM name/uuid specified is invalid VM name or uuid must be valid to fetch RMH Policy. • Scenario 4: RMH Policy does not exist. RMH Policy does not exist for specified VM. Get-vCopy Get-vCopy is used to retrieve existing Virtual Copies details of a Virtual Machine from the Recovery Manager Hyper-V Repository of a specified Hyper-V server. This command has many filters to reduce the number of Virtual Copies during retrieving process. Preconditions The user must first login with Login-Rmh.
Result with Description • Multiple {RMHirtualCopySet} objects: Multiple RMHirtualCopySet objects (one per VM). Success Paths • Scenario 1: Virtual Copy is fetched. At least one Virtual Copy meeting the criteria is returned. • Scenario 2: Virtual Copy is not fetched. No Virtual Copies meeting the criteria are specified. Nothing is returned. Failure Paths • Scenario 1: Session owner is invalid.
Result with Description • Multiple {RMHirtualMachineInfo} objects: Multiple RMHirtualMachineInfo objects (one per VM). Success Paths • Scenario 1: Virtual Machine(s) is fetched. At least one Virtual Machine is returned. • Scenario 2: Virtual Machine(s) is not fetched. No Virtual Machines are available. Nothing is returned. 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.
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 46 Mount-vCopy parameters (continued) Parameter Optional/Required Description where wwn is WWN of VV mounted, partition is the partition number, and timestamp is in format mmddyyhhmmss. 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)\).
• Scenario 3: License is missing for RMH. License is missing for RMH. • Scenario 4: Storage System host is not available to mount Virtual Volume(s). A Storage System host must be available to mount Virtual Volume(s). • Scenario 5: One or more Virtual Volumes mount points already exist. Using specified mount point prefix and RMH format of RMH.vv-wwn, the mount point attempted is already in use. • Scenario 6: Storage System fails to export Virtual Volume.
Success Paths • Scenario 1: Remove is successful. Remove is successful. Failure Paths • Scenario 1: Session owner is invalid. 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 not available. Session specified is not available for logout. This means the session has been previously closed by logout or timeout from RMH Server. • Scenario 3: Not previously added.
Success Paths • Scenario 1: RMH Policy is removed. Specified RMH Policy is successfully removed. 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: VM name/uuid is not specified. VM name or uuid must be specified to fetch RMH Policy. • Scenario 3: VM name/uuid specified is invalid.
Success Paths • Scenario 1: Remove Storage System is successful. Remove operation 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: Not previously added. Storage System specified is not previously added. Remove-vCopy Remove-vCopy removes a Virtual Copy.
Success Paths • Scenario 1: Specified Virtual Copy is removed. Specified Virtual Copy is removed. 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 not provided. Storage System session credentials are not provided for this command. • Scenario 3: License is missing for RMH.
Table 51 Restore-vCopyVM 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. If not specified, Hyper-V host/cluster must be selected using Select-Hyperv. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported. -VcNameUuid Required Select VC by name/uuid.
Select-HyperV Select-HyperV selects a Hyper-V host/cluster previously added to a user profile. Preconditions • User must first login using Login-Rmh. • User must first Add-Hyperv used in Select-Hyperv. Syntax Any optional parameters require square brackets [ ] around them. Select-HyperV -RmhServerName -HypervName [-Verbose] Table 52 Select-HyperV parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server.
Syntax Any optional parameters require square brackets [ ] around them. Set-RmhPolicy -RmhServerName -HypervName -VmNameUuid [-Expiry] [-Retention] [-SavedStateBackups] [-Verbose] Table 53 Set-RmhPolicy parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address -HypervName Required Optionally select Hyper-V host/cluster to use.
Show-Connection Show-Connection shows connection information for current login RMH user name, all RMH Hyper-V hosts/clusters, and all Hyper-V Storage Systems associated with the RMH user. The actively selected Hyper-V will also be shown. Preconditions User must first login using Login-Rmh. Syntax Any optional parameters require square brackets [ ] around them.
Table 55 Unmount-vCopy 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. If not specified, Hyper-V host/cluster must be selected using Select-Hyperv. This is FQDN or IP address. Synonyms for Hyper-V are supported. the localhost is not supported. -VcNameUuid Required Select VC by name/uuid.
Result with Description • RmhMountVirtualCopySetResult The command returns RmhMountVirtualCopySetResult objects and contains: ◦ RMHirtualCopySet with current state updated. ◦ Information on name, WWN, partition, volume guid path, and mount point of each Virtual Volume mounted. Success Paths • Scenario 1: Unmount is unsuccessful. Requested unmounts of Virtual Volume(s) is successful. Failure Paths • Scenario 1: Session owner is invalid.
Table 56 Update-HyperV parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address -HypervName Required Microsoft Hyper-V host or cluster name. This is FQDN or IP address. Synonyms are supported. The localhost is not supported. -HypervUsername Required Microsoft Hyper-V user name. If cluster, ensure all controller nodes in the cluster have the same username.
Table 57 Update-StoreServ parameters Parameter Optional/Required Description -RmhServerName Required Host name of the RMH Server. This is FQDN or IP address -HypervName Required Microsoft Hyper-V host or cluster name. This is FQDN or IP address. Synonyms are supported. The localhost is not supported. -StoreServName Required This is FQDN or IP address, etc. Synonyms for HP 3PAR StoreServ are supported.
C 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 setting for all Hyper-V servers (RMH agents).
Index InstallShield Wizard, 14 A About HP 3PAR Recovery Manager Software for Microsoft Hyper-V features, 7 Accessing the web client, 29 analyzing Virtual Copies, 36 C Command Line Interface, 44 Components of HP 3PAR Recovery Manager for Microsoft Hyper-V RMH Agent, 11 RMH Client, 11 RMH Server, 11 configuration for Hyper-V Virtual Machine, 12 connecting to Hyper-V server, 30 Recovery Manager server, 30 conventions text symbols, 59 D data consistency, 9 documentation providing feedback on, 60 E ensuring
S scheduler tab about, 28 scheduling Virtual Copy creation tasks, 39 setting policy, 34 software prequisites required licenses, 12 StoreServ credentials adding, 32 updating, 32 Summary tab about, 24 supported platforms and environments, 13 operating systems, 12 software prerequisites, 12 supported system configurations standalone host, 12 supported web browsers, 20 symbols in text, 59 T text symbols, 59 Troubleshooting, 89 types of interfaces about, 20 Types of User Interface command line interface, 7, 8 G
