Unable to Configure Citrix App Layering ELM PVS Connector

Unable to Configure Citrix App Layering ELM PVS Connector

book

Article ID: CTX226646

calendar_today

Updated On:

Description

The App Layering Agent (PVS Agent) on the PVS server is registered with the App Layering ELM virtual appliance, and the PVS Server enumerates on the App Layering PVS connector screen. However, clicking "check credentials" an error is displayed stating that the ELM cannot use the credentials on the PVS server since it does not have the rights to execute remote PowerShell commands.

You may also see "Cannot communicate with PVS on server 'ServerName'. Please ensure that the PVS Powershell Snapin has been registered".

Resolution

  1. Log into the PVS Server you are trying to configure as an administrator
  2. Uninstall App Layering PVS Agent 
  3. Reinstall App Layering PVS Agent
  4. Run the following PowerShell command: Enable-PSRemoting 
  5. Ensure that port 8016 is open (Run the "netstat -a" command and check to make sure port 8016 is listening)
  6. 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) 
  7. Run the following command, using the IP address of the ELM where indicated: Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_ELM /u:Administratorname 
  8. When prompted, enter the password for the user used above who has Administrator privileges in the Unidesk Management Console (UMC) on the ELM. 
  9. 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. 
  10. Run PowerShell command to load the appropriate dlls on the PVS Server
    • For PVS 7.7+
      • Navigate to: c:\program files\citrix\provisioning services console
      • Run the command: "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe" Citrix.PVS.snapin.dll
    • For PVS 7.1-7.6
      • Navigate to: c:\program files\citrix\provisioning services console
      • Run the command: "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe" McliPSSnapIn.dll
​Under some circumstances, all of the PVS and Broker snapins can be unregistered.  If you do nt see all 6 snapins when you run "get-pssnapin -registered", see "After upgrading Windows on a PVS server, PowerShell snapins are no longer shown" for how to get all of them reregistered.  This can happen on a major Windows update, for instance.

Problem Cause

The ELM needs to be able to remotely execute commands on the PVS server.

Issue/Introduction

Clicking "check credentials" an error is displayed stating that the ELM cannot use the credentials on the PVS server since it does not have the rights to execute remote PowerShell commands.

Additional Information

See "Install the App Layering Agent" in https://docs.citrix.com/en-us/citrix-app-layering/4/xenserver/install.html