Diagnosing your Connector Appliance

If you have problems with your Connector Appliance, you can generate and download a diagnostic report to assist with diagnosing and resolving the problem.

For more information, see the product documentation.

Generating a diagnostic report

Use this call to request a diagnostic report from your Connector Appliance. The diagnostic reports are provided in a .zip file.

Request

GET /report HTTP/1.1
Accept: */*
Host: <connector-appliance-ip-address>
Connection: keep-alive
<!--NeedCopy-->

Response

HTTP/1.1 200 OK
<!--NeedCopy-->

The response provides a zip file that includes diagnostic reports.

Check the time

The time on the Connector Appliance may differ from the time on from Citrix Cloud. If they differ by a few minutes this may cause authorization issues communicating between them.

The Citrix Cloud time can be found by calling https://agenthub.citrixworkspacesapi.net/root/utctime. Check the hypervisor time setup and the Connector Appliance NTP network settings if they differ significantly.

Request

GET /utctime HTTP/1.1
Accept: application/json; charset=utf-8
Host: <connector-appliance-ip-address>
Connection: keep-alive
<!--NeedCopy-->

Note:

No Authorization header is required to call this endpoint.

Response

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
...
"2022-06-09T14:50:14.3485404Z"
<!--NeedCopy-->
Resources
Connector Appliance APIs OpenAPI Specification
Copy Download
Diagnosing your Connector Appliance