Configuring JVMs in general settings

## Configuring JVMs in general settings |
previous | up | next

This tab in JProfiler's general settings allows you to add, edit and delete Java VMs that can be used to launch local sessions, applet sessions and servlet sessions. Any JVM added here will be available from the "Java VM" combo box in the application settings dialog for the configuration of local, applet, servlet or Web Start sessions. Any changes you make to an existing Java VM configuration directly affect the sessions which already use it.

| Adding a new Java VM is done by clicking the [New] button on the right hand side of the tab. A file chooser is brought up and prompts you for the selection of the home directory of the JVM (e.g. `c:\Program Files\jdk1.4.0` or `/usr/lib/java`). The selected virtual machine will be checked for usability by JProfiler and depending on success, a new entry in the Java VMs table is added. Proceed as described below for editing a Java VM. If JProfiler reports that the JVM is not usable and you feel that your JVM should be supported, please don't hesitate to contact us through the support request form

| Editing an existing Java VM is done by entering information directly into the columns of the Java VMs table. Double-click on the "Name" column to change the name of the JVM. This name is used for JVM selection in the application settings dialog. Double-click on "JVM home directory" and enter a directory manually or click on the button labeled [...] to change the home directory of an existing JVM. The new directory will be accepted only if the directory contains a JVM which is usable by JProfiler. Choose the JVM Mode from the "JVM Mode" combo box. This setting is initially set to the preferred value for the chosen JVM. See the remote session invocation table for details on this option.

| Deleting an existing Java VM is done by selecting the Java VM which is to be deleted and clicking the [delete] button on the right hand side of the tab or choosing Delete from the context menu. Please note that all local sessions which currently use the deleted JVM will remain without an associated JVM and will be unusable until you assign them a new one in the application settings dialog.

| Setting the default Java VM is done by selecting the Java VM which is to be the default Java VM and clicking the [Set default] button on the right hand side of the tab or choosing Set default in the context menu. For new sessions, this Java VM will be initially selected in the application settings dialog.

| Searching for Java VMs is done by clicking the [Search] button on the right hand side of the tab. This invokes the search wizard which corresponds to the functionality found in JProfiler's setup wizard. While the search wizard shows all JVMs found on your local fixed drives, only new JVMs will be merged into the Java VMs tab in the general settings dialog.