--- sourceDocument: Yokohama IT Operations Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management Release : - yokohama ft:locale : - en-US ft:publication_title : - Yokohama IT Operations Management ft:clusterId : - itom bundleId : - itom workflow : - Technology --- # Mapping application services containing Citrix XenApp and Presentation Server # Mapping application services containing Citrix XenApp and Presentation Server {#ariaid-title1} * Release version: Yokohama * * Updated January 30, 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read Service Mapping can discover application services containing Citrix XenApp, Presentation Server, and Citrix Usage Collector. ## Discovered components {#mapping-services-citrix__section_arn_hc1_4fb} {#mapping-services-citrix__table_vnn_x21_4fb__entry__6} | Name | Platform | Version | Protocol | Discovery type | Pattern (or probe if indicated) | |-|-|-|-|-|-| | Citrix XenApp Server | Windows | 6.x\>6.5, 7.x\<7.6 | WMI WinRM | Horizontal and top-down | Citrix XenApp or Presentation Server | | Citrix Presentation Server | Windows | 4.x, 5.x, 6.x\<6.5 | WMI WinRM | Horizontal and top-down | Citrix XenApp or Presentation Server | | Citrix Usage Collector | Windows | 7.x\>7.5, 8.x | WMI WinRM | Top-down | Citrix Collector | | Generic application based on the Icon Path | Windows | - | WMI WinRM | Top-down | Citrix Application Icon Path | [ ] {#mapping-services-citrix__table_vnn_x21_4fb} ## Map application services containing Citrix XenApp and Presentation Server {#ariaid-title2} 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 {#map-service-containing-citrix__ul_emk_43d_cw} * On the ServiceNow AI Platform, configure a domain user for accessing the Windows OS as described in [Windows credentials](https://www.servicenow.com/docs/access?context=r_WindowsCredentialsForm&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). 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](https://www.servicenow.com/docs/access?context=enable-winRM-MID-servers&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) * 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 ServerApplications. 2. Locate the Icon Path folder in the navigation tree. 3. Right-click the Icon Path folder and click Copy path. {#map-service-containing-citrix__ol_jcr_bq1_4fb} * (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. {#map-service-containing-citrix__ul_anp_l41_4fb}Role required: service_mapping_admin ### Procedure 1. Create a service instance. 1. Navigate to AllService MappingService Instances. 2. Click New. The Discoverable by Service Mapping option is selected by default. 3. In the Name field, enter a descriptive name for the service instance. {#map-service-containing-citrix__substeps_fmn_1by_32b} 2. Define the entry point for this service instance: 1. Select the Citrix XenApp tile. 2. Define entry point attributes. {#map-service-containing-citrix__table_g14_lw1_4fb__entry__2} | Attribute | Description | |-|-| | Host | The URL of the Citrix XenApp or Presentation Server. The URL must contain a VIP IP or a physical host. | | Port | The port that the Citrix XenApp or Presentation Server uses on the host. | | Icon Path | The 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. | | URL | The URL must contain a VIP IP or a physical host. For example, http://\/Citrix/StoreWeb. | [ ] {#map-service-containing-citrix__table_g14_lw1_4fb} 3. Click Add. 4. Click Save. {#map-service-containing-citrix__substeps_jxv_qby_32b} 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.
{#map-service-containing-citrix__substeps_tzh_ycy_32b} If the mapping result is not as you expected, perform basic troubleshooting. {#map-service-containing-citrix__table_kjv_sdkwo0_3556__entry__3} | Symptom | Cause | Solution | |-|-|-| | 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 : RuntimeException | The 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 installed | The 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. | [ ] {#map-service-containing-citrix__table_kjv_sdkwo0_3556} *[\>]: and then