JProfiler as a Netbeans 4.x/5.x module

## JProfiler as a Netbeans 4.x/5.x module |

| With JProfiler integrated into Sun Microsystems' Netbeans(TM), JProfiler can be invoked from within the IDE without any further need for session configuration. Requirements: The Netbeans 4.x plugin needs at least Netbeans 4.0. For Netbeans 3, a different module is available.

| The installation of the Netbeans module is started by selecting "Netbeans IDE 4.x" on the IDE integration tab of JProfiler's setup wizard miscellaneous options tab of JProfiler's general settings (use Session->IDE integrations in JProfiler's main menu as a shortcut). and clicking on [Integrate] Reminder: Please close Netbeans while performing the module installation. If you are performing the installation from JProfiler's setup wizard, please complete the entire setup first before starting Netbeans. A file selection box will then prompt you to locate the installation directory of Netbeans. In the next step, you are asked whether the installation should be performed globally, or for a single user only. A single user installation is mostly of interest in network installations where the user cannot write to the Netbeans installation directory. If you decide for a single user installation, another file selection box will then prompt you to locate your Netbeans user directory. This is a version-specific directory under `.netbeans` in your user home directory. The Netbeans updater is then invoked and the module is installed. After acknowledging the completion message, you can start Netbeans and check whether the installation was successful. You should now see a menu entry JProfiler top-level menu in Netbeans' main menu.

| You can profile standard and free form projects in Netbeans. For free form projects, you have to debug your application once before trying to profile it, since the required file `nbproject/ide-targets.xml` is set up by the debug action. JProfiler will add a target named "profile-jprofiler" to it with the same contents as the debug target and will try to modify the VM parameters as needed. If you have problems profiling a free form project, please check the implementation of this target.

| You can profile web applications with the integrated Tomcat or with any other Tomcat server configured in Netbeans. When your main project is a web project, selecting "Profile main project with JProfiler" (see below) starts the Tomcat server with profiling enabled. Please make sure to stop the Tomcat server before trying to profile it.

| If you use Netbeans 4.1/5.0 with the bundled Sun Java System Application Server, you can transparently profile J2EE applications with it. When your main project is set up to use Sun Java System Application Server, selecting "Profile main project with JProfiler" (see below) starts the application server with profiling enabled. Please make sure to stop the application server before trying to profile it.

| To profile your application from Netbeans, choose one of the profiling commands in the Run menu or click on the corresponding toolbar button. Main toolbar with "JProfiler" button "JProfiler" menu Explorer context menu with "JProfiler" action The profiled application is then started just as with the usual "Run" commands. When a profiling session is started, a new tab with a JProfiler window is created. Profiling sessions are closed by closing the corresponding tab. Apart from the excluded tool bar buttons for "Attach/Detach" and "Session settings", the JProfiler window and its views are exactly the same as in the standalone version. All profiling settings and view settings changes are persistent across session restarts. When JProfiler is used with the Netbeans integration, the "Show source" action for a class or a method in one of JProfiler's view will show the source element in Netbeans and not in JProfiler's integrated source code viewer.

| The JProfiler menu in Netbeans' main menu bar contains all actions required to run JProfiler from within Netbeans: Profile file with JProfiler Start profiling the currently selected class. Profile project with JProfiler Start profiling the main class of the current project. Edit Contains the JProfiler's view specific View menu which is active only during profiling. General settings Brings up the general settings dialog that contains the `Filter sets` and `Miscellaneous` tabs of the standalone version. In addition, it contains a `General profiling options` tab. On that tab you can ask JProfiler to always use interpreted mode for profiling. A separate checkbox tells JProfiler to use the deprecated JVMPI interface when profiling with a 1.5 JRE. Both these settings are trouble-shooting options and should normally not be selected. Enter license key Allows you to enter your license key. Contact sales Brings up your default mail client to write an e-mail to ej-technologies' sales department. Contact support Brings up your default mail client to write an e-mail to ej-technologies' support department. The license key is automatically included in the subject of the e-mail. JProfiler on the web Connects to JProfiler's web site in the default web browser. About JProfiler Shows general information about your copy of JProfiler and its license status.