Nutanix AHV
To install the App Layering service, you deploy the appliance to a virtual machine on your hypervisor.
- Requirements. Make sure you have the required Nutanix accounts, settings, and resources.
- Install the App Layering appliance in Nutanix. - To install the appliance, you download the installation package and deploy the appliance in Nutanix.
- If the appliance needs a Static IP address. - You can set a Static IP address by accessing the appliance configuration utility.
- Next steps. - Links to steps for installing the App Layering agent and configuring the App Layering service.
Requirements
If you are installing the appliance and building your Layers on Nutanix VMs, or you are publishing Layered Images that will be used in a Nutanix environment, you need the following settings and resources:
-
Nutanix account and privileges
- An existing or new Nutanix AHV account to use for App Layering.
- The account must have Nutanix AHV privileges to:
- Create and remove virtual disks.
- Copy and delete layers on virtual disks using Nutanix file APIs.
-
Nutanix software and settings - Access to the Nutanix Tools to install on the layer.
-
Nutanix resource information - The info listed in the Nutanix AHV Connector Configuration.
Install the App Layering appliance in Nutanix AHV
To deploy the App Layering appliance to Nutanix:
- Verify the contents of the installation package.
- Deploy the appliance.
Installation package
Note:
As of release 2409, we no longer include a repository disk with the installation package. You must create a new disk and attach it to the appliance VM.
The installation package, citrix_app_layering_nutanix_xx, includes:
| File | Description |
|---|---|
nutanix_xx.x.x.x.zip |
Contains the IMG file for the appliance VM |
citrix_app_layering_agent_installer.exe |
App Layering Agent installer |
citrix_app_layering_os_machine_tools_xx.x.x.exe |
OS Machine Tools |
Deploy the appliance in Nutanix
- Extract the download package,
citrix_app_layering_nutanix_xx.x.x.zip. The files included are listed above. - Next, unzip the
nutanix_xx.x.x.zipfile, containing oneimgfile. - In the Nutanix Prism console, select the Tools menu in the top right corner of the UI, and choose Image Configuration.
- Click the Upload Image button, and name the disk.
- Select the DISK Image Type.
- Select the Upload a File option, browse to your file share, and choose the App Layering Boot Disk (
citrix_applayering_nutanix-system.img). Wait for the upload to complete. - Select Tasks and make sure both the Image Create and Image Update tasks are complete. Once this is done, you can create the virtual machine.
- Select the VM (Virtual Machine) tab on the top left drop-down menu, and click the Create VM button.
- In the General Configuration section, complete the Name and Description of the new VM.
- In the Compute Details section, set VCPU(S) to 1.
- Set the Number of Cores per vCPU to 4.
- Set Memory to 8 GB.
- Add the system disk. In the Disks section, click Add new disk and choose type Disk.
- In the Operation drop-down menu, choose Clone from Image Service.
- In the Bus Type drop-down menu select SCSI.
- In the Image Box select the Boot disk that you uploaded during step (4), and click Add.
- Add the repository disk. In the Disks section, click Add new disk and choose type Disk.
- In the Operation drop-down menu, choose Allocate on Storage Container.
- In the Bus Type drop-down menu select SCSI.
- In the Size (GiB) box, enter 300 GB (or an appropriate size of your choosing) and click Add.
- Remove the CD-ROM (IDE) disk from the Disks.
- In the Boot Configuration section, select the UEFI radio button
- Select the Secure Boot checkbox.
- Add NIC by clicking on Add new NIC.
- Click Save to create the VM.
- Power on the VM.
Add the Citrix App Layering appliance to the Nutanix allow list
Be sure to add the appliance to the Nutanix allow list, so that the appliance is allowed to connect to Nutanix.
If the appliance needs a Static IP address
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.
- 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
Dfor Dynamic (DHCP) orSfor 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. - When prompted, enter
Yto save settings. - At the Action prompt, enter
Qto quit. - 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, if necessary, and configure the App Layering service. See When the agent is required.