HFS backup for virtual environments (Hyper-V)

Data Protection for Microsoft Hyper-V works with the IBM Spectrum Protect backup-archive client to protect Hyper-V virtual machines on the following operating systems:

  • Microsoft Windows Server 2012
  • Microsoft Windows Server 2012 R2
  • Microsoft Windows Server 2016
  • Microsoft Windows Server 2019
  • A stand-alone Hyper-V server that contains only the Windows hypervisor is also supported

Spectrum Protect for VE (Hyper-V) backup types

  • Incremental-forever full backup: Creates a backup of snapshot disk data to the IBM Spectrum Protect server.
  • Incremental-forever incremental backup: Creates a snapshot of the blocks that changed since the last incremental-forever full backup or incremental-forever incremental backup.

Spectrum Protect for VE (Hyper-V) restore types

You can restore Hyper-V VMs by using several methods. You can restore an entire virtual machine to the same location, restore an entire virtual machine to an alternative location, or restore individual files from virtual machines.

Expand All

  • The Data Protection for Microsoft Hyper-V backup software has to be installed on the Hyper-V server where the VMs are running
  • Data Protection for Microsoft Hyper-V only supports VHDX disk formats
  • One cannot run other processes (MS Backup, VM replication, etc) which are using VSS whilst one is using Data Protection for Microsoft Hyper-V
  • The volume shadow copy requestor integration service must be installed and enabled on the guest virtual machine
  • The 'Backup (volume shadow copy)' service needs to be ticked within the Integration Services on the guest virtual machines
  • Your Hyper-V VM configuration version must be either 8.0 or 9.0 for VM restore to work due to a bug in the current backup software. This issue is projected to be fixed in the Data Protection for Microsoft Hyper-V 8.1.10 version.

Access to the service is by application; send an email to hfs@ox.ac.uk to request an account.

If you have not yet contacted the HFS team for a Spectrum Protect for VE account, please do this first by emailing hfs@ox.ac.uk.

Install the latest Spectrum Protect for VE (Hyper-V) version

  1. Download the latest IBM Spectrum Protect for VE (Hyper-V) installer onto the Hyper-V server host.
  2. Run the downloaded exectuable file.  It is a self-extracting executable file and will extract the contents to a TSMVMWARE_WIN directory inside the current directory.  You need up to 2 GB of free space for the files.
  3. Change to the TSMVMWARE_WIN directory and run spinstall.exe.  Note that IBM do not sign their installer package.
  4. Follow the prompts and accept the license terms:
  5. Accept the default installation location.
  6. From the Installation Type prompt, choose Advanced installation:
  7. From the Advanced Installation Type prompt, choose Install the data mover feature or mount proxy.
  8. The installer will install several IBM packages and possibly some prerequisites too, such as C++ redistributable packages.

Run the configuration tool

  1. Download and run the latest HFS configuration tool.  It is a self-extracting executable file and will extract the contents to a Config_tool_HV directory inside the current directory.
  2. Change to the Config_tool_HV directory and run Config_tool.exe.
  3. Fill in the requested information in the form that is displayed.  You will be given the required information by the HFS Team when they have set up your Spectrum Protect for VE account.
  4. From the form select Help then Configure.

  5. Once the configuration is complete, select Exit.

We have tried to choose reasonable defaults in the configuration file (C:\Program Files\Tivoli\TSM\baclient\tsm4ve.opt).  However, there are some configuration options that you may want to adjust to suit your setup.  In particular, these are:

DOMAIN.VMFULL

This sets the list of VMs that you want to back up.  By default all Hyper-V virtual machines are backed up that are known to the Hyper-V host.  To exclude virtual machines vm1vm2 and vm3 from the backups, give them as the value for -VM, separated by commas:

DOMAIN.VMFULL all-vm;-VM=vm1,vm2,vm3

