To start installing App Layering, you need the following:
The installation package, citrix_app_layering_xenserver_4.x.x, includes:
OVA file for the appliance virtual machine
App Layering Agent installer
OS machine tools
a. Select your new appliance, which has the name
b. 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.
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.
The App Layering Agent is required for Provisioning Services and connector scripts.
The App Layering Agent enables the App Layering appliance, also known as Enterprise Layer Manager (ELM) or the App Layering packaging machine virtual machine 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 starts a PowerShell script. The script includes connector configurations that you use to do the following.
The App Layering Agent installer prompts you to register the agent with an App Layering appliance. If you do not register the agent during installation, you can manually register it later. However, remember that the PowerShell scripts do not run until the agent is registered with the ELM.
Before you install the App Layering Agent, you must have the following requirements on the system where you are installing the App Layering Agent:
At a command prompt, type:
At a command prompt, type this command and then press Enter:
At the command prompt, type:
At the command prompt, type this command and then press Enter:
On Windows 2008 R2, you must also enable PowerShell remote commands. For background information, see the Microsoft article Enable-PSRemoting.
If your 2008 R2 OS does not have PowerShell remoting enabled, run the following PowerShell command on the Provisioning Services server:
If you previously installed the App Layering Agent, you can download updated versions from the Citrix downloads page. The App Layering Agent is a standalone installation package and is also included in the full App Layering software package.
To download the App Layering Agent
To install the App Layering Agent
Log on as an administrator to the system where you are installing the agent.
Copy the file citrix_app_layering_agent_installer.exe from your computer to the Provisioning Services server.
Run the installation program as an administrator. When prompted, type the path to the directory where you want to install the App Layering Agent. The default location is C:\\Program Files (x86)\Unidesk\Agent.
The App Layering Agent installer checks to ensure that all the prerequisites are present. If any prerequisites are missing, the installer notifies you and then exits without installing.
The installer prompts you for an Agent Port number. You can accept the default port number (8016). If the default port is in use, you can specify a different port number.
The installer prompts you for the credentials (address, user name, and password) for your App Layering appliance. Type the IP address and logon for an administrator with permission to access the App Layering management console.
If you don't register the App Layering appliance now, you can register the appliance later. For more information, see the procedure Register with the App Layering appliance manually.
Click Finish to exit the wizard.
Register the App Layering Agent manually
If you did not register the App Layering Agent with an App Layering appliance during installation, you can register it manually.
To register the App Layering Agent manually
Log on as an administrator to the server where you installed the App Layering Agent.
Open a command window (cmd.exe) as an administrator. Go to the directory where you installed the App Layering Agent. For example:
CD c:\\Program Files (x86)\Unidesk\Agent
Run the following command by using the IP address of the App Layering appliance where indicated:
Unidesk.Agent.Service.exe register /i /e:IP_address_of_ELM /u:Administrator
When prompted, type the password for an administrator with privileges. Ensure that the password is for the App Layering management console.
When registration is done, a message appears that informs you of the successful outcome. The App Layering Agent registration appears in the audit log for the management service.
If the process is not successful, review the log file at \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: