# Installation notes for the IDE integrations of JProfiler

version 3.3.2
released on 2005-05-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 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` or `eclipse3-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. Activate the JProfiler plugin for the Java perspective.

### 2. IntelliJ IDEA

These instructions apply to IntelliJ IDEA 3.x and 4.x.

1. Locate `idea3-jprofiler.jar` or `idea4-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

These instructions apply to JDeveloper 10g.

1. Locate `jdeveloper-jprofiler.jar` in the directory of this readme file and copy it into the directory `lib/ext` 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 3.x and Sun ONE Studio

These instructions apply to Netbeans 3.x and Sun ONE Studio.

1. Go to the "Update Center" available from the "Tools" menu, select "Install manually downloaded modules", locate `netbeans3-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 IDE installation 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. Edit `bin/ide.policy` and add

       grant codeBase "file:C:/Program Files/jprofiler/dist/-" {
          permission java.security.AllPermission;
       };

   where you replace `C:/Program Files/jprofiler/dist/` with the actual JProfiler installation directory.

### 6. Netbeans 4.x

These instructions apply to Netbeans 4.x.

1. Go to the "Update Center" available from the "Tools" menu, select "Install manually downloaded modules", locate `netbeans4-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]/ide4` 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`