Note that if the VM name contains spaces, it should not be surrounded by quotes.  There should also be no spaces between VM names and the commas.  This applies to all DOMAIN.VMFULL options.

To specify explicitly the VMs to back up, use the VM option.  For example to back up only vm1vm2 and vm3, use:

DOMAIN.VMFULL vm=vm1,vm2,vm3

EXCLUDE.VMDISK

EXCLUDE.VMDISK excludes the specified virtual disk from backup.  For example, to exclude a specific IDE virtual disk of virtual machine "vmname":

EXCLUDE.VMDISK vmname "IDE 0 1"

The second argument is the virtual disk's location, which must begin with "SCSI" or "IDE" followed by the controller number and device location number.  Use the 'backup vm' command with the '-preview' option to determine the location of disks in a given VM:

Protect> backup vm Win2012_restored -preview
ANS2564I Gathering virtual machine information...
Backup VM command started.  Total number of virtual machines to process: 1

  1. VM Name: Win2012_restored

        Domain Keyword:       Win2012_restored
        Mode:                 Incremental Forever - Incremental
        Target Node Name:     SN-HYPERV1.IT
        Data Mover Node Name: SN-HYPERV1.IT
        Cluster Resource:     No

        Disk[1]
        Name: \\hfsvm-tsm-proxy\d$\Win2012_restored\Win2012_restored\Virtual Hard Disks\WinServ12_gen1.vhdx
        Capacity:             64.00 GB
        Size:                 18.07 GB
        Status:               included
        Disk Type:            VHDX
        Number of Subdisk:    0
        Controller Location:  IDE 0 0

        Disk[2]
        Name: \\hfsvm-tsm-proxy\d$\win2012_restored\win2012_restored\virtual hard disks\disk2.vhdx
        Capacity:             16.00 GB
        Size:                 164.00 MB
        Status:               included
        Disk Type:            VHDX
        Number of Subdisk:    0
        Controller Location:  IDE 0 1

INCLUDE.VMDISK

INCLUDE.VMDISK includes specific virtual disks in the backup of a virtual machine and creates an implicit exclude for all other virtual disks on that virtual machine.  If you do not specify one or more disk labels, all disks in the VM are backed up.  For example, if you have a virtual machine named "vmname" with four virtual disks ("IDE 0 0" to "IDE 3 "), the following would back up "IDE 0 0" and "IDE 0 1" of "vmname" but not "IDE 0 2" and "IDE 0 3":

INCLUDE.VMDISK vmname "IDE 0 0"
INCLUDE.VMDISK vmname "IDE 0 1"

The second argument is the virtual disk's location, which must begin with "SCSI" or "IDE" followed by the controller number and device location number.  Use the 'backup vm' command with the '-preview' option to determine the location of disks in a given VM (see example output of this command in the section above).

Using the Spectrum Protect client GUI

  1. Launch the Spectrum Protect for VE client GUI using shortcuts from either the desktop or Spectrum Protect for VE Start Menu folder, or by running the IBM SP for VE GUI.lnk file from the Desktop folder, using the command line.
  2. Choose Actions Backup VM to display the Backup Virtual Machine window.
  3. Expand the Hyper-V VMs item.

  4. Select virtual machines to back up.

  5. Choose Incremental Forever - Incremental from the drop down, then Backup.

  6. Task List window displays the backup progress.

  7. For detailed information, select Report.

Using the Spectrum Protect command line

To back up all virtual machines specified in the DOMAIN.VMFULL option, start the Spectrum Protect for VE command line client using the shortcut on the desktop or in the Spectrum Protect for VE Start Menu folder, or run the IBM SP for VE command line.lnk file from the Desktop folder, then run:

tsm> backup vm -mode=IFincr

To back up a specific VM, run:

tsm> backup vm 'vmname' -mode=IFincr

Using the Spectrum Protect client GUI

  1. Launch the Spectrum Protect for VE client GUI using the shortcut on the desktop or in the Spectrum Protect for VE Start Menu folder.  Alternatively you can start the program by running the 'IBM SP for VE GUI.lnk' file from the Desktop folder, using the command line.
  2. Choose Actions > Restore VM to display the Restore Virtual Machine window.
  3. Expand the Hyper-V VMs item and choose a VM in the navigation pane.  All the available backups of the VM are displayed.  Choose a backup in the right hand side window and click Restore.
  4. The Restore Destination window is displayed.  If you wish to restore to the original location, you need to make sure that there is not a VM with the same name in that location.  If you are restoring to a new location, specify as much of the information as necessary.  If you specify a new name for the VM then you must specify an alternative location.
  5. Click Restore to start the restore.

Using the Spectrum Protect command line

Start the Spectrum Protect for VE command line client using the shortcut on the desktop or in the Spectrum Protect for VE Start Menu folder (or run the 'IBM SP for VE command line.lnk' file from the Desktop folder).

  • To restore a virtual machine to the same name and location as it was backed up from:
tsm> restore vm 'vm name'

You must ensure that the target VM name no longer exists.

  • To restore a VM to a new name and new location, specify both the name and location:
tsm> restore vm 'vm name' -vmname="new vm name" -targetpath='path that you want to restore the VM to'

Restoring individual files is achieved by using the IBM Spectrum Protect Recovery Agent.  To do that, you must either:

  • Launch the Recovery Agent from Start > IBM Spectrum Protect > IBM Spectrum Protect Recovery Agent on the Hyper-V server host.
  • Start it from the command line by running: "c:\Program Files\Tivoli\TSM\RecoveryAgent\mount\RecoveryAgent.exe" -notservice
  • Or follow the steps described in the installation section and install the IBM Spectrum Protect for VE (Hyper-V)'s data mover feature on any Windows VM and launch the Recovery Agent from Start > IBM Spectrum Protect > IBM Spectrum Protect Recovery Agent

Using iSCSI

The most flexible way to restore individual files is by using the Recovery Agent to export a backup as an iSCSI target which the iSCSI initiator on a virtual machine can then mount.

  1. Select New IBM Spectrum Protect server... from the IBM Spectrum Protect Server drop-down.
  2. Set the following, then OK:

     

    Server address See the TCPServerAddress field within your tsm4ve.opt file
    Server port See the TCPPort field within your tsm4ve.opt file
    Node access method Direct
    Authentication node See the NodeName field in tsm4ve.opt
    Password The password for the authentication node

     

  3. Within Select snapshot, choose the relevant backup from Virtual machine Snapshot  Disk.

  4. Click Mount.

  5. Set a unique iSCSI target name and set the appropriate iSCSI initiator name which corresponds to the virtual machine that will connect to this iSCSI target.  Then click OK.

    Note that:

    • port 3260 must be open between the computer and the initiator on any firewall.

    • the iSCSI initiator name can be obtained from the client virtual machine; for example, on a Windows VM, it can be obtained from the "iSCSI Initiator" configuration.

  6.  The iSCSI target will now be listed in the Mounted Volumes list in the Recovery Agent.  Configure the iSCSI initiator on the appropriate machine to mount the target as read-only and copy the required files to the VM using standard operating system tools.  This will vary for each operating system.

  7. When the iSCSI target is not needed any longer, unmount it and disconnect the iSCSI initiator from the target.  Select the target in the Recovery Agent and click Dismount.

  8. Select Close to exit the Recovery Agent.

Get support


Local IT support provide your first line of on-the-spot help

FIND MY LOCAL IT TEAM

 

Common requests and fault reports can be logged using self-service

   USE IT SELF-SERVICE      

   LOG A SUPPORT CALL     

VIEW MY SUPPORT CALLS  

 

The central Service Desk is available 24x7 on +44 1865 6 12345

 

If you do not have an SSO account you can use this form to contact the Service Desk