Runtime NetLogic remote debugging¶

Introduction

It is possible to do the remote debugging of runtime NetLogic on Windows systems using Visual Studio.

To install Visual Studio or Visual Studio Code, or for references on all related debugging features, please refer to the Microsoft website.

Prerequisites

The remote Windows system must be configured as a target in Q Studio.

The target and development PC must be connected to the same network.

On the target it is necessary to install and configure Visual Studio Debug Tools (see Prepare the remote target).

Prepare the remote target

Download and install Visual Studio Debug Tools (available at this link) for the version of Visual Studio in use.
Start the newly installed Remote debugger program: a window appears showing the name of the device and the port to use to connect to it (<NAME:PORT>).
Refer to the Microsoft documentation (available at this link) to configure the firewall.

Start the debug on the development PC

Open the desired C# project in Visual Studio.
From Q Studio publish the Q Application on the target device.
In Visual Studio, in the Debug menu, click Attach to Process, then set the following parameters:
- ConnectionType: Default
- ConnectionTarget: <NAME:PORT>
Click Find and select the target device from the list: the Windows authentication window appears.
Enter the credentials of the target device user.
In Available Process select the QRuntime.exe process .
Click Attach: debug mode is started and it is possible to insert breakpoints (see Use the breakpoints), to indicate lines of code where the execution stops to allow the user to check their status, the contents of variables etc.

To stop remote debugging, close the Remote Debugger program on the target, or stop the debugging from Visual Studio.

Perform the debugging

Refer to the procedures for Visual Studio and runtime NetLogics in Runtime NetLogic remote debugging.