User Tools

Site Tools


guides:rdb

Running a remote debugger

Documentation | Running a remote debugger

An application can be debugged on a remote machine (or a Virtual Machine or Docker running on the same machine as the IDE). However, additional steps are required:

Run the Remote Debug License.lnk app from the DK program group. This command-line utility can be run as an IDE Pre-build Event.

  1. Deploy to a remote machine a file GisLicenseRDB.txt; the file must be placed into the exact location as the executable file;
  2. Embed GisLicense file (or call TGIS_LicenseManager.SetLicense);
  • Be aware that GisLicenseRDB.txt is valid only for a limited time and should be regenerated before any debug session.
  • Remember that time zones on both machines must match.

Remote debugger support is included in the complete DK installation packages available from the TatukGIS website.

Delphi Specific

RAD Studio:

- before v100:

  1. In Project Options select Build Events and edit Pre-build event to add command
    "c:\Program Files (x86)\TatukGIS\DK11 for Delphi\Remote Debugger License.lnk"
  2. In Project Deployment add %USERPROFILE%\Documents\TatukGIS\DK11 for .Delphi\GisLicenseRDB.txt and set RemotePath to be placed together with extecutabale file (typically .\).

- v102 or newer

  1. In Project Options select Build Events and edit Pre-build event to add command like this:
    "c:\users\CURRENT_USER\AppData\Local\TatukGIS\DK for Delphi.RX12\Remote Debugger License.lnk" $(PROJECTDIR)
  2. In Project Deployment add GisLicenseRDB.txt (located now in a project folder) and set RemotePath to be placed together with executable file (typically .\).

.NET Specific

Visual Studio:

- before v100:

  1. In Project Properties, edit /Build Events / Pre-build-event command line as:
    "c:\Program Files (x86)\TatukGIS\DK11 for .NET\Remote Debugger License.lnk" 
    copy "%USERPROFILE%\Documents\TatukGIS\DK11 for .NET\GisLicenseRDB.txt" $(ProjectDir)
  2. Add GisLicenseRDB.txt to the project and set Copy To Output=Copy if newer property.

- v102 or newer

  1. In Project Properties, edit /Build Events / Pre-build-event command line as:
    "c:\users\CURRENT_USER\AppData\Local\TatukGIS\DK for .NET\Remote Debugger License.lnk" $(ProjectDir)
  2. Add GisLicenseRDB.txt to the project and set Copy To Output=Copy if newer property.

ASP.NET Core Specific

Visual Studio:

- before v100:

  1. In Project Properties, edit /Build Events / Pre-build-event command line as:
    "c:\Program Files (x86)\TatukGIS\DK11 for ASP.NET\Remote Debugger License.lnk" $(ProjectDir)
  2. Add GisLicenseRDB.txt to the project and set Copy To Output=Copy if newer property.
  3. Add “%USERPROFILE%\Documents\TatukGIS\DK11 for ASPN.NET\Developer License\TatukGIS_DK11_ASPNET.license” to the project and set Copy To Output=Copy if newer property.

- v102 or newer

  1. In Project Properties, edit /Build Events / Pre-build-event command line as:
    "c:\Program Files (x86)\TatukGIS\DK for ASP.NET\Remote Debugger License.lnk" $(ProjectDir)
  2. Add GisLicenseRDB.txt to the project and set Copy To Output=Copy if newer property.
  3. Add TatukGIS_DK_ASPNET.license to the project and set Copy To Output=Copy if newer property.
2025/05/14 10:10

Page Tools