Product Documentation

MS Hyper-V

To install the App Layering service, you deploy the appliance to a virtual machine in the

  • Requirements. - Be sure you have the required Hyper-V resources.
  • Install the App Layering appliance in Hyper-V. - To install the appliance, you download the installation package and deploy the appliance to Hyper-V.
  • If the appliance needs a Static IP address.  - You can set a Static IP address by accessing the appliance configuration utility.
  • Next steps. - The App Layering agent must be installed on any Hyper-V servers that will be used for deploying packaging machines or published images. In addition, if you want to publish layered images to PVS, you must also install the App Layering agent on any PVS servers you are using. And, to run connector configuration scripts, you must install the agent in locations where your connector configurations will run Powershell scripts.


Ensure that the Hyper-V virtual machine from where you are installing the appliance meets the following prerequisites:

  • Windows Windows Server 2016, Windows Server 2012 R2
  • Virtual network in Hyper-V

Install the App Layering appliance in Hyper-V

To deploy the App Layering appliance to Hyper-V:

  • Check the contents of the installation package.
  • Learn about the virtual machine settings to use.
  • Deploy the appliance.

Installation package

The installation package, citrix_app_layering_hyperv_4.x.x, includes:

File Description VHDX files for the appliance VM
citrix_app_layering_agent_installer.exe App Layering agent installer
citrix_app_layering_os_machine_tools.exe OS Machine Tools

Virtual appliance details

Name Value
Virtual Machine Name App Layering Appliance (Enterprise Layer Manager)
VIrtual Machine Generation Generation 1
Memory 8192 MB
CPUs 4
Disk 1 unidesk_hyperv-system.vhdx
Disk 2 unidesk_hyperv-repository.vhdx

Deploy the appliance in Hyper-V

  1. Extract the download package, Two disk (vhdx) files are included.

  2. Copy the disks to a storage location that the Hyper-V server can access.

  3. Open the Hyper-V Manager, right-click the Hyper-V server where you want to deploy the appliance, and select New Virtual Machine. This opens the New Virtual Machine Wizard.

  4. On the first wizard tab, click Next to begin configuring the virtual machine.

  5. On the Specify Name and Location tab, set the Name and Location of the new VM. Ideally, use the location where you extracted the disks in step 2.

  6. On the Specify Generation tab, ensure that Generation 1 VM’s is selected. Generation 1 only is supported.

  7. On the Assign Memory tab, set the VM to use 8 GB of RAM. Make sure the Use Dynamic Memory for this virtual machine check box is not selected.

  8. On the Configure Networking tab, specify the NIC for the network adapter to use to connect to the network.

  9. On the Connect Virtual Hard Disk tab, attach the system disk (unidesk_hyperv-system.vhdx), one of the disks that you extracted in step 2.

  10. On the Summary tab, verify your choices and click Finish.

  11. Back in the Hyper-V Manager, select the VM and click Settings from the VM panel.

  12. Select Hardware > Processor, and set the Number of Virtual Processors to 4.

  13. Select IDE Controller 0 > Hard Drive, click Add.

  14. Select the Virtual Disk radio button, click Browse, and select the repository disk (unidesk_hyperv-repository.vhdx) extracted in step 2.

  15. Power on the VM.

  16. Type the IP address and logon for an administrator with permission to access the App Layering management console.

The first time you log onto the appliance you are required to change the App Layering administrator passwords, For details, see Change administrative passwords.

If the appliance needs a Static IP address

You can change the appliance’s IP address and/or its DNS servers. When the appliance is first deployed, the DNS settings are retrieved through DHCP. If DHCP is not available and you will be using static IP addresses, once you select Static, you are prompted to enter the IP addresses for your DNS servers.

  1. Log in to the Appliance Configuration utility, using the steps and default password described in Appliance settings.
  2. At the Action prompt, enter C (for Configure Networking), and press Return.
  3. At the next prompt, type D for Dynamic (DHCP) or S for Static. If you choose Static, you will be prompted for the IP address and Subnet mask, along with default addresses for the Gateway and DNS addresses.
  4. When prompted, enter Y to save settings.
  5. At the Action prompt, enter Q to quit.
  6. Restart the appliance.

Next steps

Once the appliance is installed and the IP address is configured as you want it to be, you can install the App Layering agent, and configure the App Layering service: