Configuring and running an application analysis

You can analyze more than one application at a time against more than one transformation target in the same analysis.

Procedure

1. In the Migration view, click Application inventory.

2. Select an application that you want to analyze.

3. Review the credentials assigned to the application.

4. Click Analyze.

5. Select the Analysis mode from the list:

   • Binary

   • Source code

   • Source code and dependencies

   • Upload a local binary. This option only appears if you are analyzing a single application. If you chose this option, you are prompted to Upload a local binary. Either drag a file into the area provided or click Upload and select the file to upload.

6. Click Next.

7. Select one or more target options for the analysis:

   • Application server migration to either of the following platforms:

     • JBoss EAP 7

     • JBoss EAP 8

   • Containerization

   • Quarkus

   • OracleJDK to OpenJDK

   • OpenJDK. Use this option to upgrade to either of the following JDK versions:

     • OpenJDK 11

     • OpenJDK 17

     • OpenJDK 21

   • Linux. Use this option to ensure that there are no Microsoft Windows paths hard-coded into your applications.

   • Jakarta EE 9. Use this option to migrate from Java EE 8.

   • Spring Boot on Red Hat Runtimes

   • Open Liberty

   • Camel. Use this option to migrate from Apache Camel 2 to Apache Camel 3 or from Apache Camel 3 to Apache Camel 4.

   • Azure App Service

8. Click Next.

9. Select one of the following Scope options to better focus the analysis:

   • Application and internal dependencies only.

   • Application and all dependencies, including known Open Source libraries.

   • Select the list of packages to be analyzed manually. If you choose this option, type the file name and click Add.

   • Exclude packages. If you choose this option, type the name of the package and click Add.

10. Click Next.

11. In Advanced, you can attach additional custom rules to the analysis by selecting the Manual or Repository mode:

    • In the Manual mode, click Add Rules. Drag the relevant files or select the files from their directory and click Add.

    • In the Repository mode, you can add rule files from a Git or Subversion repository.

      Important

      Attaching custom rules is optional if you have already attached a migration target to the analysis. If you have not attached any migration target, you must attach rules.

12. Optional: Set any of the following options:

    • Target

    • Source(s)

    • Excluded rules tags. Rules with these tags are not processed. Add or delete as needed.

    • Enable automated tagging. Select the checkbox to automatically attach tags to the application. This checkbox is selected by default.

      Note	Automatically attached tags are displayed only after you run the analysis. You can attach tags to the application manually instead of enabling automated tagging or in addition to it.

      Note	Analysis engines use standard rules for a comprehensive set of migration targets, but if the target is not included or is a customized framework, custom rules can be added. Only manually uploaded custom rule files are validated.

13. Click Next.

14. In Review, verify the analysis parameters.

15. Click Run.

    The analysis status is Scheduled as {ProductShortName} downloads the image for the container to execute. When the image is downloaded, the status changes to In-progress.

    Note	Analysis takes minutes to hours to run depending on the size of the application and the capacity and resources of the cluster.

    Tip

    {ProductShortName} relies on Kubernetes scheduling capabilities to determine how many analyzer instances are created based on cluster capacity. If several applications are selected for analysis, by default, only one analyzer can be provisioned at a time. With more cluster capacity, more analysis processes can be executed in parallel.

16. When analysis is complete, click the Report link to see the results of the analysis.

17. Optional: Display the details of the analysis:

    1. Click the Options menu ({kebab}).

    2. Select Analysis details. You can choose either the YAML or JSON format.