Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Mapping Citrix XenApp and Presentation Server services

Service Mapping can discover application services containing Citrix XenApp, Presentation Server, and Citrix Usage Collector.

Discovered components

NamePlatformVersionProtocolDiscovery typePattern \(or probe if indicated\)
Citrix XenApp ServerWindows6.x>6.5, 7.x<7.6WMI WinRMHorizontal and top-downCitrix XenApp or Presentation Server
Citrix Presentation ServerWindows4.x, 5.x, 6.x<6.5WMI WinRMHorizontal and top-downCitrix XenApp or Presentation Server
Citrix Usage CollectorWindows7.x>7.5, 8.xWMI WinRMTop-downCitrix Collector
Generic application based on the Icon PathWindows-WMI WinRMTop-downCitrix Application Icon Path

Parent Topic:Map a single application service using classic Service Mapping

Map Citrix XenApp and Presentation Server services

Map an application service containing Citrix XenApps, Presentation Servers, and Citrix Usage Collectors and verify that Service Mapping discovered all Citrix components correctly.

Before you begin

  • Provide a user with permissions to read and query the Citrix repository:
    • For versions 4.5 and later, a PowerShell script from the XenApp server.
    • For versions earlier than 4.5, a Microsoft Visual Basic Script (VBScript) from the Citrix Presentation Server
  • On the ServiceNow AI Platform, configure a domain user for accessing the Windows OS as described in Windows credentials.

    Note: To use this credential later for XenAPP, set the Credential alias attribute to cmdb_ci_appl_citrix_xenapp. To use this credential later for Citrix, set the Credential alias attribute to cmdb_ci_appl_citrix_collector.

  • (Optional) To discover using the WinRM protocol, see Configure WinRM trusted hosts on MID Server

  • Configure a user with permissions to run PowerShell commands on the Citrix server.
  • (For discovery of Citrix Presentation Server only) Find out the icon path for the entry point:
    1. In the Citrix Access Management Console, navigate to Presentation Server > Applications.
    2. Locate the Icon Path folder in the navigation tree.
    3. Right-click the Icon Path folder and click Copy path.
  • (For discovery of Citrix XenApp Server only) Find out the icon path for the entry point by checking the Distinguish Name attribute for the Icon Path.

Role required: service_mapping_admin

Procedure

  1. Create a service instance.

    1. Navigate to All > Service Mapping > Service Instances.

    2. Select New.

      The Discoverable by Service Mapping option is selected by default.

    3. In the Name field, enter a descriptive name for the service instance.

  2. Define the entry point for this service instance:

    1. Select the Citrix XenApp tile.

    2. Define entry point attributes.

      AttributeDescription
      HostThe URL of the Citrix XenApp or Presentation Server. The URL must contain a VIP IP or a physical host.
      PortThe port that the Citrix XenApp or Presentation Server uses on the host.
      Icon PathThe path to the logical application location as it appears in the Citrix Access Management Console. The path must start with the Applications folder. For example, /Application/Jane/Windows Media Player.
      URLThe URL must contain a VIP IP or a physical host. For example, http://<host>/Citrix/StoreWeb.
    3. Click Add.

    4. Click Save.

  3. Click Additional Info on the left and clear the Traffic based discovery check box.

  4. Click Update.

  5. Verify that the mapping result is satisfactory:

    1. Click View map and wait until the mapping is complete.

      It may take a few minutes.

    2. Review the application service map and make sure that it resembles in the following example.

Image omitted: Citrix-XenApp-top-down-map.png
Check the result of mapping an application service containing the XenApp Servers and other environment components.

If the mapping result is not as you expected, perform basic troubleshooting.

SymptomCauseSolution
Discovery failed. The discovery log displays the message that starts with the following text: You do not have sufficient permissions.The indication sections of the pattern fail, because the user does not have permissions for running PowerShell commands.Make sure that you provided a user with permissions to run PowerShell commands on servers that host Citrix XenApp, Presentation Server, or Citrix Usage Collector.
Discovery failed. The discovery log displays the error message that includes the following text:CategoryInfo : NotSpecified: \(:\) \[\], PSSecurityException+ FullyQualifiedErrorId : RuntimeExceptionThe MID Server cannot run PowerShell commands remotely, because the execution policy is set to RemoteSigned on the target servers.Use the `set-executionpolicy remotesigned` command on the target servers to enable the MID Server to successfully run PowerShell commands.
Discovery failed. The discovery log displays the error message that includes the following text:Import-XAFarm : The Citrix Common Commands PowerShell Snapin is not installedThe target host does not have this PowerShell library: Citrix Common Commands PowerShell Snapin.Download and install PowerShell SDK for Citrix XenApp on all servers hosting Citrix XenApp, Presentation Server, or Citrix Usage Collector.
The application service map shows the Citrix Delivery Controller, but does not include the Citrix XenApp, Citrix Presentation Server or Citrix Usage Collector.The icon path you defined is incorrect.Verify the icon path and reenter it in the entry point attributes for the application service.