HP Recovery Manager Software User Manual

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.

HP Part Number: QL226-96343 Published: May 2013

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. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Acknowledgements

Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks or registered trademarks of Intel Corporation or its subsidiaries

in the United States and other countries.

Microsoft®, Windows®, Windows® XP, Windows NT®, and Hyper-V® are U.S. registered trademarks of Microsoft Corporation.

Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.

Java and Oracle are registered trademarks of Oracle and/or its affiliates.

UNIX® is a registered trademark of The Open Group.

Hyper-V is a trademark of Microsoft Corporation.

All other trademarks and registered trademarks are owned by their respective owners.

Documentation

For more information about this document, go to http://www.hp.com/go/3par/ and click Support for your product, and then click Manuals.

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...................................................................................8

PowerShell Cmdlet Graphical and Command Line Interface.......................................................8

About Virtual Copy Management...............................................................................................9

Virtual Copy Data Consistency..............................................................................................9

Virtual Copy Policy...............................................................................................................9

Graphical User Interface Scheduling Tool..............................................................................10

2 Getting Started........................................................................................11

About Components of HP 3PAR Recovery Manager for Microsoft Hyper-V......................................11

About Supported Operating Systems and Software Prerequisites...................................................12

Operating Systems.............................................................................................................12

Software Prerequisites.........................................................................................................12

About Supported System Configurations....................................................................................12

Hyper-V Virtual Machine Configuration.................................................................................12

Hyper-V Stand-Alone Host Configuration...............................................................................13

About Other Requirements.......................................................................................................13

About Supported Network Ports................................................................................................13

3 Installing HP 3PAR Recovery Manager for Microsoft Hyper-V..........................14

Installing the Software.............................................................................................................14

Uninstalling the Software.........................................................................................................17

4 Using the Web Client Interface...................................................................20

Using Online Help..................................................................................................................20

Understanding the Web Client Interface....................................................................................20

Hyper-V Server View..........................................................................................................20

Virtual Machine View.........................................................................................................24

Create Virtual Copy – Last Run Output.............................................................................28

Accessing the Web Client........................................................................................................29

Connecting to Recovery Manager Server...................................................................................30

Setting Up the Recovery Manager Web Client............................................................................30

Connecting to Hyper-V Server..............................................................................................30

Installing Recovery Manager Agent......................................................................................30

Uninstalling Recovery Manager Agent..................................................................................31

Updating StoreServ Credentials...........................................................................................32

Adding HP 3PAR StoreServ System Credentials......................................................................32

Disconnecting Microsoft Hyper-V Servers...............................................................................32

Working with Virtual Copies....................................................................................................33

Creating Virtual Copies......................................................................................................33

Setting Policy to Virtual Copies............................................................................................34

Analyzing Virtual Copies....................................................................................................36

Restoring Virtual Machines From Virtual Copies......................................................................36

Removing Virtual Copies.....................................................................................................37

Mounting Virtual Copies.....................................................................................................37

Unmounting Virtual Copies..................................................................................................38

Scheduling Virtual Copy Creation Tasks................................................................................39

Scheduling Virtual Copy Analysis Tasks................................................................................41

Logging Off From Session........................................................................................................43

Contents 3

5 Using PowerShell Snap-in Command Line Interface.......................................44

Connecting to RMH Server......................................................................................................44

Login-Rmh.........................................................................................................................44

Logout-Rmh.......................................................................................................................44

Configuring RMH Server..........................................................................................................45

Add-HyperV......................................................................................................................45

Add-StoreServ...................................................................................................................46

Set-RmhPolicy....................................................................................................................46

Get-ClusterNodeNames......................................................................................................47

Get-EncryptedLoginCredentials............................................................................................47

Get-RmhPolicy...................................................................................................................48

Get-VirtualMachine............................................................................................................48

Show-Connection...............................................................................................................49

Working with Virtual Copies....................................................................................................49

Create-vCopy....................................................................................................................50

Get-vCopy........................................................................................................................51

Mount-vCopy....................................................................................................................51

Restore-vCopyVm...............................................................................................................53

Analyze-vCopy..................................................................................................................54

Unmount-vCopy.................................................................................................................54

6 Support and Other Resources.....................................................................56

Contacting HP........................................................................................................................56

HP 3PAR documentation..........................................................................................................56

Typographic conventions.........................................................................................................59

HP 3PAR branding information.................................................................................................59

7 Documentation feedback...........................................................................60

A Enabling JavaScript on Web Client.............................................................61

B HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands.......62

Add-HyperV...........................................................................................................................62

Add-StoreServ........................................................................................................................63

Analyze-vCopy.......................................................................................................................64

Create-vCopy.........................................................................................................................65

Get-ClusterNodeNames..........................................................................................................67

Get-EncryptedLoginPassword....................................................................................................68

Get-RmhPolicy........................................................................................................................69

Get-vCopy.............................................................................................................................70

Get-VirtualMachine.................................................................................................................71

Login-Rmh..............................................................................................................................72

Logout-Rmh............................................................................................................................73

Mount-vCopy.........................................................................................................................74

Remove-HyperV......................................................................................................................76

Remove-RmhPolicy..................................................................................................................77

Remove-StoreServ...................................................................................................................78

Remove-vCopy.......................................................................................................................79

Restore-vCopyVm....................................................................................................................80

Select-HyperV........................................................................................................................82

Set-RmhPolicy.........................................................................................................................82

Show-Connection....................................................................................................................84

Unmount-vCopy......................................................................................................................84

Update-HyperV......................................................................................................................86

Update-StoreServ....................................................................................................................87

4 Contents

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.........................................................................................................90

Contents 5

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.

About HP 3PAR Recovery Manager Software for Microsoft Hyper-V

HP 3PAR Recovery Manager for Microsoft Hyper-V is designed to work with Microsoft Hyper-V servers and provides system administrators with important tools to manage and backup critical Virtual Machines involving multiple virtualized machine environments. This application supplies essential GUI and command line-based tools to create, manage, browse, and restore application consistent 3PAR Virtual Copies of operating Hyper-V Virtual Machines to a point-in-time.

The following diagram displays a typical architecture and workflow involving HP 3PAR StoreServ Storage System and Microsoft Hyper-V server.

Figure 1 HP 3PAR Recovery Manager for Microsoft Hyper-V Architecture

6 Introducing HP 3PAR Recovery Manager Software for Microsoft Hyper-V

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. The software managing features include:

• Creating application consistent Virtual Copies of Microsoft Hyper-V environment

Access to PowerShell Commandlet (Cmdlet) and Web GUI◦

◦ Use of Hyper-V host as standalone host name or Hyper-V cluster name

◦ Set Virtual Copies with retention and expiry values at the time of creation

• Managing policy-base Virtual Copy lifecycle

• Accessing web graphical user interface (GUI)

Browse to get a list of Virtual Copies grouped by Virtual Machines and Hyper-V host◦

◦ Create new Virtual Copy of a Virtual Machine(s)

◦ Restore from a Virtual Copy; mount/unmount a Virtual Copy volume to any Hyper-V host

with installed agent.

◦ Administrative capabilities such as installing and monitoring RMH Agent

• 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

DescriptionFeature

Application Consistent Virtual Copy

Full VM Restore (VSS-Aware Restore)

RMH Browser Client

HP 3PAR StoreServ Credentials Management

Creates VSS aware application consistent backup of Virtual Machine (VM)

Supports VMs deployed on Cluster Shared VolumesHyper-V Clusters with Cluster Shared Volumes

Supports VMs deployed on standalone Hyper-V hostsHyper-V Standalone Hosts

Restores complete VM including its metadata and virtual hard disks from a VSS aware backup

Provides browser based GUI to display and manage mapping details of VCs, VMs, and VVs

Saves storage system (HP 3PAR StoreServ) credentials in centralized database and streamlines usability

Types of User Interface

Recovery Manager for Microsoft Hyper-V supports both GUI and command line application interfaces to manage Virtual Machines and data.

Offers tools to administrate RMH Server and agentsAdministrative Tool GUI

Provides ability to install RMH agent from remote locationRemote Agent Installation

Features of Recovery Manager Software for Microsoft Hyper-V 7

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).

NOTE: You must have an HP 3PAR Recovery Manager for Microsoft Hyper-V Software license

in order to use the Virtual Copy browser.

PowerShell Cmdlet Graphical and Command Line Interface

HP 3PAR Recovery Manager for Hyper-V includes a customized PowerShell Snap-in as the default client interface.

The default interface features command line interface (CLI) Cmdlets in RMH PowerShell Snap-in to simplify complex managing tasks of Virtual Copies involving HP 3PAR Storage Systems and Microsoft Hyper-V hosts:

Table 2 RMH PowerShell Snap-in Cmdlets

DescriptionCommand

Adds Hyper-V credentials for usersAdd-HyperV

Get-vCopy

Get-VirtualMachine

Mount-vCopy

Adding an additional HP 3PAR StoreServ credentialAdd-StoreServ

Analyzes Virtual Copies for errorsAnalyze-vCopy

Creates Virtual CopyCreate-vCopy

Creates Virtual Copy of a Virtual Machine (VM)Create-vCopy

Retrieves node names for the Hyper-V clusterGet-ClusterNodeNames

Retrieves a login password that may be using scriptingGet-EncryptedLoginPassword

Retrieves existing Virtual Copy details of a VM from an RMH Repository

Retrieves current Virtual Machines available on an active-session Hyper-V host/cluster

Initiates full restore of a VMRestore-vCopyVM

Deletes a Virtual Copy setRemove-vCopy

Mounts Virtual Copy volumes on to a Hyper-V host for manual restoration of virtual hard disks.

Unmounts mounted Virtual Copy volumesUnmount-vCopy

Retrieves RMH policy of a VMGet-RmhPolicy

Modifies RMH policy of a VMSet-RmhPolicy

