Home » Support » Index of All Documentation » Wing IDE Reference Manual » Advanced Debugging Topics »

Remote Debugging

Since remote debugging is fairly complicated to configure, we currently recommend using remote display of the IDE via X Windows (Linux/Unix) or Remote Desktop (Windows) when possible, instead of setting up the IDE on a separate host from the debug process.

When this is not an option, you can also ask the debugger to connect remotely over the network. In order to do this, take the following steps (see also Remote Debugging Example):

(1) First set up Wing IDE to successfully accept connections from another process within the same machine, as described in section Importing the Debugger. You can use any Python script for testing this until you have values that work.

(2) Optionally, alter the Server Host preference to the name or IP address of the network interface on which the IDE listens for debug connections. The default server is None, which indicates that the IDE should listen on all the valid network interfaces on the host.

(3) Optionally, alter the preference Server Port to the TCP/IP port on which the IDE should listen for debug connections. This value may need to be changed if multiple copies of Wing IDE are running on the same host.

(4) Set the Allowed Hosts preference to include the host on which the debug process will be run. For security purposes, Wing will reject connections if the host isn't included here.

(5) Configure any firewall on the system that Wing IDE is running on to accept a connection on the server port from the system that the debug process will run on.

(6) Next install Wing IDE on the machine on which you plan to run your debug program. Creating an entire Wing IDE installation is the easiest approach. Alternatives are to copy only the debug server code out of a Wing installation on the same type of OS or to compile the debugger core from source code. For details, see Installing the Debugger Core.

(7) Next, transfer copies of all your debug code so that the source files are available on the host where Wing IDE will be running and at least the *.pyc files are available on the debug host.

During debugging, the client and server copies of your source files must match or the debugger will either fail to stop at breakpoints or stop at the wrong place, and stepping through code may not work properly.

Since there is no mechanism in Wing IDE for transferring your code, you need to use NFS, Samba, FTP or some other file sharing or file transfer mechanism to keep the remote files up to date as you edit them in Wing.

If files appear in different disk locations on the two machines, you will also need to set up a file location map, as described in File Location Maps.

(8) On your debug host, copy wingdbstub.py into the same directory as your source files and import it in your Python source as described in Debugging Externally Launched Code.

(9) If you didn't copy wingdbstub.py out of a complete installation of Wing IDE on the debug host, you will need to set WINGHOME in your copy to match the location where you have copied the debug server code on your debug host.

(10) In wingdbstub.py on your debug host, set kWingHostPort. The host in this value must be the IP address of the machine where Wing IDE is running. The port must match the port configured with the Server Port preference on the host where Wing IDE is running.

(11) Then restart Wing and try running your program on the debug host. You should see the Wing IDE debugger status icon change to indicate that a debug process has attached.

If you have problems making this work, try setting kLogFile variable in wingdbstub.py for log additional diagnostic information.

Section Contents

13.1.0. SSH Tunneling
13.1.1. File Location Maps File Location Map Examples
13.1.2. Remote Debugging Example
13.1.3. Installing the Debugger Core

Remote Debugging