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 profiling tool 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 attach the profiling tool 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 you configure 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. You will need to install the generated Profiler Remote Pack on the remote system if not installed.

    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 as you would for a local application.

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

Generating a Profiler Remote Pack

To attach the profiling tool to a remote system you need to install a Remote Profiler Pack on the remote system. The Remote Profiler Pack is an archive of libraries that enables the profiling tool to attach to the remote system.

To generate a Remote Profiler Pack

  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 open the Attach Wizard.
  4. In the Attach Wizard, select the type of application.

    If you choose J2EE Web/App Server you also need to select the server type.

  5. Select the Remote attach mode and click Next.
  6. Specify the Hostname and operating system. Click Next.
  7. Review the attach settings and click Next.
  8. Select the Java platform.
  9. Read the attach instructions and click Generate Remote Pack.

When you click Generate Remote Pack you are prompted to specify a location where you want to save the Profiler Remote Pack. After the IDE generates the pack you need to follow the Attach Wizard instructions to install the pack and start the remote system on the pack.

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

Legal Notices