MIDAS Knowledge Base MIDAS Knowledge Base

How to enable debug logging

Note: This article applies to self-hosted editions of MIDAS only

If when using your MIDAS scheduling system you see a "MIDAS encountered an unexpected error" or "Unable to save settings" error message in your browser, then to help identify the specific cause of the error you may need to enable debug logging.

For security reasons, debug logging in MIDAS is disabled by default, and therefore in the unlikely event that your MIDAS encounters an error, very limited information will be shown to end-users.

If you're running MIDAS v4.16 (or later), then you can enable/disable debug logging via MIDAS Admin Options → Manage MIDAS → Miscellaneous → Enable Debug Logging.

If the error prevents you from reaching the Manage MIDAS settings page, or you're running MIDAS v4.15 (or earlier), then please do the following:

MIDAS v4.16+

To enable debug logging, you will need access to the server where your MIDAS resides, and you'll need to do the following:
  1. Locate the "midas.dat" file and open this in a standard text editor. This is a JSON file.
  2. Search the file for the phrase "debug", if present, change its corresponding value from empty/zero to "3". If the phrase isn't present in the "midas.dat" file, then add it:
  3. On the second line of this file, add the following on its own line (ensuring the line ends with a comma):
    "debug" : 3,
  4. Save changes to the midas.dat file back to your server.

MIDAS pre v4.16

To enable debug logging if you're running an earlier version of MIDAS (pre v4.16), you will need access to the server where your MIDAS resides, and you'll need to do the following:
  1. Locate the "midasglobal.dat" file and open this in a standard text editor. This is an XML file.
  2. Search the file for the phrase "", if present, change its corresponding value from empty/zero to "3". If the phrase isn't present in the "midasglobal.dat" file, then add it:
  3. On line 3 of this file (after the <midas> tag on the previous line), add the following:
    <debug>3</debug>
  4. Save changes to the midasglobal.dat file back to your server

Once debug logging has been enabled, try to recreate the conditions which led to the "MIDAS encountered an unexpected error" or "Unable to save settings" message in your browser, and additional diagnostic information may be shown on screen along with the generic error message.

In addition, a "debug.dat" file may also be created on your server (at the location where your MIDAS is installed), which will contain further specifics on the error.

Important: We recommend only enabling debug logging to troubleshoot a specific issue, or when requested to by MIDAS support. Once your issue has been resolved, you should disable debug logging again and remove any created "debug.dat" file from your server

You might also be interested in...


MIDAS » KB » Support » Article 00146

← Return to the Knowledge Base