Product Documentation

MS Azure

To install the App Layering service, you deploy the appliance to a virtual machine using the Azure resource manager.

  • Requirements. - Make sure you have the Azure resources you need to install the appliance.
  • Install the App Layering appliance in Azure. - To install the appliance, you download the installation package and deploy the appliance.
  • Next steps - Links to steps for installing the App Layering agent and configuring the App Layering service.

Note: If you have not already set up a connection to an Azure Virtual Network, see Get started with Azure for more information.


Before installing App Layering in Azure, be sure you have the following.

  • An Azure account and subscription

    To deploy and configure the App Layering appliance, you will need the credentials for an account that has administrative access to your Azure subscription. For more information, refer to the Microsoft Azure Sign in page.

  • A Virtual Network in Azure

    Your deployment in Azure can operate in a point-to-site or site-to-site Virtual Network. The appliance and its network file share must have network connectivity. However, the appliance does not require network connectivity to the layered images you publish. A site-to-site connection between your corporate and Azure networks is recommended for accessing the management console on the appliance. For more information, refer to the Microsoft Azure Virtual Network page. Note: If you have not already set up a connection to an Azure Virtual Network, see Get started with Azure for more information.

  • A Network File Share (Azure specifics)

    A file share server in Azure performs significantly better than an on-premise file share. Even though the Azure File Share feature is not supported, you can use an existing network file share or create a new file share in the Azure environment. Important: Using Premium Storage is strongly recommended.

  • Azure Resource Manager

    App Layering is designed to work with Azure’s new Resource Management (ARM) model. It does not support Azure’s Classic deployment model. All resources such as virtual network, file shares and OS machines that App Layering will work with must be created with Azure Resource Manager. For more information, refer to the Azure Resource Manager overview page.

  • Azure Powershell v5

    Azure Powershell v5 must be installed on the Windows system that will be used to install the appliance in Azure.

Install the App Layering appliance in Azure

To deploy the App Layering appliance to Azure:

  • Check the contents of the installation package.
  • Learn what’s included in the installation script.
  • Deploy the appliance.

Installation package

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

File Description VHD file for the appliance VM
AzureELMDeploymentV5.ps1 Installation Script
citrix_app_layering_agent_installer.exe App Layering agent installer
citrix_app_layering_os_machine_tools.exe OS Machine Tools
DeployAzureRmVm.template.json App Layering template

Installation script

The installation script included in the installation package does the following.

  • Copies the included VHD to the Azure location you specify.
  • Creates a virtual machine in Azure using the VHD,
  • Attaches the repository disk.
  • Boots the Azure appliance.

When you run the script:

  • IMPORTANT: Be sure to note the Resource group location you select, as you will need this information later. For more information about resource groups, refer to Using the Azure Portal to manage your Azure resources.
  • When selecting a virtual machine size, it is strongly recommended that you select a machine with 4 CPUs, and at least 14 GB of memory (script default).
  • The name you specify for the new virtual machine must comply with Azure naming conventions.
  • Select a Virtual Network in which HTTP port: 80 is accessible (Public IP can be disabled).

Deploy the appliance in Azure

The App Layering ZIP download requires 31GB of space when uncompressed.

  1. Extract the download package, The files included are listed above.
  2. Extract the ZIP file to a folder on your local drive.
  3. Open an Azure Powershell window.
  4. Execute the AzureELMDeploymentV5.ps1 script and answer the prompts. The script:
    • Copies the VHD to the Azure location of your choice, and attaches the repository disk.
    • Boots the appliance.
    • If the script fails, check the values to make sure that the values are correct for your environment.

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.

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: