| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| <link rel="stylesheet" href="../book.css" charset="ISO-8859-1" type="text/css"> |
| <title> |
| Using the remote Java application launch configuration |
| </title> |
| </head> |
| <body> |
| <h1> |
| Using the remote Java application launch configuration |
| </h1> |
| <p>The <strong>Remote Java Application </strong> launch configuration should |
| be used when debugging an application that is running on a remote VM. |
| Since the application is started on the remote system, the launch |
| configuration does not specify the usual information about the JRE, program |
| arguments, or VM arguments. Instead, information about connecting to |
| the application is supplied. |
| </p> |
| <p>To create a <strong>Remote Java Application</strong> launch |
| configuration, do the following: |
| </p> |
| <ol> |
| <li> |
| Select <strong>Run >Debug...</strong>.from the workbench menu bar (or |
| <strong>Debug... </strong>from the drop-down menu on the <strong>Debug</strong> |
| tool bar button) to show the launch configuration dialog. |
| </li> |
| <li> |
| Select the <strong>Remote Java Application</strong> in the list of |
| configuration types on the left. |
| </li> |
| <li> |
| Click the <strong>New</strong> button. A new remote launch configuration is created and three tabs are shown: <strong>Connect</strong>, |
| <strong>Source</strong>, and <strong>Common</strong>. |
| </li> |
| <li> |
| In the <strong>Project</strong> field of the <strong>Connect</strong> tab, type or browse to select the project to use as a reference for |
| the launch (for source lookup). A project does not need to be specified. |
| </li> |
| <li> |
| In the <strong>Host</strong> field of the <strong>Connect</strong> tab, type the IP address or domain name of the host where the Java |
| program is running.<br> |
| If the program is running on the same machine as the workbench, type <em>localhost</em>. |
| </li> |
| <li> |
| In the <strong>Port</strong> field of the <strong>Connect</strong> tab, type the port where the remote VM is accepting connections. |
| Generally, this port is specified when the remote VM is launched. |
| </li> |
| <li> |
| The <strong>Allow termination of remote VM</strong> flag is a toggle that determines whether the <strong>Terminate</strong> command is |
| enabled in the debugger. Select this option if you want to be able to terminate the VM to which you are connecting. |
| </li> |
| <li> |
| Click <strong>Debug</strong>. The launch attempts to connect to a VM at the specified address and port, and the result is displayed in the Debug view. If |
| the launcher is unable to connect to a VM at the specified address, an error message appears. |
| </li> |
| </ol> |
| <p>Specific instructions for setting up the remote VM should be obtained |
| from your VM provider. </p> |
| <p> |
| <img border="0" src="../images/ngrelc.gif" alt="Related concepts" width="159" height="27"><br> |
| <a href="../concepts/concepts-10.htm">Debugger</a> |
| </p> |
| <p> |
| <img border="0" src="../images/ngrelt.gif" alt="Related tasks" width="159" height="27"><br> |
| <a href="../tasks/tasks-130.htm">Launching a Java program</a><br> |
| <a href="../tasks/tasks-142.htm">Disconnecting from a VM</a><br> |
| <a href="../tasks/tasks-executionArgs.htm">Setting execution arguments</a> |
| </p> |
| <p> |
| <img border="0" src="../images/ngrelr.gif" alt="Related reference" width="159" height="27"><br> |
| <a href="../reference/ref-51.htm">Debug view</a> |
| </p> |
| <p> |
| <a href="../hglegal2003.htm"><img src="../images/ngibmcpy2003.gif" alt="Copyright (c) 2000, 2003 IBM Corporation and others. All Rights Reserved." border="0" width="324" height= |
| "14"></a> |
| </p> |
| </body> |
| </html> |
| |
