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.
Each connector configuration is set up to access a storage location via a specific account. For more about connectors and connector configurations, 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.
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:
- 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.
- 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 (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:
- Installed on the Microsoft Hyper-V server where you want to create layers or publish layered images. For details, see Install the App Layering agent in the App Layering installation topic.
- Registered with the App Layering appliance. For details, see Register with the App Layering appliance manually in the App Layering installation topic.
Create a Hyper-V connector configuration
To use the Hyper-V connector for layering or publishing, you:
- In the wizard you are using to create a layer or an image template, click the Connector tab.
- Below the list of connector configurations, click the New button. This opens a small dialog box.
- Select the Hyper-V Connector Type. Then click New to open the Connector Configuration page.
- Complete the fields on the Connector Configuration page. For guidance, see the field definitions in the Hyper-V requirements section above.
- Click the TEST button to verify that the appliance can access the location specified using the credentials supplied.
- Click SAVE. The new connector configuration should now be listed on the Connector tab.