Installation Using Eclipse UI

This topic provides the instructions for installing IBM^® DevOps Model Architect.

Before you begin

Review the below topics

User can install product as non administrator or non root user. Make sure that the Eclipse installation path does not contain any space characters. There are components in DMA which do not work correctly if they are located in a path that contains a space.

About this task

Installation Using Eclipse UI

This section describes how to install DMA as an update site on top of Eclipse 2023.06 using Eclipse's graphical user interface.

Procedure

Start Eclipse
To install DMA on Eclipse IDE for Java Developer or Eclipse IDE for Enterprise Java and Web Developers, open the Preferences dialog from the Window menu to manage your preferences. Go to Install/Update > Available Software Sites preference page. Uncheck all the software sites except 2023-06 and The Eclipse Project Updates checkboxes.

Note: If you want to install DMA on Eclipse IDE for Enterprise Java and Web Developers, uncheck all the software sites except 2023-06, The Eclipse Project Updates and The Eclipse Web Tools Platform (WTP) software repository checkboxes.`

Note: It is important to uncheck items like Latest Eclipse Simultaneous Release, Latest Eclipse IDE Packages Release and others that can trigger Eclipse components upgrade that may cause errors during installation.
Refer Section Install additional eclipse features before DMA installation of Pre-Installation task before installation of DMA
Choose Install New Software command from the Help menu.
Press the Add... button and enter the location of DMA update site. If the update site is located on a server, you can directly type the URL in the Location field. If you have it as a zip file in the system then press the Archive ... button and select it. If you have zip file already unpacked in a folder then you should use Local button and select the folder. You can give meaningful name to the repository in case you want to install again in future. For example:
Select the added repository in the Work with drop down. A list of DMA installation categories will be shown in the list below. It will look like something like this (which categories that are available depends on exact version of DMA):
Under each installation category you can see the features it contains. You can select individual features to install. but often you will select only the top level categories to install all features they contain. The Core DMA functionality is contained in DMA Core category. All other categories contain optional additional functionality which you may or may not choose to install depending on your needs.
Select DMA Core and any other optional categories you want to install. Press Next button.
Note:
If you get errors at this step double check that you run with sufficient privileges to be able to make updates to the system and files. ( On Windows you need to start Eclipse using Run As Administrator on command on Linux with root rights.) Also make sure that you use a Java 17 JVM.

Note:
Depending on what Eclipse distribution you use, some Eclipse plugins which DMA requires may be missing. Such plugins must be downloaded during the installation. To allow this to happen automatically you must select the checkbox Contact all update sites during install to find required software. As explained above, Eclipse 2023-06 http://download.eclipse.org/releases/2023-06 must be in the list of available software sites (Preferences – Install/Update – Available Software Sites). If your machine does not have internet access, please follow the instructions given in the chapter Installing without Internet Access.

Note:
If you install the DMA EGit Integration (under the category DMA Integrations) you also must install EGit (Git integration for Eclipse). DMA has its own version of EGit which is extended compared to the one that is part of Eclipse itself. At a minimum, you must install the component called "Git integration for Eclipse".

Note:
If you choose to install the DMA EGit Integration into an Eclipse installation that already contains a version of EGit that is different from the version included in the DMA EGit Integration, you will be informed with a page similar to the one shown below. You should then choose the option to update your installation to be compatible with the items being installed. This will automatically uninstall the existing EGit feature, before installing the DMA EGit Integration.
Review Install Details page with a message that "Your original request has been modified". This is just information that Eclipse detected Git integration of Eclipse which it will update with DMA version of eGit. Just press Next button to proceed.
A final Review Licenses page will now be shown. If you accept the license agreements, click the appropriate button and then Finish button.
During installation you might get Trust page from Eclipses. Click button Select All then click on Trust Selected button of dialog to proceed the installation.
The installation will now start. This can take several minutes so please be patient.
After the installation is complete, you will be asked to restart Eclipse. Answer Yes button. You are not encouraged to try to use DMA without first restarting Eclipse.
When Eclipse has started again you can confirm that DMA was successfully installed. Open the About dialog
Likewise, you can also confirm that DMA has been installed successfully on the Eclipse IDE for Enterprise Java and Web Developers.
Click the button to view the installed version of DMA and release.
You can also find the installed DMA features if you press the Installation Details button in the About dialog, and then click the Installed Software tab.

Feedback