migration toolkit for applications 8.1

Release Notes

Release Notes for migration toolkit for applications 8.1

Red Hat Customer Content Services

Abstract

Review the new features, enhancements, fixed issues, and known issues in migration toolkit for applications (MTA) 8.0 and 8.1 to plan and manage your application updates. You can also explore available Technology Preview features and other release details.

Chapter 1. MTA 8.1.0

Review the Release Notes for new features, enhancements, and fixes in migration toolkit for applications (MTA) 8.1.

1.1. New features and enhancements

Review the following major new features and enhancements in migration toolkit for applications (MTA) version 8.1.0.

Centralized configuration management across components for standardizing analysis configuration and custom rules

You can use the centralized configuration management to standardize analysis configurations and custom rules for the following migration toolkit for applications (MTA) components:

  • User interface (UI)
  • Command-line interface (CLI)
  • The Visual Studio Code MTA extension.

Profiles contain analysis configuration that allows organizations to standardize configuration and simplify configuration management by adopting a platform engineering approach. The architect can create, update, and delete profiles and custom rules. Migrators can sync with the MTA Hub to download available configuration bundles and use them to run an analysis in the UI, CLI, and by using the Visual Studio Code plugin.

MTA-6491

MTA supports proxy service to connect to the LLM
You can allow client endpoints, for example, the MTA Visual Studio Code extension, to use the proxy service to access the large language models (LLMs). The client uses Keycloak credentials to authenticate to the MTA Hub. To authenticate to the LLM, the client sends a JSON Web Token (JWT) issued by Keycloak to the proxy service. The proxy service validates the client’s JWT against the Hub’s Keycloak instance. In a separate process, the proxy service authenticates to the LLM by using the cluster secret that contains the LLM API key configured by the administrator. Thus, the proxy service allows administrators to create, manage, and rotate LLM API keys without the need to share the LLM key with multiple client endpoints.

1.2. Developer Preview features

Review Developer Preview features that are available in migration toolkit for applications (MTA) 8.1.0.

For more information about the support scope of Red Hat Developer Preview software, see Developer Preview Support Scope.

C# provider for analyzing C# applications in source-only mode across MTA components (Developer Preview)

You can use the external csharp provider to run an analysis in source-only mode for C# source code in the migration toolkit for applications (MTA) command-line interface (CLI), user interface, and the MTA Visual Studio Code extension. csharp parses the source code by using tree-sitter and uses stack graph for the analysis to find references to types, methods, classes, and fields. Based on the C# rule definition, the analyzer identifies violations in your code that you must resolve before the application migration.

Important

Analyzing C# applications is fully supported in the MTA UI.

MTA-6492

The MTA Visual Studio Code extension pack and the Core extension with language-specific extension (Developer Preview)

The migration toolkit for applications (MTA) Visual Studio Code extension consists of an analyzer Remote Procedure Call (RPC) binary that runs an analysis for the following extensions:

  • Core (supported)
  • C#
  • Java
  • Javascript
  • Go
  • Extension pack

You can download the MTA version 8.1.0 Visual Studio Code extension as an extension pack that bundles the Core extension along with all the supported language-specific extensions. You can also use this extension when you want to analyze a project in a specific programming language. Alternatively, you can download the MTA Core extension with one language-specific extension to analyze a project coded in the programming language supported by the extension.

1.3. Known issues

Review the following newly identified and previously known issues in migration toolkit for applications (MTA) version 8.1.0. All future release notes list a known issue until resolved, at which point it appears as a fixed issue.

MTA UI does not trigger a violation for open source dependencies in Gradle applications

MTA user interface (UI) does not trigger a violation for open source libraries when you run a source+dependency analysis of a Gradle application. As a result, the analysis report does not list incidents for open source dependencies.

To work around this problem, analyze Gradle applications by using the MTA command-line interface (CLI).

MTA-6211

1.4. Fixed issues

