Product Documentation

Citrix Hypervisor

To install the App Layering service, you deploy the appliance to a virtual machine on your hypervisor.

  • Requirements - Make sure you have the Citrix Hypervisor requirements listed below.
  • Install the App Layering appliance in Citrix Hypervisor - To install the appliance, you download the installation package and install it on Citrix Hypervisor. See details below.
  • If the appliance needs a Static IP address - You can set a Static IP address by accessing the appliance configuration utility. For details, see If the appliance needs a Static IP address below.
  • Next steps - After installing the appliance, install the App Layering agent and configure the App Layering service.


To start installing App Layering, you need the following:

  • A supported version of Citrix Hypervisor
  • Storage
  • Citrix Hypervisor account and privileges A Citrix Hypervisor account to use for App Layering service. The account must have Citrix Hypervisor privileges to:
    • Create and remove virtual disks.
    • Copy and delete layers on virtual disks by using Citrix Hypervisor file APIs.
  • Citrix Hypervisor software and settings Access to the Citrix Hypervisor Tools to install on the layer.
  • Citrix Hypervisor resource information The Citrix Hypervisor info listed in Citrix Hypervisor Connector Configuration.

Install the App Layering appliance

To install the App Layering appliance on Citrix Hypervisor:

  • Check the contents of the installation package.
  • Deploy the appliance.

Installation package

The installation package, citrix_app_layering_Citrix Hypervisor_4.x.x, includes:

File Description
Citrix Hypervisor_x.x.x.ova OVA file for the appliance virtual machine
citrix_app_layering_agent_installer.exe App Layering Agent installer
citrix_app_layering_os_machine_tools.exe OS machine tools

Deploy the App Layering appliance

  1. Extract the download package, citrix_app_layering_Citrix The files included are previously listed.

  2. Extract the Citrix Hypervisor_elm_4.x.x.x.ova file to a folder on your local drive.

  3. In your XenCenter client, select File > Import.

  4. In the wizard that opens, select the following values:
    • Import Source - Browse to the source on your local drive.
    • Location - Choose the Citrix Hypervisor where you want to deploy the appliance.
    • Storage - Use the default value to put storage disks on the Local Citrix Hypervisor Storage.
    • Networking - Select the correct network for your Citrix Hypervisor configuration.
    • Security - This tab is not available. Click Next.
    • OS Fixup Settings - Select Don’t use Operating System Fixup.
    • Transfer VM Settings - Choose the correct network and choose DHCP.
    • Finish - Review your settings and then click Finish.
  5. Switch to Notification view and wait for the deployment to complete. The process can take 20–35 minutes.

  6. Switch to Infrastructure view.

  7. Select your new appliance, which has the name: CentOS-7_x86_64_build_template_Citrix Hypervisor.

  8. Click Properties, and enter a new name and description for your new appliance. The new virtual machine has 8 GB of memory and 4 CPUs.

  9. Type the IP address for the new appliance, and log in as “administrator” with the password “Unidesk1”.

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

Be sure to install the App Layering Agent, if your environment requires it. See the next section for details.

If you want the appliance to use 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:

Citrix Hypervisor