# Installation notes for the IDE integrations of JProfiler

version 5.2.2
released on 2009-04-22

## I. Automatic Installation

In order to minimize the post-install configuration, we recommend to install the IDE integrations from within JProfiler:

Choose Session->IDE integrations from JProfiler's main menu, select the desired IDE and click on "Integrate".

For more information on how to work with the IDE integrations, please see the JProfiler help.

## II. Manual Installation

Manual installations are not recommended. They're outlined below in case the automatic installation cannot be used, for example if admin rights are required.

### 1. eclipse and WSAD

These instructions apply to eclipse 2.x, WSAD 5.x and eclipse 3.x.

1. Create a directory called `com.jprofiler.integrations.eclipse` in the plugins directory of your eclipse installation.
2. Locate `eclipse2-jprofiler.zip`, `eclipse3-jprofiler.zip` or `eclipse31-jprofiler.zip` in the directory of this readme file and unpack it into the directory created in step a).
3. Start eclipse, open the preferences dialog from the main menu (Window->Preferences), select "JProfiler" and fill in the path to the jprofiler executable (`jprofiler.exe` on Windows and`jprofiler.sh` on UNIX based platforms).
4. For eclipse 2.x and WSAD 5.x, activate the "JProfiler" plugin for the Java perspective under Window->Customize perspective->Other. For eclipse 3.x, activate the "Profile" actions for the Java perspective under Window->Customize perspective->Command.

### 2. IntelliJ IDEA

These instructions apply to IntelliJ IDEA 3 to 7

1. Locate `idea3-jprofiler.jar`, `idea4-jprofiler.jar` or `idea5-jprofiler.jar` in the directory of this readme file and copy it into the directory "plugins" in your IDEA installation.
2. Create a file `jprofiler.properties` in the same directory with the contents:

       jprofilerExecutable=path_to_jprofiler_executable

   On Windows, take care to substitute backslashes with forward slashes. For example: `C:/Program Files/jprofiler/bin/windows/jprofiler.exe`

### 3. JBuilder

These instructions apply to JBuilder 7 to 2005.

1. Locate `jbuilder-jprofiler.jar` in the directory of this readme file and copy it into the directory `lib/ext` in your JBuilder installation.
2. Start JBuilder.
3. When invoking the "optimize" action for the first time, fill in the path to the jprofiler executable (`jprofiler.exe` on Windows and `jprofiler.sh` on UNIX based platforms).

### 4. JDeveloper 10.1.3

These instructions apply to JDeveloper 10g version 10.1.3.

1. Locate `jdeveloper1013-jprofiler.zip` in the directory of this readme file and extract it into the directory `jdev/extensions` in your JDeveloper installation.
2. Start JDeveloper, choose Tools->Preferences->JProfiler and fill in the path to the jprofiler executable (`jprofiler.exe` on Windows and `jprofiler.sh` on UNIX based platforms).

### 5. Netbeans

These instructions apply to Netbeans 4 to 6

1. Go to "Update Center" or "Plugins" available from the "Tools" menu, and install `netbeans{4,5,6}-jprofiler.nbm` in the directory of this readme file and install it into the IDE.
2. Create a file `jprofiler.properties` in the Netbeans user directory or in the directory `[IDE installation directory]/ide{4,5,6}` with the contents:

       jprofilerExecutable=path_to_jprofiler_executable

   On Windows, take care to substitute backslashes with forward slashes. For example: `C:/Program Files/jprofiler/bin/windows/jprofiler.exe`
3. In the same directory as the above file, create a subdirectory modules/ext and copy the contents of $JPROFILER_HOME/lib to that directory.