Stellarmate offers an application that makes it simpler for StellarMate users to send debug logs to StellarMate Developers. Ekos Debugger allows users to start up KStars and/or INDI and whenever an error occurs and/or a crash happens, users are able to save the logs and attach them to a ticket.

How to use Ekos Debugger

1. VNC into your StellarMate or use any other method to view the StellarMate Desktop.

2. Double-click on the Ekos Debugger icon

ekosdebugger click

3. Ekos Debugger can be used to Debug either KStars/Ekos or INDI drivers. Decide which mode you want to run the debugger with. Each mode has its own tab in Ekos Debugger.

KStars

Select KStars if the crash occurs in KStars/Ekos (e.g KStars abruptly shuts downs and restarts).

INDI

Select INDI if you recieve messages that a particular driver crashes while using Ekos. For example, if the QHY driver crashes, you'd get a message that says that indi_qhy_ccd driver crashed. In this case, INDI driver needs to be debugged and not Ekos.

Debugging KStars

To debug KStars/Ekos crashes, make sure you are on the KStars tab and then select the modules that are usually crashing with your profile and then click Start.

Note: You can click on the Restart on Crash checkbox to toggle automatic reloading of KStars/INDI.

ekosdebugger kstars

KStars/INDI should now be open, proceed with starting your profile and using StellarMate normally.

ekosdebugger kstars open

Debugging INDI

To debug INDI driver crashes, make sure you are on the INDI tab and then select the equipment profile and driver to debug.

ekosdebugger indi1. Select which equipment profile to debug.

2. Select which driver to specifically debug (e.g. Above we selected QHY CCD camera driver).

Then click the Start button to start INDI server debugging process. Once that is started, launch KStars and edit your equipment profile:

1. If your profile was set to Local, simply switch it to Remote and leave everything as is.

2. If your profile was already set to Remote, ensure the remote host is set to localhost and that INDI Web Manager button is unchecked.

ekosdeubbger indi profile

Save your equipment profile and then start it. Continue to use Ekos normally until you detect a driver crash. Send the crash logs as explained below.

Sending Crash Logs

When KStars or INDI crashes, click on the Save Logs button and choose the folder where the logs will be saved.

ekosdebugger saveprocess

Navigate to your Logs folder in order to retrieve your logs.

ekosdebugger logs folder

Next, you can now open a new ticket or go to your existing ticket, and attach the .zip log file by clicking on Upload Files to get support.

ekosdebugger ticket

Details

Created : 2020-07-16 07:35:39, Last Modified : 2022-04-30 06:32:09