## Attaching to a Remote Application

See Also

You can profile an application that is running on a remote system such as a web server by attaching the profiler to the application. When you use this mode, the remote application starts after the profiler is attached. This mode enables you to obtain profiling data on the startup of the target JVM.

To profile an application on a remote system,

- To attach profiler to an application on a remote system, you need to download and install the Profiler Remote Pack on the remote system. The remote system needs to be started on the Profiler Remote Pack and configured to support remote profiling.

  You can download the Profiler Remote Pack from the Profiler web site:

You use the Attach Wizard to specify the attachment settings for your project. In the Attach Wizard you specify the type of application and the remote location. Based on the details that you provide, the Attach Wizard provides you with a set of instructions on how to configure the remote system to support profiling.

After configuring the remote system according to the instructions, you can attach the profiler to the remote location. You only need to configure the attach mode once. The attachment settings are associated with that project. You can go through the Attach Wizard at any time to change any of the attachment settings.

To profile a remote application:

1. Choose Profile > Attach Profiler from the main menu.
2. Select the Project from the dropdown list at the top of the Select Profiling Task dialog box, if available.
3. In the bottom of the dialog box, click define to configure the attachment settings.
4. Select the type of application.
5. Select the server type, if necessary.
6. Select the Remote attach mode and click Next.
7. Complete the Attach wizard to specify the attachment settings according to the target application.
8. Click Finish to exit the Attach wizard.
9. Configure the target location and start the remote application according to the instructions provided in the Attach Wizard.

   When you start the remote application, the application will wait until the IDE is attached before starting.

10. Select a profiling task and any profiling options.
11. Click Attach.

When you click Attach, the IDE will attach to the remote JVM and the application will start. You can view profiling data like you would for a local application.

After the IDE is attached to the remote application you can do the following:

- Detach from the remote application.

  When you detach from the remote application, the remote application does not stop but you stop receiving profiling data about the remote application. To attach to the remote application you need to use the startup options provided by the Attach wizard and start the remote application again.

- Modify the profiling session.

  You can modify the profiling session without detaching from the remote application. For example, you can change the profiling task to monitoring to reduce the profiling overhead, and then modify the task again later. This way you do not need to reattach and restart the remote application.

See Also
  Profiling Using Attach Mode
  Attaching to a Local Application
  Selecting a Profiling Task

Legal Notices