Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
swdev:howto:remote_debug_delphi_application [2009/06/26 11:44] smayr |
swdev:howto:remote_debug_delphi_application [2009/06/26 12:17] (current) smayr |
||
---|---|---|---|
Line 1: | Line 1: | ||
== Remote Debug a Delphi Application == | == Remote Debug a Delphi Application == | ||
+ | Source: Borland Developer Studio 2006 Help. | ||
=== Installing a Debbuger on Remote Machine === | === Installing a Debbuger on Remote Machine === | ||
- | Source: Borland 2006 Help | ||
To install the remote debugger if the installation disk is not available | To install the remote debugger if the installation disk is not available | ||
Line 19: | Line 19: | ||
* Copy the files from your local machine to the directory you created on the remote machine. | * Copy the files from your local machine to the directory you created on the remote machine. | ||
* On the remote computer, register '' | * On the remote computer, register '' | ||
- | * If you are debugging an ASP.NET application, | + | * If you are debugging an ASP.NET application, |
- | If you are debugging an ASP.NET application, | + | |
+ | === Establishing a Connection for Remote Debugging === | ||
+ | |||
+ | You must establish a TCP/IP connection between the local and remote machines in preparation for remote debugging. This connection uses multiple ports that are chosen dynamically by Windows. The remote debug server listens on one port, and a separate port is opened for each application that is being debugged. A firewall that only allows connections to the listening port will prevent the remote debugger from working. | ||
+ | |||
+ | **Note:** If the remote machine uses the firewall included with Windows XP service pack 2, you will receive a message asking whether Borland remote debugging service should be allowed. You must indicate that this is allowed. | ||
+ | |||
+ | **Warning: | ||
+ | |||
+ | To connect the local machine and the remote machine | ||
+ | |||
+ | * Ensure that the remote debugger is installed on the remote machine. | ||
+ | * Ensure that the executable files and symbol files (.tds. .rsm and .pdb) have been copied to the remote machine. | ||
+ | * On the remote machine, start '' | ||
+ | * On the local machine, choose Run > Attach to Process. This displays the Attach to Process dialog. | ||
+ | * Specify the host name or TCP/IP address for the remote machine, then click Refresh. A list of processes running on the remote machine is displayed. This verifies the connectivity between the local and remote machines. | ||
+ | * On the local machine, choose Run > Load Process > Remote. This displays the Remote page of the Load Process dialog. | ||
+ | * In the Remote path field, specify the full path for the directory on the remote machine into which you copied the executable files and symbol files. The name of the executable must be included. For example, if you are debugging a '' | ||
+ | * In the Remote host field, specify the host name or TCP/IP address for the remote machine. | ||
+ | * Click the Load button. This connects the IDE on the local machine to the debugger on the remote machine. | ||
+ | |||
+ | Once this connection is established, | ||
+ | **Note:** You cannot interact directly with the remote application through the remote debugger. For interactive debugging, you can establish a remote desktop connection. | ||
+ | |||
+ | === Preparing Files for Remote Debugging === | ||
+ | |||
+ | Executable files and symbol files must be copied to the remote machine after they are compiled. You must set the correct options on your local machine in order to generate these files. | ||
+ | |||
+ | To prepare files for debugging on a remote machine | ||
+ | |||
+ | * Open the project on your local machine. | ||
+ | * Choose Project > Options > Linker and verify that the " | ||
+ | |||
+ | ^ Language ^ Debug symbol file extension ^ | ||
+ | | Delphi for Win32 | .rsm | | ||
+ | | Delphi for .NET | .rsm and .pdb | | ||
+ | | C++ | .tds | | ||
+ | | C# | .pdb | | ||
+ | |||
+ | * Compile the project on your local machine. | ||
+ | * Copy the executable files and symbol files for the project to the remote machine. | ||
+ | * Choose Run > Load Process | ||
+ | * Specify the directory into which you copied the symbol files in the Debug symbols search path field. | ||
+ | * Click OK. |