App Layering

MS Hyper-V

To install the App Layering service, you deploy the appliance to a virtual machine in Hyper-V. If the appliance requires a static IP address, you configure one using the appliance configuration utility, as described below. The last section describes next steps.


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

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

Download the installation package

Download the installation package, citrix_app_layering_hyperv_4.x.x, from the Citrix download site. The zip file 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 machine settings for the appliance

The virtual machine that you use for the appliance must be configured as follows:

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

To deploy the appliance:

  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.

  4. On the first wizard tab that opens, 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 VMs 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 on to the appliance you are required to change the App Layering administrator passwords. For details, see Change administrative passwords.

Configure a Static IP address for the appliance, if necessary

You can change the appliance’s IP address and its DNS servers. When the appliance is first deployed, the DNS settings are retrieved through DHCP. If DHCP is not available and you are 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 are prompted for the IP address and Subnet mask, along with the 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 correctly configured, you need to:

MS Hyper-V