How to enable debug logging for Citrix WEM Cloud Authentication Service and Citrix WEM Cloud Messaging Service on Cloud Connectors

How to enable debug logging for Citrix WEM Cloud Authentication Service and Citrix WEM Cloud Messaging Service on Cloud Connectors

book

Article ID: CTX253841

calendar_today

Updated On:

Description

The Workspace Environment Management (WEM) service is a Citrix Workspace product.
Similar to on-premise WEM, the WEM Service Agent needs to connect to the WEM service Broker.
In order to do so, the WEM Service Agent must first request the WEM service Broker's URL and a service key from a Citrix Cloud Connector (CCC) before it can connect to the WEM service Broker.
After retrieving the Broker URL and service key from the CCC, the Agent connects to the WEM service Broker using the provided URL. The Agent presents the service key, the WEM service Broker validates the service key, and communications between the Agent and WEM service Broker commence.

The Citrix WEM Cloud Authentication Service on the CCC handles the Broker URL/service key requests.

Note: After Agent to Broker comms has completed, the service key is no longer valid, and so the Agent must request a new WEM service Broker URL and service key, each time it needs to communicate with the WEM service Broker.

After enabling debug logging for the Citrix WEM Cloud Authentication Service on the CCC, the log file only contains entries related to these Agent requests. Refer to the instructions below.


Instructions

To enable debug mode for WEM connector provider, log on to cloud connector machine and create following values in registry key HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\WEM\ConnectorSettings
  • DWORD value AuthServiceDebugMode and set value to 1
  • DWORD value MessagingServiceDebugMode and set value to 1

After creating the registry values, restart following services:
  • CitrixWemAuthSvc (Citrix WEM Cloud Authentication Service)
  • CitrixWemMsgSvc (Citrix WEM Cloud Messaging Service)
Generated log files are in the C:\ProgramData\Citrix\WemProvider folder.

Note: Enabling Citrix WEM Cloud Messaging Service debug logging is not required to troubleshoot WEM Service Agent to WEM service Broker communications issues - it has only been included here for the sake of completeness.