Chapter 3. MTA 7.1.0
3.1. New features
This section provides the new features and improvements of the Migration Toolkit for Applications (MTA) 7.1.0.
Support for analyzing applications managed with Gradle has been added to MTA
In earlier releases of Migration Toolkit for Applications (MTA), you could use MTA to analyze Java applications managed only with Maven. With this update, MTA can also extract dependencies from Gradle projects. As a result, you can now analyze applications that use Gradle instead of Maven.
Support for analyzing applications managed with Gradle is a Developer Preview feature only. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to upcoming product features in advance of their possible inclusion in a Red Hat product offering, enabling customers to test functionality and provide feedback during the development process. These features might not have any documentation, are subject to change or removal at any time, and testing is limited. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
Support for analyzing .NET applications has been added to MTA
In Migration Toolkit for Applications (MTA) 7.1.0, you can use MTA to analyze Windows-only .NET framework applications to aid migration from version 4.5 or later to multi-platform .NET 8.0 running on OpenShift Container Platform. This feature is only available in the command-line interface (CLI).
Support for analyzing .NET applications is a Developer Preview feature only. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to upcoming product features in advance of their possible inclusion in a Red Hat product offering, enabling customers to test functionality and provide feedback during the development process. These features might not have any documentation, are subject to change or removal at any time, and testing is limited. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
Support for languages other than Java
In Migration Toolkit for Applications (MTA) 7.1.0, you can use MTA to analyze .NET applications written in languages other than Java. To run analysis on .NET applications written in languages other than Java, add a custom rule set and do not specify a target language.
Support for languages other than Java is a Developer Preview feature only. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to upcoming product features in advance of their possible inclusion in a Red Hat product offering, enabling customers to test functionality and provide feedback during the development process. These features might not have any documentation, are subject to change or removal at any time, and testing is limited. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
Assessment and review statuses are now displayed in the MTA UI
In earlier releases of Migration Toolkit for Applications (MTA), the status of the assessment and the review was only displayed for applications. With this update, the status of the archetype assessment and review processes is displayed in the MTA user interface (UI):
The assessment statuses are the following:
- Completed: All required assessments completed.
- InProgress: The assessment process is in progress.
- NotStarted: The assessment process has not been started.
The review statuses are the following:
- Completed: A review exists.
- NotStarted: The review process has not been started.
New Insights feature has been added
Tagging rules that earlier generated tags and showed the presence of technology also generate Insights now and show the location of code. While Insights do not impact the migration, they contain useful information about the technologies used in the application and their usage in the code. Insights do not have an effort and category assigned but might have a message and tag. You can view Insights in the Static report under the Insights tab.
Insights is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.
New MTA CLI options are available to select language providers when analyzing multi-language applications
In earlier releases of Migration Toolkit for Applications (MTA), you could not select specific language providers to run separately for the analysis of a multi-language application. With this update, you can use the new --provider MTA command-line interface (CLI) option to explicitly set which language provider to run.
The following CLI options are also available with this update:
-
--list-providersto list language providers supported for the analysis. -
--override-provider-settingsto override an existing supported language provider or to run your own unsupported provider.
You can now also configure supported language provider options in a provider’s configuration file.
A new Task Manager page is now available in the MTA UI
In earlier releases of Migration Toolkit for Applications (MTA), tasks that were being performed and the queue of pending tasks were not displayed in the MTA user interface (UI). With this update, a new Task Manager page is available to view the following information about the tasks that are queued:
- ID: The ID of the task.
- Application: The application name associated with the task.
- Status: The status of the task, for example, Scheduled, Pending, In progress, Succeeded, or Failed.
- Kind: The type of the task, for example, analyzer or discovery.
- Priority: Priority of the task. The value is from zero to any positive integer. The higher the value in this column, the higher the priority of the task.
- Preemption: It allows the scheduler to cancel a running task and free the resources for higher priority tasks. The values are true or false.
- Created By: The name of the user who created the task.
Multiple applications can now be selected to filter the applications list in Application Inventory
In earlier releases of Migration Toolkit for Applications (MTA), you could select only one application to filter the results on the Application Inventory page. With this update, you can select multiple applications as a single filter to display the list of applications corresponding to this filter.
Support for providing a single report when analyzing multiple applications on the CLI
mta-cli was designed to analyze a single application and produce a report about that application. With this update, you can use the --bulk option of the analyze command to analyze multiple applications, one analyze command per application, but with a common output file for all of the reports. As described in the CLI Guide, this results in mta-cli generating a single analysis report for all the applications, instead of generating a separate report for each application.
Support for providing a single report when analyzing multiple applications on the CLI is a Developer Preview feature only. Developer Preview features are not supported by Red Hat in any way and are not functionally complete or production-ready. Do not use Developer Preview features for production or business-critical workloads. Developer Preview features provide early access to upcoming product features in advance of their possible inclusion in a Red Hat product offering, enabling customers to test functionality and provide feedback during the development process. These features might not have any documentation, are subject to change or removal at any time, and testing is limited. Red Hat might provide ways to submit feedback on Developer Preview features without an associated SLA.
New detailed reports generated during application analysis
A new feature has been introduced that provides a more detailed analysis of your application. Two additional log reports, issues.yaml and deps.yaml, are now available for viewing and downloading. These reports contain details about unmatched rules.
To enable the system to generate these reports, select the Enable enhanced analysis details checkbox in the Advanced options window during application analysis.
3.2. Upgrade notes
This section provides upgrade notes for the Migration Toolkit for Applications (MTA) 7.1.0.
PostgreSQL is migrated to version 15
In the Migration Toolkit for Applications (MTA) 7.1.0, the postgresql container image has been migrated to a new postgresql-15 version to be compatible with support. Note that this migration occurs during the upgrade to 7.1.0 and might take some time. The upgrade is considered to be completed when the status of the Tackle CR is Successful. To check the status of the Tackle, enter:
$ oc wait --for=condition=Successful --namespace=openshift-mta tackles.tackle.konveyor.io/tackle
tackle.tackle.konveyor.io/tackle condition met3.3. Known issues
This section provides highlighted known issues in Migration Toolkit for Applications (MTA) version 7.1.0.
Enabling Preemption does not work if authentication is enabled
In Migration Toolkit for Applications (MTA) 7.1.0, Preemption cannot be enabled for tasks in the Task Manager page and the Task Manager drawer if MTA authentication is enabled. To work around this issue, disable authentication. (MTA-3195)