Review the following fixed issues that have a significant impact in migration toolkit for applications (MTA) version 8.1.0.

Creating Source Control credentials no longer fails when the password exceeds the character limit

Before this update, you could not create Source Control credentials in the MTA user interface (UI) if you entered a user credential password that exceeded the 120-character limit. With this update, MTA does not the limit for maximum length for user credentials. As a result, you can create Source Control credentials with longer passwords.

MTA-6598

Non-UTF-8 source files display correctly in a static report

Before this update, after you ran the source code analysis by using the MTA command-line interface (CLI), non-UTF-8 encoded source files appeared distorted in a static report, causing readability issues. With this update, the browser correctly displays non-UTF-8 encoded source files in the static report.

MTA-5932

MTA CLI correctly processes Cloud Foundry applications with service bindings

Before this update, the discovery process for Cloud Foundry (CF) applications with service bindings by using live connection failed in the migration toolkit for applications (MTA) command-line interface (CLI). MTA CLI did not parse the VCAP_SERVICES environment variables correctly to handle service binding information for services, for example, cf bind-service <application_name> postgres01. With this update, MTA CLI no longer fails to complete the discovery of CF applications with service bindings.

MTA-6424

Chapter 2. migration toolkit for applications 8.0

Review the Release Notes for new features, enhancements, and fixes in migration toolkit for applications (MTA) 8.0.

2.1. MTA 8.0.1

Review the MTA 8.0.1 section for enhancement, fixed issues, and known issues.

2.1.1. New features and enhancements

Review the following major new features and enhancements in migration toolkit for applications (MTA) 8.0.1.

MTA supports pre-generated Maven index to reduce binary application analysis latency

Before this update, the analysis performance for Java binaries degraded because MTA relied on Maven search to analyze Java binary applications. With this enhancement, MTA has pre-generated bundled Maven index that does not require connecting to an external index through a network connection. As a result, MTA performs fast, low-memory look-ups of Maven artifacts by using local Maven Search and you can analyze Java binaries in disconnected environments.

MTA-6231

2.1.2. Known issues

Review the following newly identified and previously known issues in migration toolkit for applications (MTA) version 8.0.1. All future release notes list a known issue until resolved, at which point it appears as a fixed issue.

MTA assessment form malfunctions when you use it with a custom questionnaire

In the MTA user interface, selecting an answer to a question in the assessment form generated from a custom questionnaire causes the form to select an option available for another question.

To work around this problem, ensure that one or more order keys listed in a section, for example answers, have a unique order number.

MTA-6262

MTA UI does not trigger a violation for open source dependencies in Gradle applications

MTA UI does not trigger a violation for open source libraries when you run a source+dependency analysis of a Gradle application. As a result, the analysis report does not list incidents for open source dependencies.

To work around this problem, analyze Gradle applications by using the MTA command-line interface (CLI).

MTA-6211

MTA UI fails to process applications with service bindings

When you use the migration toolkit for applications (MTA) user interface (UI) to run an application discovery for a deployed Cloud Foundry (CF) application with a service binding, MTA UI does not parse the VCAP_SERVICES environment variables correctly to handle service binding information. As a result, the discovery fails.

To work around this problem, run the application discovery by using the MTA command-line interface (CLI).

MTA-6424

Rules with METHOD_CALL or CONSTRUCTOR_CALL do not match expected locations when specifying parameters

Search patterns in Java rules that have the METHOD_CALL and CONSTRUCTOR_CALL locations do not match the expected methods and constructors in the application source code.

For example:

    java.referenced:
      location: CONSTRUCTOR_CALL
      pattern: javax.servlet.UnavailableException(javax.servlet.Servlet,java.lang.String)

does not match

 String str = "something";
 Servlet s = exception1.getServlet();
 UnavailableException exception2 = new UnavailableException(s, str);

In addition, search patterns that do not contain Fully Qualified Names (FQNs) do not match. For example:

    java.referenced:
      location: CONSTRUCTOR_CALL
      pattern: UnavailableException(Servlet s,String str)

