Collecting Log Files for the Horizon Cloud Connector Appliance

You can use the Horizon Universal Console or the Horizon Cloud Connector configuration portal to download the log files for a Horizon Cloud Connector virtual appliance. If you cannot access these automated methods for collecting logs, you can collect the logs manually by establishing an SSH connection to the appliance and running a command-line script.

Using the Horizon Cloud Connector Configuration Portal

You can use the appliance's configuration portal to download the log files for the virtual appliance in .zip format. This log collection capability is available before, during, and after you pair the Horizon pod with the cloud control plane. This feature is supported from version 1.7 onwards.

1. Using a browser, navigate to the URL of the Horizon Cloud Connector appliance.
2. In the login screen, enter your Customer Connect account credentials and click Login. If needed, click Accept to continue past the Terms of Service message.
3. Click Download Log in any of the configuration portal screens. Specify a location for the .zip logs package and save the logs package.

Using Horizon Universal Console

After you successfully pair a Horizon pod with the control plane and use the Horizon Universal Console to complete the Active Directory registration workflow, you can then use the console to download the Horizon Cloud Connector logs in .zip format.

1. In the console, navigate to the details page for the pod. Select Settings > Capacity. Click the Pods tab if needed and then click the name of the pod in the list. If needed, click the Summary tab to display the pod's details page.
2. Select More > Download Connector Logs. Specify a location for the .zip logs package and save the logs package.

Using the Command Line

If you cannot access the Download Log button in the Horizon Cloud Connector configuration portal or the Download Connector Logs action in Horizon Universal Console, you can still collect the appliance's log files manually by running the configure-adapter.py command-line script. This feature is supported from version 1.7 onwards.

Locate configure-adapter.py in the Horizon Cloud Connector filesystem to use in the following steps. The configure-adapter.py file is located in a bin directory within the /opt directory structure. For example, for Horizon Cloud Connector version 2.5 and later, the file is located in /opt/horizon/bin directory.

1. Open an SSH connection to the Horizon Cloud Connector appliance.

2. Change to the directory location of the configure-adapter.py file.

3. In the command-line terminal, run the following script:

   configure-adapter.py --archiveLogs
   

   The script bundles the logs and archives them as a .tgz package in the /home/logs directory. You can find the filename of the .tgz archive listed near the end of the script's output.

   For example, the following excerpt shows the output of a script that has saved the Horizon Cloud Connector logs to the cc_logs_20200424_154638.tgz archive in /home/logs.

   Logs archived at /home/logs/cc_logs_20250107_154638.tgz
   ------------------------------------------------------------------------------------
   Archived successfully!
   

4. Then copy the created TGZ file from the appliance's /home/logs directory to /home/ccadmin directory and change the permissions (chmod) to 644. For example, for a file named cc_logs_20250107_154638.tgz, the following block is an example of copying the file and change mode to 644.

   cp /home/logs/cc_logs_20250107_154638.tgz /home/ccadmin/
   chmod 644 /home/ccadmin/cc_logs_20250107_154638.tgz
   

5. Then you can use a tool such as WinSCP to copy the TGZ file to your local system using the ccadmin account.