Debug a running remote program (gsserver)

The following steps show how to attach the Graphical Debugger to a remote process running on a gsserver.

Remote debugging via gsserver does not require manual entry of host or process details, the dialog automatically lists processes from the configured remote server.
Warning:

Remote debugging is not supported for GDC-UR applications rendered in a Chrome browser. For details on this restriction, please see QWebEngine Remote Debugging no longer works in Chrome.

Before you begin:
  • You have a Genero program running on a remote host managed by gsserver.
  • You have a remote configuration already defined in Genero Studio.
  • You have source files which are accessible either through mount points or synchronization directories.
  1. Select Debug >> Attach to Process....
    The Attach to process dialog opens.
  2. Select the Attach to remote process (gsserver) radio button.
  3. From the list displayed in the the dialog, select the process you want to attach to. This list shows all running fglrun programs on the configured gsserver, including PID.
  4. Click Attach.
    The debug session starts.
    Tip:

    Genero searches the directories specified by the FGLSOURCEPATH environment variable for the relevant source file. If Genero Studio cannot find the source (.4gl) file, the Select the file dialog opens and you must navigate to the directory and select the relevant source file. To avoid this additional step, add the path to the source file to FGLSOURCEPATH before attempting to attach to the process.