Cmdlet for user authenticationLogin-Rmh

Logs off user from RMH and terminates the sessionLogout-Rmh

Cmdlet to log on to an HP 3PAR StoreServLogin-StoreServ

Cmdlet to log off from an HP 3PAR StoreServLogout-StoreServ

Remove-HyperV

8 Introducing HP 3PAR Recovery Manager Software for Microsoft Hyper-V

Removes Microsoft Hyper-V host/cluster credentials associated with a RMH user

Removes RMH policy of a virtual machineRemove-RmhPolicy

Table 2 RMH PowerShell Snap-in Cmdlets (continued)

DescriptionCommand

Remove-StoreServ

Show-Connection

Unmount-vCopy

Update-HyperV

Update-StoreServ

For more information about using RMH PowerShell Cmdlets, see “Using PowerShell Snap-in

Command Line Interface” (page 44).

About Virtual Copy Management

HP 3PAR Recovery Manager for Microsoft Hyper-V features an essential Virtual Copy management tool with enhanced recovery commands that allows 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. Recovery Manager for Microsoft Hyper-V manages the set of Virtual Copies as a single entity.

Removes HP 3PAR StoreServ credentials associated with a RMH user

Removes a Virtual CopyRemove-vCopy

Initiates a full restore or recovery of virtual machinesRestore-vCopyVm

Shows connection information for current login RMH user name

Unmounts currently mounted Virtual Copy volume(s) for the specified Virtual Copy and virtual machine name

Updates Microsoft Hyper-V credentials already present in RMH database for user

Updates HP 3PAR StoreServ credentials already present in RMH database for user

NOTE: HP 3PAR Recovery Manager for Microsoft Hyper-V requires a license. In addition, specific

licenses are required for HP 3PAR Virtual Copy and HP 3PAR Virtual Lock when performing Virtual Copy operations and setting volume retention policies.

Virtual Copy Data Consistency

You can create application consistent Virtual Copies of Hyper-V Virtual Machines with Microsoft VSS technology and HP 3PAR VSS Provider.

When a VSS aware VM Virtual Copy is created, the VM is put into a saved state during the Virtual Copy creation operation. Simultaneously, both VSS and HP 3PAR VSS Provider automatically creates HP 3PAR Virtual Copies of the underlying LUNs and the VM returns to the previous state during the operation. Recovery Manager for Microsoft Hyper-V then saves any details of the Virtual Copy, along with VSS backup document, for browsing and restoring purposes.

Application consistency is provided for HP 3PAR snapshots of Virtual Machines for data compatibility with supported applications. Recovery Manager for Microsoft Hyper-V supports VSS Child VM Snapshots and provides crash consistent backups through using saved state method.

NOTE: The current version of HP 3PAR Recovery Manager for Microsoft Hyper-V supports system

crash, VM and application consistent Virtual Copies. Application consistency is provided for HP 3PAR snapshots of Virtual Machines for data compatibility with supported applications. Recovery Manager for Microsoft Hyper-V supports only VSS Child VM Snapshots.

Virtual Copy Policy

Recovery Manager for Microsoft Hyper-V provides the ability to create Virtual Copy policies for VMs. Only a single policy is permitted for every Virtual Machine and the policies exist independently of the virtual disks the VM is using.

About Virtual Copy Management 9

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. For

more information about obtaining a license for HP 3PAR Virtual Lock™, contact your local service provider.

• Enable Saved State Backup -

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 20).

10 Introducing HP 3PAR Recovery Manager Software for Microsoft Hyper-V

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 Components of HP 3PAR Recovery Manager for Microsoft Hyper-V

HP 3PAR Recovery Manager Software for Microsoft Hyper-V includes the following deployable components:

DescriptionComponent

RMH Server

RMH Agent

RMH Client

• Installs on any operating Microsoft Windows server

• Access to a configuration database repository

• Repository management

• Serves as a web server for connecting clients

• Operates on every Hyper-V host

• Access to RMH VSS requestor and restore utilities

• Access to HP 3PAR VSS Provider

• Use of PowerShell Cmdlet to create Virtual Copies

Figure 2 Recovery Manager for Microsoft Hyper-V Configuration

About Components of HP 3PAR Recovery Manager for Microsoft Hyper-V 11

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 Core version)

HP 3PAR OS Software

• 3.1.1 MU1 or MU2

• 3.1.2

Software Prerequisites

HP 3PAR OS Licenses

• HP 3PAR Virtual Copy

• HP 3PAR Recovery Manager for Microsoft Hyper-V

• HP 3PAR Virtual Lock

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.)

• Visual C++ Redistributable for Visual Studio 2012

HP 3PAR Recovery Manager for Microsoft Hyper-V Agent

• MPIO

• Microsoft Hyper-V Server

• HP 3PAR VSS Provider (version 2.2.1.5 and above)

• HP 3PAR OS CLI (required by HP 3PAR VSS Provider)

HP 3PAR Recovery Manager for Microsoft Hyper-V Client

• Microsoft Windows with Powershell 2.0

About Supported System Configurations

Hyper-V Virtual Machine Configuration

• Single StoreServ per VM

• Multiple virtual hard disks per VM

• VHDs and Pass-through VVs

• All VHDs from HP 3PAR VVs

12 Getting Started

• 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 is not supported on a Hyper-V host.

For information about supported platforms, refer to the HP 3PAR OS Configuration Matrix. To obtain a copy of this documentation, go to http://www.hp.com/go/3par/, navigate to your product page, click Support for your product, and then click Manuals.

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.

• Microsoft.NET 4.5 Runtime is required or installation fails.

• The HP 3PAR Recovery Manager for Microsoft Hyper-V license and the HP 3PAR Virtual Copy

license is required for Virtual Copy operation.

• Integration services must be enabled.

• Virtual Machines must have Hyper-V integration services enabled in order to perform VC

operations with application consistency.

• HP 3PAR Recovery Manager Software for Microsoft Hyper-V currently only supports English

localization.

About Supported Network Ports

HP 3PAR Recovery Manager Software for Microsoft Hyper-V uses the following network ports:

• 5555 SSL for GUI and Powershell communications Client-to-Server and Server-to-Agent

• 5783 SSL port to HP 3PAR StoreServ

• Hyper-V Server HTTP port and Hyper-V Server HTTPS port for secure access (between the

Hyper-V Server, client, and HP 3PAR Recovery Manager for Microsoft Hyper-V

If firewalls settings are active, you must change the rules settings to allow traffic to these ports with the outbound connections for HP 3PAR Recovery Manager for Microsoft Hyper-V to work properly.

About Other Requirements 13

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.

CAUTION: Verify Microsoft Visual C++ 2012 Redistributable Package (x64) is already installed

before beginning the installation process. Any missing prerequisite packages may cause the installation to fail.

1. Insert the HP 3PAR Recovery Manager Software for Microsoft Hyper-V disc into your CD-ROM drive.

2. Double-click the applicable installation package to launch the InstallShield wizard.

3. Click Next and follow the InstallShield Wizard instructions. You can cancel at anytime during the installation. Click Cancel to end the installation process.

Figure 3 InstallShield Wizard dialog

4. Review the license agreement before accepting the terms and click Next.

14 Installing HP 3PAR Recovery Manager for Microsoft Hyper-V

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.

Installing the Software 15

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.

16 Installing HP 3PAR Recovery Manager for Microsoft Hyper-V

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 Microsoft Windows Control Panel

The following method completely removes all components of RMH.

1. Click Start→Control Panel→Programs→Programs and Features.

2. Select HP 3PAR Recovery Manager for Microsoft Hyper-V from the list of programs.

3. Click Uninstall.

NOTE: If the secure network port is used, you need to unbind the port.

For installations on Windows 2008 R2, run netsh http show sslcert to view port binding information.

Uninstalling the Software 17

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.

Figure 11 Program Maintenance Options

18 Installing HP 3PAR Recovery Manager for Microsoft Hyper-V

3. Review the message dialog. Click Remove.

Figure 12 Removing the Program dialog

Uninstalling the Software 19

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.

HP 3PAR Recovery Manager supports the following web browsers:

Table 3 Supported Web Browsers

Using Online Help

For additional help and information about HP 3PAR Recovery Manager, locate the menu bar and click Help.

Understanding the Web Client Interface

Recovery Manager for Microsoft Hyper-V provides a simplified web user interface with essential tools to manage and perform specific operations relating to the maintenance of existing Virtual Machines.

The following sections describe the views of default workspace for Hyper-V Server and Virtual Machines.

VersionWeb Browser

22 or newerGoogle Chrome

8 and 9Microsoft Internet Explorer

16 or newerMozilla Firefox

Hyper-V Server View

The default Hyper-V Server view displays:

• The Tree View tab lists all Hyper-V servers and associated Virtual Machines in the system.

• The Data View tab displays associated clusters and controller nodes details with specific

Hyper-V servers.

• The Task View tab provides status information about the status and results of user operations

such as creating a Virtual Copy.

Figure 13 Recovery Manager Hyper-V Home Workspace View

20 Using the Web Client Interface

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.

For more information about working with a Virtual Copy, see “Creating Virtual Copies”

(page 33) and “Setting Policy to Virtual Copies” (page 34).

Figure 15 Hyper-V Server Virtual Machines Tab

Table 4 Hyper-V Server Virtual Machines Tab

DisplaysColumn

Name of Virtual MachineName

Activity status of the Virtual MachineState

Current system condition of the Virtual MachineHealth

Associated clusters belonging to the serverClustered

Current condition of CSVUsing CSV

Full path of the system root pathSystem Root Path

Understanding the Web Client Interface 21

• 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.

Table 5 Hyper-V Server Virtual Volumes Tab

DisplaysColumn

Description of virtual volumeVirtual Volume

Description of World Wide Name of virtual volumeWorld Wide Name

System IDID

Current status of virtual volumeStatus

Name of HP 3PAR StoreServ associated with virtual volumeHP 3PAR StoreServ Name

Description of volume typeVolume Type

Type of provisioningProvision Type

Size of storage spaceRequested Size

Current storage space usageUsed

22 Using the Web Client Interface

• The Virtual Copies tab provides a list of all Virtual Copies created from Virtual Machines on

the Hyper-V server.

Figure 17 Hyper-V Server Virtual Copies Tab

Table 6 Hyper-V Server Virtual Copy Control Bar

Create

Policy

Table 7 Hyper-V Server Virtual Copy Control Bar

Table 8 Hyper-V Server Virtual Copy Tab

ActionOption

Creates a Virtual Copy for all the Virtual Machines on the Hyper-V Server

Sets the policy for all the Virtual Machines on the Hyper-V Server

ActionOption

Mounts a virtual copy on the Virtual MachineMount

Unmounts a virtual copy from the Virtual MachineUnmount

Analyzes the selected virtual copyAnalyze

Restores the selected virtual copyRestore

Removes the selected virtual copy from the listRemove

DisplaysColumn

Name of Virtual CopyName

Virtual Machine

Table 9 Details of Virtual Copy Pane

Date and time of Virtual Copy CreationCreated Date/Time

Name of the Virtual Machine the Virtual Copy was created for

Understanding the Web Client Interface 23

Table 10 Details of Virtual Volumes Pane

DisplaysColumn

Name of base volumeBase Volume

Base IDBase ID

Name of Virtual Copy volumeVirtual Copy Volume

Virtual Copy IDVirtual Copy ID

StatusStatus

Mounted or unmounted statusMounted

Name of the host receiving the exported Virtual CopyExported Host

Date of expirationExpiry

Date of retentionRetention

DisplaysColumn

Path of virtual volumePath

Location to mount Virtual CopyMount Point

Status of virtual volumeIn Saved State

Activity of virtual volumeIn Use

Virtual Machine View

Under the Tree View pane, a set of Virtual Machines are listed underneath a correlating Hyper-V server.

The default Virtual Machine view displays:

• The Summary tab provides a general system summary of the Virtual Machine.

Size of virtual volumeFile Size

Maximum size of hard diskMaximum Internal Size

24 Using the Web Client Interface

Figure 18 Virtual Machine Summary Tab

• The Virtual Hard Disks tab lists connecting hard disks associated with the Virtual Machine.

Figure 19 Virtual Hard Disks Tab

Table 11 Virtual Hard Disks Tab

DisplaysColumn

Full address path of virtual hard disksPath

Type of hard disks: Dynamic or staticType

Yes or No valuesIn Saved State

Virtual HD in use or notIn Use

Size of file(s)File Size

Maximum storage capacityMaximum Internal Size

Type of backup storageBackup Storage Type

Understanding the Web Client Interface 25

• The Virtual Volumes tab displays a comprehensive summary of all Virtual Volumes associated

with the Virtual Machine.

Figure 20 Virtual Volumes Tab

Table 12 Virtual Volumes Tab

DisplaysColumn

Description of virtual volumeVirtual Volume

Description of World Wide Name of virtual volumeWorld Wide Name

System IDID

Current status of virtual volumeStatus

HP 3PAR StoreServ Name

Name of HP 3PAR StoreServ associated with virtual volume

Type of volumeVolume Type

Type of provisioningProvision Type

Size of storage spaceRequested Size

Current storage space usageUsed

• The Virtual Copies tab provides a list of all Virtual Copies created from a Virtual Machine.

26 Using the Web Client Interface

Figure 21 Virtual Copies Tab

Table 13 Virtual Machine Control Bar

ActionOption

Creates a Virtual Copy for the Virtual MachineCreate

Table 14 Virtual Copy Pane

Table 15 Details of Virtual Copy Pane

Sets the policy for the Virtual MachinePolicy

DisplaysColumn

Name of Virtual CopyName

Date and time of Virtual Copy CreationCreated Date/Time

DisplaysColumn

Name of base volumeBase Volume

Base IDBase ID

Name of Virtual Copy volumeVirtual Copy Volume

Virtual Copy IDVirtual Copy ID

StatusStatus

Mounted or unmounted statusMounted

Name of the host receiving the exported Virtual CopyExported Host

Date of expirationExpiry

Table 16 Details of Virtual Volumes Pane

Date of retentionRetention

DisplaysColumn

Path of virtual volumePath

Location to mount Virtual CopyMount Point

Understanding the Web Client Interface 27

Table 16 Details of Virtual Volumes Pane (continued)

DisplaysColumn

Status of virtual volumeIn Saved State

Activity of virtual volumeIn Use

Size of virtual volumeFile Size

Maximum size of hard diskMaximum Internal Size

• The Scheduler tab enables you to create a schedule to create a Virtual Copy or analyze all

Virtual Copes.

Figure 22 Scheduler Tab

Table 17 Scheduler Tab

Create Virtual Copy – Last Run Output

This function is optional when a scheduled task is run successfully from the windows scheduler but may fail from the PowerShell. In this event you can click the Last Run Output button or right click a Create VC or Analyze All VC schedule and the last run output will appear with the status.

DisplaysColumn

Name of policy taskTask Name

Scheduled policy time periodSchedule on Server

Last scheduled policy run timeLast Run Time

Upcoming scheduled policy run timeNext Run Time

Expiration of scheduled policy run timeExpiry

Retention of policyRetention

Result status of last policy run timeLast Run Status

28 Using the Web Client Interface

Figure 23 Last Run Output

Accessing the Web Client

1. Launch a preferred web browser.

2. Type https://<RmhServer>:5555/Server/Html5 in the address bar.

3. 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. For more information about adjusting the internet settings, see “Enabling JavaScript on Web Client” (page 61).

Accessing the Web Client 29

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. Type the required credentials:

• Hyper-V server hostname or IP address

• User name

• Password

Figure 26 Connect to Hyper-V Server Dialog Box

3. Click Connect.

Installing Recovery Manager Agent

To install HP 3PAR Recovery Manager agent on a Hyper-V server:

30 Using the Web Client Interface

1. From the menu bar, click Administrative Tools to open the drop-down menu.

Figure 27 Installing Recovery Manager Agent Dialog Box

2. Right-click content menu of the Hyper-V Servers tree node.

3. 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. Enter the user credentials for the following:

• Hyper-V server host name or IP address

• User name

• Password

Setting Up the Recovery Manager Web Client 31

Figure 28 Uninstall Recovery Manager Agent Dialog Box

3. Right-click context menu of the Hyper-V Servers tree node.

4. Select the Hyper-V server in tree view pane.

5. 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.

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 StoreServ Credential hyperlink located on the control bar.

3. Enter the credentials for the following:

• 3PAR StoreServ Name

• User name

• Password

Figure 29 Add 3PAR StoreServ Dialog Box

4. Click Add.

Disconnecting Microsoft Hyper-V Servers

To disconnect a Microsoft Hyper-V server:

32 Using the Web Client Interface

1. From the Tree pane view, select the Hyper-V server.

2. 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.

The application also provides the capability to perform a full restoration of any Virtual Machines to its original or new location from a point-in-time Virtual Copy or VSS aware Snapshot. Any existing configuration files and virtual hard disks are overwritten if the Virtual Machine is restored to its original location.

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 Machine tab then select one or

more Virtual Machines and click Create VC.

• Select a Hyper-V Server from the tree and click the Virtual Copy tab then click Create.

• Select a Virtual Machine from the tree and click the Virtual Copy tab then click Create.

To create a Virtual Copy:

1. From the Tree view pane, select the Hyper-V server.

2. Click the Virtual Machines tab and select one or more Virtual Machines.

Working with Virtual Copies 33

Figure 31 Virtual Machines Tab

3. Click Create Virtual Copy.

4. 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.

NOTE: For more information about using the CLI feature to create a Virtual Copy, see

Setting Policy to Virtual Copies

You can set expiration and retention policies to any newly created Virtual Copies.

34 Using the Web Client Interface

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. Click Virtual Copy Policy.

4. Set the values for the following options:

• Set Virtual Copy expiration

• Set Virtual Copy retention

• Enable saved state backup

NOTE: Click the question mark for more details about the option.

Figure 34 Virtual Copy Policy Dialog Box

Working with Virtual Copies 35

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 35 Summary of Analyzed Virtual Copies

Restoring Virtual Machines From Virtual Copies

To restore a Virtual Machine from a Virtual Copy:

1. From the Tree view pane, select the Hyper-V server.

2. Click the Virtual Copy tab and select a Virtual Copy.

36 Using the Web Client Interface

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.

To mount a Virtual Copy to a node cluster or Microsoft Hyper-V server:

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.

Working with Virtual Copies 37

Figure 38 Selecting a Virtual Copy and Virtual Volume

4. Click Mount.

5. 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. 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 40 Selecting a Virtual Copy and Virtual Volume

4. Click Unmount.

38 Using the Web Client Interface

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 42 Scheduler Tab

3. Click the Create Virtual Copy tab.

4. Click Add.

5. Follow the wizard to complete the scheduling tasks and click Next.

Working with Virtual Copies 39

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. Set the values for the Schedule, Date, and Time and click Next.

40 Using the Web Client Interface

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. 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.

Working with Virtual Copies 41

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. Review the summary of task and click Save.

42 Using the Web Client Interface

Figure 50 Schedule Virtual Copy Analysis Task Summary

Logging Off From Session

To log off from the Recovery Manager Server:

1. From the menu bar, click Logon\Administrator.

2. Click Logout.

Logging Off From Session 43

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. After a

successful login is established, the user is not required to enter additional credentials for subsequent Cmdlets.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Table 18 Login-Rmh parameters

-RmhEncrytedPassword

Logout-Rmh

The optional logout-Rmh Cmdlet logs off the user from the application.

Preconditions

The user must first login with Login-Rmh.

Syntax

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-RmhUserName

Required-RmhPassword

Host name of the RMH Server. This is FQDN or IP address.

RMH user name. If not specified, a dialog box will be presented to enter credentials.

RMH user password. If not specified, a dialog box will be presented to enter credentials.

May be used instead of

-RmhPassword

Any optional parameters require square brackets [ ] around them.

Logout-Rmh -RmhServerName <RmhServerName> [-Remove]

44 Using PowerShell Snap-in Command Line Interface

Table 19 Logout-Rmh parameters

DescriptionOptional/RequiredParameter

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.

Preconditions

• User must first log on with Login-Rmh

• Hyper-V name (or synonym) just not already exist

Syntax

Any optional parameters require square brackets [ ] around them.

Add-HyperV -RmhServerName <RmhServerName> -HypervName <HypervName>

-HypervUsername <HypervUser> -HypervPassword <HypervPassword> [-Verbose]

Required-RmhServerName

Optional-Remove

Host name of the RMH Server. This is FQDN or IP address.

If specified, RMH user along with Hyper-V host/cluster and Storage System credentials will be removed from RMH credentials repository.

Table 20 Add-HyperV parameters

Required-RmhServerName

Required-HypervName

Required-HypervUsername

Required-HypervPassword

DescriptionOptional/RequiredParameter

Host name of the RMH Server. This is FQDN or IP address.

Hyper V host or cluster name. This is FQDN or IP address. Synonyms are checked. The localhost is not supported.

Hyper-V username. If cluster, ensure all controller nodes in the cluster have the same username. If not specified, a dialog box will be presented to enter credentials.

Hyper-V password. If cluster, ensure all controller nodes in the cluster have the same password. If not specified, a dialog box will be presented to enter credentials.

Displays progress messages.Optional-Verbose

Configuring RMH Server 45

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.

• HP 3PAR StoreServ name must not already exist for specified Microsoft Hyper-V

Syntax

Any optional parameters require square brackets [ ] around them.

Add-StoreServ -RmhServerName <RmhServerName> -HypervName <HypervName>

-StoreServName <StoreServName> -StoreServUsername <StoreServUsername>

-StoreServPassword <StoreServPassword> [-Verbose]

Table 21 Add-StoreServ parameters

DescriptionOptional/RequiredParameter

Set-RmhPolicy

The set-RmhPolicy Cmdlet provides the ability to edit the default RMH Policy settings of a Virtual Machine.

Preconditions

The user must first login with Login-Rmh.

Required-RmhServerName

Required-HypervName

Required-StoreServName

Required-StoreServUsername

Required-StoreServPassword

Host name of the RMH Server. This is FQDN or IP address.

This is FQDN or IP address. Synonyms are supported. The localhost is not supported.

This is FQDN or IP address, etc. Synonyms for HP 3PAR StoreServ are supported.

Note, if not provided, a dialog box will pop up asking for credentials.

Displays progress messagesOptional-Verbose

Syntax

Any optional parameters require square brackets [ ] around them.

Set-RmhPolicy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VmNameUuid <VmNameUuid> [-Expiry] [-Retention] [-SavedStateBackups] [-Verbose]

46 Using PowerShell Snap-in Command Line Interface

Table 22 Set-RmhPolicy parameters

DescriptionOptional/RequiredParameter

Get-ClusterNodeNames

Required-RmhServerName

Required-HypervName

Required-VmNameUuid

Optional-Expiry

Optional-Retention

Optional-SavedStateBackups

Host name of the RMH Server. This is FQDN or IP address.

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.

Name/unique id of VM to set policy for Virtual Machine.

Integer value followed by letter h or d for Hours and Days respectively. Use 0 to reset.

Integer value followed by letter h or d for Hours and Days respectively. Use 0 to reset

Disabled or enabled. Use reset to reset.

Displays progress messagesOptional-Verbose

The Get-ClusterNodeNames command retrieves cluster node names for the Hyper-V cluster.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Get-ClusterNodeNames -RmhServerName <RmhServerName> -HypervName <HypervName> [-Verbose]

Table 23 Get-ClusterNodeNames parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Host name of the RMH Server. This is FQDN or IP address.

Displays progress messages.Optional-Verbose

Get-EncryptedLoginCredentials

Get-EncryptedLoginCredentials is used for scripting to return an encrypted password for the currently logged-in RMH user.

Configuring RMH Server 47

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Get-EncryptedLoginCredentials -RmhServerName <RmhServerName> [-Verbose]

Table 24 Get-EncryptedLoginCredentials parameters

DescriptionOptional/RequiredParameter

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.

Get-RmhPolicy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VmNameUuid <VmNameUuid> [-Verbose]

Table 25 Get-RmhPolicy parameters

Required-RmhServerName

Host name of the RMH Server. This is FQDN or IP address.

Displays progress messages.Optional-Verbose

DescriptionOptional/RequiredParameter

Host name of the RMH Server. This is FQDN or IP address.

Required-HypervName

Required-VmNameUuid

Get-VirtualMachine

Get-VirtualMachine retrieves current Virtual Machines available on an active-session Hyper-V host/cluster.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

48 Using PowerShell Snap-in Command Line Interface

Name/unique id of VM to set policy for Virtual Machine.

Displays progress messagesOptional-Verbose

Get-VirtualMachine -RmhServerName <RmhServerName> -HypervName <HypervName> [-Verbose]

Table 26 Get-VirtualMachine parameters

DescriptionOptional/RequiredParameter

The command returns multiple RMHirtualMachineInfo objects.

Show-Connection

Show-Connection displays connection information for current login RMH user name, all RMH Hyper-V hosts/clusters, and all Hyper-V Storage Systems associated with the user. The actively selected Hyper-V will also be shown.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Show-Connection -RmhServerName <RmhServerName> [-HypervName] [-ShowMissingStorageSystems] [-Verbose]

Required-RmhServerName

Required-HypervName

Host name of the RMH Server. This is FQDN or IP address.

Displays progress messages.Optional-Verbose

Table 27 Show-Connection parameters

Working with Virtual Copies

This section describes the command usage and parameters for working with Virtual Copies.

DescriptionOptional/RequiredParameter

Required-RmhServerName

Optional-HypervName

Optional-ShowMissingStorageSystems

Host name of the RMH Server. This is FQDN or IP address.

If specified, Storage Systems used by Hyper-V(s), but missing credentials, are shown.

Displays progress messages.Optional-Verbose

Working with Virtual Copies 49

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.

Create-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VmNamesUuids <VmNamesUuids> [-VcNamePrefix] [-Expiry] [-Retention] [-SavedStateBackups] [-Verbose]

Table 28 Create-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-VmNamesUuids

Optional-VcNamePrefix

Optional-Expiry

Host name of the RMH Server. This is FQDN or IP address.

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.

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.

Integer value followed by letter h or d for Hours and Days respectively Default: use the RMH Policy.

Optional-Retention

This Cmdlet returns a list of custom objects of type RmhCreateVirtualcopyResult, each for every VM being used and includes following properties:

• VM Name or UUID

• Success/Failure status of the create-vCopy operation for the VM

50 Using PowerShell Snap-in Command Line Interface

Integer value followed by letter h or d for Hours and Days respectively Default: use the RMH Policy.

Disabled or enabled.Optional-SavedStateBackups Default: use the RMH policy.

Displays progress messagesOptional-Verbose

• Detailed error message(s) when operation fails

• An instance of an object of type RMHirtualcopySet describing created Virtual Copy set.

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.

Syntax

Any optional parameters require square brackets [ ] around them.

Get-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName> [-VcNamesUuids] [-VmNamesUuids] [-Timestamp] [-Verbose]

Table 29 Get-vCopy parameters

(create a link for the following: See Get-vCopySet Cmdlet for details of this object)

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Optional-VcNamesUuids

Optional-VmNamesUuids

Optional-Timestamp

The command returns multiple RMHirtualSet objects.

Host name of the RMH Server. This is FQDN or IP address.

Select VCs by name/uuid using a comma-separated list. If not specified, VCs name/uuid is not used to filter selection.

Select names/uuids to filter VC selection by VM. If not specified, VM names/uuids is not used to filter selection.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

Displays progress messages.Optional-Verbose

Mount-vCopy

Mount-vCopy exports and mounts specified Virtual Copy virtual volumes to a Hyper-V host for manual restoration of virtual hard disks. This command can be repeated with unique mount point prefixes if necessary.

Mount point is not required. Volume Guid will only access virtual volume(s) if mount point prefixes are not specified.

Preconditions

The user must first login with Login-Rmh.

Working with Virtual Copies 51

Syntax

Any optional parameters require square brackets [ ] around them.

Mount-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VcNameUuid <VcNameUuid> -VmNameUuid <VmNameUuid> [-Timestamp] [-MountPointPrefix] [-Select] [-HypervHostName] [-HypervUsername] [-HypervPassword] [-Verbose]

Table 30 Mount-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-VmNameUuid

Optional-Timestamp

Optional-MountPointPrefix

Host name of the RMH Server. This is FQDN or IP address.

Select VC by name/uuid.Required-VcNameUuid

Select name/uuid to filter VC selection by Virtual Machine.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

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.timestamp

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)\).