No known workaround exists.

MTA-6402

2.1.3. Fixed issues

Review the following fixed issues that have a significant impact in migration toolkit for applications (MTA) version 8.0.1.

Improved the performance of Java binary analysis
Before this change, when you analyzed Java binary applications, MTA incorrectly classified some open source dependencies as internal dependencies. MTA then decompiled and analyzed the dependencies that caused the analysis to take longer to complete. With this update, MTA passes the location of the Maven index file to the Java provider to determine if an embedded dependency is open source or internal. This fix resolved the following issue:
Analysis of binary applications classifies open source dependencies correctly

When you analyzed Java binary applications, MTA incorrectly classified some open source dependencies as internal dependencies. With this version, MTA classifies embedded open source dependencies correctly after a source+dependency binary analysis.

MTA-6357

You can specify an organization when importing applications from Cloud Foundry

When you imported applications from Cloud Foundry (CF), MTA did not have a provision for you to mention the CF organizations. With this release, you can configure one or more organizations, spaces, and applications for the discovery process. The spaces can belong to different organizations and the applications can belong to different spaces. You must specify at least one organization for application discovery.

MTA-6271

MTA CLI correctly processes Cloud Foundry applications with service binding

The discovery process of Cloud Foundry (CF) applications with service bindings by using live connection failed in MTA CLI. The MTA CLI did not parse the VCAP_SERVICES environment variables correctly to handle service binding information for an array of services, for example, cf bind-service <application_name> postgres01. With this version, MTA CLI successfully completes the discovery of CF applications with service bindings.

MTA-6399

MTA automatically tags imported Cloud Foundry applications

When you imported applications in MTA from a Cloud Foundry (CF) instance, the applications did not contain the Cloud Foundry tag. The tag links an application to an archetype. The archetype has a generator that produces the deployment assets for a migration path. With this release, you no longer have to manually add the Cloud Foundry tag in the imported application.

MTA-6282

You can import Cloud Foundry applications from the application inventory in the MTA web console

Before this update, an MTA Architect could not discover or import applications from the Cloud Foundry (CF) source platform on the application inventory page. As a result, only an MTA Administrator could import the applications on the Source platforms page in the Administrator mode. With this release, Architects can import CF applications in the Application Inventory.

MTA-6120

Concurrent usage of Red Hat Developer Lightspeed for MTA for code resolution at scale no longer causes race conditions

Concurrent usage of the Solution Server through the Red Hat Developer Lightspeed for MTA in Visual Studio Code for code resolution at scale caused race conditions for duplicate incidents. With this release, the plugin generates resolutions for the incidents identified when many users use it concurrently.

MTA-6230

MTA uses FQNs in Java rules to match annotations in source code

Before this update, the annotation rules for Java applications did not use Fully Qualified Names (FQNs) to match with the annotation location in source code. As a result, the rule triggered incorrect matches or false positives for issues. For example, a rule that looked for the javax.enterprise.inject.Produces incorrectly matched with occurrences of javax.ws.rs.Produces. With this release, MTA uses the FQN in the ANNOTATION field in rules to match annotations in the source code.

MTA-6195

MTA triggers rules to match import statements with wildcard in Java applications analysis

MTA did not trigger rules to match import statements that contain a wildcard when analyzing a Java application. As a result, MTA did not detect specific incidents in the report after the analysis. With this release, this issue is fixed.

MTA-4027

You can edit secure SVN application without an error in MTA user interface

When you disabled the Allow insecure connection for an application stored in the Subversion (SVN) repository and edited the application, the user interface displayed a blank page some times with the TypeError cannot read properties of undefined (reading 'kind'). With this version, you can edit secure SVN applications in the MTA user interface.

MTA-6263

MTA no longer fails language and tech discovery for Java application in SVN repositories

