Knowledge Base: Troubleshooting

  • How to reset the app

    If you experience problems with starting the application, you can reset it by deleting the configuration files. This will remove all your CatLight settings and preferences, so that you can re-configure the application from a clean state.

    Location of configuration files on different platforms

    Windows:

    Mac OS:

    Linux: 

  • Application logs

    If you have a problem with the app, you can inspect the application logs. They will often provide a detailed description of the problem and can also point to the specific project or build that is causing trouble.

    Logs are written in two groups of files: 

    • Log.txt – this is the log file of the background process that contains most of the app logic. It is usually the most useful, so check it first.
    • TrayLog.txt – this is a log file of the UI process. If the application does not start, this log can contain details about the problem.

    Windows

    Logs location:

    Mac OS X

  • Connection problems with self-signed SSL certificates

    If your build server is using self-signed certificate, CatLight may not be able to connect and will show a message like "SSL connect error". This happens because SSL certificate of your server is not trusted by your operating system. 

    Add this certificate as trusted to resolve the problem, and try connecting again.

    Instructions for Windows: https://blogs.technet.microsoft.com/sbs/2008/05/08/installing-a-self-signed-certificate-as-a-trusted-root-ca-in-windows-vista/ 

    For OS X: http://www.robpeck.com/2010/10/google-chrome-mac-os-x-and-self-signed-ssl-certificates 

    For Linux:

    http://askubuntu.com/questions/530056/install-root-certificate-on-ubuntu-14-04-64-bit