Optional-Select

Optional-HypervHostName

Optional-HypervUsername

52 Using PowerShell Snap-in Command Line Interface

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. Wildcards are not allowed. By default, RMH will mount all Virtual Copy volumes in a VCS.

Hyper-V host name. Use this option to specify host node in cluster. You may also use this option in a non-cluster environment. If not specified,

HypervHostName is used from Login-Rmh.

Hyper-V user name. If not specified,

HypervUsername is used from Login-Rmh.

Table 30 Mount-vCopy parameters (continued)

DescriptionOptional/RequiredParameter

The command returns RmhMountVirtualCopySetResult objects and contains:

• RmhMountVirtualCopySet with current state updated

• Information on name, WWN, partition, volume guid path, and mount point of each Virtual

Volume mounted

Restore-vCopyVm

The restore-vCopyVm initiates a full restore or recovery of Virtual Machines.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Restore-vCopyVm -RmhServerName <RmhServerName> [-HypervName] -VcNameUuid <VcNameUuid> -VmNameUuid <VmNameUuid> [-Timestamp] [-Force] [-RestartVm] [-Verbose]

Optional-HypervPassword

Hyper-V user name. If not specified,

HypervUsername is used from Login-Rmh.

Displays progress messages.Optional-Verbose

Table 31 Restore-vCopyVm parameters

