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 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:
|hyperv_x.x.x.zip||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:
|Virtual Machine Name||App Layering Appliance (Enterprise Layer Manager)|
|VIrtual Machine Generation||Generation 1|
Deploy the appliance in Hyper-V
To deploy the appliance:
Extract the download package, citrix_app_layering_hyperv_4.x.x.zip. Two disk (vhdx) files are included.
Copy the disks to a storage location that the Hyper-V server can access.
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.
On the first wizard tab, click Next to begin configuring the virtual machine.
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.
On the Specify Generation tab, ensure that Generation 1 VM’s is selected. Generation 1 only is supported.
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.
On the Configure Networking tab, specify the NIC for the network adapter to use to connect to the network.
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.
On the Summary tab, verify your choices and click Finish.
Back in the Hyper-V Manager, select the VM and click Settings from the VM panel.
Select Hardware > Processor, and set the Number of Virtual Processors to 4.
Select IDE Controller 0 > Hard Drive, click Add.
Select the Virtual Disk radio button, click Browse, and select the repository disk (unidesk_hyperv-repository.vhdx) extracted in step 2.
Power on the VM.
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.
Configure a Static IP address for the appliance, if required
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.
- Log in to the Appliance Configuration utility, using the steps and default password described in Appliance settings.
- At the Action prompt, enter C (for Configure Networking), and press Return.
- 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.
- When prompted, enter Y to save settings.
- At the Action prompt, enter Q to quit.
- Restart the appliance.
Once the appliance is installed and the IP address is correctly configured, you need to: