MS Hyper-V

An MS-Hyper-V connector configuration includes the credentials and storage location the appliance needs to connect to Hyper-V, and it identifies the properties to be associated with the vDisk.

You can select a Hyper-V connector for importing the OS, creating other layers, or publishing layered images. Each connector configuration is set to access a storage location using a specific account.

The Hyper-V connector uses Microsoft’s Background Intelligent Transfer Service (BITS) to copy disks to and from the appliance. With BITS the appliance reports progress as a percentage complete, and the connector no longer requires a CIFS share.

For more about connectors and connector configurations in general, see Connector configurations.

Before you start

The first time you create an image template for publishing layered images to your Microsoft Hyper-V environment, you need to add a new Hyper-V connector configuration for that location.

Hyper-V requirements

You can use a Hyper-V connector configuration makes it easy to connect to a location in your Microsoft Hyper-V environment.

The information you need for the Hyper-V connector configuration includes:

  • Hyper-V Configuration
    • Agent - App Layering agent from the list of agents registered with the appliance.
    • User Name - Agent user name.
    • Password - Agent password.
  • Virtual Machine Settings
    • Template VM (Optional) - A template that can be used to clone a Hyper-V virtual machine with the desired hardware settings (memory, CPUs and video settings). You can specify the host, datastore and network for configuring the resulting virtual machines. The template must have at least one network card attached, and it must not have any disks attached. Otherwise, you receive an error when attempting to validate or save the configuration.
    • Number of CPUs - Number of CPUs to use for creating a Packaging Machine or publishing a layered image. The default value is 4 CPUs.
    • Memory (Mbs) - Amount of memory allocated for creating the Packaging Machine or the layered image Machine. The default value is 8192 Mbs.
    • Network - Network switch. You can select from a list of network switches known by the agent.
  • Storage Settings
    • Local path to storage, e.g. C:\Virtual Machines - Location where the disks and Packaging Machines are created. This value must be the same as the location specified in the UNC path.
    • Layer Disk Cache Size in GB (optional) - Amount of File Share space (in gigabytes) to use for caching layer disks. A value of:
      • 0 disables layer caching.
      • 1+ enables layer caching and specifies the amount of space to allow for caching layer disks on the File Share. keep copies of boot disks and packaging disks and reuses these disks to create new packaging machines. The reuse of these boot disks and packaging disks reduces the time it takes to package an app layer.

App Layering requirements

The App Layering agent is required to use a Hyper-V connector. The App Layering agent must be:

Create a Hyper-V connector configuration

To use the Hyper-V connector for layering or publishing, you:

  1. In the wizard you are using to create a layer or an image template, click the Connector tab.
  2. Below the list of connector configurations, click the New button. This opens a small dialog box.
  3. Select the Hyper-V Connector Type. Then click New to open the Connector Configuration page.
  4. Complete the fields on the Connector Configuration page. For guidance, see the field definitions in the Hyper-V requirements section above.
  5. Click the TEST button to verify that the appliance can access the location specified using the credentials supplied.
  6. Click SAVE. The new connector configuration should now be listed on the Connector tab.

HTTPS and certificate errors

By default, HTTPS is turned off and certificate errors are ignored, because the self-signed certificate that comes with the appliance would fail over HTTPS. When you upload your own certificate, you can configure the connector to use HTTPS and to stop ignoring certificate errors.

If you want to enable HTTPS for Hyper-V

if you want to enable HTTPS for Hyper-V, edit the settings for turning on HTTPS and for ignoring certificate erros in the config.json file.

  1. Open the Hyper-V connector config.json file:

    /usr/local/lib/node_modules/unidesk-hyperv-connector/config.json

  2. Set useHttpsFileTransfer to true:

    “useHttpsFileTransfer”: true

  3. Set ignoreCertificateErrors to false:

    “ignoreCertificateErrors”: false

  4. Restart the Hyper-V connector.

Certificate errors

Once certificate errors are no longer ignored, you will receive the following error if your certificate expires:

Failed copying file to D:\path\file.vhdx. The certificate authority is invalid or incorrect.
The error occurred while the remote file was being processed.