Before this update, for a Java application source code stored in an SVN repository, MTA produced an error when trying to checkout the repository by using the SVN credential. As a result, the language and tech discovery of the application failed. With this release, you can analyze an application stored in SVN repository without any error.

MTA-6141

MTA displays source repository URL when you skip configuring the repository type field

MTA did not show the source repository URL in the application details view if you did not select between the Git or Subversion repository type. As a result, you could not run an analysis on the application source code. With this release, you can use MTA to run an analysis on the source code even if you do not configure the repository type field.

MTA-6105

You can complete an assessment by using a custom questionnaire in the MTA user interface

Before this update, you could not proceed to the final step after filling in the responses to the custom questionnaire because MTA disabled the Next button in the web console. With this release, you can complete the questionnaire in MTA user interface.

MTA-6143

MTA web console detects custom rules when you upload many rules at a time

When you uploaded more than one custom rule at a time in the web console, MTA did not detect the rules. With this version, you can upload one or more custom rules at once.

MTA-6029

2.2. MTA 8.0.0

Review the Release Notes for new features, enhancements, Technology Preview features, removed features, fixed issues, and known issues in migration toolkit for applications (MTA) 8.0.0.

2.2.1. New features and enhancements

Review the following major new features and enhancements in migration toolkit for applications (MTA) 8.0.0.

Red Hat Developer Lightspeed for MTA is available in the Visual Studio Code extension

You can opt to use Red Hat Developer Lightspeed for MTA features in the Visual Studio Code extension. With the Developer Lightspeed feature, you can use a large language model (LLM) of your choice to request code changes for resolving the issues found through a static code analysis of your Java application.

The Red Hat Developer Lightspeed for MTA core features are the following:

  • RAG solution: The Red Hat Developer Lightspeed for MTA uses Retrieval Augmented Generation (RAG) for context-based resolutions of issues in code. Developer Lightspeed improves the context shared with the LLM to generate more accurate suggestions to fix the issue in the code.

    The context is a combination of the source code, the issue description, and solved examples. Solved examples contain code changes you accepted for other migrations, code you manually modified, and a pattern of resolution for an issue that you can use in the future.

  • Solution Server (Technology Preview): Solution Server is a component that allows Red Hat Developer Lightspeed for MTA to build a collective memory of code changes from all analysis performed in an organization. It also works with the LLM to improve the pattern of resolutions from solved examples for future analysis.

    The Solution Server delivers two primary benefits to users:

  • Contextual Hints: It surfaces examples of past migration solutions, including successful user modifications and accepted fixes, offering actionable hints for difficult or previously unsolved migration problems.

    • Migration Success Metrics: It exposes detailed success metrics for each migration rule, derived from real-world usage data. Integrated Development Environments (IDEs) or automation tools can use these metrics to present users with a “confidence level” or likelihood of Red Hat Developer Lightspeed for MTA successfully resolving a given migration issue or incident.
  • Agentic AI (Technology Preview): In the agent mode, Red Hat Developer Lightspeed for MTA makes iterative resolutions to issues in code. If you accept the suggested resolutions, Developer Lightspeed scans the code for diagnostic or linting issues that the accepted solution might introduce and fixes those issues. NOTE: To obtain support for features in Red Hat Developer Lightspeed for MTA, you need an active Red Hat Advanced Developer Suite (RHADS) subscription.

MTA-5371

MTA supports platform awareness to import applications from source platform instances

You can use platform awareness to discover applications from a source platform and import them into the MTA application inventory. MTA discovers the applications by their coordinates on the source platform where you deployed them. With platform awareness, you can use the platform and runtime configurations of applications to create a discovery manifest to generate other deployment assets. In MTA 8.0.0, you can discover applications deployed in the Cloud Foundry platform.

MTA-4846

MTA supports asset generation for application migration in the web console

You can use the discovery manifest to generate assets in the web console to deploy applications in Red Hat OpenShift or Kubernetes. The asset generation workflow includes generators, target profiles, and the archetypes. Generators parse the application manifest configurations to create the deployment assets for a specific kind of target platform. In the target profiles, you can run one or more generators in sequence for a given archetype.

