Chapter 2. Installing the MTA plugin
You can install the MTA plugin in a connected or a restricted network environment.
2.1. Installing in a connected environment
You need a connected environment to install the MTA plugin.
The MTA plugin has been tested with the Eclipse IDE for Java Enterprise Developers 2023-03.
Prerequisites
The following are the prerequisites for the Migration Toolkit for Applications (MTA) installation:
Java Development Kit (JDK) is installed. MTA supports the following JDKs:
- OpenJDK 11
- OpenJDK 17
- Oracle JDK 11
- Oracle JDK 17
- Eclipse Temurin™ JDK 11
- Eclipse Temurin™ JDK 17
- 8 GB RAM
-
macOS installation: the value of
maxprocmust be2048or greater.
- Eclipse IDE for Java Enterprise Developers 2023-03
- JBoss Tools, installed from the Eclipse Marketplace
- Mylyn SDK and frameworks, installed with Eclipse
Eclipse is pre-configured for Java 17, and the plugin operates directly with Java 17.
You can also run the plugin with Java 11, which requires setting the JRE version to Java 11 when creating up a new Eclipse project or importing an existing one. See step 6 below.
Procedure
- Launch Eclipse.
-
From the menu bar, select Help
Install New Software. - Next to the Work with field, click Add.
-
In the Name field, enter
MTA. -
In the Location field, enter
https://marketplace.eclipse.org/content/migration-toolkit-applications-mtaand click OK. Select the Java version to use.
- If using Java 11, in the JRE list, select JavaSE 11.
- If using Java 17, leave the JRE selection unchanged.
- Select all the JBoss Tools - MTA check boxes and click Next.
- Review the installation details and click Next.
- Accept the terms of the license agreement and click Finish.
- Restart Eclipse.
2.2. Installing in a connected environment
You need a connected environment to install the MTA plugin.
The MTA plugin has been tested with the Eclipse IDE for Java Enterprise Developers 2023-03.
Prerequisites
The following are the prerequisites for the Migration Toolkit for Applications (MTA) installation:
Java Development Kit (JDK) is installed. MTA supports the following JDKs:
- OpenJDK 11
- OpenJDK 17
- Oracle JDK 11
- Oracle JDK 17
- Eclipse Temurin™ JDK 11
- Eclipse Temurin™ JDK 17
- 8 GB RAM
-
macOS installation: the value of
maxprocmust be2048or greater.
- Eclipse IDE for Java Enterprise Developers 2023-03
- JBoss Tools, installed from the Eclipse Marketplace
- Mylyn SDK and frameworks, installed with Eclipse
Eclipse is pre-configured for Java 17, and the plugin operates directly with Java 17.
You can also run the plugin with Java 11, which requires setting the JRE version to Java 11 when creating up a new Eclipse project or importing an existing one. See step 6 below.
Procedure
- Launch Eclipse.
-
From the menu bar, select Help
Install New Software. - Next to the Work with field, click Add.
-
In the Name field, enter
MTA. -
In the Location field, enter
https://marketplace.eclipse.org/content/migration-toolkit-applications-mtaand click OK. Select the Java version to use.
- If using Java 11, in the JRE list, select JavaSE 11.
- If using Java 17, leave the JRE selection unchanged.
- Select all the JBoss Tools - MTA check boxes and click Next.
- Review the installation details and click Next.
- Accept the terms of the license agreement and click Finish.
- Restart Eclipse.
2.3. Accessing the MTA tools
You can access the MTA plugin tools in the MTA perspective.
Prerequisites
- You must restart the Eclipse IDE after installing the MTA plugin.
Procedure
-
Click Window
Perspective Open Perspective Other. Select MTA and click OK.
The following components are displayed:
- Issue Explorer displays the migration issues identified by the MTA plugin.
MTA Server is a separate process that analyzes projects, flags migration issues, and generates reports.
You can start, stop, and view the status of the MTA server in the Issue Explorer.
- Issue Details displays detailed information about a selected issue, including the hint, severity, and any additional resources.
MTA Report is an HTML report generated by the MTA plugin. From the report landing page you can navigate to detailed reports, such as Application Details, Issues, and Dependencies.
NoteThe report is not generated by default. You must select the Generate Report option in the run configuration.
