Chapter 2. Installing the MTA plugin
Chapter 2. Installing the MTA plugin You can install the MTA plugin in a connected or a restricted network environment. 2.1. Installing Java Development Kit You must have the Java Development Kit (JDK) installed on your system prior to installing the Eclipse integrated development environment (IDE). Migration Toolkit for Applications (MTA) supports the following JDKs: OpenJDK 11 OpenJDK 17 Oracle JDK 11 Oracle JDK 17 Eclipse TemurinTM JDK 11 Eclipse TemurinTM JDK 17 Procedure From the Oracle JDK download page , download the JDK tar.gz file suitable for your system. Note You need to accept the Oracle license agreement to proceed. Alternatively, you can download JDK by using the command-line interface: USD wget https://download.oracle.com/java/11/latest/<jdk-file> Extract the tar.gz file: USD tar -xzf <jdk-file> Optional: To make JDK available system-wide, move the extracted folder to the /opt directory: USD sudo mv <jdk-extracted-folder> /opt/<jdk-file> Set up the JAVA_HOME environment variable and add the JDK bin directory to the PATH variable: Open the .bashrc file: USD nano ~/.bashrc Add the following lines to the file: export JAVA_HOME=/opt/<jdk-file> export PATH=USDPATH:USDJAVA_HOME/bin Save the file and close it. To apply the new changes, reload the file: USD source ~/.bashrc Verification Use the java --version command to verify the installed JDK version: USD java --version 2.2. Installing Eclipse Eclipse is an integrated development environment (IDE) that you can use to install the Migration Toolkit for Applications (MTA) plug-in used for migrating and modernizing applications. Prerequisites You have the Java Development Kit (JDK) installed on your system. For more information, see Installing Java Development Kit . MTA supports the following JDKs: OpenJDK 11 OpenJDK 17 Oracle JDK 11 Oracle JDK 17 Eclipse TemurinTM JDK 11 Eclipse TemurinTM JDK 17 Procedure From the Eclipse download page , download the required Eclipse IDE tar.gz file, for example, Eclipse IDE for Java Developers . Extract the tar.gz file: USD tar -xzf <file_name>.tar.gz Optional: To make Eclipse available system-wide, move the extracted folder to the /opt directory: USD sudo mv eclipse /opt/eclipse Optional: To make Eclipse launch from the command line, create a symbolic link to the executable: USD sudo ln -s /opt/eclipse/eclipse /usr/bin/eclipse Optional: To launch Eclipse from you application menu, create a desktop entry: Create a new eclipse.desktop file: sudo nano /usr/share/applications/eclipse.desktop Add the following content to the eclipse.desktop file: [Desktop Entry] Name=Eclipse IDE 2024-03 Type=Application Exec=/opt/eclipse/eclipse Terminal=false Icon=/opt/eclipse/icon.xpm Comment=Intergrated DEvelopment Environment NoDisplay=false Categories=Development;IDE; Name[en]=Eclipse IDE 2024-03 2.3. Adding JBoss Tools dependencies for the MTA plug-in JBoss Tools dependencies are required by Eclipse during the Migration Toolkit for Applications (MTA) plug-in installation process. Prerequisites You have the Java Development Kit (JDK) installed on your system. For more information, see Installing Java Development Kit . MTA supports the following JDKs: OpenJDK 11 OpenJDK 17 Oracle JDK 11 Oracle JDK 17 Eclipse TemurinTM JDK 11 Eclipse TemurinTM JDK 17 Procedure Launch Eclipse. From the menu bar, select Help Install New Software . Add the JBoss Tools update website by specifying the https://download.jboss.org/jbosstools/photon/development/updates/ location. 2.4. Installing in a connected environment You need a connected environment to install the MTA plugin. The MTA plugin has been tested with the Eclipse integrated development environment (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 TemurinTM JDK 11 Eclipse TemurinTM JDK 17 8 GB RAM macOS installation: the value of maxproc must be 2048 or greater. Eclipse IDE for Java Enterprise Developers 2023-03 JBoss Tools, installed from the Eclipse Marketplace Important You must also add JBoss Tools dependencies that are required by Eclipse during the MTA plug-in installation process. For more information, see Adding JBoss Tools dependencies for the MTA plug-in . Mylyn SDK and frameworks , installed with Eclipse Note 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 . 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-mta and 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 . Review the installation details and click . Accept the terms of the license agreement and click Finish . Restart Eclipse. 2.5. 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. Note The report is not generated by default. You must select the Generate Report option in the run configuration.
wget https://download.oracle.com/java/11/latest/<jdk-file> tar -xzf <jdk-file> sudo mv <jdk-extracted-folder> /opt/<jdk-file> nano ~/.bashrc export JAVA_HOME=/opt/<jdk-file> export PATH=USDPATH:USDJAVA_HOME/bin source ~/.bashrc java --version tar -xzf <file_name>.tar.gz sudo mv eclipse /opt/eclipse sudo ln -s /opt/eclipse/eclipse /usr/bin/eclipse sudo nano /usr/share/applications/eclipse.desktop [Desktop Entry] Name=Eclipse IDE 2024-03 Type=Application Exec=/opt/eclipse/eclipse Terminal=false Icon=/opt/eclipse/icon.xpm Comment=Intergrated DEvelopment Environment NoDisplay=false Categories=Development;IDE; Name[en]=Eclipse IDE 2024-03