How to Troubleshoot Installation Failures on Citrix Cloud Connector for Windows

Check Windows Services

The first step in diagnosing any issues with Cloud Connector installation is to evaluate the health of the connector machine.

·Login to the Connector machine as administrator.

·RunServices.mscfrom either the Start Menu or from a Command Prompt.

·The following Citrix services are required to be in Started state for the Cloud Connector’s communications with the Citrix Cloud.

Solutions

·Try to manually start any stopped services and see if that solves the issue.

·If services are unable to start, review the logs (discussed later) and event view for clues.

·If the services are not listed, the install likely did not complete properly.

·This may require an uninstall, reboot and reinstall of the controller software.



Connectivity Test

·It is important that the Connector meet the properconnectivity requirementsprior to installation.

Tools

·To troubleshoot connectivity issues quickly, run theCloud Connector Connectivity Check Utilityto verify the Machine has the required connectivity.

·Investigate and resolve any proxy or firewall errors.

Advanced Logging

·Enable AdditionalDebug Loggingfor Proxy Events on Citrix Cloud Connector

Solutions

Event messages

  • Event messages are available in the Windows Application Event viewer on the Cloud Connector machine.
  • All Citrix Services report messages to the event viewer.

·Locate any relevant errors that coincide with the time of the install failure.

Event messages

Event messagesare available in the Windows Event viewer on the Cloud Connector machine.

·The Windows event logs that the Cloud Connector generates are in the following documents:

·Connector Agent Provider [XML format]

·Connector AgentWatchDog Provider [XML format]

Connector Installation Logs

·Recentinstallation logsare located here:

%LOCALAPPDATA%TempCitrixLogsCloudServicesSetup.

·Additionally, historical install logs are added to:

%ProgramData%CitrixWorkspaceCloudInstallLogs

·Search the text files for errors or exceptions.

·Look for key points of interest, like where packages are installed successfully, or communications are being tested.

·Look for any errors that might be related to the exact time of the install failure.

·Common Exit codes

·1603 – An unexpected error occurred.

·2 – A prerequisite check failed.

·0 – Installation completed successfully.

Solutions

·Make sure the installationpre-requisitesare met.

·Make sure the Windows systems are in good health and fully updated.

·Reboot the machine prior to running the install.

Connector logs

·By default, event logs are located in this directory of the machine hosting the Cloud Connector:

C:ProgramDataCitrixWorkspaceCloudLogs

·The plugins folder contains many logs that coincide with the Citrix Windows Services.

C:ProgramDataCitrixWorkspaceCloudLogsPlugins

·Browse these logs if a specific service is failing to start.

Solutions

·Make sure the installationpre-requisitesare met.

·Make sure the Windows systems are in good health and fully updated.

·Reboot the machine prior to running the install.

Related:

Leave a Reply