Release Notes

Migration Toolkit for Applications 5.2

New features, known issues, and resolved issues

Red Hat Customer Content Services

Abstract

This document describes new features, known issues, and resolved issues for the Migration Toolkit for Applications, version 5.2.1.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Chapter 1. New features

This section describes the new features of the Migration Toolkit for Applications (MTA) 5.2.1.

Important

Rules for migrating from Java EE8 to Jakarta EE9 and OpenRewrite support are both provided as Technology Preview only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs), might not be functionally complete, and Red Hat does not recommend to use them for production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

See Technology Preview features support scope on the Red Hat Customer Portal for information about the support scope for Technology Preview features.

Rules for migrating from Java EE8 to Jakarta EE9

MTA rules replace Java EE8 artifact dependencies and package import statements and rename XML schema namespaces, prefixed properties, and bootstrapping files for Jakarta EE9. You run these rules by specifying the jakarta-ee target.

OpenRewrite recipe support

OpenRewrite automates large-scale, distributed source code refactoring. You can run OpenRewrite recipes by using the MTA CLI.

The recipe org.jboss.windup.JavaxToJakarta renames imported javax packages to their jakarta equivalents.

MTA extension for Visual Studio Code compatible with Codespaces

The MTA extension for Microsoft Visual Studio Code is now compatible with Microsoft Visual Studio Codespaces.

Rules for the Springboot-to-Quarkus migration path

Rulesets identify Quarkus-supported technologies by detecting a POM dependency, embedded JAR file, or a partial file path within an Apache Maven Shade uber JAR.

The rules identify the following technologies:

  • Apicurio Studio
  • Flyway
  • Liquibase
  • Liquibase for MongoDB
  • OpenTelemetry
  • Picocli

Chapter 2. Known issues

At the time of release, the following known issues have been identified as major issues worth highlighting.

For a complete list of all known issues, see the list of 5.2.1 known issues in Jira.

Table 2.1. Major known issues

IDComponentSummary

WINDUP-3138

CodeReady Workspace plugin

The plugin works with CodeReady Workspace 2.09, but not version 2.10.

WINDUP-3165

Web console on OpenShift Container Platform

Analysis fails when MTA custom labels are uploaded and advanced options are enabled.

WINDUP-3160

Web console on OpenShift Container Platform

If you run an analysis on multiple applications and subsequently delete an application and rerun the analysis, the analysis hangs.

WINDUP-3005

Web console

The Save and Save and run buttons are not displayed on the Custom rules and Custom labels tabs on the Analysis configuration page.

WINDUP-3159

Web console

If you delete an application from a project after running an analysis, the number of applications is not updated when you rerun the analysis.

Chapter 3. Resolved issues

At the time of the release, the following resolved issues have been identified as major issues worth highlighting:

Table 3.1. Major resolved issues

IDComponentSummary

WINDUP-3201

Red Hat CodeReady Studio extension

The plugin cannot be used in Red Hat CodeReady Studio 12.21.0.GA.

WINDUP-3125

ItelliJ IDEA plugin and Visual Studio Code extension

The Apply QuickFix menu option is not disabled after a QuickFix is applied.

WINDUP-3134

ItelliJ IDEA plugin

After you run an analysis, the Mark as Complete menu option is not displayed.

WINDUP-3136

Visual Studio Code extension

If you run an analysis with an incorrect JAVA_HOME environmental variable, the analysis continues to run after you correct the variable and the Run option is disabled.

Legal Notice

Copyright © 2022 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.