3 Install JDK Mission Control and Supported Plug-ins

Review the prerequisites and system requirements before you install JMC. Apart from the base JMC application, there are many plug-ins available that you can install depending on your requirements.

You can install JMC as a standalone application or as an Eclipse plug-in.

System Requirements and Supported Platforms

JMC system requirements and supported platforms.

See Oracle JDK Mission Control Certified System Configurations.

Download and License Information

JDK Mission Control homepage provides access to JMC and related plug-in downloads.

Product Download

Download JMC or Eclipse IDE as per your requirement.

Standalone JMC and Plug-ins Download

Download JMC from: JDK Mission Control (JMC) 8 Downloads; ensure that you accept the license agreement.

Download Plug-ins from:

• Oracle plug-ins: https://download.oracle.com/technology/products/missioncontrol/updatesites/oracle/8.3.1/rcp/
• OpenJDK plug-ins: https://download.oracle.com/technology/products/missioncontrol/updatesites/openjdk/8.3.1/rcp/

JMC Plug-ins for the Eclipse IDE

Download Eclipse IDE from Eclipse IDE for Eclipse Committers

Download Plug-ins from:

• Oracle plug-ins: https://download.oracle.com/technology/products/missioncontrol/updatesites/oracle/8.3.1/ide/
• OpenJDK plug-ins: https://download.oracle.com/technology/products/missioncontrol/updatesites/openjdk/8.3.1/ide/

JMC Core APIs

Access JMC APIs from Documentation for JMC Core API.

You can also download the Core APIs from Maven Central. See MVN Repository to view the list of JMC bundles. You can download the JMC Core APIs by adding the dependency in the pom.xml file. For example, to download org.openjdk.jmc.common API, provide the following dependency values in pom.xml file:

<dependency>
    <groupId>org.openjdk.jmc</groupId>
    <artifactId>common</artifactId>
    <version>8.3.1</version>
</dependency>

License Information

See UPL License and Java SE Licensing Information User Manual for licensing information.

Installation Instructions

You can install JMC as a standalone application or as a plug-in within the Eclipse IDE.

Note:

Apply the latest Critical Patch Update (CPU) or Security Alert; older versions are not updated with the latest security patches.

Install JMC Standalone Application

Prerequisites

• Install JDK 11 64-bit (or later); see Download and License Information.
• Ensure that you set the <jdk_installation_path>/bin PATH environment variable and the $TEMP directory is accessible.
• For configuration details, see JDK Mission Control 8 Installation Instructions.

Follow these steps to install the JMC standalone application and relevant plug-ins.

1. Download the latest JMC relevant to your platform. For instance, jmc-8.3.1_windows-x64.zip for Windows.

   Note:

   If you have multiple JDK versions installed and you want to configure a specific JDK version, see the Specify the JDK Version to be Used by JMC section in JDK Mission Control 8 Installation Instructions.
2. Extract the downloaded compressed file, access the /bin folder, and open jmc.exe.
   You can also start JMC from command prompt using the command:

   • Windows: <JMC_ROOT>\jmc-<version>_windows-x64\bin\jmc.exe
   • Linux: <JMC_ROOT>/jmc-<version>_linux-x64_bin/bin/jmc
   • macOS: open <JMC_ROOT>/jmc-<version>_macos-x64/JDK\ Mission\ Control.app

Install Plug-ins for JMC Standalone Application

The plug-ins for JMC are a set of artifacts designed to extend its functionality.

There are several plug-ins that are built for JMC. These plug-ins are not distributed with the base JMC application. They are hosted on remote locations (update sites) from where they can be download. Some plug-ins are open source while some are provided by Oracle.

The URL of the remote locations (update site) is updated in the JMC application.

Follow these steps to install the JMC plug-ins:

1. Open JMC. Go to Help and Install New Software.
   The available plug-ins are categorized into Mission Control, Mission Control (Oracle), and Mission Control (Experimental).

   Note:

   • If JMC is unable to contact the update sites, then check the JMC application proxy.
   • Go to Windows and Preferences (in macOS, go to JDK Mission Control and Preferences). In General and Network Connections window, verify the Host proxy setting for HTTP, HTTPs, and Port value.
2. In the Available Software window, select the required plug-ins, click Next. See Plug-in Details to know more about the plug-ins available for the JMC standalone application.
3. In the Install Details window, view the details of the selected plug-ins and click Next.
4. Accept the license agreements and click Finish.

   Note:

   To use the installed plug-ins, restart JMC.

Install JMC and Associated Eclipse Plug-ins

The JDK Mission Control plug-ins for Eclipse are a set of artifacts for the Eclipse IDE designed to help develop, profile, and diagnose applications running on supported JDKs.

Prerequisites

• Install Eclipse 4.24 and later
• Uninstall previous versions of JMC, if any
• Ensure that Eclipse is running on a supported JDK version (not JRE)

Follow these steps to install the JMC as an Eclipse plug-in:

1. Open Eclipse IDE. Go to Help and Install New Software.
2. In the Work with field, enter the URL https://download.oracle.com/technology/products/missioncontrol/updatesites/openjdk/8.3.1/ide/.
   The available plug-ins are categorized into Mission Control, Mission Control (Oracle), and Mission Control (Experimental).
3. Expand all the categories, select Base (Required) and other required plug-ins, and click Next. See Plug-in Details.
4. In the Install Details window, view the details of the selected plug-ins and click Next.
5. Select I accept the terms of the license agreement and click Finish.
6. Restart Eclipse.

The JMC icon should appear in Eclipse toolbar.

Plug-in Details

You can install Oracle, Open source, and Experimental plug-ins according to your requirement.

Note:

Install the latest version of the plug-ins to get the most recent security patches.

• Oracle plug-ins: Developed and supported by Oracle, which extends the base JMC functionality.
• Open source plug-ins: Developed by open source community, which provides additional functionality.
• Experimental plug-ins: Developed by Oracle as a technology preview that may later be incorporated into the main distribution, depending on the feedback. These plug-ins are currently not supported and are provided only for evaluation purposes. The experimental plug-ins are not included in the JDK Mission Control product distribution.

Plug-ins for JMC Standalone Application

• Oracle plug-ins:
  • Coherence Tab Pack
  • WebLogic Pages
  • Threadlogic

    Note:

    The Threadlogic plug-in is deprecated in JMC 8 and will be removed in JMC 9.
• Open source plug-ins:
  • JDK Mission Control RCP Updates
  • Flight Recorder Metadata Page
  • JavaFX Page
• Experimental plug-ins:
  • Subscription Tab
  • Twitter Action
  • G1 Page

JMC Plug-ins for Eclipse IDE

• Open Source plug-ins:
  • JDK Mission Control IDE Integration
  • Flight Recorder Metadata Page
  • JavaFX Page
• Experimental plug-ins:
  • Subscription Tab
  • Twitter Action
  • G1 Page
  • Flight Recorder Launch Configuration Tab
  • JDK Mission Control PDE Integration
• Mission Control Localization plug-ins:
  • Japanese Language Support (for IDE Integration)
  • Simplified Chinese Language Support (for IDE Integration)

Start JDK Mission Control

See JDK Mission Control 8 Installation Instructions.