Download
VisualVM is available in two distributions: VisualVM available at visualvm.dev.java.net and
Java VisualVM available as a JDK tool in Sun JDK distributions starting from JDK 6 update 7. In initial releases these tools are identical,
but in the future Java VisualVM will be a stable tool tested with each JDK distribution, whereas VisualVM will be a bleeding-edge distribution with the latest
features and bug fixes.
Note: Be sure to read the Release Notes prior to installing VisualVM to be aware of minimal system requirements.
The main prerequisite is a correctly installed Sun JDK 6+ (available at java.sun.com) which will be used for running VisualVM.
Download
First Steps
- Unzip the downloaded archive. The archive already contains the top-level
visualvm
directory.
- Start VisualVM by invoking the binary appropriate for your OS:
visualvm\bin\visualvm.exe
or visualvm/bin/visualvm
You may provide additional options to define JDK and/or VisualVM user directory:
--jdkhome "<path to JDK>" --userdir "<path to userdir>"
- During first VisualVM startup the profiler performs calibration, be sure that there's no additional load on your machine and
dynamic frequency switching technologies like SpeedStep and PowerNow! are disabled. After startup VisualVM should look similar to
this screenshot.
- Check out the Getting Started document, it's designed to help you start using VisualVM.
Potential Problems
There are several problems which can occur when starting VisualVM for the first time:
- VisualVM doesn't start: there are several problems which could prevent VisualVM from starting without any visible reason:
- The download is broken - make sure you've got the correct bits (archive managers typically notify you when the archive is broken)
- VisualVM waits for license confirmation - make sure you haven't overlooked the License Agreement dialog
- Incorrect JDK is used for running VisualVM - if you haven't defined a JDK to run VisualVM manually, make sure that the
default Java on your system is Sun JDK 6+
- Incorrectly set JDK for running VisualVM - if you have defined a JDK to run VisualVM manually, make sure the path to the JDK is correct and doesn't end with a slash
- Incorrectly set VisualVM user directory - if you have defined VisualVM user directory manually, make sure it is outside of VisualVM installation directory
-
VisualVM startup terminates by Error Starting VisualVM Dialog - unsupported version of Java: this typically happens when JRE or incorrect JDK version is used to run VisualVM,
make sure VisualVM is running on Sun JDK 6+
-
Local Applications Cannot Be Detected dialog is shown after VisualVM startup: this can happen on Windows systems, see the Troubleshooting Guide
for more details and steps to fix the problem
If you are experiencing other problems or you need more details, try to find a solution in the Troubleshooting Guide.
If it doesn't help, you may ask for help on a mailing list or file a bug report
(you need to be registered to access the mailing list or file a bug report).