Required-RmhServerName

Optional-HypervName

Required-VmNameUuid

Optional-Timestamp

DescriptionOptional/RequiredParameter

Host name of the RMH Server. This is FQDN or IP address.

Select VC by name/uuid.Required-VcNameUuid

Select name/uuid to filter VC selection by VM.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

Bypass confirmation prompt.Optional-Force

If specified, VM will be restarted.Optional-RestartVm

Displays progress messages.Optional-Verbose

This command returns the location of restored Virtual Machine and host name.

Working with Virtual Copies 53

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.

Analyze-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName> [-VcNamesUuids] [-VmNamesUuids] [-Timestamp] [-Cleanup] [-Verbose]

Table 32 Analyze-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Optional-VcNamesUuids

Optional-VmNamesUuids

Optional-Timestamp

Optional-Cleanup

Host name of the RMH Server. This is FQDN or IP address.

Select VCs by name/uuid using a comma-separated list. If not specified, VCs name/uuid is not used to filter selection.

Select names/uuids to filter VC selection by VM. If not specified, VM names/uuids is not used to filter selection.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

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.

Unmount-vCopy

Unmount-vCopy unmounts currently mounted Virtual Copy volume(s) for the specified Virtual Copy and Virtual Machine name. The Hyper-V host used in Login-Rmh is used by the mount command.

Preconditions

The user must first login with Login-Rmh.

54 Using PowerShell Snap-in Command Line Interface

Displays progress messages.Optional-Verbose

Syntax

Any optional parameters require square brackets [ ] around them.

Unmount-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VcNameUuid <VcNameUuid> -VmNameUuid <VmNameUuid> [-Timestamp] [-Select]

[-HypervHostName] [-HypervUsername] [-HypervPassword] [-Verbose]

Table 33 Unmount-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-VmNameUuid

Optional-Timestamp

Optional-Select

Optional-HypervHostName

Host name of the RMH Server. This is FQDN or IP address.

Select VC by name/uuid.Required-VcNameUuid

Select name/uuid to filter VC selection by Virtual Machine.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

Hyper-V host name. Use this option to specify host node in cluster. You may also use this option in a non-cluster environment. If not specified,

HypervHostName is used from Login-Rmh.

Optional-HypervUsername

Optional-HypervPassword

Hyper-V user name. If not specified,

HypervUsername is used from Login-Rmh.

Hyper-V user name. If not specified,

HypervUsername is used from Login-Rmh.

Displays progress messages.Optional-Verbose

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

Working with Virtual Copies 55

6 Support and Other Resources

Contacting HP

For worldwide technical support information, see the HP support website:

http://www.hp.com/support

Before contacting HP, collect the following information:

• Product model names and numbers

• Technical support registration number (if applicable)

• Product serial numbers

• Error messages

• Operating system type and revision level

• Detailed questions

Specify the type of support you are requesting:

systems

Support requestHP 3PAR storage system

StoreServ 7000 StorageHP 3PAR StoreServ 7200, 7400, and 7450 Storage

HP 3PAR T-Class storage systems HP 3PAR F-Class storage systems

HP 3PAR documentation

Supported hardware and software platforms

and administer HP 3PAR storage systems

Using the HP 3PAR CLI to configure and administer storage systems

3PAR or 3PAR StorageHP 3PAR StoreServ 10000 Storage systems

See:For information about:

The Single Point of Connectivity Knowledge for HP Storage Products (SPOCK) website:

http://www.hp.com/storage/spock

The HP 3PAR StoreServ Storage site:Locating HP 3PAR documents

http://www.hp.com/go/3par

To access HP 3PAR documents, click the Support link for your product.

HP 3PAR storage system software

HP 3PAR StoreServ Storage Concepts GuideStorage concepts and terminology

HP 3PAR Management Console User's GuideUsing the HP 3PAR Management Console (GUI) to configure

HP 3PAR Command Line Interface Administrator’s Manual

to manage host configuration and connectivity information

Model (CIM) to manage HP 3PAR storage systems

56 Support and Other Resources

HP 3PAR Command Line Interface ReferenceCLI commands

HP 3PAR System Reporter Software User's GuideAnalyzing system performance

HP 3PAR Host Explorer User’s GuideInstalling and maintaining the Host Explorer agent in order

HP 3PAR CIM API Programming ReferenceCreating applications compliant with the Common Information

See:For information about:

HP 3PAR-to-3PAR Storage Peer Motion GuideMigrating data from one HP 3PAR storage system to another

Configuring the Secure Service Custodian server in order to monitor and control HP 3PAR storage systems

Copy

Identifying storage system components, troubleshooting information, and detailed alert information

Server

HP 3PAR Secure Service Custodian Configuration Utility Reference

HP 3PAR Remote Copy Software User’s GuideUsing the CLI to configure and manage HP 3PAR Remote

HP 3PAR Upgrade Pre-Planning GuideUpdating HP 3PAR operating systems

HP 3PAR F-Class, T-Class, and StoreServ 10000 Storage Troubleshooting Guide

HP 3PAR Policy Server Installation and Setup GuideInstalling, configuring, and maintaining the HP 3PAR Policy HP 3PAR Policy Server Administration Guide

HP 3PAR documentation 57

See:For information about:

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 StoreServ 7000 Storage Site Planning ManualHP 3PAR 7200, 7400, and 7450 storage systems HP 3PAR StoreServ 7450 Storage Site Planning Manual

HP 3PAR 10000 storage systems

Installing and maintaining HP 3PAR 7200, 7400, and 7450 storage systems

initializing the Service Processor

7450 storage systems

HP 3PAR host application solutions

Backing up Oracle databases and using backups for disaster recovery

HP 3PAR StoreServ 10000 Storage Physical Planning Manual

HP 3PAR StoreServ 10000 Storage Third-Party Rack Physical Planning Manual

HP 3PAR StoreServ 7000 Storage Installation GuideInstalling 7200, 7400, and 7450 storage systems and HP 3PAR StoreServ 7450 Storage Installation Guide HP 3PAR StoreServ 7000 Storage SmartStart Software

User’s Guide

HP 3PAR StoreServ 7000 Storage Service GuideMaintaining, servicing, and upgrading 7200, 7400, and HP 3PAR StoreServ 7450 Storage Service Guide

HP 3PAR StoreServ 7000 Storage Troubleshooting GuideTroubleshooting 7200, 7400, and 7450 storage systems HP 3PAR StoreServ 7450 Storage Troubleshooting Guide

HP 3PAR Service Processor Software User GuideMaintaining the Service Processor HP 3PAR Service Processor Onsite Customer Care

(SPOCC) User's Guide

HP 3PAR Recovery Manager Software for Oracle User's Guide

Backing up Exchange databases and using backups for disaster recovery

Backing up SQL databases and using backups for disaster recovery

Backing up VMware databases and using backups for disaster recovery

Installing and using the HP 3PAR VSS (Volume Shadow Copy Service) Provider software for Microsoft Windows

Best practices for setting up the Storage Replication Adapter for VMware vCenter

Troubleshooting the Storage Replication Adapter for VMware vCenter Site Recovery Manager

Installing and using vSphere Storage APIs for Array Integration (VAAI) plug-in software for VMware vSphere

HP 3PAR Recovery Manager Software for Microsoft Exchange 2007 and 2010 User's Guide

HP 3PAR Recovery Manager Software for Microsoft SQL Server User’s Guide

HP 3PAR Management Plug-in and Recovery Manager Software for VMware vSphere User's Guide

HP 3PAR VSS Provider Software for Microsoft Windows User's Guide

HP 3PAR Storage Replication Adapter for VMware vCenter Site Recovery Manager Implementation Guide

HP 3PAR Storage Replication Adapter for VMware vCenter Site Recovery Manager Troubleshooting Guide

HP 3PAR VAAI Plug-in Software for VMware vSphere User's Guide

58 Support and Other Resources

Typographic conventions

Table 34 Document conventions

ElementConvention

Bold text

Monospace text

Bold monospace 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

• File and directory names

• System output

• Code

• Commands, their arguments, and argument values

• Code variables

• Command variables

• Commands you enter into a command line interface

• System output emphasized for scannability

WARNING! Indicates that failure to follow directions could result in bodily harm or death, or in

irreversible damage to data or to the operating system.

CAUTION: Indicates that failure to follow directions could result in damage to equipment or data.

NOTE: Provides additional information.

Required

Indicates that a procedure must be followed as directed in order to achieve a functional and supported implementation based on testing at HP.

HP 3PAR branding information

• The server previously referred to as the "InServ" is now referred to as the "HP 3PAR StoreServ

Storage system."

• The operating system previously referred to as the "InForm OS" is now referred to as the "HP

3PAR OS."

• The user interface previously referred to as the "InForm Management Console (IMC)" is now

referred to as the "HP 3PAR Management Console."

• All products previously referred to as “3PAR” products are now referred to as "HP 3PAR"

products.

Typographic conventions 59

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.

60 Documentation 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. Click Yes to continue.

4. Click Ok to confirm.

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.

Syntax

Any optional parameters require square brackets [ ] around them.

Add-HyperV -RmhServerName <RmhServerName> -HypervName <HypervName>

-HypervUsername <HypervUser> -HypervPassword <HypervPassword> [-Verbose]

