Debugging

When an issue occurs, while using Remote Desktop Manager, the support personnel may ask you to turn on debugging and send the information back.

Any debug level other than zero will slow down the application and write a lot of information in the application logs. As soon as you have completed the diagnostics, you should revert back the debug level to zero.

The Ad hoc debugging method is sufficient in most cases, use the in-depth debugging method whenever you need to diagnose the startup or the initial connection.

Solution

Method AD HOC Debugging

  1. In Remote Desktop Manager, open Help – Profiler, move the window aside to clear the main window.
    KB2022
  2. In the Debug Only tab, click on the ellipsis button and activate the proper debug categories.
  3. In Remote Desktop Manager, perform the action that is under investigation.

For timing session load times, please press Ctrl+F5 to invalidate the cache and perform a full refresh. You should see debug information appear in the profiler window.

  1. Click on Send trace to Support.
  2. In the following dialog, ensure you specify enough information to link the report to the appropriate ticket.

If the process was started from the forum include your forum username.

Method In-Depth Debugging

  1. In Remote Desktop Manager open File – Options – Advanced.
  2. Click on the Debug level ellipsis button and activate the proper debug categories.
  3. In the Information section, you will see a hyperlink to your configuration folder, press on it to have a file explorer window opened in that folder.
    KB2023
  4. Close Remote Desktop Manager

As a preparatory phase, it would be best to clear existing logs to limit the scope of what will need to be analyzed.

  1. Delete or rename files named RemoteDesktopManager.log, RemoteDesktopManager.log.db and RemoteDesktopManager.debug from your configuration folder.
  2. Start Remote Desktop Manager.
  3. Perform the action that is under investigation.
  4. Open File – Options – Advanced, set the Debug level to zero.
  5. Close Remote Desktop Manager.
  6. Package the *.log, *.log.db and *.debug files from your configuration folder and send them to us.