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.

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 .\).

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.

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.