Mapping application services containing Citrix XenApp and Presentation Server

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

Discovered components

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

Map application services containing Citrix XenApp and Presentation Server

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

始める前に

• 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.
  注:

  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

手順

1. Create a service instance.
   1. Navigate to All > Service Mapping > Service 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.
2. Define the entry point for this service instance:
   1. Select the Citrix XenApp tile.
   2. Define entry point attributes.

      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://<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.

      
      
      

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

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.