# Installation notes for the IDE integrations of JProfiler

version 7.1.2
released on 2012-06-30

## 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

These instructions apply to all versions of eclipse.

1. Create a directory called `com.jprofiler.integrations.eclipse` in the plugins directory of your eclipse installation.
2. Locate the suitable `eclipseNN-jprofiler.zip` file (where `NN` is the eclipse version) 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` on UNIX based platforms).
4. For eclipse 2.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 all versions of IntelliJ IDEA

1. Locate the suitable `ideaNN-jprofiler.jar` (where NN is the IDEA version) 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 all versions of JBuilder.

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 all versions of JDeveloper.

1. Locate `jdeveloperNN-jprofiler.zip` (where NN is the JDeveloper version) 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

1. Go to "Update Center" or "Plugins" available from the "Tools" menu, and install `netbeansNN-jprofiler.nbm` (where NN is the Netbeans version) 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]/ideX` (where X is a number) 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.