MTA-4847

MTA CLI supports running a live discovery in a remote CF instance

With this update, you can perform a live discovery to determine applications that you deployed in a certain Cloud Foundry (CF) cluster. For example, you can determine how many applications are in the cluster. You can also use the live discovery if you do not have access to manifest YAML files.

For more information, see Performing a live discovery in a remote CF instance.

MTA-4847

MTA CLI supports concealing sensitive information in a discovery manifest

You can conceal sensitive information, for example, services and Docker credentials, in a Cloud Foundry (CF) discovery manifest by using the mta-cli discover cloud-foundry --conceal-sensitive-data command. This command generates the following files:

  • A discovery manifest
  • A file with concealed data

For more information, see Concealing sensitive information in a discovery manifest.

MTA-4847

Analysis insights are available in the MTA UI

Analysis insights contain information about the technologies used in the application and their usage in the code. Before this update, you could only view insights in the analysis output and a static report after running an application analysis. With this enhancement, you can access analysis insights also from the migration toolkit for applications (MTA) user interface (UI).

MTA-5420

A new Visual Studio Code IDE plugin for application analysis

With this enhancement, you can use a new Visual Studio Code Integrated Development Environment (IDE) plugin that has the following features:

  • Standard application analysis and issue detection
  • Generative AI (GenAI) feature:

    • When enabled, you can use GenAI to find solutions for the analysis incidents. Note that GenAI is enabled by default.
    • When disabled, you can run a standard application analysis.
Note

You must restart your server after changing the GenAI settings for the change to take effect.

MTA-5360

MTA UI supports setting default credentials

Before this update, you could only assign credentials to an application manually after you added or imported this application to the migration toolkit for applications (MTA) user interface (UI). However, you might need to import a large set of applications,with each application requiring credentials for language and technology discovery tasks. With this update, instead of manually defining credentials, you can define default credentials for any application that does not yet have credentials.

Important

You can only set Maven or source control credentials as default credentials. You can define only one default set of credentials per credential type.

For more information, see Setting default credentials.

MTA-5254

2.2.2. Technology Preview features

Review all Technology Preview features available in migration toolkit for applications (MTA) 8.0.0.

For information on Red Hat’s scope of support for Technology Preview features, see Technology Preview Features Support Scope.

Support for the Solution Server in Developer Lightspeed (Technology Preview)

Solution Server is a component that allows Developer Lightspeed for MTA to build a collective memory of code changes from all analysis performed in an organization. This capability is a Technology Preview feature. The Solution Server works with the LLM to improve the pattern of resolutions from solved examples for future analysis.

The Solution Server has the following benefits:

  • Contextual Hints: It surfaces examples of past migration solutions, including successful user modifications and accepted fixes, offering actionable hints for difficult or previously unsolved migration problems.
  • Migration Success Metrics: It exposes detailed success metrics for each migration rule, derived from real-world usage data. These metrics can be used by Integrated Development Environments (IDEs) or automation tools to present users with a “confidence level” or likelihood of Developer Lightspeed for MTA successfully resolving a given migration issue or incident.
Support for Agentic AI in Developer Lightspeed (Technology Preview)
In the agent mode (Agentic AI), Developer Lightspeed for MTA makes iterative resolutions to issues in code. If you accept the suggested resolutions, Developer Lightspeed scans the code for diagnostic or linting issues that can occur due to the solution you accepted and fixes those issues. This capability is a Technology Preview feature.

2.2.3. Removed features

Review all features removed in migration toolkit for applications (MTA) 8.0.0. All removed features were deprecated in earlier releases and are no longer supported.

MTA removes support for XML rules

In migration toolkit for applications (MTA) 8.1.1, MTA removes XML rules and no longer supports them in the MTA user interface (UI) and command-line interface (CLI).

MTA-5357

