13.4 Enabling Launcher logging

About the launcher

The Desktop App must run initial checks and configurations before starting. These are done by the ClickShare launcher during startup. It is not possible for the user to interact or control the launcher.

About logs

Logs provide additional context and information about the ClickShare system at the point of failure. This can be used by the service team to diagnose potential problems with the ClickShare or the configuration. It is recommended to share logs whenever a service ticket is created.

Prerequisites

The Desktop App must be closed before the logging mode can be activated. For more information, see “Quit”.

Terminal
A terminal is a program that lets a user do actions through commands in a Command Line Interface (CLI). These actions are often intended to affect specific folders or locations on the device. For this reason, it is important to be aware of the active directory (folder) that the terminal is currently working with.
How to enable
  1. Open the terminal with administrator rights.

  2. Change the root folder using the following command:

    • For Windows, cd C:\Program Files (x86)\Barco\ClickShare Extension Pack\Launcher
    • For MacOS, cd /Applications/ClickShare\ Launcher.app/Contents/MacOS/

  3. Enable logging of the launcher using the following command:

    • For Windows, clicksharelauncher.exe -enablelogging
    • For MacOS, ./clicksharelauncher -enablelogging
  4. Recreate the issue, bug or problem.

  5. Create a .zip file of all files in the folder location:

    • For Windows, %localappdata%/Barco/ClickShare Launcher
    • For MacOS, ~/Library/Application Support/Barco/ClickShare Launcher/
  6. Create a support ticket on the Barco support page with the zipped folder attached.