Table 35 Add-HyperV parameters

Required-RmhServerName

Required-HypervName

Required-HypervUsername

Required-HypervPassword

Success Paths

• Scenario 1: Add Hyper-V is successful.

Add Hyper-V successful for specified Hyper-V host.

DescriptionOptional/RequiredParameter

Host name of the RMH Server. This is FQDN or IP address.

Hyper V host or cluster name. This is FQDN or IP address. Synonyms are checked. The localhost is not supported.

Hyper-V username. If cluster, ensure all controller nodes in the cluster have the same username. If not specified, a dialog box will be presented to enter credentials.

Hyper-V password. If cluster, ensure all controller nodes in the cluster have the same password. If not specified, a dialog box will be presented to enter credentials.

Displays progress messages.Optional-Verbose

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.

62 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

• 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.

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.

• HP 3PAR StoreServ name must not already exist for specified Microsoft Hyper-V

Syntax

Any optional parameters require square brackets [ ] around them.

Add-StoreServ -RmhServerName <RmhServerName> -HypervName <HypervName>

-StoreServName <StoreServName> -StoreServUsername <StoreServUsername>

-StoreServPassword <StoreServPassword> [-Verbose]

Table 36 Add-StoreServ parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-StoreServName

Required-StoreServUsername

Host name of the RMH Server. This is FQDN or IP address.

This is FQDN or IP address. Synonyms are supported. The localhost is not supported.

This is FQDN or IP address, etc. Synonyms for HP 3PAR StoreServ are supported.

Note, if not provided, a dialog box will pop up asking for credentials.

Required-StoreServPassword

Note, if not provided, a dialog box will pop up asking for credentials.

Displays progress messagesOptional-Verbose

Add-StoreServ 63

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.

• Scenario 3: Storage System credentials are already specified

User is already logged in with specified Storage System.

Analyze-vCopy

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Analyze-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName> [-VcNamesUuids] [-VmNamesUuids] [-Timestamp] [-Cleanup] [-Verbose]

Table 37 Analyze-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Optional-VcNamesUuids

Host name of the RMH Server. This is FQDN or IP address.

Select VCs by name/uuid using a comma-separated list. If not specified, VCs name/uuid is not used to filter selection.

Optional-VmNamesUuids

Optional-Timestamp

Optional-Cleanup

64 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

Select names/uuids to filter VC selection by VM. If not specified, VM names/uuids is not used to filter selection.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

If specified, Analyze-vCopy will clean up the inconsistent VC by removing it. Removing the inconsistent

Table 37 Analyze-vCopy parameters (continued)

DescriptionOptional/RequiredParameter

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.

Displays progress messages.Optional-Verbose

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.

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, this command fails.

• Scenario 2: Storage System session credentials are not provided.

Storage System session credentials are not provided for this command.

• Scenario 3: Database has missing Virtual Volumes.

The database repository is validated against Storage System and at least one Virtual Volume is unavailable.

Create-vCopy

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Create-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VmNamesUuids <VmNamesUuids> [-VcNamePrefix] [-Expiry] [-Retention]

[-SavedStateBackups] [-Verbose]

Table 38 Create-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Host name of the RMH Server. This is FQDN or IP address.

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

Create-vCopy 65

Table 38 Create-vCopy parameters (continued)

DescriptionOptional/RequiredParameter

supported. The localhost is not supported.

Required-VmNamesUuids

Optional-VcNamePrefix

Optional-Expiry

Optional-Retention

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.

Integer value followed by letter h or d for Hours and Days respectively Default: use the RMH Policy.

Disabled or enabled.Optional-SavedStateBackups Default: use the RMH policy.

Displays progress messages.Optional-Verbose

Result with Description

• Multiple {RmhCreateVirtualcopyResult} objects.

◦ VM Name or UUID

◦ Success/Failure status of the create-vCopy operation for the VM

◦ 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).

Success Paths

• Scenario 1: Virtual Copies are successfully created.

Virtual Copies on VM(s) specified are successfully created.

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: No VM is specified.

At least one VM must be specified for command.

66 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

• 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.

• 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.

VSS requestor fails during backup. Reason is displayed.

• Scenario 13: Multiple Storage Systems is not supported.

RMH does not support multiple Storage Systems for VM.

Get-ClusterNodeNames

Get-ClusterNodeNames retrieves node names for the Hyper-V cluster.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Get-ClusterNodeNames -RmhServerName <RmhServerName> -HypervName <HypervName> [-Verbose]

Table 39 Get-ClusterNodeNames parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Host name of the RMH Server. This is FQDN or IP address.

Displays progress messages.Optional-Verbose

Get-ClusterNodeNames 67

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.

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.

Syntax

Any optional parameters require square brackets [ ] around them.

Get-EncryptedLoginCredentials -RmhServerName <RmhServerName> [-Verbose]

Table 40 Get-EncryptedLoginPassword parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Host name of the RMH Server. This is FQDN or IP address.

Displays progress messages.Optional-Verbose

Success Paths

• Scenario 1: Get is successful.

Get 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: Failure to encrypt login password.

RMH Server cannot encrypt login password.

68 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

Get-RmhPolicy

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Get-RmhPolicy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VmNameUuid <VmNameUuid> [-Verbose]

Table 41 Get-RmhPolicy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-VmNameUuid

Host name of the RMH Server. This is FQDN or IP address.

Name/unique id of VM to set policy for Virtual Machine.

Displays progress messages.Optional-Verbose

Result with Description

• {RMHirtualCopySet} has the following properties:

◦ IsVirtualCopyApplicationConsistent: if yes, an application consistent VC is

created.

◦ VirtualCopyExpirationTime: if non-zero, expiry values will be set in Storage System

for all VC volumes created.

◦ VirtualCopyRetentionTime: if non-zero, retention values will be set in Storage

System for all VC volumes created.

◦ SavedStateBackus: Enabled or Disabled.

Success Paths

• Scenario 1: RMH Policy is fetched.

RMH Policy is fetched for specified VM.

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.

Get-RmhPolicy 69

• Scenario 3: VM name/uuid specified is invalid

• Scenario 4: RMH Policy does not exist.

Get-vCopy

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Get-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName> [-VcNamesUuids] [-VmNamesUuids] [-Timestamp] [-Verbose]

Table 42 Get-vCopy parameters

VM name or uuid must be valid to fetch RMH Policy.

RMH Policy does not exist for specified VM.

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Optional-VcNamesUuids

Optional-VmNamesUuids

Optional-Timestamp

Host name of the RMH Server. This is FQDN or IP address.

Select VCs by name/uuid using a comma-separated list. If not specified, VCs name/uuid is not used to filter selection.

Select names/uuids to filter VC selection by VM. If not specified, VM names/uuids is not used to filter selection.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

Displays progress messages.Optional-Verbose

70 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

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.

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.

Get-VirtualMachine

Get-VirtualMachine retrieves current Virtual Machines available on an active-session Hyper-V host/cluster.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Get-VirtualMachine -RmhServerName <RmhServerName> -HypervName <HypervName> [-Verbose]

Table 43 Get-VirtualMachine parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Host name of the RMH Server. This is FQDN or IP address.

Displays progress messages.Optional-Verbose

Get-VirtualMachine 71

Result with Description

• Multiple {RMHirtualMachineInfo} objects:

Success Paths

• Scenario 1: Virtual Machine(s) is fetched.

• Scenario 2: Virtual Machine(s) is not fetched.

Failure Paths

• Scenario 1: Session owner is invalid.

• Scenario 2: Unable to fetch Hyper-V.

Login-Rmh

Multiple RMHirtualMachineInfo objects (one per VM).

At least one Virtual Machine is returned.

No Virtual Machines are available. Nothing is returned.

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.

A Hyper-V is required to fetch VMs.

Log into RMH Server using Windows RMH account. The optional login-Rmh enables the user to log on to Recovery Manager for Hyper-V. After a

successful login is established, the user is not required to enter additional credentials for subsequent Cmdlets.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Table 44 Login-Rmh parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-RmhUserName

Required-RmhPassword

Host name of the RMH Server. This is FQDN or IP address.

RMH user name. If not specified, a dialog box will be presented to enter credentials.

RMH user password. If not specified, a dialog box will be presented to enter credentials.

Optional-RmhEncrytedPassword

72 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

May be used instead of

-RmhPassword.

Success Paths

• Scenario 1: Login 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.

RMH Server cannot authenticate with the specified Hyper-V host.

• Scenario 4: Storage System session credentials are invalid.

Storage System session credentials provided are invalid.

• Scenario 5: Storage System credentials are already specified.

User has already logged in with specified Storage System.

• Scenario 6: Cannot start RMH session.

A Hyper-V is required to fetch VMs.

• Scenario 2: Unable to fetch Hyper-V.

Failure occurred to start session. Reason displayed.

Logout-Rmh

The optional logout-Rmh Cmdlet logs off the user from the application.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Logout-Rmh -RmhServerName <RmhServerName> [-Remove]

Table 45 Logout-Rmh parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Optional-Remove

Host name of the RMH Server. This is FQDN or IP address.

If specified, RMH user along with Hyper-V host/cluster and Storage System credentials will be removed from RMH credentials repository.

Logout-Rmh 73

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.

Mount-vCopy

Mount point is not required. Volume Guid will only access virtual volume(s) if mount point prefixes are not specified.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Mount-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VcNameUuid <VcNameUuid> -VmNameUuid <VmNameUuid> [-Timestamp] [-MountPointPrefix] [-Select] [-HypervHostName] [-HypervUsername] [-HypervPassword] [-Verbose]

Table 46 Mount-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-VmNameUuid

Host name of the RMH Server. This is FQDN or IP address.

Select VC by name/uuid.Required-VcNameUuid

Select name/uuid to filter VC selection by Virtual Machine.

Optional-Timestamp

Optional-MountPointPrefix

74 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