MTA removes support for the Eclipse IDE plugin
MTA removes the Eclipse Integrated Development Environment (IDE) plugin for migration toolkit for applications (MTA) to analyze the effort for migrating and modernizing your applications and no longer supports it. As an alternative, you can use the migration toolkit for applications extension for Visual Studio Code.

2.2.4. Known issues

Review the following newly identified and previously known issues in migration toolkit for applications (MTA) version 8.0.0. All future release notes list a known issue until resolved, at which point it appears as a fixed issue.

Application analysis with MTA CLI might fail with the "invalid header line" error

An application analysis by using the migration toolkit for applications (MTA) command-line interface (CLI) might fail with the following error message:

level=error msg="initialize failed" error="context canceled" provider=java
error="invalid header line "An error has occurred. See the log file"

To work around this problem, clean up metadata and cache:

  1. Clear the .metadata subdirectory under the directory from which you ran the mta-cli analyze command.
  2. Clear the Maven cache.

MTA-6125

MTA analysis result does not change if you add or remove a custom rule

When you use Developer Lightspeed for MTA, the analysis results do not change if you include or remove a custom rule but do not restart the analyzer process.

To work around this problem, restart the analyzer process by clicking the Start/Stop button after making a configuration change.

MTA-6129

ANNOTATION location rules do not match on FQNs

The ANNOTATION search location does not properly use Fully Qualified Names (FQNs) to match annotations. This leads to incorrect matches and false positives in analysis issues. For example, a rule that searches for annotations using the javax.enterprise.inject.Produces pattern might incorrectly match the occurrences of the javax.ws.rs.Produces annotation in the source code.

No known workaround exists.

MTA-6195

Developer Lightspeed for MTA database throws a connection error

The Solution Server throws a connection error when concurrent connections increase in a short span of time. To work around this problem, enter the following command to allow the Developer Lightspeed for MTA database to expire idle connections:

oc -n openshift-mta exec deploy/kai-db – psql -U postgres -d postgres -c "ALTER ROLE kai SET idle_session_timeout = '1min'; ALTER ROLE kai SET idle_in_transaction_session_timeout = '1min';"

MTA-6204

2.2.5. Fixed issues

Review the following fixed issues that have a significant impact in migration toolkit for applications (MTA) version 8.0.0.

MTA merges the default values.yaml file with the discover values.yaml file when generating a deployment manifest

Before this update, when you generated a deployment manifest by using the Helm template, MTA ignored the default values in the values.yaml file packaged with the Helm chart. As a result, MTA used only the values from the values.yaml file created after running the mta-cli discover command. With this update, MTA merges the default values.yaml file with the discover values.yaml file.

MTA-5793

MTA CLI no longer fails to detect dependencies for Gradle projects

Before this update, when you ran an application analysis for Gradle projects in containerless mode, migration toolkit for applications (MTA) command-line interface (CLI) did not detect Gradle dependencies. As a result, the analysis report did not list the dependencies and displayed an error message in the analysis logs instead. With this update, MTA CLI detects Gradle dependencies after the analysis is complete.

MTA-4033

MTA UI no longer fails to analyze projects built with Gradle version 7 and later

Before this update, when you analyzed an application built with Gradle in Source code + dependencies mode in the migration toolkit for applications (MTA) user interface (UI), the analysis failed if you had Gradle version 7 or later installed. With this update, you can analyze applications built with Gradle 7 or later in the MTA user interface.

MTA-5907

The discovery manifest lists all defined web processes in the application

Before this update, the mta-cli discover command only moved an application-level process with the process type explicitly defined to the processes block in the discovery manifest. As a result, the discovery manifest did not list implicit application-level processes in the processes block. This resulted in the violation of the recommended clarity and proper configuration practices, especially if Cloud Foundry application manifest includes multiple process types. With this update, mta-cli discover moves both implicit and explicit application-level process types to the processes block in the discovery manifest.

MTA-6030

Legal Notice

Copyright © 2026 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.