Skip to content

Troubleshooting

Jose Alonso Solis-Lemus edited this page Jun 1, 2022 · 5 revisions

Contents:

  1. CemrgApp crashes on start
  2. Finding the Log
  3. For bigger problems (logging an issue)

CemrgApp crashes on start

Sometimes when things do not work it is due to CemrgApp not closing correctly, for example, a particular side view window was not closed before closeing the app. When this happens, CemrgApp can crash on loading.

The solution is to remove the autosave folders, which get created and stored automatically. The location of these folders changes depending on the operating system.

On Windows:

  1. Press Ctrl+E to bring up an explorer window
  2. In the path bar type c:/Users/YOUR_USERNAME/AppData/Local/KCL (do not confuse with the search bar at the top-right)
  3. In the folder, delete all folders starting with CemrgApp

On UNIX

  1. Open a terminal and type
rm -rf ~/.local/share/KCL/CemrgApp* 

Finding the Log

Finding errors can be tricky. CemrgApp provides a log file of the actions happening in the background. Accessing it can be very helpful for troubleshooting the app. The log is under Window > Show View > Logging.

The log can be copied into the clipboard and easily shared. This is the best way to troubleshoot any problems with the app.

For bigger problems (logging an issue)

Issues section of the repository can be used to track todos, bugs, feature requests, and more. As issues are created, they’ll appear here in a searchable and filterable list. To get started, you should create an issue.