Specify timestamp of VC to locate in the format mmddyyhhmmss.

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.timestamp

Table 46 Mount-vCopy parameters (continued)

DescriptionOptional/RequiredParameter

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)\).

Result with Description

Optional-Select

Optional-HypervHostName

Optional-HypervUsername

Optional-HypervPassword

Hyper-V host name. Use this option to specify host node in cluster. You may also use this option in a non-cluster environment. If not specified,

HypervHostName is used from Login-Rmh.

Hyper-V user name. If not specified,

HypervUsername is used from Login-Rmh.

Hyper-V user name. If not specified,

HypervUsername is used from Login-Rmh.

Displays progress messages.Optional-Verbose

• {RmhMountVirtualCopySetResult} has the following descriptions:

◦ RmhMountVirtualCopySet with current state updated.

◦ Information on name, WWN, partition, volume guid path, and mount point of each Virtual

Volume mounted.

Success Paths

• Scenario 1: Mount is successful.

Mount 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 not provided.

Storage System session credentials are not provided for this command.

Mount-vCopy 75

• 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.

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.

Remove-HyperV

Remove-HyperV removes Microsoft Hyper-V host/cluster credentials associated with a RMH user.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Remove-HyperV -RmhServerName <RmhServerName> [-HypervName] [-Verbose]

Table 47 Remove-HyperV parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Optional-HypervName

Host name of the RMH Server. This is FQDN or IP address.

Displays progress messages.Optional-Verbose

76 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

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.

Hyper-V is not previously added.

Remove-RmhPolicy

Remove-RmhPolicy removes RMH policy of a Virtual Machine.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Remove-RmhPolicy -RmhServerName <RmhServerName> [-HypervName] -VmNameUuid <VmNameUuid> [-Verbose]

Table 48 Remove-RmhPolicy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Optional-HypervName

Required-VmNameUuid

Host name of the RMH Server. This is FQDN or IP address.

Select name/uuid to filter Virtual Copy selection by Virtual Machine.

Displays progress messages.Optional-Verbose

Remove-RmhPolicy 77

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.

VM name or uuid must be valid to fetch RMH Policy.

• Scenario 4: RMH Policy does not exist.

RMH Policy is not previously set for specified VM.

Remove-StoreServ

Remove-StoreServ removes HP 3PAR StoreServ credentials associated with a RMH user.

Preconditions

• The user must first login with Login-Rmh.

• HP 3PAR StoreServ credentials must already exist for specified Microsoft Hyper-V.

Syntax

Any optional parameters require square brackets [ ] around them.

Remove-StoreServ -RmhServerName <RmhServerName> -HypervName <HypervName>

-StoreServName <StoreServName> [-Verbose]

Table 49 Remove-StoreServ parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-StoreServName

Host name of the RMH Server. This is FQDN or IP address.

This is FQDN or IP address. Synonyms for Hyper-V are supported. Thelocalhost is not supported.

Synonyms for HP 3PAR StoreServ are supported.

Displays progress messages.Optional-Verbose

78 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

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.

Preconditions

The user must first login with Login-Rmh.

Post Conditions

• Virtual Copy removed and all available Virtual Volumes deleted, or

• Virtual Copy retained due to at least one Virtual Volume failing to delete with reason other

than not found on storage system.

Syntax

Any optional parameters require square brackets [ ] around them.

Remove-vCopy -RmhServerName <RmhServerName> [-HypervName] -VcNameUuid <VcNameUuid> -VmNameUuid <VmNameUuid> [-Timestamp] [-Force] [-Verbose]

Table 50 Remove-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Optional-HypervName

Required-VmNameUuid

Host name of the RMH Server. This is FQDN or IP address.

Select VC by name/uuid.Required-VcNameUuid

Select name/uuid to filter VC selection by VM.

Optional-Timestamp

Specify timestamp of VC to locate in the format mmddyyhhmmss.

Bypass confirmation prompt.Optional-Force

Displays progress messages.Optional-Verbose

Remove-vCopy 79

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.

License is missing for RMH.

• Scenario 4: Virtual Volume(s) is mounted.

Virtual Copies cannot be removed while mounted.

• Scenario 5: RW Virtual Volume(s) is missing.

Message is displayed. Remove operation continues.

• Scenario 6: Virtual Volume(s) in use by other Virtual Copy records.

Unable to delete. In Use by other Virtual Copies. Remove operation continues and leaves Virtual Volume alone.

• Scenario 7: Unable to delete RW Virtual Volume.

Unable to delete RW Virtual Volume. Remove operation continues.

• Scenario 8: License is missing for RMH.

Unable to delete RW Virtual Volume. Remove operation continues.

• Scenario 9: Only one Virtual Copy can be removed at a time.

Filtering of Virtual Copies using -VcNameUuid/-VmNameUuid does not result in only one Virtual Copy to remove.

• Scenario 10: Virtual Copy is not removed.

If Storage System reports error other than virtual volume not found, the Virtual Copy is retained.

Restore-vCopyVm

The restore-vCopyVm initiates a full restore or recovery of Virtual Machines.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Restore-vCopyVm -RmhServerName <RmhServerName> [-HypervName] -VcNameUuid <VcNameUuid> -VmNameUuid <VmNameUuid> [-Timestamp] [-Force] [-RestartVm] [-Verbose]

80 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

Table 51 Restore-vCopyVM parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Optional-HypervName

Required-VmNameUuid

Optional-Timestamp

Host name of the RMH Server. This is FQDN or IP address.

Select VC by name/uuid.Required-VcNameUuid

Select name/uuid to filter VC selection by VM.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

Bypass confirmation prompt.Optional-Force

If specified, VM will be restarted.Optional-RestartVm

Displays progress messages.Optional-Verbose

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.

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 missing for RMH.

License is missing for RMH.

• Scenario 4: Original mount points do not exist.

The original mount points for VM system files and all VHDs must exist.

• Scenario 5: Fails to mount Virtual Volumes to Hyper-V host.

Unable to mount Virtual Volumes to Hyper-V host for restore.

• Scenario 6: Fails to unmount Virtual Volumes from Hyper-V host.

After restore is complete, unmount is unable to complete.

• Scenario 7: Only one Virtual Copy may be restored at a time.

Filtering of Virtual Copies using -VcNameUuid/-VmNameUuid does not result in only one Virtual Copy to restore.

Restore-vCopyVm 81

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 <RmhServerName> -HypervName <HypervName> [-Verbose]

Table 52 Select-HyperV parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Host name of the RMH Server. This is FQDN or IP address

Select Hyper-V host/cluster to use by default. This is FQDN or IP address. Synonyms for Hyper-V are supported. The localhost is not supported.

Display progress messages.Optional-Verbose

Success Paths

• Scenario 1: Hyper-V is selected.

Specified Hyper-V is selected.

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: Hyper-V host/cluster name is not specified.

Hyper-V host/cluster name must be specified.

• Scenario 3: Hyper-V host/cluster name is not available for user.

Add-Hyperv must be issued to associate Hyper-V first.

• Scenario 4: Cannot communicate with specified Hyper-V host/cluster.

Cannot communicate with Hyper-V specified. Host is unavailable. Invalid credentials specified.

• Scenario 5: Cannot communication with Storage System(s) associated with Hyper-V.

Cannot communicate with associated Storage System(s).

Set-RmhPolicy

Set-RmhPolicy modifies RMH policy of a VM.

Preconditions

User must first login using Login-Rmh.

82 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

Syntax

Any optional parameters require square brackets [ ] around them.

Set-RmhPolicy -RmhServerName <RmhServerName> -HypervName <HypervName>

-VmNameUuid <VmNameUuid> [-Expiry] [-Retention] [-SavedStateBackups]

[-Verbose]

Table 53 Set-RmhPolicy parameters

DescriptionOptional/RequiredParameter

Success Paths

Required-RmhServerName

Required-HypervName

Required-VmNameUuid

Optional-Expiry

Optional-Retention

Host name of the RMH Server. This is FQDN or IP address

Name/unique id of VM used to set policy.

Integer value followed by letter h or d for Hours and Days respectively. Use 0 to reset.

Integer value followed by letter h or d for Hours and Days respectively. Use 0 to reset

Disabled or enabled. Use reset to reset.Optional-SavedStateBackups

Display progress messages.Optional-Verbose

• Scenario 1: RMH Policy is set.

RMH Policy successfully sets for VM.

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: Expiry is invalid.

Expiry specified is invalid. Valid: 1-43800 h, 1-1825 d, or 0 to reset.

• Scenario 4: Retention is invalid.

Retention specified is invalid. Valid: 1-336 h, 1-14 d, or 0 to reset.

• Scenario 5: Expiry/Retention settings conflict.

Expiry and retention settings conflict for valid cases on Storage System.

• Scenario 5: Cannot communicate with VM.

Cannot communicate with VM to validate VM.

Set-RmhPolicy 83

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.

Show-Connection -RmhServerName <RmhServerName> [-HypervName] [-ShowMissingStorageSystems] [-Verbose]

Table 54 Show-Connection parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Optional-HypervName

Optional-ShowMissingStorageSystems

Host name of the RMH Server. This is FQDN or IP address

If specified, the resulting connections shown will be for this Hyper-V. Synonyms for Hyper-V are supported. The localhost is not supported.

If specified, Storage Systems used by Hyper-V(s), but missing credentials, are shown.

Display progress messages.Optional-Verbose

Success Paths

• Scenario 1: Connection information shown.

RMH Session and all Hyper-V/ Storage System connection information currently established are shown.

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.

Unmount-vCopy

Unmount-vCopy unmounts currently mounted Virtual Copy volume(s) for the specified Virtual Copy and Virtual Machine name. The Hyper-V host used in Login-Rmh is used by the mount command.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Unmount-vCopy -RmhServerName <RmhServerName> [-HypervName] -VcNameUuid <VcNameUuid> -VmNameUuid <VmNameUuid> [-Timestamp] [-Select] [-HypervHostName] [-HypervUsername] [-HypervPassword] [-Verbose]

