Pre-installation tasks

Edit online

Before you install, you might need to prepare or configure your computer.

  • For developing Java applications, you must install Eclipse IDE for Java Developers for Eclipse 2024-06. This can be downloaded from https://www.eclipse.org/downloads/packages/release/2024-06/r/eclipse-ide-java-developers. You can use the Eclipse installer to downloaded it automatically.

  • For developing Java and Web applications, you must install Eclipse IDE for Enterprise Java and Web Developers for Eclipse 2024-06. This can be downloaded from https://www.eclipse.org/downloads/packages/release/2024-06/r/eclipse-ide-enterprise-java-and-web-developers. You can use the Eclipse installer to downloaded it automatically.

  • Access to a repository containing the DMA update site. This can either be a locally downloaded zip file or the address of a shared repository that has been preconfigured for your usage.

    Note: You can download the DMA update site zip file from IBM Site.

  • A valid license. This can either be provided by means of a license server that contains DMA licenses, or it can be a license key (permanent or trial) which you have obtained from IBM.

  • An installation of a Java development kit (JDK) 64 bit.

    Note:

    DMA requires a Java 21 or 17 JDK, both when installing and running it. We recommend using the Open JDK (see the System Requirements for the exact recommended versions.)

    Eclipse 2024-06 includes Java 21 by default. If you prefer to use Java 17, specify the JDK path in the eclipse.ini file located in the Eclipse installation directory.

    For example:

    -vm

    D:/openjdk-17/jdk-17/bin/server/jvm.dll

  • For Mac, add the below entry to config.ini file to provide non-root user access to var directory for DMA license plugins to access:
    com.ibm.cic.licensing.p2.home.dir=/var

Install additional eclipse features before DMA installation

Note: The following section is only applicable for installing DMA on Eclipse IDE for Java Developers, and can be skipped when installing DMA on Eclipse IDE for Enterprise Java and Web Developers.
Follow the steps below to install the required eclipse feature on top of base Eclipse IDE for Java Developer for Eclipse 2024-06
  • Launch Eclipse.
  • Choose Install New Software command from the Help menu.
  • Select “2024-06 - https://download.eclipse.org/releases/2024-06” from the dropdown in Work With

    Choose the below options to install the required Eclipse features:

    • General Purpose Tools -> Eclipse Plug-in Development Environment
    • Web, XML, Java EE and OSGi Enterprise Development -> Eclipse Java Web Developer Tools
    • Web, XML, Java EE and OSGi Enterprise Development -> WST Server Adapters
  • Review Install Details for the above eclipse feature installation. Click the Next button to proceed.
  • Once the installation is completed, Click on Restart Now button to restart eclipse.