Skip to content

Commit 7127ce5

Browse files
authored
Update AppCAT doc for release 7.6.0.5
1 parent e196d5f commit 7127ce5

File tree

1 file changed

+62
-57
lines changed

1 file changed

+62
-57
lines changed

articles/migrate/appcat/java-preview.md

Lines changed: 62 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -75,24 +75,24 @@ For the JDK requirement, we recommend you use the [Microsoft Build of OpenJDK](/
7575
| macOS | Apple Silicon | [Download][10] | [sha256][11] / [sig][12] |
7676
| Linux | AArch64 / ARM64 | [Download][4] | [sha256][5] / [sig][6] |
7777

78-
[1]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-amd64-7.6.0.4-preview.tar.gz
79-
[2]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-amd64-7.6.0.4-preview.tar.gz.sha256sum.txt
80-
[3]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-amd64-7.6.0.4-preview.tar.gz.sig
81-
[4]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-arm64-7.6.0.4-preview.tar.gz
82-
[5]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-arm64-7.6.0.4-preview.tar.gz.sha256sum.txt
83-
[6]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-arm64-7.6.0.4-preview.tar.gz.sig
84-
[7]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-amd64-7.6.0.4-preview.tar.gz
85-
[8]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-amd64-7.6.0.4-preview.tar.gz.sha256sum.txt
86-
[9]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-amd64-7.6.0.4-preview.tar.gz.sig
87-
[10]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-arm64-7.6.0.4-preview.tar.gz
88-
[11]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-arm64-7.6.0.4-preview.tar.gz.sha256sum.txt
89-
[12]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-arm64-7.6.0.4-preview.tar.gz.sig
90-
[13]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-amd64-7.6.0.4-preview.zip
91-
[14]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-amd64-7.6.0.4-preview.zip.sha256sum.txt
92-
[15]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-amd64-7.6.0.4-preview.zip.sig
93-
[16]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-arm64-7.6.0.4-preview.zip
94-
[17]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-arm64-7.6.0.4-preview.zip.sha256sum.txt
95-
[18]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-arm64-7.6.0.4-preview.zip.sig
78+
[1]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-amd64.tar.gz
79+
[2]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-amd64.tar.gz.sha256sum.txt
80+
[3]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-amd64.tar.gz.sig
81+
[4]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-arm64.tar.gz
82+
[5]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-arm64.tar.gz.sha256sum.txt
83+
[6]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-linux-arm64.tar.gz.sig
84+
[7]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-amd64.tar.gz
85+
[8]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-amd64.tar.gz.sha256sum.txt
86+
[9]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-amd64.tar.gz.sig
87+
[10]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-arm64.tar.gz
88+
[11]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-arm64.tar.gz.sha256sum.txt
89+
[12]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-macos-arm64.tar.gz.sig
90+
[13]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-amd64.zip
91+
[14]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-amd64.zip.sha256sum.txt
92+
[15]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-amd64.zip.sig
93+
[16]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-arm64.zip
94+
[17]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-arm64.zip.sha256sum.txt
95+
[18]: https://aka.ms/appcat/azure-migrate-appcat-for-java-cli-windows-arm64.zip.sig
9696

9797
### Prerequisites
9898

@@ -122,40 +122,10 @@ Extract the binary from the downloaded file. You should see the following folder
122122

123123
### Running the tool
124124

125-
#### Option 1: Add the appcat binary path to your $PATH
126-
127-
Move the contents of the folder to the **.appcat** folder in the user's home directory - **$HOME/.appcat** on Linux/Mac and **%USERPROFILE%/.appcat** on Windows.
128-
129-
Add the **.appcat** folder to your `PATH` environment variable so you can run the tool from any folder in the terminal.
130-
131-
# [Linux / macOS](#tab/linux)
132-
133-
```bash
134-
mv <path-to-extracted>/azure-migrate-appcat-for-java-cli-<OS>-<architecture>-<release-version>-preview/ $HOME/.appcat
135-
```
136-
137-
# [Windows](#tab/windows)
138-
139-
```cmd
140-
move <path-to-extracted>\azure-migrate-appcat-for-java-cli-<OS>-<architecture>-<release-version>-preview\ %USERPROFILE%\.appcat
141-
```
142-
143-
---
125+
To run the `appcat` from any location in your terminal, extract the archive to your desired location, for example, `~/.appcat` on Linux/Mac or `%USERPROFILE%\.appcat` on Windows, then update the `PATH` environment variable to include the directory where you extracted the archive.
144126

145127
> [!NOTE]
146-
> When the `appcat` binary is called from a different folder than where it's installed, it looks for its dependencies in the **.appcat** folder in the user's home directory.
147-
148-
#### Option 2: Run appcat from the downloaded folder
149-
150-
Change the directory to the extracted folder:
151-
152-
```bash
153-
cd /azure-migrate-appcat-for-java-cli-<OS>-<architecture>-<release-version>-preview/
154-
./appcat --help
155-
```
156-
157-
> [!NOTE]
158-
> The `appcat` binary first looks for its dependencies in the current directory. If the dependencies aren't found, it falls back to the configuration described in the [Option 1](#option-1-add-the-appcat-binary-path-to-your-path) section.
128+
> When the `appcat` binary is called, it first looks for its dependencies in the executable folder specified in the `PATH` environment variable. If the dependencies aren't found, it falls back to the user's home directory - `~/.appcat` on Linux/Mac or `%USERPROFILE%\.appcat` on Windows.
159129
160130
## Usage
161131

@@ -249,24 +219,46 @@ openjdk21
249219

250220
#### Analyzing Multiple Applications
251221

252-
AppCAT is designed to analyze a single application per command execution, but if you use the `--bulk` option, you can analyze multiple applications in a single execution. This option generates a single static report in the output directory that includes the results for all applications.
222+
AppCAT supports multiple applications analysis in per command execution.
223+
You can provide a comma-separated list of input paths for the `--input` flag to analyze multiple applications in a single command.
224+
The output directory and static report will include the combined analysis results for all applications.
253225

254226
To analyze multiple applications, run the following command:
255227

256228
# [Linux / macOS](#tab/linux)
257229

258230
```bash
259-
./appcat analyze --bulk --input=<path-to-source-A> --output=<path-to-output-ABC> --target=<targetname>
260-
./appcat analyze --bulk --input=<path-to-source-B> --output=<path-to-output-ABC> --target=<targetname>
261-
./appcat analyze --bulk --input=<path-to-source-C> --output=<path-to-output-ABC> --target=<targetname>
231+
./appcat analyze --input=<path/to/source/A>,<path/to/source/B>,<path/to/source/C> --output=<path/to/output/ABC> --target=<targetname>
232+
```
233+
234+
# [Windows](#tab/windows)
235+
236+
```cmd
237+
.\appcat.exe analyze --input=<path/to/source/A>,<path/to/source/B>,<path/to/source/C> --output=<path/to/output/ABC> --target=<targetname>
238+
```
239+
240+
AppCAT also allows you to use `--bulk` option to incrementally add more application analysis to an existing output directory and static report.
241+
When using the `--bulk` option, you must use it consistently across all command executions that write to the same output.
242+
243+
> [!NOTE]
244+
> When multiple input paths are provided, `--bulk` is enabled by default.
245+
246+
To incrementally add more application analysis to an existing static report run the following command:
247+
248+
# [Linux / macOS](#tab/linux)
249+
250+
```bash
251+
./appcat analyze --input=<path/to/source/A>,<path/to/source/B>,<path/to/source/C> --output=<path/to/output/ABC> --target=<targetname>
252+
./appcat analyze --bulk --input=<path/to/source/D> --output=<path/to/output/ABC> --target=<targetname>
253+
./appcat analyze --bulk --input=<path/to/source/E> --output=<path/to/output/ABC> --target=<targetname>
262254
```
263255

264256
# [Windows](#tab/windows)
265257

266258
```cmd
267-
.\appcat.exe analyze --bulk --input=<path-to-source-A> --output=<path-to-output-ABC> --target=<targetname>
268-
.\appcat.exe analyze --bulk --input=<path-to-source-B> --output=<path-to-output-ABC> --target=<targetname>
269-
.\appcat.exe analyze --bulk --input=<path-to-source-C> --output=<path-to-output-ABC> --target=<targetname>
259+
.\appcat.exe analyze --input=<path/to/source/A>,<path/to/source/B>,<path/to/source/C> --output=<path/to/output/ABC> --target=<targetname>
260+
.\appcat.exe analyze --bulk --input=<path/to/source/D> --output=<path/to/output/ABC>
261+
.\appcat.exe analyze --bulk --input=<path/to/source/E> --output=<path/to/output/ABC>
270262
```
271263

272264
---
@@ -358,6 +350,12 @@ Then, for each file or class affected by the incident, you can jump into the sou
358350

359351
## Release notes
360352

353+
### 7.6.0.5
354+
355+
This release contains the following fixes and enhancements.
356+
357+
358+
361359
### 7.6.0.4
362360

363361
This release contains the following fixes and enhancements.
@@ -454,6 +452,13 @@ GA (Generally Available) release of Azure Migrate application and code assessmen
454452

455453
## Known Issues
456454

455+
### 7.6.0.5
456+
457+
- Rules issues:
458+
- The `azure-system-config-01000` rules aren't being triggered.
459+
- The `azure-password-01000` rule detects only one violation, even when multiple violations exist in the same file.
460+
- An error in the Watcher Error channel on Windows: `Windows system assumed buffer larger than it is, events have likely been missed`. This error message appears on the command line during long-running jobs on Windows.
461+
457462
### 7.6.0.4
458463

459464
- Rules issues:

0 commit comments

Comments
 (0)