Product Documentation

Hyper-V connector configuration

Jan 11, 2018

A Provisioning Services 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.

Each Connector Configuration is set up to access a storage location via a specific account. For more about Connectors and Connector Configurations, see Connector Essentials.

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
    • 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
    • Remote path to storage, eg. server virtual machines - UNC path to the File Share being used for layering and publishing.
    • 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.
    • Use the Agent Credentials checkbox - If checked, the agent credentials are used as the File Share credentials. Otherwise, you must specify the credentials used to connect to the File Share.
    • User Name and Password (if different than use the Agent Credentials) - These values are only required if you've chosen not to use the Agent credentials.
    • Layer Disk Cache Size in GB - Amount of File Share space to use for caching layer disks. A value of:
      • 0 disables layer caching.
      • 1 or more enables layer caching, and sets the connector to use this amount of space on the File Share to cache layer disks.

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.