84 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

Table 55 Unmount-vCopy parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Optional-HypervName

Required-VmNameUuid

Optional-Timestamp

Optional-Select

Optional-HypervHostName

Host name of the RMH Server. This is FQDN or IP address.

Select VC by name/uuid.Required-VcNameUuid

Select name/uuid to filter VC selection by Virtual Machine.

Specify timestamp of VC to locate in the format mmddyyhhmmss.

Hyper-V host name. Use this option to specify host node in cluster. You may also use this option in a non-cluster environment. If not specified,

HypervHostName is used from Login-Rmh.

Optional-HypervUsername

Optional-HypervPassword

Hyper-V user name. If not specified,

HypervUsername is used from Login-Rmh.

Hyper-V user name. If not specified,

HypervUsername is used from Login-Rmh.

Displays progress messages.Optional-Verbose

Unmount-vCopy 85

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.

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 missing for RMH.

License is missing for RMH.

• Scenario 4: One or more Virtual Volumes mount points do not exist.

Using a specified mount point prefix and RMH format of RMH.vv-wwn, the mount point attempted is not available to unmount.

• Scenario 5: Storage System host is not available to unmount Virtual Volume(s).

A Storage System host must be available to unmount Virtual Volume(s).

• 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.

• Specified Microsoft Hyper-V credentials must already exist.

Syntax

Any optional parameters require square brackets [ ] around them.

Update-HyperV -RmhServerName <RmhServerName> -HypervName <HypervName>

-HypervUsername <HypervUsername> -HypervPassword <HypervPassword> [-Verbose]

86 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

Table 56 Update-HyperV parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-HypervUsername

Success Paths

• Scenario 1: Update Hyper-V is successful

Add Microsoft Hyper-V is successful.

Failure Paths

Host name of the RMH Server. This is FQDN or IP address

Microsoft Hyper-V host or cluster name. This is FQDN or IP address. Synonyms are supported. The localhost is not supported.

Microsoft Hyper-V user name. If cluster, ensure all controller nodes in the cluster have the same username. Note: if not provided, a dialog box will pop up asking for credentials.

Microsoft Hyper-V password.Required-HypervPassword

NOTE: If not provided, a dialog box

will pop up asking for credentials.

Display progress messages.Optional-Verbose

• 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.

User has already logged in with specified Microsoft Hyper-V.

Update-StoreServ

Update-StoreServ updates HP 3PAR StoreServ credentials already present in RMH database for user.

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 updated and persisted in database.

Syntax

Any optional parameters require square brackets [ ] around them.

Update-StoreServ -RmhServerName <RmhServerName> -HypervName <HypervName>

-StoreServName <StoreServName> -StoreServUsername <StoreServUsername>

-StoreServPassword <StoreServPassword> [-Verbose]

Update-StoreServ 87

Table 57 Update-StoreServ parameters

DescriptionOptional/RequiredParameter

Required-RmhServerName

Required-HypervName

Required-StoreServName

Required-StoreServUsername

Required-StoreServPassword

Success Paths

• Scenario 1: Update HP 3PAR StoreServ is successful.

Add HP 3PAR StoreServ is successful.

Failure Paths

Host name of the RMH Server. This is FQDN or IP address

Microsoft Hyper-V host or cluster name. This is FQDN or IP address. Synonyms are supported. The localhost is not supported.

This is FQDN or IP address, etc. Synonyms for HP 3PAR StoreServ are supported.

NOTE: If not provided, a dialog box

will pop up asking for credentials.

NOTE: If not provided, a dialog box

will pop up asking for credentials.

Display progress messages.Optional-Verbose

• 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.

• Scenario 3: HP 3PAR StoreServ credentials are already specified.

User has already logged on with specified HP 3PAR StoreServ.

88 HP 3PAR Recovery Manager for Microsoft Hyper-V Powershell Commands

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).

About installing McAfee Antivirus 89

Index

About HP 3PAR Recovery Manager Software for Microsoft

Hyper-V

features, 7 Accessing the web client, 29 analyzing Virtual Copies, 36

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

data consistency, 9 documentation

providing feedback on, 60

ensuring volume consistency, 9

firewalls, 13

GUI

about, 20

Hyper-V server view, 20

server summary view, 21

setting up, 30

Virtual Machine view, 24

Virtual Machines tab, 21

HP 3PAR Recovery Manager Software for Microsoft

Hyper-V

about, 6 Hyper-V

Virtual Machines tab, 22 Hyper-V standalone host configuration, 13 Hyper-V Virtual Machine configuration, 12

installation requirements, 13 installing

agent, 30 Installing RMH software, 14

InstallShield Wizard, 14

JavaScript, 61

license, 13 logging off, 43

managing Virtual Copies, 33 Microsoft Hyper-V servers

disconnecting, 32

mounting Virtual Copies, 37

network ports, 13

online help, 20 operating systems, 12 other requirements, 13

Powershell Commandlets

Add-Hyper-V, 62 Add-StoreServ, 63 Analyze-vCopy, 64 Create-vCopy, 65 Get-ClusterNodeNames, 67 Get-EncryptedLoginPassword, 68 Get-RmhPolicy, 69 Get-vCopy, 70 Get-VirtualMachine, 71 list, 62 Login-Rmh, 72 Logout-Rmh, 73 Mount-vCopy, 74 Remove-Hyper-V, 76 Remove-RmhPolicy, 77 Remove-StoreServ, 78 Remove-vCopy, 79 Restore-vCopyVm, 80 Select-Hyper-V, 82 Set-RmhPolicy, 82 Show-Connection, 84 Unmount-vCopy, 84 Update-HyperV, 86 Update-StoreServ, 87

removing Virtual Copies, 37 requirements for installation, 13 restoring Virtual Copies, 36 RMH agent, 30

90 Index

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

text symbols, 59 Troubleshooting, 89 types of interfaces

about, 20 Types of User Interface

command line interface, 7, 8

GUI, 7

supported types, 9

Virtual Copy Management, 9

data consistency, 9 GUI, 10 Virtual Copy policy, 9

Virtual Copy policy

attributes, 10

virtual hard disks tab

about, 25

Virtual Volumes tab

about, 26

web browser, 8

enabling JavaScript, 61 web browsers, 20 working with Virtual Copies

about, 33

analyzing, 36

creating, 33

mounting, 37

removing, 37

restoring, 36

scheduling tasks, 39

scheduling Virtual Copy analysis tasks, 41

setting policy, 34

unmounting, 38

uninstalling

RMH agent, 31

uninstalling the software, 17

Microsoft Windows control panel, 17 unmounting Virtual Copies, 38 Using the CLI, 49

about, 44

adding Hyper-V, 45

adding StoreServ, 46

analyzing, 54

connecting, 44

creating Virtual Copies, 50

displaying connections, 49

logging off, 44

logging on, 44

mounting, 51

restoring, 53

retrieving credentials, 47

retrieving existing Virtual Copies, 51

retrieving names, 47

retrieving policies, 48

retrieving Virtual Machines, 48

setting policy, 46

unmounting, 54

Virtual Copies tab

about, 26 Virtual Copy data consistency

HP Recovery Manager Software User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

HP 3PAR Recovery Manager 1.1.0 Software for Microsoft Hyper-V

Contents

About HP 3PAR Recovery Manager Software for Microsoft Hyper-V

6 Introducing HP 3PAR Recovery Manager Software for Microsoft Hyper-V

Features of Recovery Manager Software for Microsoft Hyper-V

Types of User Interface

Web Browser Graphical User Interface

PowerShell Cmdlet Graphical and Command Line Interface

About Virtual Copy Management

Virtual Copy Data Consistency

Virtual Copy Policy

Graphical User Interface Scheduling Tool

2 Getting Started

About Components of HP 3PAR Recovery Manager for Microsoft Hyper-V

About Supported Operating Systems and Software Prerequisites

Operating Systems

Software Prerequisites

About Supported System Configurations

Hyper-V Virtual Machine Configuration

Hyper-V Stand-Alone Host Configuration

About Other Requirements

About Supported Network Ports

Installing the Software

14 Installing HP 3PAR Recovery Manager for Microsoft Hyper-V

Uninstalling the Software

4 Using the Web Client Interface

Using Online Help

Understanding the Web Client Interface

Hyper-V Server View

Virtual Machine View

Create Virtual Copy – Last Run Output

Accessing the Web Client

Connecting to Recovery Manager Server

Setting Up the Recovery Manager Web Client

Connecting to Hyper-V Server

Installing Recovery Manager Agent

Uninstalling Recovery Manager Agent

Updating StoreServ Credentials

Adding HP 3PAR StoreServ System Credentials

Disconnecting Microsoft Hyper-V Servers

Working with Virtual Copies

Creating Virtual Copies

Setting Policy to Virtual Copies

Analyzing Virtual Copies

Restoring Virtual Machines From Virtual Copies

Removing Virtual Copies

Mounting Virtual Copies

Unmounting Virtual Copies

Scheduling Virtual Copy Creation Tasks

Scheduling Virtual Copy Analysis Tasks

Logging Off From Session

5 Using PowerShell Snap-in Command Line Interface

Connecting to RMH Server

Login-Rmh

Logout-Rmh

Configuring RMH Server

Add-HyperV

Add-StoreServ

Set-RmhPolicy

Get-ClusterNodeNames

Get-EncryptedLoginCredentials

Get-RmhPolicy

Get-VirtualMachine

Show-Connection

Working with Virtual Copies

Create-vCopy

Get-vCopy

Mount-vCopy

Restore-vCopyVm

Analyze-vCopy

Unmount-vCopy

6 Support and Other Resources

Contacting HP

HP 3PAR documentation

Typographic conventions

HP 3PAR branding information