Configuring DMA to use Java 17

Edit online

Configure the Eclipse 2024-06 environment to run DevOps Model Architect (DMA) 1.0.3 with Java 17 instead of the default Java 21 runtime.

Before you begin

Ensure that the following requirements are met:

  • Eclipse 2024-06 is installed.
  • DevOps Model Architect (DMA) 1.0.3 is installed in Eclipse.
  • A supported Java 17 JDK is available on the system.

About this task

Eclipse 2024-06 includes a default Java 21 runtime. DevOps Model Architect (DMA) 1.0.3 supports both Java 21 and Java 17. By default, DMA runs with the Java version configured for the host Eclipse instance. No configuration changes are required when you use the default Java 21 runtime.

To run DMA with Java 17, you must configure the Java runtime that Eclipse uses.

Important:

DMA is delivered as an Eclipse update site and relies on the Java configuration of the host Eclipse installation. The DMA installation does not modify the eclipse.ini file or the Java runtime.

Procedure

  1. Install a Java 17 JDK:

    Install a supported Java 17 JDK on your system and note the installation path.

  2. Configure the Java runtime using one of the following methods:

    • Method 1: Edit the configuration file (recommended)

      This method configures Eclipse permanently.

      1. Locate the eclipse.ini file in the Eclipse installation directory.
      2. Update the -vm argument to point to the Java 17 JDK.
      3. Update the required Java version setting. Eclipse 2024-06 typically includes the following line by default: -Dosgi.requiredJavaVersion=21.

        Change the value to 17, or remove the line entirely if you do not want to enforce a minimum Java version. 

        -Dosgi.requiredJavaVersion=17

    • Method 2: Use JVM arguments (advanced)

      This method starts Eclipse with Java 17 without modifying the eclipse.ini file, provided that the file does not enforce a higher minimum Java version.

      Example (Windows):

      eclipse.exe -vm "C:\Program Files\Java\jdk-17\bin\java.exe" -vmargs -Dosgi.requiredJavaVersion=17

      In this example:

      • -vm specifies the Java 17 runtime.
      • -Dosgi.requiredJavaVersion=17 allows Eclipse and DMA to start with Java 17 when no higher minimum Java version is enforced.
  3. Save your changes and restart Eclipse:

    When Eclipse restarts, DMA runs with Java 17.

What to do next

DMA 1.0.3 runs by using Java 17 when you start it in Eclipse 2024-06.