Home

Hyper-V Agent User Guide

1. Completed af Not Protected af Not Protected af Not Protected af Not Protected Current Inventory w Show 25 recordsperpage lt Refresh Last Run Size 100 today at 12 18PM 26 57 KB aan R 200 e Select the check box for each VM that you want to include in the backup job e Select the check box at the top left of the list to select all VMs on the page Note If you select a VM that is already included in another job it will not be added to the new job 6 Click Create Hyper V Job S 7 Inthe Create New Job dialog box specify the following information e Inthe Name box type a name for the backup job e Inthe Description box type a description for the backup job e Inthe Destination list select the vault where you want to save the backup data e Inthe Encryption Password and Confirm Password boxes enter a data encryption password You can also enter a password hint in the Password Hint box Important You must enter the encryption password to recover your data If you forget the password you lose access to your data The password is not maintained anywhere else and cannot be recovered Note Hyper V backup data is encrypted using the AES 256 encryption method 29 Hyper V Agent 7 4 User Guide Create New Job Virtual Machines Description Unprotected Protected by this job Encryption Password Confirm Password Password Hint Schedule 8 Doone or more of the following u
2. Hyper V Agent 7 4 User Guide 11 4 1 e Port Number Port used to connect to the vault e Attempt to Reconnect Every Specifies the number of seconds after which the Agent should try to connect to the vault if the vault becomes unavailable during a backup or restore e Abort Reconnect Retries After Enter the number of minutes after which the Agent should stop trying to reconnect to the vault if the vault becomes unavailable during a backup or restore If the Agent cannot connect to the vault successfully in the specified number of tries the backup or restore fails e Enable over the wire encryption for transmission to from the vault By default when data is transmitted to and from the vault it is encrypted using AES encryption To disable over the wire transmission clear this option Click Save The name of the Hyper V cluster or standalone host now appears on the Computers page in Portal instead of the Management service computer name Change credentials or the network address for accessing Hyper V To change credentials or the network address for accessing Hyper V 1 On the navigation bar in Portal click Computers Find the Agent for which you want to change Hyper V credentials and click the computer row to expand its view Click the Advanced tab On the Cluster Credentials tab specify the following information e Inthe Address box type the host name or IP address of the Hyper V cluster or standalone host
3. O PL oO BC Oo Nin2012R2 Bigiob Completed today st 4 09 Ph 9 85 GB Select Action 4 Inthe Current Inventory Protected Inventory filter click Protected Inventory The Virtual Machines tab shows VMs that have been backed up and can be restored 5 Doone of the following e To restore one VM click Restore in its Select Action menu e Torestore multiple VMs select the check box for each VM that you want to restore Click Restore Hyper V Job The Hyper V Restore dialog box shows the VM or VMs that you want to restore 42 Hyper V Agent 7 4 User Guide Hyper V Restore se the same password for all VMs _ Encryption Password Virtual Machine a New VM Name Backup Set Destination VM Identity Select Backup Set X Select Volume X Assign new if original exists Win2012R2 Select Backup Set v Select Volume v Assign new if original exists 6 Doone of the following e Ifyou are restoring one VM enter the data encryption password in the Encryption Password box e Ifyou are restoring multiple VMs protected with the same encryption password select the Use the same password for all VMs check box In the Encryption Password box enter the data encryption password If you do not remember a password click the Hint button to view the password hint e Ifyou are restoring multiple VMs that were protected by jobs with different encryption passwords clear the Use the same password for all VMs check box 7 For e
4. When creating a new Hyper V backup job you can select VMs on the Virtual Machines tab to include in the job You can only select VMs that appear on the Hyper V Virtual Machines tab at the same time Note If you select a VM that is already included in another job the VM will not be added to the new job You can also add a Hyper V backup job without selecting VMs on the Virtual Machines tab See Add a Hyper V backup job To add a Hyper V backup job by selecting VMs 1 On the navigation bar click Computers The Computers page shows registered computers and environments Click the Hyper V environment row a Click the Virtual Machines tab The Virtual Machines tab lists VMs in the Hyper V environment The Jobs column is blank for VMs that are not included in a backup job By default the Virtual Machines tab shows 25 VMs at a time If the VMs that you want to include in the job are not listed on the tab click the Show lt number of gt records per page list and click the number of VMs to show 28 Hyper V Agent 7 4 User Guide Note A maximum of 200 VMs can appear on the Virtual Machines tab at the same time and you can only select VMs that appear on the Virtual Machines tab However you can add more VMs to the job later in this procedure Virtual Machine Job O10 Oo AutoVM193 AutoVM270 AutoVM302AutoVM302 AutoVM341 5 Doone of the following AutoVM126 job126 Last Backup Status All
5. 10 Hyper V Agent 7 4 User Guide You can also move to a new Agent version when recovering a protected Hyper V environment after a disaster or when migrating VMs to a new environment See Upgrade the Hyper V Agent in a new environment 3 3 1 Upgrade the Hyper V Agent Management service Before upgrading the Management service make sure that no backups or restores are running After upgrading the Management service upgrade any Host services to the same version See Upgrade the Hyper V Agent Host service Note To upgrade the Management service silently see Upgrade the Hyper V Agent Management service in silent mode To upgrade the Hyper V Agent Management service 1 On the server or VM where you want to upgrade the Management service double click the Hyper V Agent Management service installation kit 2 Inthe confirmation dialog box click Yes 3 Inthe installation wizard click Next 4 On the Installation Completed page click Finish 3 3 2 Upgrade the Hyper V Agent Host service Before upgrading the Host service make sure that no backups or restores are running and that the Management service has been upgraded to the same version See Upgrade the Hyper V Agent Management service Note To upgrade the Host service silently see Upgrade the Hyper V Agent Host service in silent mode To upgrade the Hyper V Agent Host service 1 On the server where you want to upgrade the Host service double click the Hyper V Agent Hos
6. 3 Install the Hyper V Agent Host service on each host and register it to the Management service See Install the Hyper V Agent Host service 4 Restore VMs See Restore Hyper V VMs 1 Restore the Portal and its protected database See the Portal Installation and Administration Guide 2 Rebuild the lost Hyper V cluster or standalone host i e Windows server with Hyper V role 3 Install the Hyper V Agent Management service and recover configuration information and jobs from the offline Hyper V Agent Enter information for the new Hyper V environment rebuilt in Step 1 on the Cluster Credentials tab See Recover jobs and settings from an offline Hyper V Agent 4 Install the Hyper V Agent Host service on each host and register it to the Management service See Install the Hyper V Agent Host service 5 Restore VMs See Restore Hyper V VMs 49 Hyper V Agent 7 4 User Guide 8 Monitor computers and processes You can monitor your backups restores and protected environments using the following Portal features 8 1 Computer page The Computer page shows status information for protected environments and their jobs See View status information on the Computer page Process logs Process logs indicate whether each backup and restore completed successfully and provide information about any problems that occurred See View process logs and View a Hyper V VMs backup history and logs View st
7. Because the schedule with the Monthly retention type is higher in the list than the schedule with the Daily retention type the Monthly retention type is applied to the safeset Note If a job is scheduled to run at slightly different times the Agent attempts to run the job according to each schedule For example if a job is scheduled to run at 11 PM by one schedule and 11 01 PM by another schedule the Agent will attempt to run the job twice Try to avoid overlapping schedules problems can occur if a job is scheduled to run twice in a short period of time 33 Hyper V Agent 7 4 User Guide Create New Job Virtual Machines Schedule Description Add Schedule Destination Retention Schedule Enable Priority vault Encryption Password Monthly 1 00 PM Last eecccece Daily Confirm Password Password Hint Note You cannot defer scheduled Hyper V backups Hyper V Agent backups can only be deferred when they are run manually ad hoc See Perform an ad hoc backup To add or edit a schedule for a Hyper V backup job 1 Inthe Create New Job or Edit Job dialog box while adding or editing a Hyper V backup job click Schedule 2 Inthe Schedule box do one of the following e To adda schedule click Add Schedule e To edit a schedule find the schedule that you want to edit 3 Inthe schedule row select a retention type A retention type specifies the number of days a backup is kept on the
8. Delet amp apackup Jobi minien tt a e eee eee 37 Hyper V Agent 7 4 User Guide 5 8 Disable or enable all scheduled backup jODS c cccccccccessssssscecececessessaeseeeessessessaeees 38 5 9 Performan ad hoc backup s 4 c cetiviee ic cadecevdige ed a a ase evdeneied ake E OE ER 39 6 Restore Hyper V VMS sssri osason aenean oap e o a saas sesapesesosesteses 41 7 Recover jobs and settings from an offline Hyper V Agent ssssscccssssscecssssceeesssseeeees 45 7 1 Hyper V disaster rOCOVELY c cccccccecsssessssececececessessaeeececscessesuaeseeeescesseesaeseeeesseesesaaees 48 8 Monitor computers and Processes cccsssssscccssssscccsssscccccsscsccecssssccccssseccacsssscsecssseceanssss 50 8 1 View status information on the Computer PAe ccesssscccecessesssseceeeeecessesenteaeeeesens 50 8 2 WICWDKOCESS IO EOE E EEEE ONEA E EA ONAE E E E ovate 51 8 3 View a Hyper V VM s backup history and lOgS cccecessssccececessesecneaeceescessessaeaeeeesens 53 8 4 Hyper V Agent logs and configuration fil S ccccccccccscssssssssececeescessessaeseeeessessesssaeens 56 9 Understanding and troubleshooting Hyper V processSeS sssseesssssssssosssssosessossessosseseoe 57 Appendix A Alternate Hyper V Agent deployments sssssssssesessssssosssssoosessooseseossssscssessoo 58 Al Alternate deployment for protecting a Hyper V cluster cccccccccssssssseceeeeesessesseaeees 58 A2 Alternate deployment fo
9. Recommended deployment for protecting a Hyper V cluster and Recommended deployment for protecting a Hyper V standalone host For best practices in a protected Hyper V environment see Best practices in a protected Hyper V environment 2 1 Portal for managing a Hyper V Agent The Hyper V Agent is managed using EVault Portal Note You cannot manage the Hyper V Agent using Web CentralControl or Windows CentralControl You must have a Portal account before you install the Hyper V Agent The account can be on a Portal instance that is hosted by EVault or installed on premises If your Portal instance is installed on premises ensure that the Portal database is backed up so that the Hyper V environment can be fully restored in the event of a disaster Information for the Hyper V Agent including vault and backup job information is saved in the Portal database See Recover jobs and settings from an offline Hyper V Agent 2 2 Vaults for Hyper V backups To provide fast local vault access for backups and restores back up Hyper V data to an Express Recovery Appliance ERA or virtual ERA vERA The data can then be replicated to the EVault cloud to ensure offsite protection in the case of a disaster If you choose not to use an ERA or vERA consider using a QuickShip vault QSM to seed Hyper V backups locally The data can then be imported into the EVault cloud Hyper V Agent 7 4 User Guide 2 3 Recommended deployment for protecting
10. UIREG_PASSWORD password1234 COORD NATOR_PORT portNumber Optional Specifies the port used to communicate with Hyper V Agent Host services Example COORDINATOR_PORT 5444 If you do not specify a port port 5444 is used for communicating with Hyper V Agent Host services INSTALLDIR installFolder Optional Specifies the installation folder for the Management service if you do not want to install the Management service in the default location The installation folder must be enclosed in double quotation marks if there are spaces in the path Example INSTALLDIR c Program Files Management Service If you do not specify an installation folder the Management service is installed in the default location C Program Files EVault Software For example to install the Management service in silent mode you could run the following command Hyper V_Agent_Management x xx xxxx exe S L1033 V qn L v ogs 1 log UIREG NETADDRESS 192 0 2 233 MECN 61 Hyper V Agent 7 4 User Guide UIREG USERNAME user site com U B2 Install the Hyper V Agent Host service in silent mode REG PASSWORD password1234 UIREG PORT 8086 INSTALLDIR C Program Files Management Service To install the Host service in silent mode run the following command in the directory where the installation kit is located installKit
11. V Agent backup job each VM in the job is backed up as a separate job task on the vault This differs from traditional Agent jobs where each backup job is associated with a single task on the vault A task is created on the vault for a VM as soon as a backup job that includes the VM is created That is a task for a VM is created on the vault before the VM is backed up If a protected VM has been deleted from the Hyper V environment and is no longer included in a backup job you can still see the VM in Portal and restore the VM from the vault C1 Determine the name of a VM s task on the vault Each VM in a Hyper V backup job is backed up as a separate task on the vault and is automatically assigned a unique task name To help you find each task on the vault you can view the task name for each protected Hyper V VM in Portal Note To determine the vault where a particular VM backup is saved check the VM s backup history The vault IP address for a safeset appears in the Location field on the Backup History tab See View a Hyper V VMs backup history and logs To determine the Account Username and the Agent Host name for the backup on the vault see information in the Vault Settings dialog box See Add a vault connection To determine the name of a VM s task on the vault 1 In Portal on the navigation bar click Computers A grid lists available computers 2 Find the Hyper V environment with the protected VM and expand the en
12. backup job The VM backup will continue without reseeding because the vault and encryption password are the same in the temporary job and in the existing scheduled job Add a Hyper V backup job To add a Hyper V backup job 1 On the navigation bar click Computers The Computers page shows registered computers and environments Click the Hyper V environment row a Click the Jobs tab In the Job Tasks menu click Create New Hyper V Job The Create New Job dialog box appears The Unprotected box shows VMs that are not included ina backup job 26 Hyper V Agent 7 4 User Guide Create New Job Virtual Machines m Description Unprotected Protected by this job Destination Encryption Password Confirm Password Password Hint Schedule 5 Inthe Create New Job dialog box specify the following information e Inthe Name box type a name for the backup job e Inthe Description box type a description for the backup job e Inthe Destination list select the vault where you want to save the backup data e Inthe Encryption Password and Confirm Password boxes enter a data encryption password You can also enter a password hint in the Password Hint box Important You must enter the encryption password to recover your data If you forget the password you lose access to your data The password is not maintained anywhere else and cannot be recovered Note Hyper V backup data is encrypted using t
13. be fully restored if the Portal is also lost the Portal database must be backed up For more information see the Portal Installation and Administration Guide To recover jobs and settings from an offline Hyper V Agent 1 Install the Hyper V Agent Management service on a supported Windows server On the Register EVault Software Hyper V Agent Management with Portal page of the installer register the Management service to the Portal where the original Hyper V Agent was registered Register the Management service to the Portal using the user who installed the original Hyper V Agent or using an Admin user in the original user s site See Install the Hyper V Agent Management service 45 Hyper V Agent 7 4 User Guide 2 Log into Portal as the user who installed the original Hyper V Agent or as an Admin user in the original user s site 3 In Portal on the navigation bar click Computers The Computers page shows registered computers 4 Find the computer where the new Hyper V Agent Management service is installed and expand its view by clicking its row Before you recover jobs and settings from the offline Hyper V agent the name of the computer where the Management service is installed appears on the Computers page The Configuration mode selection section appears Note The Recover a previous Hyper V Agent option only appears if there is an offline Hyper V Agent in the user s site This agent must be configured
14. before you can continue The wizard below will help you accomplish this in a few easy steps Configuration mode selection D Configure a new Hyper V Agent Gives you the option to register an agent with Hyper V Server Recover a previous Hyper V Agent Gives you the option to recover a registration and all backup jobs from an offline agent You can still change all configuration and jobs after recovery 5 Select Recover a previous Hyper V Agent and then click Continue Hyper V Agent 7 4 User Guide The Recover section appears The Select an offline agent to recover from list shows the names of protected Hyper V environments where the Management service is offline and shows the last date and time when the Management service connected to Portal Note The date and time shown in the Select an offline agent to recover from list could reflect the date and time when the Management service was installed or the server was restarted The date and time in this list does not reflect the date and time of the last backup This agent must be configured before you can continue The wizard below will help you accomplish this in a few easy steps Configuration mode selection Recover D Configure a new Hyper V Agent Select an offline agent to recover from Gives you the option to register an agent with AC DEV 1 31 2014 10 14 34 AM 05 00 M Hyper V Server Recover a previous Hyper V Agent Gives you the option to recover a registratio
15. disk The Hyper V Agent does not back up VMs that contain shared virtual hard disks Shared virtual hard disks became available in Windows Server 2012 R2 Live migration fails If a VM is currently being backed up live migration could fail for the VM VM restore fails You cannot restore a VM that was backed up in a Windows 2012 R2 environment to a Windows 2012 environment 57 Hyper V Agent 7 4 User Guide Appendix A Alternate Hyper V Agent deployments A1 Alternate deployment for protecting a Hyper V cluster As described in Recommended deployment for protecting a Hyper V cluster we recommend installing the Hyper V Agent Management service on a VM in the cluster and installing the Host service on each host in the cluster If you do not want to deploy a VM in the cluster for the Management service you can install the Management service directly on a Hyper V host or on any supported Windows server that has local network access to the cluster The server can be a physical or virtual machine that is on the same domain as the Hyper V cluster You must install the Hyper V Agent Host service on at least one host in a protected cluster You do not have to install the Host service on every host in a cluster since a single Host service can back up VMs on all hosts However this configuration is not optimal for the following reasons e If the Host service is installed on only one host all backup operations are delegated to the s
16. e Hyper V Agent Management service See Install the Hyper V Agent Management service e Hyper V Agent Host service See Install the Hyper V Agent Host service Note You do not have to install Agent software on individual VMs in the Hyper V environment You can then configure the Hyper V Agent to communicate with the Hyper V environment and add a vault connection See Configure the Hyper V Agent If a previous version of the Hyper V Agent is installed you can upgrade the Agent See Upgrade the Hyper V Agent 3 1 Install the Hyper V Agent Management service The Hyper V Agent Management service is installed on a server that has local network access to a protected Hyper V environment See Recommended deployment for protecting a Hyper V cluster and Recommended deployment for protecting a Hyper V standalone host By default the Management service communicates with Host services using port 5444 However you can specify a custom port during the Management service installation Ensure that the correct inbound port is open Note To install the Management service silently see Install the Hyper V Agent Management service in silent mode To install the Hyper V Agent Management service 1 On the server or VM where you want to install the Management service double click the Hyper V Agent Management service installation kit 2 Onthe Welcome page click Next 3 On the License Agreement page read the license agreement Click accept the te
17. lists available computers 2 Select the check box to the left of each protected environment for which you want to enable or disable all schedules 38 Hyper V Agent 7 4 User Guide 3 5 9 In the Actions list do one of the following e To enable all schedules for the selected computers click Enable Scheduled Jobs e To disable all schedules for the selected computers click Disable Scheduled Jobs Perform an ad hoc backup After a backup job is created you can run the backup at any time even if the job is scheduled to run at specific times To perform an ad hoc backup 1 On the navigation bar click Computers A grid lists available computers Find the computer with the backup job that you want to run and expand its view by clicking the computer row Click the Jobs tab Find the job that you want to run and click Run Job in its Select Action menu The Run Job dialog box shows the default settings for the backup Note Beginning at this point you can click Start Backup to immediately start the job If you prefer you can change backup options before running the job In the Retention Scheme list click a retention type The retention type specifies the number of days a backup is kept on the vault how many copies of a backup are stored online and how long backup data is stored offline Do one of the following e To allow the backup job to run without a time limit clear the Use Deferring check
18. schedule so it does not run clear Enable 7 To remove the schedule click Delete Schedule 8 If there is more than one schedule row you can use the Priority arrows to move a schedule higher or lower in the list Schedules that are higher in the list have higher priority than schedules lower in the list If a job is scheduled to run at the same time by multiple schedules the job only runs once at the scheduled time If the schedules have different retention types the job only runs with the retention type of the schedule that is highest in the list 36 Hyper V Agent 7 4 User Guide Create New Job Name Virtual Machines HyperVBackup Schedule Description Add Schedule Destination a Retention Schedule Enable Priority vault Encryption Password Monthly 11 00 PM Last Daily 11 00 PM Su Mo Tu We Th F Confirm Password Password Hint 9 Click Save 5 7 Delete a backup job You can delete a backup job When you delete a backup job for most EVault Agents you can also request that the job s backup data be deleted from the vault When you delete a Hyper V job you cannot request that backup data from the job be deleted from the vault A protected Hyper V VM can be restored even if its backup job no longer exists See Restore Hyper V VMs To delete a backup job 1 On the navigation bar click Computers The Computers page shows registered computers 2 Find the Agent with the job t
19. where the Host service is installed When restoring a Hyper V VM in a cluster you must choose a host where the Host service is running or the restore will fail If the Host service is not installed on the node where you want to restore a VM you can restore the VM to a node that has the Host service and then migrate the VM to another node in the cluster Note Portal does not indicate which nodes in a cluster have the Host service installed All hosts in a Hyper V cluster appear on the Hosts tab on the Computer page even if the Host service is only installed on some of the hosts In the event of a disaster a QSM vault can be used to provide local vault access for restoring VMs that are backed up to the EVault cloud 41 Hyper V Agent 7 4 User Guide To restore Hyper V VMs 1 On the navigation bar click Computers A grid lists available computers 2 Find the Hyper V environment with the VM that you want to restore and expand the environment view by clicking the row 3 Click the Virtual Machines tab The Virtual Machines tab shows all VMs in the Hyper V environment hyper 7 40 7063 Hyper V Server Windows Ser oK Online rtual Machines Hosts Jobs Vault Settings Advanced w Current Inventory Show 25 v records per page Refresh Virtual Machine Job Backup Status Last Run Size Actions Emergent Completed today at 258 PM 21568 Select Action o today at 417 PM 8 0468 Select Action
20. 4 10 02 18 AM 07 00 List of processes on the date selected in Backup 5 22 2014 12 16 24 AM 07 00 the calendar The History Logs window shows the selected log 8 3 View a Hyper V VM s backup history and logs Hyper V backup jobs can include multiple VMs but each VM is backed up as a separate task on the vault You can view historical backup information and logs separately for each Hyper V VM To view a Hyper V VM s backup history and logs 1 On the navigation bar click Computers The Computers page shows registered Agents 2 Find the Hyper V Agent for which you want to view the backup history and logs and click the row to expand its view 3 Click the Virtual Machines tab The Virtual Machines tab shows VMs in the Hyper V cluster or standalone host The Backup Status column shows the backup status of each VM Possible statuses include Completed Indicates that the VM has been backed up oO Missed 53 Hyper V Agent 7 4 User Guide Oo Deferred Note Hyper V VM backups can be deferred when they are run manually ad hoc but not when they are scheduled to run e we Not Protected Indicates that the VM is not part of a backup job Never Run Indicates that the VM is part of a backup job that was never run e D In Progress e Failed Cancelled o a hv host 01 7 30 5141 Hyper V Server Warning Online Fi
21. EVault Software Hyper V Agent 7 4 User Guide Revision This manual has been updated for Version 7 4 Software Version 7 40 October 2014 2014 EVault Inc EVault A Seagate Company makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose Furthermore EVault reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of EVault to notify any person of such revision of changes All companies names and data used in examples herein are fictitious unless otherwise noted No part of this document may be reproduced transmitted transcribed stored in a retrieval System or translated into any language including computer language in any form or by any means electronic mechanic magnetic optical chemical or otherwise without prior written permission of EVault A Seagate Company c o Corporation Trust Center 1209 Orange Street Wilmington New Castle Delaware 19801 www evault com EVault EVault Software EVault SaaS and EVault DeltaPro are registered trademarks of EVault Inc All other products or company names mentioned in this document are trademarks or registered trademarks of their respective owners Acknowledgements Two encryption methods DES and TripleDES include cryptographic software written by Eric Young The Windows versions of these a
22. M will not overwrite the existing VM Two VMs in a Hyper V environment can have the same GUID if they are on separate hosts and are not configured for high availability e To restore the VM with its original GUID unless a VM with the original GUID exists in the Hyper V environment click Assign new if original exists If a VM with the original GUID exists in the Hyper V environment the VM is restored with a new GUID e Click the VM row to expand its view Do one or more of the following e To specify a host for the restored VM click a host in the Host list e To power on the VM after it is restored select Power on VM e To leave the restored VM powered off clear Power on VM e To connect the restored VM to the network select Enable network connectivity If Enable network connectivity is selected and the VM has a network adapter with the same name as a network adapter on the host the VM will be automatically connected to the network e To restore the VM without network connectivity clear Enable network connectivity 8 Click Run Restore 44 Hyper V Agent 7 4 User Guide 7 Recover jobs and settings from an offline Hyper V Agent If a Hyper V Agent goes offline because it is lost or unavailable you can install a new Management service and recover jobs and settings from the offline Agent You can then enter credentials run backup jobs from the original Agent and restore VMs that were protected by the Agent You can recover
23. Name S L lt localeID gt V qn L v logFileName HOST managementServiceAddress PORT portNumber INSTALLDIR installPath Where installKitName is the name of the Hyper V Agent Host service installation kit Hyper V_Agent_Host x XX XXXX EX X XX XXXX represents the Agent version number The following table lists and describes command parameters Parameter Description L lt localeID gt Optional Specifies the language for installation log messages The default value 1033 English United States is the only available value Note Only English is supported with Hyper V Agent 7 40 However this version of the Agent can be installed on a non English operating system Support for other languages will be available in a subsequent release logFileName Optional Specifies the path and name of the installation log file If the logFileName includes spaces enclose the value in double quotation marks Example C Logs My Log txt If you do not specify a logFileName the installation log is saved in the Windows installer default location usually the user s temp directory HOST managementServiceAddre Ss Specifies the host name or IP address of the Hyper V Agent Management service that assigns work to the Host service Example HOST 192 0 2 234 Specifying the host name is recommended This will allow DNS to handle IP address changes 62 H
24. On the Destination Folder page do one of the following e To install the Host service in the default location C Program Files EVault Software click Next e To specify another installation location click Change In the Change Current Destination Folder window browse to the new installation location or enter a folder in the Folder name box Click OK On the Destination Folder page click Next On the Connect with Hyper V Agent Management service page in the Network Address box enter the host name or IP address of the Hyper V Agent Management service that will assign work to the Host service Specifying the host name of the Management service is recommended This will allow DNS to handle IP address changes In the Port box enter the port number for communicating with the Hyper V Agent Management service By default the Management service communicates with Host services using port 5444 However a custom port might have been specified during the Management service installation Click Next Click Install On the Wizard Completed page click Finish Upgrade the Hyper V Agent To upgrade a Hyper V Agent first upgrade the Management service and then upgrade all Host services in the Hyper V environment See Upgrade the Hyper V Agent Management service and Upgrade the Hyper V Agent Host service Note All services must be upgraded to the same version Earlier service versions cannot be used with later service versions
25. See Disable or enable all scheduled backup jobs 12 Hyper V Agent 7 4 User Guide 4 Configure the Hyper V Agent After the Hyper V Agent Management service is installed and registered with EVault Portal you must configure the Agent by doing the following Provide credentials for authenticating with the Hyper V environment that you want to protect The user should be an Active Directory domain user with administrative rights to the Hyper V cluster or standalone host Add a vault connection A vault connection provides vault information and credentials so that the Agent can back up data to and restore data from the vault You can also change Hyper V credentials and add vault connections after the initial configuration See Change credentials or the network address for accessing Hyper V and Add a vault connection Optionally you can do the following Add a description for the Agent The description appears for the Hyper V environment on the Computers page See Add a description Add retention types that specify how long backups are kept on the vault See Add retention types Configure email notifications so that users receive emails when backups complete fail or have errors See Configure email notifications Specify the amount of bandwidth consumed by backups See Configure bandwidth throttling To configure the Hyper V Agent 1 On the navigation bar in Portal click Computers The Computers page shows regist
26. To view logs for a job click the job status For more information see View process logs View process logs To determine whether a backup or restore completed successfully or to determine why a process failed vi j ou can view a job s process logs To view process logs 1 On the navigation bar click Computers The Computers page shows registered Agents 51 Hyper V Agent 7 4 User Guide 2 Find the Agent for which you want to view logs and click the row to expand its view On the Jobs tab the Last Backup Status column shows the status of each backup job 3 To view log files for a job do one of the following e Inthe job s Select Action menu click History Logs e Inthe Last Backup Status column click the job status The History Logs window shows the log for the most recent process on the computer backup restore or synchronization Note Synchronization is a process that occurs automatically before a backup The Agent synchronizes information with the vault to determine which safesets are online History Logs AGENT Job3 Job Details ce File Choose a Lo 2014 12 17 43 AM o ily 22 May 00 00 06 BKUP I 0438 Download 22 May 00 00 06 BKU 14 Agent Version 7 32 3423 Apr 17 2014 21 11 16 22 May 00 00 06 BKUP 04127 job started at 22 May 2014 00 00 06 0700 22 May 00 00 06 BKU job name Job3 02 20 V 9677 lt Volume 8806ba64 2634 11e3 9e31 806e6f6e6963 gt lt gt is added to
27. Use fixed size VHDXs or VHDs If a VM includes a dynamically expanding virtual hard disk VHDX or VHD an incremental backup might be as large as a seed backup Consistent with Microsoft best practices we recommend not using dynamically expanding VHDXs or VHDs in a production environment See Hyper V VHD format dynamic virtual hard disks are not recommended for virtual machines that run server workloads in a production environment hard disks are not recommended for virtual machines that run server workloads in a production environment aspx Avoid using VMs with limited or no backup support The Hyper V Agent has limited support for VMs that contain e Virtual disks which are configured as dynamic disks by Windows Disk Management within a VM e FAT or FAT32 volumes e Linux guest OS e No Hyper V Integration Services running During a backup Hyper V puts these VMs into a saved state for a brief period of time while capturing a VSS snapshot The backup will be crash consistent not application consistent See Planning for Backup http technet microsoft com en us library dd252619 WS 10 aspx During a backup the Hyper V Agent skips VMs that contain mixed storage or share virtual hard disks See Understanding and troubleshooting Hyper V processes Hyper V Agent 7 4 User Guide 3 Install and upgrade the Hyper V Agent To protect a Microsoft Hyper V environment you must install two Hyper V Agent components
28. V Agent 7 4 User Guide 10 11 12 13 14 15 7 1 To determine whether the credentials are valid click Verify Information If the credentials are valid click Okay in the confirmation message box Click Save In the confirmation message box click Okay On the Vault Settings tab enter the password for each vault connection See Add a vault connection On the Jobs tab edit each job enter its encryption password and click Save In the confirmation message box click Continue See Edit a Hyper V backup job If required on the Advanced tab on the Notifications tab enter the SMTP password See Configure email notifications Click Save In the confirmation message box click Okay If the Hyper V Agent Management service now has a new IP address check whether Agent Host services are communicating with the Management service If not reinstall the Host service on each Hyper V cluster host or standalone node See Install the Hyper V Agent Host service If the protected Hyper V VMs exist in the environment i e the VMs were restored after a disaster or remained intact when the Hyper V Agent was lost you can re enable all scheduled backup jobs for the Hyper V environment See Disable or enable all scheduled backup jobs Hyper V disaster recovery The following table outlines the process of recovering a protected Hyper V environment when one or more of the following components are lost Hyper V Agent Manag
29. a Hyper V cluster To protect a Hyper V cluster EVault recommends the following e install the Management service on a VM in the cluster and enable High Availability on the VM e Install the Host service on each host in the cluster If the Host service is installed on all hosts in the cluster the Hyper V Agent Management service automatically distributes the backup processing load across the hosts If you do not want to deploy a VM in the cluster for the Management service see the alternate deployment described in Alternate deployment for protecting a Hyper V cluster For supported platform information see the Hyper V Agent release notes Note You cannot install the Host service on a host where the Agent for Microsoft Windows is installed The Windows Agent is not compatible with the Host service 2 4 Recommended deployment for protecting a Hyper V standalone host To protect a standalone Hyper V host EVault recommends installing both the Management service and Host service on the standalone host If you want to minimize performance impact in the environment or do not want to open the virtualized environment for Portal or vault access see the alternate deployment method described in Alternate deployment for a protecting a Hyper V standalone host For supported platform information see the Hyper V Agent release notes Note You cannot install the Agent for Microsoft Windows on the standalone host The Windows Agent is not compati
30. ach VM that you are restoring do the following in the VM row e Optional In the New VM Name box enter a name for the restored VM If you do not enter a name the VM is restored with its original name e Inthe Backup Set list click the backup from which you want to restore If you did not enter the same password for all VMs enter the password in the Encryption Password box Click Apply e Inthe Destination list click the destination for the VM files If you want to specify a folder for restoring the VM files enter the folder in the Sub Path box Click Apply You can enter subfolders in the Sub Path box e g folder subfolder1 subfolder2 In a Hyper V cluster you can restore files to a CSV In a standalone host you can restore files to volumes on direct attached storage 43 Hyper V Agent 7 4 User Guide You cannot restore VMs to system volumes System volumes do not appear in the Destination list If you do not specify a folder the VM is restored to a folder with the VM name Note Hyper V VM files will not be restored to a non empty folder If a folder exists it will create a new folder with the same name followed by a number in brackets e Inthe VM Identity list do one of the following e To restore the VM with a new GUID click Assign new identity e To restore the VM with its original GUID click Restore original identity Note If a VM with the original GUID exists in the Hyper V environment the restored V
31. ackup jobs if they have been missed Ask for confirmation before starting missed Shutdown Options Eau ei Prevent shutdown when backups are running 5 Click Save 4 4 Add retention types Retention types specify the number of days a backup is kept on the vault how many copies of a backup are stored online and how long backup data is stored offline Portal Admin users and regular users can add retention types for an Agent To add a retention type 1 On the navigation bar click Computers 2 Find the Agent for which you want to add a retention type and click the row to expand its view 3 On the Advanced tab click the Retention Types tab 4 Click Create Retention Type The Retention Type dialog box appears 18 Hyper V Agent 7 4 User Guide Retention Type Retention Details Name Po Backup Retention Number of Backup Copies to Keep C Create archived copies Keep Archives For Save Cancel 5 Complete the following fields Name Specifies a name for the retention type Backup Retention Specifies the number of days a safeset is kept on the vault A safeset is deleted when its expiry date is reached Note Safesets are not deleted unless the specified number of copies online has also been exceeded Number of Backup Copies to Keep Specifies how many safesets from a backup job are stored online It functions in a first in first out m
32. anner Once the number of safesets is exceeded the oldest safesets are automatically deleted until the actual number of safesets matches the definition Note Safesets are not deleted unless the specified number of days online has also been exceeded Create archived copies Select this check box to create archived copies of safesets 19 Hyper V Agent 7 4 User Guide Keep Archives For Specifies how long the data is stored offline Archive storage is used to store data offline for long periods of time This data is not immediately accessible since it is stored remotely A greater amount of time is required to restore from archive media Typically only long term data archives are stored offline The parameters for archived data are from 365 to 9999 days Assuming that at least one successful backup has been completed for the job there will never be less than one copy of its backup online This is true even if all retention settings are zero expiry conditions have been met and the job definition is deleted from your system Deleting the job does not affect data on the vault Only your service provider can remove jobs and their associated data from the vault This is a safeguard against accidental or malicious destruction of data 6 Click Save 4 5 Configure email notifications Email notifications can be configured so that someone receives emails when backups and restores fail or finish Noti
33. atus information on the Computer page On the Computer page in Portal you can view status information for protected environments and their jobs To view status information on the Computer page 1 On the navigation bar click Computers The Computers page shows registered Agents The Availability column indicates whether each Agent is online or offline Online computers are in contact with Portal while offline computers are not currently available A computer can be offline if it is turned off if the Agent has been uninstalled from the system or if the system has been lost The Status column shows the status of each computer Possible statuses include e OK Indicates that all jobs on the computer ran without errors or warnings 0 Warning Indicates that one or more of the computer s jobs completed with warnings e A attention Indicates that one or more of the computer s jobs failed or completed with errors Unconfigured Indicates that no jobs have been created for the computer Find the Agent for which you want to view logs and click the row to expand its view View the Jobs tab If a backup or restore is running for a job an In Progress symbol amp appears beside the job name Name Description Last Backup Status Last Run Job yJob Job Completed today at 9 59 AM a lt n VM Job Completed today at 10 00 AM 50 Hyper V Agent 7 4 User Guide 8 2 If you click the symbol the Process De
34. b to change one or more of the following e VMs that are included in the job e Encryption password and password hint e Schedules and retention types You cannot change a backup job s name or vault connection Because each VM is backed up as a separate safeset on the vault you can move a VM from one backup job to another without causing the backup to reseed As long as both jobs use the same encryption password and back up VMs to the same vault moving a VM from one job to another does not cause the VM to reseed To edit a Hyper V backup job 1 On the navigation bar click Computers The Computers page shows registered computers and environments 2 Click the Hyper V environment row a 3 Doone of the following e On the Jobs tab in the Jobs column click the name of the job that you want to edit e On the Jobs tab find the job that you want to edit In its Select Action menu click Edit Job e On the Virtual Machines tab in the Jobs column click the name of the job that you want to edit e On the Virtual Machines tab click a VM that belongs to the job you want to edit In the Select Action menu click Edit Job 4 Inthe Edit Job dialog box change the job description encryption password or password hint if desired 31 Hyper V Agent 7 4 User Guide VMs in the backup job appear in the Protected by this job box Edit Job Virtual Machines Description Unprotected Protected by this job Destination l Passwor
35. ble with the Host service 2 5 Best practices in a protected Hyper V environment For best performance consider the following best practices for a Hyper V environment that is protected by the Hyper V Agent Enable CSV Cache In a failover cluster enabling the CSV cache might improve Hyper V Agent backup performance Microsoft recommends enabling the CSV cache for read intensive workloads See Use Cluster Shared Volumes ina Failover Cluster http technet microsoft com en us library jj612868 aspx and How to Enable CSV Cache http blogs msdn com b clustering archive 2012 03 22 10286676 aspx Hyper V Agent 7 4 User Guide Clean up snapshots and checkpoints before backups The Hyper V Agent backs up and restores user level snapshots or checkpoints with VMs which can take a significant amount of time Note Snapshots in Windows 2012 are the same as checkpoints in Windows Server 2012 R2 Consistent with Microsoft best practices we recommend not taking user level snapshots or creating checkpoints of VMs that will be backed up in a production environment except in a transient fashion When it is necessary to take a snapshot or create a checkpoint of a protected VM remove the snapshot or checkpoint before the next backup See Hyper V Avoid using snapshots on a virtual machine that runs a server workload in a production environment hitp technet microsoft com en us library ee941140 v ws 10 aspx
36. box e To specify a maximum amount of time that the backup job can run select the Use Deferring checkbox From the Backup time window list select Minutes or Hours In the adjacent box type the maximum number of minutes or hours that the job can run 39 Hyper V Agent 7 4 User Guide Note When deferring is used the backup job does not back up any new data after the specified amount of time even if some data is not backed up Changes to data that was previously backed up will be backed up regardless of the backup time window 7 Click Start Backup The Process Details dialog box shows the backup progress and indicates when the backup is completed 8 If you want to stop the backup click Stop 9 To close the Process Details dialog box click Close 40 Hyper V Agent 7 4 User Guide 6 Restore Hyper V VMs You can restore one or more virtual machines VMs from a Hyper V backup In a single request you can restore VMs that were backed up using multiple Hyper V backup jobs even if each job has a different encryption password You can restore a protected VM even if the original VM no longer exists in the Hyper V environment and its backup job no longer exists Restored VMs are imported automatically into Hyper V Restored VMs keep their original names unless you specify new VM names during the restore process If you restore VMs from a Windows 2012 environment to a Windows 2012 R2 environment the restored VMs ar
37. can be backed up concurrently e Backup processing for individual VMs can be distributed across multiple nodes in a Hyper V cluster e The Hyper V Agent is scalable in large Hyper V environments e AVM can be moved to another job without reseeding if encryption credentials are the same in both jobs e A protected VM can be restored even if its backup job has been deleted e If a protected VM has been deleted from your environment and is no longer associated with a backup job you can still see the VM in Portal in the protected view and restore the VM from the vault After restoring the VM you can add the VM to a new job with the same encryption password and continue to back up the VM without reseeding All Hyper V backup data is protected using AES 256 encryption 5 1 Best practices for backing up Hyper V VMs Consider the following best practices when creating and running Hyper V backup jobs Include more than one VM in a backup job Avoid creating a separate backup job for each VM The Agent is optimized for backing up multiple VMs concurrently in one job 24 Hyper V Agent 7 4 User Guide Include VMs on the same CSV in the same backup job Where possible include VMs on the same CSV in the same backup job If multiple jobs are needed to back up VMs on the same set of CSVs stagger the job schedules so that the jobs do not run at the same time Avoid reseeds After the first backup for a Hyper V VM the Agent only send
38. ckup To view information for a different safeset click the calendar button E in the calendar that appears click the date of the backup for which you want to view information In the list of backups on the selected date click the backup for which you want to view information The tab shows information for the selected backup 55 Hyper V Agent 7 4 User Guide History Logs hv host 01 VM SESS History Log File 4 1 20 AM amp Catalog Number 000000048 Location 192 168 0 250 Status Online Backup Time Storage Size Backup Type Retention Encrypted Compressed Media Type Tape Label Expiry 5 29 2014 1 20 AM 8 4 Hyper V Agent logs and configuration files Hyper V Agent logs are saved in the Hyper V Agent Management service installation folder in a Data subfolder By default the location is C Program Files EVault Software Hyper V Agent Management Data logs This folder includes logs from both the Hyper V Agent Management and Host services Host services upload logs to the Management service after a process ends Note Because Hyper V Agent Host services perform backups and restores and do not upload logs until a process is completed you cannot view backup or restore logs on the Management service computer while processes are running Because the lt ManagementServicelnstallFolder gt Data folder also contains Hyper V Agent configuration information it can provide all information necessar
39. d Confirm Password Password Hint s Schedule 5 Do one or more of the following to add VMs to or remove VMs from the job e To find one or more VMs in the Unprotected or Protected box enter characters from the VM names in the associated Filter VMs box e To add all VMs in the Unprotected box to the backup job click Protect all e To add some VMs in the Unprotected box to the backup job select the VMs in the Unprotected box and then click Protect selected To select multiple VMs in the list press CTRL and click the VM names To select multiple consecutive VMs in the list press Shift and then click the first and last VM that you want to select e To remove all VMs in the Protected by this job box from the backup job click Unprotect all amp e To remove some VMs in the Protected by this job box from the backup job select the VMs in the Protected by this job box and then click Unprotect selected To select multiple VMs in the list press CTRL and click the VM names To select multiple consecutive VMs in the list press Shift and then click the first and last VM that you want to select 32 Hyper V Agent 7 4 User Guide Ensure that each VM that you want to include in the backup job appears in the Protected by this job box Note When editing a Hyper V job you cannot select VMs from a list to include or exclude as you can when adding a job See Add a Hyper V backup job by selecting VMs 6 To schedule the back
40. dd Vault The Vault Settings dialog box appears Vault Settings Basic Settings Advanced Settings Vault Profile Agent Host Name Vault Name Port Number Vault 2546 Address Attempt to Reconnect Every seconds Account Abort Reconnect Retries After minutes Username M Enable over the wire encryption for transmission to from the vault Password 16 Hyper V Agent 7 4 User Guide 4 Doone of the following e Inthe Vault Name box enter a name for the vault connection In the Address box enter the vault host name or IP address In the Account Username and Password boxes enter an account and credentials for backing up data to and restoring data from the vault Specifying the host name of the vault is recommended This will allow DNS to handle IP address changes e If a policy with a vault profile is assigned to the computer click the Vault Profile list In the list click the vault profile that you want to add for the computer Vault information and credentials are then populated in the Vault Settings dialog box For more information about policies see the Portal online help 5 Optional Change one or more of the following Advanced Settings for the vault connection e Agent Host Name Name of the computer on the vault For a Hyper V environment by default the name is the fully qualified domain name of the cluster or standalone host e Port Number Port used to connect to the vault e Attemp
41. de the Hyper VAEN nt i depen Hace a aa eee a heads 10 4 Configure the Hyper V Agent sssesssssessssossssossessoossssoosessossesscosessoossssoosessoosessessesseeseseoe 13 4 1 Change credentials or the network address for accessing Hyper V ssscccceeeseesees 15 4 2 Add a Vault CONNECTHION ccccccsssececssssececsesnececsesaeeecseaeeecseaueeecsesuececsesaeeecseueeeseeaeeeeses 16 4 3 Add ta COSCHIPUIONN ac2 25 eels ccecees oes beac E E E E teen 17 4 4 Add r tention ty Pes aore arn onea sav bes ecenks cde ch tae a e aa a aia aaa ia a E EEEE 18 4 5 Configureem il NOtITICAtIONS iesenii netia a a a a a ene 20 4 6 Configure bandwidth throttling cccccssssccccecessesssseceeeescessesseaeseeeescessesneaeeeeeeeseeeas 22 5 Add and run Hyper V backup jobS sessessessessssossseoossssoossssossessoossssoossssooseseoosessoosesesssese 24 5 1 Best practices for backing up Hyper V VMS ccsssccccccscsssessssececececessesseaeseseessesseesnaeees 24 5 2 Best practices for seeding Hyper V VM backups s ssssssssssssssssssssersrsssseserensnssssesereese 25 5 3 AddaiHyper V back p jobi anica teas Seven a e a a ia s cats 26 5 4 Add a Hyper V backup job by selecting VMS ccccccscsssssssecececessesssseseeeeecessessnseeeeeeeens 28 5 5 Edit a Hyper V backup j biia i arera EAA E AA E EE A EAA E AR ER 31 5 6 Add or edit a schedule for a Hyper V backup job cccccsccccccessesssseseceeecessessnteaeeeesens 33 5 7
42. duled Hyper V backup jobs it is best not to seed VMs in a scheduled job If you add a VM to an existing scheduled job the job could take a long time and potentially cause the backup to overlap the next scheduled backup To seed a VM backup EVault recommends creating a temporary job with the VM You can seed the VM backup by running the temporary job manually ad hoc with deferring and then move the VM to an existing 25 Hyper V Agent 7 4 User Guide scheduled job To avoid reseeding the encryption password and vault must be the same in the temporary job and in the job where you eventually add the VM Note Normally it is best to include multiple VMs in a single backup job See Best practices for backing up Hyper V VMs To create and run a job manually ad hoc to seed a VM backup 1 5 3 Create a temporary backup job that includes the VM that you want to seed Ensure that the encryption password and vault for the temporary job are the same as the password and vault for the job where you eventually want to add the VM See Add a Hyper V backup job or Add a Hyper V backup job by selecting VMs Run the temporary job manually ad hoc You can enable deferring when running the job manually and run the job multiple times until the VM backup is completely seeded See Perform an ad hoc backup After the VM backup is seeded move the VM out of the temporary job and add it into an existing scheduled job See Edit a Hyper V
43. e restored as Generation 1 VMs You cannot restore VMs from a Windows 2012 R2 environment to a Windows 2012 environment Each VM has a unique identifier You can restore a VM with its original internal identification number GUID with a new GUID or with a new GUID if a VM with the original GUID exists in the Hyper V environment Note A restored Hyper V VM never overwrites an existing VM When restoring a VM you must specify a destination for the VM files If you are restoring to a Hyper V cluster available destinations are Cluster Shared Volumes CSV found in the Failover Cluster Manager If you are restoring to a standalone host available destinations are volumes on direct attached storage You can also specify a datastore folder for the files If you do not specify a folder a new folder with the same name as the VM is created for the VM files All of a VM s disks are restored in a single location even if the disks originally resided on different volumes and you select the original host and datastore Hyper V VM files will not be restored to a non empty folder If a folder exists it will create a new folder If you force a custom folder and this folder exists the restore of that specific VM will fail If you stop a restore process VMs that are restored before you stop the process remain in the Hyper V environment VMs that are not fully restored when you stop the process are not restored You can only restore a Hyper V VM to a host
44. e Hyper V Agent Management service installation kit Hyper V_Agent_Management x xx xxxx exe X XX XXXX represents the Agent version number The following table lists and describes command parameters Parameter Description L lt localeID gt Optional Specifies the language for uninstallation log messages The default value 1033 English United States is the only available value Note Only English is supported with Hyper V Agent version 7 30 However this version of the Agent can be installed on a non English operating system Support for other languages will be available in a subsequent release LogFileName Optional Specifies the path and name of the uninstallation log file If the logFileName includes spaces enclose the value in double quotation marks Example C Logs My Log txt If you do not specify a logFileName the uninstallation log is saved in the Windows installer default location usually the user s temp directory 65 Hyper V Agent 7 4 User Guide B7 Uninstall the Hyper V Agent Host service Do not uninstall the Host service when a backup or restore operation is running Uninstalling the Agent Host service during any operation will leave the Agent in an inconsistent state You can later reinstall an Agent Host Service without having to restore state information as long as no backup or restore operations are in progress Note You can also uninstall the Host service
45. e standalone host For supported platform information see the Hyper V Agent release notes Note The Agent for Microsoft Windows cannot be installed on the standalone host 59 Hyper V Agent 7 4 User Guide Appendix B Install upgrade and uninstall the Hyper V Agent This appendix includes procedures for installing and upgrading Hyper V Agent components silently and for uninstalling Hyper V Agent components For other installation information and procedures see Install and upgrade the Hyper V Agent B1 Install the Hyper V Agent Management service in silent mode To install the Management service in silent mode run the following command in the directory where the installation kit is located installKitName S L lt localeID gt V qn L v logFileName UIREG NETADDRESS webUIAddress UIREG PORT webUIportNumber UIREG USERNAME webUIUser UIREG PASSWORD webUIUserPassword COORDINATOR _ PORT portNumber INSTALL DIR installPath Where installKitName is the name of the Hyper V Agent Management service installation kit Hyper V_Agent_Management x xx xxxx exe X XX XXXX represents the Agent version number The following table lists and describes command parameters Parameter Description L lt localeID gt Optional Specifies the language for installation log messages The default value 1033 English United States is the only avai
46. ement service Note You do not need to recover settings separately for a Host service that is lost or becomes unavailable Host services upload their settings and logs to the Management service When you register a Host service to a Management service the Host service obtains its settings from the Management service Hyper V cluster or standalone host EVault Portal IMPORTANT Configuration data vault and job information for the Hyper V Agent is saved in the EVault Portal database To ensure that the Portal and a Hyper V environment can be fully restored if the Portal is lost the Portal database must be backed up For more information see the Portal Installation and Administration Guide 48 Hyper V Agent 7 4 User Guide Component Lost Recovery Process Hyper V Hyper V Portal Agent environment Management cluster or service standalone Install the Hyper V Agent Management service and recover configuration information and jobs from the offline Hyper V Agent See Recover jobs and settings from an offline Hyper V Agent J 1 Rebuild the lost Hyper V cluster or standalone host i e Windows server with Hyper V role 2 Install the Hyper V Agent Management service and recover configuration information and jobs from the offline Hyper V Agent Enter information for the new Hyper V environment rebuilt in Step 1 on the Cluster Credentials tab See Recover jobs and settings from an offline Hyper V Agent
47. ent that directly communicates with Portal e Hyper V Agent Host service The Host service is installed on one or more hosts in a Hyper V environment Host services perform VM backups and restores as delegated by the Management service Host services do not directly communicate with Portal so there is no need to open ports between Host services and Portal When performing a backup or restore the Host service communicates directly with the vault where the VM is backed up Even though it consists of more than one component the Hyper V Agent appears as a single system in Portal Hyper V Agent 7 4 User Guide Components for protecting a Hyper V environment Hyper V Cluster PEER Hyper V Agent Host Service Hyper V Agent Management Service Coordinate Express Recovery Appliance ERA or Virtual ERA vERA agaa SHER Agent _ Manage Agent __Host Service backups and restores Replicate data B I v Hyper i Host Service Vault Hyper V Agent 7 4 User Guide 2 Prepare for a Hyper V Agent deployment Before installing a Hyper V Agent you must do the following e Obtain a Portal account for managing the Agent See Portal for managing a Hyper V Agent e Determine the destination vaults for Hyper V backups See Vaults for Hyper V backups e Consider where to install Hyper V Agent components to protect a Hyper V cluster or standalone host See
48. ered computers Find the computer that has the Hyper V Agent Management service installed and expand its view by clicking its row Before you provide Hyper V credentials for the Agent the name of the computer where the Management service is installed appears on the Computers page The Configuration mode selection section appears Select Configure a new Hyper V Agent and then click Continue Note The Recover a previous Hyper V Agent option will also appear if offline Hyper V Agents are available This option is used to recover Hyper V Agent configuration and all backup jobs from an offline Agent instead of configuring a new Agent See Recover jobs and settings from an offline Hyper V Agent 13 Hyper V Agent 7 4 User Guide 4 Inthe Register agent with Hyper V environment section specify the following information e Inthe Address box type the host name or IP address of the Hyper V cluster or standalone host that you want to protect Specifying the host name of the cluster or standalone host is recommended This will allow DNS to handle IP address changes e Inthe Domain box type the domain of the account for authenticating with the Hyper V cluster or standalone host The domain is not required if you specify the domain in the Username box e Inthe Username box type the domain administrator account that is used to authenticate with the Hyper V cluster or standalone host You can type the account as username domain use
49. fications make it easier to monitor Agent health and manage backups You do not need to check logs to determine whether backups and restores succeeded or failed Admin users and regular users in the Portal can change email notification settings for an Agent To configure email notifications 1 On the navigation bar click Computers 2 Find the Agent for which you want to configure email notifications and click the row to expand its view 3 On the Advanced tab click the Notifications tab 20 Hyper V Agent 7 4 User Guide J On Successful Completion SMTP Settings Email From Address Recipient Address es Select one or more of the following checkboxes On Failure _ On Error Outgoing Mail Server SMTP Outgoing Server Port SMTP SMTP Credentials if required User Name Password Domain e On failure If selected users receive an email notification when a backup or restore fails If a backup fails you cannot recover any files from the backup e On error If selected users receive an email notification when a backup or restore completes with errors in the log file You cannot recover files that are backed up with errors but you can restore other files from the backup safeset e On successful completion If selected users receive an email notification when a backup or restore completes successfully You can recover files from a backup that completes even if there are
50. hat you want to delete and expand its view by clicking its row 3 Click the Jobs tab 4 Inthe Select Action menu of the job that you want to delete click Delete Job 5 Inthe confirmation dialog box click Delete 37 Hyper V Agent 7 4 User Guide 5 8 Disable or enable all scheduled backup jobs Admin users can disable or enable all scheduled backup jobs for a Hyper V environment Note You can also disable or enable a specific schedule for a backup job See Add or edit a schedule for a Hyper V backup job When you disable all scheduled jobs for a protected environment backup jobs do not run according to any schedules When jobs are disabled for a Hyper V environment you cannot view or edit schedules in the Schedule area of the Edit Job dialog box as shown in the following screenshot Edit Job Name Virtual Machines HypVjob Schedule a Scheduling is disabled for this job and Description Destination valt Encryption Password Confirm Password Enabling all scheduled jobs can be particularly useful after a Hyper V disaster recovery When you recover jobs and settings from an offline Hyper V Agent all scheduled backup jobs for the Agent are disabled When you enable scheduled jobs for a Hyper V environment jobs run according to any schedules where the Enable check box is selected in the Edit Job dialog box To enable or disable all schedules 1 On the navigation bar click Computers A grid
51. he AES 256 encryption method 6 Doone or more of the following until the Protected box shows all VMs that you want to include in the job e To find one or more VMs in the Unprotected or Protected box enter characters from the VM names in the associated Filter VMs box e To add all VMs in the Unprotected box to the backup job click Protect all e To add some VMs in the Unprotected box to the backup job select the VMs in the Unprotected box and then click Protect selected 27 Hyper V Agent 7 4 User Guide 5 4 To select multiple VMs in the list press CTRL and click the VM names To select multiple consecutive VMs in the list press Shift and then click the first and last VM that you want to select e To remove all VMs in the Protected box from the backup job click Unprotect all e To remove some VMs in the Protected box from the backup job select the VMs in the Protected box and then click Unprotect selected To select multiple VMs in the list press CTRL and click the VM names To select multiple consecutive VMs in the list press Shift and then click the first and last VM that you want to select Ensure that each VM that you want to include in the backup job appears in the Protected box To schedule the backup job to run click Schedule In the Schedule box that appears create one or more schedules See Add or edit a schedule for a Hyper V backup job Click Create Job Add a Hyper V backup job by selecting VMs
52. ingle host The load cannot be distributed e AVM that is stored ona local volume can only be backed up if the Host service installed on the host e A Hyper V VM can only be restored to a host where the Host service is running When restoring a Hyper V VM ina cluster you must choose a host where the Host service is running or the restore will fail Note If the Host service is not installed on the host where you want to restore a VM you can restore the VM to a host where the Host service is installed and then migrate the VM to the host that you want for the VM For supported platform information see the Hyper V Agent release notes Note You cannot install the Host service on a host where the Agent for Microsoft Windows is installed A2 Alternate deployment for a protecting a Hyper V standalone host As described in Recommended deployment for protecting a Hyper V standalone host we recommend installing both the Management service and Host service on the standalone host If you want to minimize performance impact in the environment or you do not want to open the virtualized environment for Portal or vault access you can install the Management service on a separate Windows server with local network access to the standalone host The Management service server can be a physical or virtual machine that is on the same domain as the Hyper V standalone host 58 Hyper V Agent 7 4 User Guide You must install the Host service on th
53. ion Types Execution Priority Advanced Notifications j Low Normal High Performance Agent Log Files Days to Limit Bandwidth Su Mo Tu We Th Fr f Se Limit Bandwidth Between the Hours 12 00 AM iv 12 00 AM M Agent time zone Max Bandwidth 0 Mbps 23 Hyper V Agent 7 4 User Guide 5 Add and run Hyper V backup jobs After a Hyper V environment is added in Portal you can create a backup job that protects VMs in the cluster or standalone host The backup job specifies virtual machines VMs to back up specifies where to save the backup data and includes schedules for running the backup job Each VM in a Hyper V environment can only be included in one backup job at a time If a VM is already included in a backup job you cannot add it to another job For best practices when creating and running backup jobs see Best practices for backing up Hyper V VMs For best practices when seeding VM backups see Best practices for seeding Hyper V VM backups To create Hyper V backup jobs see Add a Hyper V backup job or Add a Hyper V backup job by selecting VMs When you run a Hyper V Agent backup job each VM in the job is backed up as a separate job task on the vault This differs from jobs created using traditional Agents where each backup job is associated with a single task on the vault This Hyper V Agent backup job design provides a number of benefits e VMs ina single job
54. lable value Note Only English is supported with Hyper V Agent 7 40 However this version of the Agent can be installed on a non English operating system Support for other languages will be available in a subsequent release logFileName Optional Specifies the path and name of the installation log file If the logFileName includes spaces enclose the value in double quotation marks Example C Logs My Log txt If you do not specify a logFileName the installation log is saved in the Windows installer default location usually the user s temp directory 60 Hyper V Agent 7 4 User Guide Parameter Description UIREG NETADDRESS webUIAddre SS Specifies the host name or IP address of the Portal for managing the Hyper V Agent Example UIREG_NETADDRESS 192 0 2 233 Specifying the host name is recommended This will allow DNS to handle IP address changes UIREG PORT webUIportNumber Optional Specifies the port number used to communicate with Portal Example UIREG_PORT 8086 If you do not specify a webUlportNumber port 8086 is used for communicating with Portal UIREG USERNAME webUIUser Specifies the name of the Portal user associated with the Hyper V Agent Example UIREG_USERNAME user site com Sword UIREG PASSWORD webUIUserPas Specifies the password of the specified Portal user Example
55. lgorithms also include software written by Tim Hudson Bruce Schneier designed Blowfish encryption Part of the software embedded in this product is gSOAP software Portions created by gSOAP are Copyright 2001 2006 Robert A van Engelen Genivia Inc All Rights Reserved THE SOFTWARE IN THIS PRODUCT WAS IN PART PROVIDED BY GENIVIA INC AND ANY EXPRESS OR IMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHER IN CONTRACT STRICT LIABILITY OR TORT INCLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE The EVault Software Agent EVault Software CentralControl and EVault Software Director applications have the encryption option of AES Advanced Encryption Standard Advanced Encryption Standard algorithm named Rijndael pronounced Rain Doll was developed by cryptographers Dr Joan Daemen and Dr Vincent Rijmen This algorithm was chosen by the National Institute of Standards and Technology NIST of the U S Department of Commerce to be the new Federal Information Processi
56. n and all backup jobs from an offline agent You can still change all configuration and jobs after recovery 6 From the Select an offline agent to recover from list choose the Hyper V Agent from which you want to recover jobs and settings If you are sure that this is the correct offline Agent click Continue Note Do not click Continue unless the correct offline Agent is selected The offline Agent s settings and jobs are downloaded immediately after you click Continue The system downloads the offline Hyper V Agent s jobs and settings On the Computers page the computer name changes to the name of the protected Hyper V cluster or standalone host The Success section lists the passwords that you need to enter Hyper V environment vault registrations job encryption and Email notifications 7 Click OK 8 On the Cluster Credentials tab do one of the following e To continue protecting the same Hyper V environment enter the password for the specified user e To provide credentials for a new Hyper V environment so you can restore VMs to the new environment enter Hyper V environment information in the Address and Domain boxes In the Username box type the domain administrator account that is used to authenticate with the Hyper V cluster or standalone host In the Password box type the password for the specified user For more information see Change credentials or the network address for accessing Hyper V 47 Hyper
57. n individual virtual machines VMs The Agent protects VMs in standalone and clustered Hyper V environments with support for application consistent backups The Hyper V Agent concurrently backs up multiple VMs in a single backup job In a cluster backup operations can be distributed across nodes making the solution scalable in large environments Within a Hyper V cluster the Agent can back up VMs that have migrated to different nodes or to different storage You can include multiple VMs in a single backup job but each VM is backed up as a separate task on the vault As a result each VM has a single backup history even if it is moved from one backup job to another over time Each VM is independent from the job in which it is backed up When restoring a VM you do not need to remember which backup job it was in You can restore a protected VM even if its backup job has been deleted The Hyper V Agent is closely integrated with EVault Portal You must use Portal to manage the Hyper V Agent back up VMs to a secure vault and restore VMs The Portal instance can be hosted by EVault or installed on premises 1 1 Hyper V Agent components The Hyper V Agent consists of two components e Hyper V Agent Management service The Management service is a central management component that communicates with EVault Portal and delegates backup and restore operations to Hyper V Agent Host services The Management service is the only Hyper V Agent compon
58. nancial Services Windows Server 2012 R2 x64 Virtual Machines Hosts Jobs Vault Settings Advanced Current Inventory X Show 25 records per page Refresh Virtual Machine Backup Status Last Run Size Actions o All X VM13 af Not Protected VM182 wf Not Protected vM570 HypVJob Never Run Select Action X VM73 af Not Protected vMess af Not Protected vM Job Completed todayat1 20AM_ 4 04MB Select Action X vMi af Not Protected 4 Click the Backup Status column of the VM for which you want to view the backup history and logs The History Logs window lists log files from the date selected in the calendar 54 Hyper V Agent 7 4 User Guide History Logs hv host 01 VM Backup History ee File Choose a Log File amp May 2014 a Wed May 21 2014 Tu We Th Fr Sa SYNCHXLOG 5 21 2014 10 20 39 PM 07 00 00000048 XLOG 5 21 2014 10 20 39 PM 07 00 00000047 XLOG 5 21 2014 10 20 07 PM 07 00 5 To view a log file for a process on the selected date click the process The log file appears 6 To view a log file for a different date click the calendar button E in the calendar that appears click the date of the log that you want to view In the list of processes on the selected date click the process for which you want to view the log The log file appears 7 To view summary information for a particular VM backup click the Backup History tab The tab shows information for the VM s most recent ba
59. ng Standard FIPS The EVault Software Agents and EVault Software Director applications also have the added security feature of an over the wire encryption method Hyper V Agent 7 4 User Guide Contents 1 Introduction to the Hyper V Agent cccccsssssceccssssceccesssceccssssceccesssceseesseeessssseseeessseesoes 3 1 1 Hyper V Agent components ccsssssssceccceccecssesescececeaneesssseeceeeeeeuaassescececessageseeeseeeaeaqags 3 2 Prepare for a Hyper V Agent deployment sssscccsssssscccsssscccessssecesessssceecssssccensscseeansnss 5 2 1 Portal for managing a Hyper V Agent cccccecssssececececeesesssaececececseseaeaeeeesceseessaeaeeeesens 5 2 2 Vaults for Hyper V DaCkUpS cccsessssccececsssessnnscecececesseseeaeeeeeeseesseseeaeseeeesessseseaaeaeeeesens 5 2 3 Recommended deployment for protecting a Hyper V CIUStEM cccccccccecesessssteseeeeeens 6 2 4 Recommended deployment for protecting a Hyper V standalone host sccccceees 6 2 5 Best practices in a protected Hyper V EnvirOnMent ccccccccccssssssssseeeceeessessstsseeeeeens 6 3 Installand upgrade the Hyper V Agent cccssssssccsssssscecssssscccessseceesssseceenssssceeessssceeeenss 8 3 1 Install the Hyper V Agent Management service cccceessssecececeeessesneseceeeeeseessaeaeeeeeens 8 3 2 Install the Hyper V Agent Host SCrViC cccccsessscccececeesesseaeeececeseeseaeaeeeeeceseessasaeeeesens 9 3 3 Upgra
60. ntil the Protected by this job box shows all VMs that you want to include in the job e To find one or more VMs in the Unprotected or Protected by this job box enter characters from the VM names in the associated Filter VMs box e To add all VMs in the Unprotected box to the backup job click Protect all e To add some VMs in the Unprotected box to the backup job select the VMs in the Unprotected box and then click Protect selected To select multiple VMs in the list press CTRL and click the VM names To select multiple consecutive VMs in the list press Shift and then click the first and last VM that you want to select e To remove all VMs in the Protected box from the backup job click Unprotect all e To remove some VMs in the Protected box from the backup job select the VMs in the Protected box and then click Unprotect selected To select multiple VMs in the list press CTRL and click the VM names To select multiple consecutive VMs in the list press Shift and then click the first and last VM that you want to select 30 Hyper V Agent 7 4 User Guide Ensure that each VM that you want to include in the backup job appears in the Protected by this job box 9 To schedule the backup job to run click Schedule In the Schedule box that appears create one or more schedules See Add or edit a schedule for a Hyper V backup job 10 Click Create Job 5 5 Edit a Hyper V backup job You can edit an existing Hyper V backup jo
61. ommand parameters Parameter Description logFileName Optional Specifies the path and name of the installation log file If the logFileName includes spaces enclose the value in double quotation marks Example C Logs My Log txt If you do not specify a logFileName the installation log is saved in the Windows installer default location usually the user s temp directory 63 Hyper V Agent 7 4 User Guide For example to install the Management service in silent mode you could run the following command Hyper V_Agent_Management x xx xxxx exe S L1033 V qn L v C logs 1l log B4 Upgrade the Hyper V Agent Host service in silent mode To upgrade the Host service in silent mode run the following command in the directory where the installation kit is located installKitName S L lt localeID gt V qn L v logFileName HOST managementServiceAddress PORT portNumber INSTALLDIR installPath Where installKitName is the name of the Hyper V Agent Host service installation kit Hyper V_Agent_Host x XX XXXX EXE X XX XXXX represents the Agent version number The following table lists and describes command parameters Parameter Description logFileName Optional Specifies the path and name of the installation log file If the logFileName includes spaces enclose the value in double quotation marks Example C Logs My Log txt If you do no
62. r a protecting a Hyper V standalone host cccccessessteeees 58 Appendix B Install upgrade and uninstall the Hyper V Agent sssssessssosssesssessossessosseseoe 60 B1 Install the Hyper V Agent Management service in silent mode cccccccesessessteees 60 B2 Install the Hyper V Agent Host service in silent MOdC cc cccccccecsssssssseceeeeesessesseaeees 62 B3 Upgrade the Hyper V Agent Management service in silent mode cccccesessessreeees 63 B4 Upgrade the Hyper V Agent Host service in silent MOdC ccccccccseesssseceeecesesssstsaeees 64 B5 Uninstall the Hyper V Agent Management ServiCe cccssssssecececessesssaeseeeessessesnaaeees 64 B6 Uninstall the Management service in silent MOdEC ceccessceceeecessesssaeceeeessessessaeens 65 B7 Uninstall the Hyper V Agent Host service ccccssccccccecesseseaececeeseessesnsaeceeeessessnsnaees 66 B8 Uninstall the Host service in silent mode ssssssssesssssssrsssssrsssesrssserrsssererssreressreensseens 66 Appendix C Understanding Hyper V backups on a vault ccccsssssccccsssseccecssseceecssseceeeeees 67 C1 Determine the name of a VM s task on the vault eee ceceeseeceeeeeeeeeseeeeeeseeeeeeseeeeaeens 67 Hyper V Agent 7 4 User Guide 1 Introduction to the Hyper V Agent EVault Agent for Hyper V provides data protection for Microsoft Hyper V environments without requiring Agent software to be installed o
63. rms in the license agreement and then click Next 4 On the Destination Folder page do one of the following e To install the Management service in the default location C Program Files EVault Software Hyper V Agent Management click Next Hyper V Agent 7 4 User Guide e To install the Management service in another location click Change In the Change Current Destination Folder dialog box browse to the new installation folder or enter it in the Folder name box Click OK On the Destination Folder page click Next 5 On the Register EVault Software Hyper V Agent Management with Portal page specify the following information e Inthe Network Address box type the host name or IP address of the Portal for managing the Hyper V Agent Specifying the host name of the Portal is recommended This will allow DNS to handle IP address changes e Inthe Port box type the port number for communicating with the Portal e Inthe Username box type the name of the Portal user for managing the Hyper V Agent After the Hyper V Agent is installed the Agent appears on the Computers page of the Portal for this user and other Admin users in the user s site e Inthe Password box type the password of the specified Portal user 6 Click Next 7 On the Configure Communication Port page specify the port used to communicate with Hyper V Agent Host services and then click Next By default the Management service communicates with Host service
64. rname or username domain e Inthe Password box type the password for the specified user 5 To validate the credentials click Verify Information If the credentials are valid a message appears Click Okay 6 Click Continue 7 Inthe Vault Configuration section click Configure Vault Note You can also add vault connections after the initial configuration See Add a vault connection 8 On the Vault Settings tab click Add Vault 9 Inthe Vault Settings dialog box do one of the following e Inthe Vault Name box enter a name for the vault connection In the Address box enter the vault host name or IP address In the Account Username and Password boxes enter an account and credentials for backing up data to and restoring data from the vault Specifying the host name of the vault is recommended This will allow DNS to handle IP address changes e Ifa policy with a vault profile is assigned to the computer click the Vault Profile list In the list click the vault profile that you want to add for the computer Vault information and credentials are then populated in the Vault Settings dialog box For more information about policies see the Portal online help 10 Optional Change one or more of the following Advanced Settings for the vault connection e Agent Host Name Name of the computer on the vault For a Hyper V environment by default the name is the fully qualified domain name of the cluster or standalone host 14
65. s are being backed up ona node each gets 1 3 of the specified maximum bandwidth on the node The total bandwidth sent to the vault can be as high as the specified maximum multiplied by the number of nodes where the Host service is installed Bandwidth settings include e Maximum bandwidth upper limit in megabits per second to be consumed by the Agent for all backups and restores e Period of time during the day that throttling is in effect Only one time window can be specified Outside the window no throttling takes place e Days of the week that throttling is in effect If the bandwidth throttling time period begins when a backup is underway the maximum bandwidth is applied dynamically to the running backup Similarly if the bandwidth throttling time period ends when a backup is running bandwidth throttling is ended for the backup If you edit an Agent s bandwidth settings while a backup is running the new Agent settings do not affect the backup that is running Bandwidth settings are applied when a backup starts and are not applied to backups that are already running To configure bandwidth throttling 1 On the navigation bar click Computers 2 Find the Agent for which you want to configure bandwidth throttling and click the row to expand its view 3 Click the Advanced tab click the Performance tab and then edit the bandwidth settings 22 Hyper V Agent 7 4 User Guide Jobs Vault Settings Options Retent
66. s data that has changed since the last backup to the vault However under some circumstances reseeds can occur In a reseed all data for a VM is sent to the vault even though the VM was previously backed up The following list describes situations when backups reseed e VM backups ina job reseed if the job is directed to a different vault e VM backups ina job reseed if the job s encryption password changes e If aVM is backed up as part of one backup job and is then moved to a job with a different encryption password the amount of data sent to the vault is equivalent to a seed backup If a VM is moved to a different backup job with the same encryption password the VM backup does not reseed e After storage migration snapshot AVHD files reseed Hard disk VHD x files do not reseed after storage migration 5 2 Best practices for seeding Hyper V VM backups The first backup for a Hyper V VM is a seed backup in which all VM data is sent to the vault Consider the following best practices when seeding Hyper V VM backups Seed backups locally Ideally use an ERA or vERA to provide fast local vault access If you do not use an ERA or vERA consider using a QuickShip vault QSM to seed Hyper V backups locally The data can then be imported into the EVault cloud Seed VM backups in separate jobs Seeding backups particularly for large VMs can take a significant amount of time Because deferring is not available for sche
67. s using port 5444 Ensure that this inbound port or the custom communication port specified is open 8 On the Ready to Install the Program page click Install 3 2 Install the Hyper V Agent Host service The Hyper V Agent Host service is installed on one or more hosts in a protected Hyper V environment See Recommended deployment for protecting a Hyper V cluster and Recommended deployment for protecting a Hyper V standalone host Before you can install a Host service the Hyper V Agent Management service must be installed on a server with local network access to the Hyper V environment During the installation the Host service must be able to establish connection with the Management service Ensure that there is local network connectivity to the Management service and that the correct port is open Do not install the Host service on the same machine as Agent for Microsoft Windows The installer does not enforce this coexistence constraint Note To install the Host service silently see Install the Hyper V Agent Host service in silent mode Hyper V Agent 7 4 User Guide To install the Hyper V Agent Host service 1 10 3 3 Log in to the Hyper V host where you want to install the Host service Double click the Hyper V Agent Host service installation kit On the Welcome page click Next On the License Agreement page read the license agreement Click accept the terms in the license agreement and then click Next
68. snapshot using B5946137 7B9F 4925 10 02 20 VSS I 09677 lt Volume 8806ba65 2634 11e3 9e31 806e6f6e6963 gt lt C gt is added to snapshot using B5946137 7B9F 4925 1ABD60B20DS provider 00 02 SV I 08370 Volume lt Volume 8806ba64 2634 11e3 9e31 806e6f6e6963 gt is BMR required 0 Volume lt C gt is BMR required 0 connect to the Vault at 192 168 0 200 Connection to the Vault is using AES encryption login as The Vault at 192 168 0 200 supports Logical Vault Replication 2 9 9 0 The Vault at 192 168 0 200 has accepted the operation N N N N 12 Alternate vault is not found 2 N N NNNNNMN 22 May UTI 05210 Computer information dn hn AGENT ip 192 0 2 3 vid 833619c5 81c0 495c a182 c90d8ab2e8d7 cid 0b193e18 5269 4c91 9dbb 2def027d3515 22 May 00 02 49 UTIL I 05211 Job information tn Job3 vid 833619c5 81c0 495c al82 c90d8ab2e8d7 cid 0b193e18 5269 4c91 4 To only show errors and warnings in the log click the Errors and Warnings Only option at the top right of the window 5 To view a log for a different process click the calendar button In the calendar that appears click the date of the log that you want to view In the list of processes on the selected date click the process for which you want to view the log 52 Hyper V Agent 7 4 User Guide History Logs AGENT Job3 Job Details aS File Choose a Log File lt May 2014 2 Thu May 22 2014 Su Mo Tu We Th Fr Sa Backup 5 22 201
69. t service installation kit 2 Inthe confirmation dialog box click Yes 3 Inthe installation wizard click Next 4 On the Installation Completed page click Finish 11 Hyper V Agent 7 4 User Guide 3 3 3 Upgrade the Hyper V Agent in a new environment When recovering a protected Hyper V environment after a disaster or when migrating VMs to a new environment you can move to a new Agent version and recover Agent jobs and settings from the previous Agent version For example you can move from Hyper V Agent 7 30 in a Windows Server 2012 environment to Hyper V Agent 7 40 in a Windows Server 2012 R2 environment recover backup jobs and back up VMs in the new environment using the recovered jobs To upgrade the Hyper V Agent when migrating to a new environment 1 Create a new Hyper V environment If possible migrate VMs from the original environment to the new Hyper V environment Install the new Hyper V Agent version in the new Hyper V environment See Install the Hyper V Agent Management service and Install the Hyper V Agent Host service Recover jobs and settings from the earlier Hyper V Agent version See Recover jobs and settings from an offline Hyper V Agent If the original protected Hyper V environment is lost or unavailable or VMs cannot be migrated to the new environment restore protected VMs to the new Hyper V environment See Restore Hyper V VMs Enable all scheduled jobs for the new Hyper V Agent
70. t specify a logFileName the installation log is saved in the Windows installer default location usually the user s temp directory For example to upgrade the Host service in silent mode you could run the following command Hyper V_Agent_Host x xx xxxx exe S L1036 V qn L v C logs 1 log B5 Uninstall the Hyper V Agent Management service Note You can also uninstall the Management service using Add Remove Programs in Windows Control Panel To uninstall the Hyper V Agent Management service 1 On the machine where you want to uninstall the Management service double click the Hyper V Agent Management service installation kit 64 Hyper V Agent 7 4 User Guide 2 A warning message asks you to ensure that there are no backups or restores in progress To proceed with uninstalling the Management service click Yes 3 On the Welcome page click Next 4 On the Program Maintenance page select Remove and then click Next 5 Onthe Remove the Program page click Remove 6 If the Files in Use page appears select Automatically close and attempt to restart applications and then click OK 7 On the InstallShield Wizard Completed page click Finish B6 Uninstall the Management service in silent mode To uninstall the Management service in silent mode run the following command installKitName S L lt localeID gt V qn REMOVE ALL L v logFileName Where installkitName is the name of th
71. t to Reconnect Every Specifies the number of seconds after which the Agent should try to connect to the vault if the vault becomes unavailable during a backup or restore e Abort Reconnect Retries After Specifies the number of times the Agent tries to reconnect to the vault if the vault becomes unavailable during a backup or restore If the Agent cannot connect to the vault successfully in the specified number of tries the backup or restore fails e Enable over the wire encryption for transmission to from the vault By default when data is transmitted to and from the vault it is encrypted using AES encryption To disable over the wire transmission clear this option 6 Click Save 4 3 Add a description You can add a description for an Agent in Portal The description appears on the Computers page and can help you find and identify a particular Agent To add a description 1 On the navigation bar click Computers 2 Find the Agent for which you want to add a description and click the row to expand its view 3 On the Advanced tab click the Options tab 17 Hyper V Agent 7 4 User Guide 4 Inthe Agent Description box enter a description for the Agent Jobs Vault Settings Advanced Jptions Retention Types Notifications Perf m 6 rmance Agent Log Files Agent Description 7 3 3 Hibernation Options a Prevent standby hibernation when backups are runnin Advanced Schedule Options z Start scheduled b
72. tails dialog box shows progress information for the current backup or restore The Last Backup Status column shows the result of the last backup attempt for each job Possible statuses include Completed Indicates that the last backup completed successfully and a safeset was created Q Completed with warnings Indicates that the last backup completed and a safeset was created but problems occurred during the backup For example a warning could indicate that a file or volume that was selected in the backup job was not available for backup Q Deferred Indicates that the last backup was deferred A safeset was created but not all data that was selected was backed up Deferring is used to prevent large backups from running at peak network times When deferring is enabled a backup job does not back up any new data after a specified amount of time Note Hyper V VM backups can be deferred when they are run manually ad hoc but not when they are scheduled to run Q Missed Indicates that the job has not run for 7 days A Completed with errors Indicates that the backup completed and a safeset is available for restore but problems occurred For Hyper V environments this status can appear when problems were encountered during the backup but the backups later succeeded A Failed Indicates that the backup failed and no safeset was created Never Run Indicates that the backup job has never run Cancelled
73. that you want to protect Specifying the host name of the cluster or standalone host is recommended This will allow DNS to handle IP address changes e Inthe Domain box type the domain of the account for authenticating with the Hyper V cluster or standalone host The domain is not required if you specify the domain in the Username box e Inthe Username box type the domain administrator account that is used to authenticate with the Hyper V cluster or standalone host You can type the account as username domain username or username domain e Inthe Password box type the password for the specified user 15 Hyper V Agent 7 4 User Guide 4 To validate the credentials click Verify Information If the credentials are valid a message appears Click Okay 5 Click Save 4 2 Adda vault connection Before you can back up data to a vault a vault connection must be added for the Agent A vault connection provides vault information and credentials so that data can be backed up to and restored from the vault Portal Admin users and regular users can add vault connections for an Agent You can also add a vault connection during the initial Hyper V Agent configuration See Configure the Hyper V Agent To add a vault connection 1 On the navigation bar in Portal click Computers 2 Find the Agent for which you want to add a vault connection and click the computer row to expand its view 3 On the Vault Settings tab click A
74. the following information and settings from an offline Hyper V Agent e Backup jobs e Vault settings e Hyper V environment address and last backup status e Advanced settings including the Agent description retention types notifications and bandwidth throttling You cannot recover passwords for a Hyper V Agent You must manually enter Hyper V environment vault and encryption passwords after recovering Hyper V Agent jobs and settings You might also need to enter an SMTP password for notifications You can recover jobs and settings from an earlier Hyper V Agent version or the current version Recovering jobs from a previous Agent version can be useful when migrating Hyper V VMs to a new environment See Upgrade the Hyper V Agent If you recover jobs and settings from an offline Hyper V Agent in a Windows 2012 environment and then restore VMs to a Windows 2012 R2 environment the restored VMs are restored as Generation 1 VMs You cannot restore VMs from a Windows 2012 R2 environment to a Windows 2012 environment When you recover jobs and settings from an offline Hyper V Agent all scheduled backup jobs for the Agent are disabled If Hyper V VMs remain in the protected environment or have been restored after a disaster you can re enable all scheduled jobs for the environment See Disable or enable all scheduled backup jobs IMPORTANT Hyper V Agent settings are saved in the EVault Portal database To ensure that a Hyper V environment can
75. up job to run click Schedule In the Schedule box that appears create one or more schedules See Add or edit a schedule for a Hyper V backup job 7 Click Save 5 6 Add or edit a schedule for a Hyper V backup job When adding or editing a Hyper V backup job you can create a schedule for running the job and enable or disable the schedule You can also edit existing schedules You can specify a retention type for each schedule The retention type specifies the number of days a backup is kept on the vault how many copies of a backup are stored online and how long backup data is stored offline See Add retention types You can create complex schedules for a Hyper V backup job by creating multiple schedules For example you can schedule a backup job to run at midnight every Friday and schedule the job to run at 8 pm on the first day of every month To create multiple schedules repeat the following procedure for each schedule If a job is scheduled to start at exactly the same time by multiple schedules the job only runs once at the scheduled time If the jobs have different retention types the retention type of the schedule that is highest in the list is applied to the resulting safeset For example in the following screenshot the job is scheduled to run at 11 PM on the last day of the month with the Monthly retention type and every night at 11 PM with the Daily retention type On the last day of each month the job runs only once at 11 PM
76. using Add Remove Programs in Windows Control Panel To uninstall the Hyper V Agent Host service 1 On the Hyper V host where you want to uninstall the Host service double click the Hyper V Agent Host service installation kit 2 A warning message asks you to ensure that there are no backups or restores in progress To proceed with uninstalling the Host service click Yes 3 On the Welcome page click Next 4 On the Program Maintenance page click Remove and then click Next 5 Onthe Remove the Program page click Remove 6 If the Files in Use page appears select Automatically close and attempt to restart applications and then click OK 7 On the InstallShield Wizard Completed page click Finish B8 Uninstall the Host service in silent mode To uninstall the Host service in silent mode run the following command in the directory where the installation kit is located installKitName S V qn REMOVE ALL Where installkitName is the name of the Hyper V Agent Host service installation kit Hyper V_Agent_Host x XX XXXX EXE X XX XXXX represents the Agent version number 66 Hyper V Agent 7 4 User Guide Appendix C Understanding Hyper V backups on a vault This appendix provides information about how Hyper V VM backups are stored on a vault Note This information is provided for vault administrators It might not be relevant for customers who back up Hyper V VMs to the EVault cloud When you run a Hyper
77. vault how many copies of a backup are stored online and how long backup data is stored offline 4 Inthe Schedule box click the arrow The Configure Job Schedule dialog box opens 5 Inthe Configure Job Schedule dialog box do one of the following e Torun the backup on specific days each week click Days of Week in the Schedule View list Select the days when you want to run the job Use the At fields to specify the time when you want to run the job each day Click Okay 34 Hyper V Agent 7 4 User Guide Configure Job Schedule Schedule View Days of Week su ey TOY Wey AY RY se V Agent time zone Okay Cancel e Torun the backup on specific dates each month click Days of Month in the Schedule View list On the calendar select the dates when you want to run the job Use the At fields to specify the time when you want to run the job on each date Click Okay Configure Job Schedule LJL Schedule View Days of Month 4 11 18 25 AM Agent time zone Okay Cancel e To create a custom schedule click Custom in the Schedule View list In the Custom Cycle box enter a custom schedule Follow the format and notation described in the dialog box Click Okay 35 Hyper V Agent 7 4 User Guide Configure Job Schedule Lell Schedule View The new or revised schedule appears in the Schedule box 6 To enable the schedule to run select Enable To disable the
78. vironment view by clicking the row 3 Click the Virtual Machines tab The Virtual Machines tab shows all protected VMs in the Hyper V cluster or standalone host 4 Inthe Current Inventory Protected Inventory filter click Protected Inventory The Virtual Machines tab shows VMs that have been backed up and can be restored 5 Point to the VM that you want to find on the vault 67 Hyper V Agent 7 4 User Guide A tooltip shows the name of the VM s task on the vault E PAN b 3 Completed VM ID HV_MA6J2Z2GNPC5CUS5IIWQSAQ54BMM4 E zzz Completed 6 To copy the name of the VMs task on the vault click the tooltip The task name for the vault is copied to the clipboard today at 11 31 AM today at 1 14 PM 68
79. warnings in the log file Email notifications are sent separately for each backup and restore For example if three backup jobs fail on a computer and On failure is selected for the computer three notification emails are sent If users will receive email notifications after backups and restores specify the following email notification information Server SMTP Email From Email address from which email notifications will be sent Address Outgoing Mail Network address of the SMTP that will send the email Server Port SMTP Recipient Email notification recipient email addresses separated by commas Address es These should be real valid email addresses If one or more is not valid the transmission to those addresses will fail and errors will appear in the log files Outgoing Port number for sending email notifications 21 Hyper V Agent 7 4 User Guide SMTP If required SMTP username domain and password Credentials 4 Click Save 4 6 Configure bandwidth throttling Bandwidth throttling settings specify the amount of bandwidth consumed by an Agent for backups For example you might want to restrict the amount of bandwidth used for daytime backups so that online users are not affected and allow unlimited bandwidth usage at night so that scheduled backups run as fast as possible For the Hyper V Agent bandwidth throttling is applied at the Host level If three VM
80. y for troubleshooting Agent issues If information is required for troubleshooting you can compress the lt ManagementsServicelnstallFolder gt Data folder as a zip file and send it to EVault 56 Hyper V Agent 7 4 User Guide 9 Understanding and troubleshooting Hyper V processes This section provides information that can be helpful when monitoring and troubleshooting Hyper V Agent processes Some VMs backed up before others If a Hyper V backup job includes more than one VM each VM is backed up as a separate job or task on the vault If you stop a Hyper V backup job that is running VMs in the job that have already been completely backed up remain on the vault The Hyper V Agent is optimized for backing up VMs whose virtual disks do not span multiple CSVs Any VMs which span multiple CSVs will be backed up in a separate stage after all VMs which have their virtual disks ona single CSV VM skipped during backup AVM could be skipped during a backup for one of the following reasons e The VM s storage is being moved while the backup job is running If you try to back up a VM during storage migration the VM is skipped during the backup Other VMs in the same job will be backed up e The VM contains mixed storage e g one virtual disk on local storage and another virtual disk ona CSV The Hyper V Agent does not back up VMs that contain mixed storage Other VMs in the same job are backed up e The VM shares a virtual hard
81. yper V Agent 7 4 User Guide Parameter Description PORT portNumber Optional Specifies the port number for communicating with the Hyper V Agent Management service Example UIREG_PORT 5444 If you do not specify a port number port 5444 is used INSTALLDIR installFolder Optional Specifies the installation folder for the Host service if you do not want to install the Host service in the default location The installation folder must be enclosed in double quotation marks if there are spaces in the name or path Example INSTALLDIR c Program Files Host Service If you do not specify an installation folder the Host service is installed in the default location C Program Files EVault Software For example to install the Host service in silent mode you could run the following command Hyper V_Agent_Host x xx xxxx exe S L1036 V gqn L v C logs 1 log HOST 192 0 2 234 PORT 5444 B3 Upgrade the Hyper V Agent Management service in silent mode To upgrade the Management service in silent mode run the following command in the directory where the installation kit is located installKitName S L lt localeID gt V qn L v logFileName Where installkitName is the name of the Hyper V Agent Management service installation kit Hyper V_Agent_Management x xx xxxx exe X XX XXXX represents the Agent version number The following table lists and describes c

Hyper-V Agent User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents