Product Documentation

Install

Jan 11, 2018

Before you start

To get started with App Layering, you will need:

Installation package

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

File Description

Nutanix_x.x.x.zip

IMG files for the appliance VM

citrix_app_layering_agent_installer.exe

App Layering Agent installer

citrix_app_layering_win_gold_image_tools.exe

OS Machine Tools

Deploy the App Layering Appliance (Nutanix AHV)

  1. Log in to the Citrix Cloud. A Citrix App Layering tile should be displayed at the bottom of the page.
  2. On the Citrix App Layering tile, click Request Trial, and check your email for a message from Citrix Cloud.

  3. In the message you received, click the Sign In button. This returns you to layering.cloud.com.

  4. Click Manage on the App Layering tile. The Citrix App Layering page is displayed.

  5. Get familiar with the service by reading the Overview. When ready, click the Get Started button to open the Getting Started tab.

  6. Under Step 1, click the Get Cloud Connector button, and for instructions click the Documentation link.

  7. Use the Connector documentation to install a Cloud Connector, then return to the Getting Started tab.

  8. At the top of the page select the hypervisor where you are deploying the App Layering service. This selection determines which platform-specific installation package will be downloaded in Step 2.

  9. Under Step 2, click the Download for Hypervisor button to download the appliance installation package for the hypervisor you have selected.

  10. Under Step 3, right-click Instructions, open the page in a new browser tab, and select your hypervisor. The installation instructions for your hypervisor are displayed.

  11. Extract the download package, citrix_app_layering_nutanix_4.x.x.zip. The files included are listed above.

  12. Next, unzip the nutanix_4.x.x zip file, containing two IMG files.

  13. In the Nutanix Prism console, select the Tools menu in the top right corner of the UI, and choose Image Configuration.

  14. Click the Upload Image button, and name the disk.

  15. Select the Disk Image Type.

  16. Select the Upload a File option, browse to your file share, and choose the App Layering Boot Disk (the "system" IMG). Wait for the upload to complete.

  17. Repeat steps 13 - 16 for the Local Storage Disk (the "repository" IMG).

  18. Select Tasks and make sure that for each of the disks, both the Image Create and Image Update tasks are complete. Once this is done, you can create the VM.

  19. Select the VM tab on the top left dropdown menu, and click the Create VM button.

  20. Complete the Name and Description of the new VM.

  21. Set VCPU(S) to 1.

  22. Set Number of Cores per VCPU to 4.

  23. Set Memory to 8 GB.

  24. To add the Disks to the VM, click Add new disk and choose type Disk.

  25. In the Operation drop-down, choose Clone from Image Service.

  26. In the Bus Type drop-down select IDE.

  27. In the Image Box select the Boot disk that you uploaded, and click Add.

  28. Repeat the above steps for the following disks:

    Boot Disk: citrix_applayering_nutanix-system.img

    Repository Disk: citrix_applayering_nutanix-repository.img

  29. Add NIC by clicking on Add new NIC.

  30. Click Save to complete dialog and create VM.

  31. Power on the VM.

  32. Back in the Cloud, under Step 4, the Documentation link opens the instructions for logging in. (The link below opens the same article.)

  33. Click the Log into Appliance button. This opens the Manage tab. Follow the instructions (link below) to log into the appliance.

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 receive the error: "Cannot create UUID from string "undefined""

Ensure that you have waited for both tasks for each disk to be completed before attempting to create the VM.

Install the App Layering Agent (required for PVS and Connector Scripts)

The App Layering Agent enables the App Layering appliance (Enterprise Layer Manager) or a Unidesk Packaging Machine VM to run PowerShell commands locally. If you supply the proper credentials, the agent can run PowerShell commands as a specific user.

The App Layering Agent is required in cases where one of your Connector Configurations launches a PowerShell script. This includes Connector Configurations you use to:

  • Publish Layered Images to a provisioning system.
  • Package Layers in your hypervisor environment.

The App Layering Agent installer prompts you to register the agent with a App Layering appliance. If you do not register the agent during installation, you can manually register it later. However, keep in mind that the PowerShell scripts will not run until the agent is registered with the ELM.

Prerequisites

Before you install the App Layering Agent, you must have the following requirements on the system where you are installing the App Layering Agent:

  • An account with administrator privileges
  • .NET 4.5
  • PowerShell 3.0 or greater
  • PowerShell Snap-in
    Before using the App Layering Agent on a PVS server you must ensure the PowerShell Snap-in is installed. This is a manual step.
    • For PVS 7.7 and later, you must install the Powershell Snap-in Citrix.PVS.Snapin.dll.
    • For PVS 7.6 and PVS 7.1, you must install McliPSSnapIn.dll. Use the installutil.exe to install the Snap-in.

Example (7.6):
From a command prompt, go to: c:\program files\citrix\provisioning services console
Run this command: "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe" McliPSSnapIn.dll

Example (7.7):
From a command prompt, go to: c:\program files\citrix\provisioning services console
Run this command: "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe" Citrix.PVS.snapin.dll

On Windows 2008 R2, you must also enable PowerShell remote commands. For background information, see this Microsoft article: https://technet.microsoft.com/en-us/library/hh849694.aspx

If your 2008 R2 OS does not have PowerShell remoting enabled, run the following PowerShell command on the PVS server: Enable-PSRemoting  

Install the App Layering Agent

  1. Log in as an administrator on the system where you are installing the agent.

  2. Download the App Layering Agent from the Unidesk Download page.

  3. Copy the Unidesk_agent_installer.exe file from the App Layering Agent folder to a convenient location on the PVS server.

  4. Run the Unidesk_agent_installer.exe as Administrator, and when prompted, enter the path to the directory where you want to install the App Layering Agent. The default location is C:\\Program Files (x86)\Unidesk\Agent.

  5. The App Layering Agent installer checks to see if all Prerequisites are present. If any prerequisites are missing, the installer reports this and exits without installing.

  6. The installer prompts you for an Agent Port number. You can accept the default port number (8016) or specify a different one if the default port is already in use.

  7. The installer prompts you for the credentials (address, username, and password) for your App Layering appliance. Register the App Layering Agent with the ELM by entering the IP address and login credentials for a Unidesk Management Console (UMC) user on the ELM with Administrator privileges, (for example, the credentials you use to log into the UMC).
    Note: If the App Layering appliance is not available yet or you choose not to register with it now, you can manually register at a later time using the procedure described in Register with the App Layering appliance manually.

  8. Click Finish to exit the wizard.

Register the App Layering Agent manually

If the App Layering Agent was not registered with a App Layering appliance during installation, you can register it later by using the following procedure.

To manually register the App Layering Agent with the ELM:

  1. As an administrator, log in to the server where you installed the App Layering Agent.

  2. Open a command window (cmd.exe) as administrator and navigate to the directory where the App Layering Agent is installed. (The default location is C:\\Program Files (x86)\Unidesk\Agent.)

  3. Run the following command, using the IP address of the ELM where indicated:

    Unidesk.Agent.Service.exe register /i /e:IP_address_of_ELM /u:Administrator

  4. When prompted, enter the password for a user who has Administrator privileges in the Unidesk Management Console (UMC) on the ELM.

  5. When the registration process completes, a message appears informing you of the successful outcome. The App Layering Agent registration appears in the Audit log for the Management Service in the UMC.

If the process does not succeed, examine the \Unidesk\Agent\Logs\unidesk.agent.log file in the App Layering Agent installation directory. You can also view Help for the App Layering Agent command line options by running the following command: Unidesk.Agent.Service.exe /?.