Preparing to debug on a remote DataMiner Agent

Proceed as follows if you want to debug a QAction or an automation script located on the DataMiner Agent that is running on another machine.

1. Copy or install Remote Debugging Monitor (msvsmon.exe) on the remote DataMiner Agent.

   • To install Remote Debugging Monitor on the remote DataMiner, either download and run the installer, or copy all files from the following local folder to a random folder on the remote DataMiner Agent:

     C:\Program Files\Microsoft Visual Studio\<version>\Professional\Common7\IDE\Remote Debugger\x86

     Example: C:\Program Files\Microsoft Visual Studio\18\Professional\Common7\IDE\Remote Debugger\x86

     Note

     • Remote Debugging Monitor (msvsmon.exe) can run with any user account that has Administrator rights.
     • Make sure that the version of Remote Debugging Monitor on the remote DataMiner Agent is the version supplied with the version of Visual Studio you are using on your local computer.

2. On the remote DataMiner Agent, log on with an account that has Administrator rights, and start Remote Debugging Monitor as an Administrator.

   • Make sure Remote Debugging Monitor uses "Windows Authentication". To check this setting, go to Tools > Options.

   Note

   It might be necessary to change certain firewall settings.

3. Run Visual Studio as an Administrator.

4. Make sure that, in the DMA tab of the DIS Settings window, you have added the DataMiner Agent with the correct user account and that, in its Debugging tab, you have configured the following settings:

   • Enable remote debugging must be selected.
   • Debugger qualifier must be set to the qualifier supplied by the Remote Debugging Monitor (msvsmon.exe) in a log entry at startup. Format: dmaname:ipport. Default port: 4026.

You are now ready to start debugging. See Debugging a connector or Debugging an automation script.