You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Learn how to interpret the AppCAT report.
4
4
author: KarlErickson
5
5
ms.author: karler
6
6
ms.reviewer: brborges
@@ -10,73 +10,75 @@ ms.topic: overview
10
10
ms.date: 06/27/2025
11
11
#customer intent: As a developer, I want to assess my Java application so that I can understand its readiness for migration to Azure.
12
12
---
13
+
13
14
# Interpret the AppCAT 7 report
14
15
15
-
This article guides you through the AppCAT report to help you well understand it for assessing the migration readiness of your Java application to Azure. The report provides a comprehensive overview of the application and its components. You can use this report to gain insights into the structure and dependencies of the application, and to determine its suitability for replatform and modernization.
16
+
This article guides you through the AppCAT report to help you understand it for assessing the readiness of your Java application for migration to Azure. The report provides a comprehensive overview of the application and its components. You can use this report to gain insights into the structure and dependencies of the application and to determine its suitability for replatforming and modernization.
16
17
17
18
## Application list view
18
-
The landing page of the report presents a overall view of all analyzed applications. From here, you can navigate to individual application reports to explore detailed findings.
19
19
20
-
:::image type="content" source="media/java/appcat-7-report-applist.png" alt-text="app list of the AppCAT assessment report." lightbox="media/java/appcat-7-report-applist.png":::
20
+
The landing page of the report presents an overall view of all analyzed applications. From here, you can navigate to individual application reports to explore detailed findings.
21
+
22
+
:::image type="content" source="media/java/appcat-7-report-applist.png" alt-text="Screenshot of the AppCAT assessment report Applications list." lightbox="media/java/appcat-7-report-applist.png":::
21
23
22
24
## Application view
23
25
24
-
The application report consists of 3 sections:
26
+
The application report consists of the following three sections:
25
27
26
-
-**Application Information**: Reveals the basic information of your application including Java version, framework, build tool, etc.
27
-
-**Issue Summary**: shows the issue overview for three domains with percentage on issue criticality.
28
-
- The detail report is organized into 4 sub sections:
28
+
-**Application Information**: reveals the basic information of your application including Java version, framework, build tool, and so on.
29
+
-**Issue Summary**: shows the issue overview for three domains with percentages for issue criticality.
30
+
- The detail report is organized into the following four subsections:
29
31
-**Issues**: Provides a concise summary of all issues that require attention.
30
32
-**Dependencies**: Displays all Java-packaged dependencies found within the application.
31
-
-**Technologies**: Displays all embedded libraries grouped by functionality, allowing you to quickly view the technologies used in the application.
32
-
-**Insights**: Detailed files and information to better understand detected technologies.
33
+
-**Technologies**: Displays all embedded libraries grouped by functionality, enabling you to quickly view the technologies used in the application.
34
+
-**Insights**: Displays file details and information to help you understand the detected technologies.
33
35
34
-
:::image type="content" source="media/java/appcat-7-report-app.png" alt-text="app view of the AppCAT assessment report." lightbox="media/java/appcat-7-report-app.png":::
36
+
:::image type="content" source="media/java/appcat-7-report-app.png" alt-text="Screenshot of the AppCAT assessment report." lightbox="media/java/appcat-7-report-app.png":::
35
37
36
38
### Issues
37
39
38
-
Access this part by clicking the Issues tab. It provides a categorized issue list of various aspects of Azure readiness, cloud native, and Java modernization that you need to address to successfully migrate the application to Azure. Learn more about domain and criticality via below sections.
40
+
Access this part by selecting the **Issues** tab. This tab provides a categorized issues list of various aspects of Azure readiness, cloud native, and Java modernization that you need to address to successfully migrate the application to Azure. The following tables describe the **Domain** and **Criticality** values:
| Mandatory | Issues that must be fixed for migration to Azure.|
51
+
| Potential | Issues that might impact migration and need review.|
52
+
| Optional | Low-impact issues. Fixing them is recommended but optional.|
51
53
52
-
:::image type="content" source="media/java/appcat-7-report-issues.png" alt-text="issues of the AppCAT assessment report." lightbox="media/java/appcat-7-report-issues.png":::
54
+
:::image type="content" source="media/java/appcat-7-report-issues.png" alt-text="Screenshot of the AppCAT assessment report Issues tab." lightbox="media/java/appcat-7-report-issues.png":::
53
55
54
-
Each reported issue can be expanded, by clicking on the title, to obtain additional details. The following information is provided:
56
+
For more information, you can expand each reported issue by selecting the title. The report provides the following information:
55
57
56
-
- A list of files where the incidents occurred, along with the number of code lines impacted. If the file is a Java source file, then clicking the filename will direct you to the corresponding Source report.
58
+
- A list of files where the incidents occurred, along with the number of code lines impacted. If the file is a Java source file, then selecting the filename directs you to the corresponding source report.
57
59
- A detailed description of the issue. This description outlines the problem, provides any known solutions, and references supporting documentation regarding either the issue or resolution.
58
60
59
-
:::image type="content" source="media/java/appcat-7-report-issue-detail.png" alt-text="issue detail of the AppCAT assessment report." lightbox="media/java/appcat-7-report-issue-detail.png":::
61
+
:::image type="content" source="media/java/appcat-7-report-issue-detail.png" alt-text="Screenshot of the AppCAT assessment report issue details." lightbox="media/java/appcat-7-report-issue-detail.png":::
60
62
61
-
:::image type="content" source="media/java/appcat-7-report-issue-code.png" alt-text="issue code of the AppCAT issue code report." lightbox="media/java/appcat-7-report-issue-code.png":::
63
+
:::image type="content" source="media/java/appcat-7-report-issue-code.png" alt-text="Screenshot of the AppCAT assessment issue code report." lightbox="media/java/appcat-7-report-issue-code.png":::
62
64
63
65
### Technologies
64
66
65
-
Access this part by clicking the Technologies tab. The report lists the occurrences of technologies, grouped by function, in the analyzed application. It is an overview of the technologies found in the application, and is designed to assist users in quickly understanding each application's purpose.
67
+
Access this part by selecting the **Technologies** tab. The report lists the occurrences of technologies, grouped by function, in the analyzed application. This report is an overview of the technologies found in the application, and is designed to assist you in quickly understanding each application's purpose.
66
68
67
-
:::image type="content" source="media/java/appcat-7-report-technologies.png" alt-text="technologies of the AppCAT assessment report." lightbox="media/java/appcat-7-report-technologies.png":::
69
+
:::image type="content" source="media/java/appcat-7-report-technologies.png" alt-text="Screenshot of the AppCAT assessment report Technologies tab." lightbox="media/java/appcat-7-report-technologies.png":::
68
70
69
71
### Dependencies
70
72
71
-
Access this part by clicking the Dependencies tab. Displays all Java-packaged dependencies found within the application.
73
+
Access this part by selecting the **Dependencies** tab. Displays all Java-packaged dependencies found within the application.
72
74
73
-
:::image type="content" source="media/java/appcat-7-report-dependencies.png" alt-text="dependencies of the AppCAT assessment report." lightbox="media/java/appcat-7-report-dependencies.png":::
75
+
:::image type="content" source="media/java/appcat-7-report-dependencies.png" alt-text="Screenshot of the AppCAT assessment report Dependencies tab." lightbox="media/java/appcat-7-report-dependencies.png":::
74
76
75
77
### Insights
76
78
77
-
Access this part by clicking the Insights tab. Detailed files and information to better understand detected technologies.
79
+
Access this part by selecting the **Insights** tab. Displays file details and information to help you understand the detected technologies.
78
80
79
-
:::image type="content" source="media/java/appcat-7-report-insights.png" alt-text="Insights of the AppCAT assessment report." lightbox="media/java/appcat-7-report-insights.png":::
81
+
:::image type="content" source="media/java/appcat-7-report-insights.png" alt-text="Screenshot of the AppCAT assessment report Insights tab." lightbox="media/java/appcat-7-report-insights.png":::
Copy file name to clipboardExpand all lines: articles/migrate/appcat/appcat7-quick-start.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: "Quickstart: Assess a Java Project using AppCAT 7"
3
-
description: Azure Migrate application and code assessment tool - Quick start to assess a java project.
3
+
description: Learn how to assess a Java project using AppCAT 7.
4
4
author: KarlErickson
5
5
ms.author: karler
6
6
ms.reviewer: brborges
@@ -13,13 +13,13 @@ ms.date: 06/27/2025
13
13
14
14
# Quickstart: Assess a java project using AppCAT 7
15
15
16
-
This article describes how to download, install and run AppCAT 7 against a sample Java project.
16
+
This quickstart shows you how to download, install, and run AppCAT 7 against a sample Java project.
17
17
18
18
## Prerequisites
19
19
20
-
Before downloading AppCAT, please make sure JDK is installed and configured correctly.
20
+
Before downloading AppCAT, be sure the JDK is installed and configured correctly.
21
21
22
-
-[Download](/java/openjdk/download#openjdk-17) and [install Microsoft Build of OpenJDK 17](/java/openjdk/install). Ensure that the `JAVA_HOME` environment variable is set.
22
+
-[The Microsoft Build of OpenJDK 17](/java/openjdk/install). Ensure that the `JAVA_HOME` environment variable is set.
23
23
24
24
## Download and install
25
25
@@ -76,7 +76,7 @@ Extract the binary from the downloaded file. You should see the following folder
76
76
77
77
## Run AppCAT against a sample Java project
78
78
79
-
In following steps, let's do application assessment using AppCAT against [Airsonic-Advanced](https://github.com/airsonic-advanced/airsonic-advanced) - a community-driven, web-based media streamer that enables you to access and share your music collection.
79
+
In following steps, you do an application assessment using AppCAT against [Airsonic-Advanced](https://github.com/airsonic-advanced/airsonic-advanced) - a community-driven, web-based media streamer that enables you to access and share your music collection.
80
80
81
81
1. To run `appcat` from any location in your terminal, extract the archive to your desired location. Then, update the `PATH` environment variable to include the directory where you extracted the archive.
82
82
@@ -89,7 +89,7 @@ In following steps, let's do application assessment using AppCAT against [Airson
1. Run the assessment scripts living in samples folder of the downloaded AppCAT release package with providing the path to the cloned folder above. Depending on your operating system, run the appropriate script, as shown in the following example. The reports are automatically generated and opened in your web browser. You can find the reports under **../samples/report-\*** (Linux/macOS) or **..\samples\report-\*** (Windows).
92
+
1. Run the assessment scripts in the samples folder of the downloaded AppCAT release package by providing the path to the cloned folder from the previous step. Depending on your operating system, run the appropriate script, as shown in the following example. The reports are automatically generated and opened in your web browser. You can find the reports under **../samples/report-\*** (Linux/macOS) or **..\samples\report-\*** (Windows).
93
93
94
94
### [Linux / macOS](#tab/linux)
95
95
@@ -110,12 +110,12 @@ In the **samples** directory, you can find the following scripts to run differen
110
110
111
111
-**run-assessment**: Provides a report with code assessment and steps for migrating Airsonic to Azure App Service on Tomcat.
112
112
-**run-assessment-transform-rules**: Converts Windup XML rules to analyzer-lsp-compatible YAML rules.
113
-
-**run-assessment-custom-rules**: Provides a code assessment report using custom rules (transform XML to YAML).
113
+
-**run-assessment-custom-rules**: Provides a code assessment report using custom rules *transform XML to YAML*.
114
114
-**run-assessment-openjdk21**: Generates a report with code assessment and steps for migrating Airsonic to OpenJDK 21.
115
115
-**run-assessment-package-only**: Produces a report by assessing specific packages.
116
116
117
117
## Next steps
118
118
119
-
-[Interpret the report](appcat7-interpret-report.md)
120
-
-[CLI Command Guide for AppCAT 7](appcat7-cli-guide.md)
121
-
-[Create custom rules for AppCAT 7](appcat7-rule-guide.md)
119
+
-[Interpret the AppCAT 7 report](appcat7-interpret-report.md)
120
+
-[CLI command guide for AppCAT 7](appcat7-cli-guide.md)
121
+
-[Rules development guide for AppCAT 7](appcat7-rule-guide.md)
0 commit comments