Visit Azul.com Support

Azul Payara AI Upgrade Assistant

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us

The Azul Payara AI Upgrade Assistant upgrades the Jakarta EE API level of your application. It combines a static analysis of your source code with an AI agent that applies the required changes and checks the result by compiling your project.

The tool is a standalone tool, separate from Azul Payara Server. It runs against your application’s source tree, on a developer machine or in a CI pipeline, and does not require an Azul Payara Server installation.

What the Tool Does

Moving an application to a newer Jakarta EE version means dealing with methods that were removed, changed signatures, deprecated annotation properties, and configuration that has moved. The Azul Payara AI Upgrade Assistant automates the three steps of that work:

  1. Find every affected file and line, with a precise inventory of the required changes.

  2. Fix each issue with an AI agent that receives the exact location and the recommended change.

  3. Verify that the project still compiles, and repeat until no issues remain or the round limit is reached.

You choose how far the tool goes:

Stage Description

Detection only

Reports which technologies your project uses. Changes nothing.

Advisors and recipes

Reports every Jakarta EE migration issue and applies the fixes that need no AI. Use migration.apply=false for a read-only report.

AI agent

Runs the above, sends the remaining findings to the AI agent, applies the fixes, compiles the project, and repeats.

You can run the tool as a Maven plugin, as a plain jar, from a web page, or from Claude Code.

See How It Works for details.

Supported Migrations

The tool supports the following migration paths:

From To How

Jakarta EE 8

Jakarta EE 10

Recipes and AI agent

Jakarta EE 8

Jakarta EE 11

Recipes and AI agent

Jakarta EE 9

Jakarta EE 10

AI agent

Jakarta EE 9

Jakarta EE 11

AI agent

Jakarta EE 10

Jakarta EE 11

AI agent

The javax. to jakarta. rename is handled by recipes, so applications on Jakarta EE 8 can be upgraded directly.

Jakarta EE 9 is supported as a starting point only, not as a target. Only Jakarta EE 10 and 11 are official targets (migration.target), because Payara 6 is certified for Jakarta EE 10 and Payara 7 for Jakarta EE 11. Only Payara Server 6.2021.1.Alpha1 was certified for Jakarta EE 9, so there is no production-ready Payara build for it.

The tool works with Maven, Gradle and Ant projects, because it can be run as a plain jar. Dependency changes are written for Maven pom.xml files only. For other build tools they are partly manual.

What the Tool Is Not

  • It does not translate vendor-proprietary APIs. The tool changes the Jakarta EE level of your application, not the vendor underneath it.

  • It is not a Payara Server version upgrade tool. If your application targets a Jakarta EE level that your current server does not support, upgrade the server as well. See Recommended Migration Sequence and the Payara Server Upgrade Tool.

  • It is not the analysis-only Upgrade Advisor Tool that is bundled with the server. The two tools have similar purposes, but the Azul Payara AI Upgrade Assistant is a separate artifact and runs outside the server.

Licensing and Costs

The Azul Payara AI Upgrade Assistant is available for you to use with your Azul Payara Enterprise subscription as an entitlement. There is a separate license, but no per-application fee, and no usage metric.

Important
 The tool uses a Large Language Model (LLM) that you provide. Inference costs, such as API token usage with your provider, are your responsibility and are not included in the subscription.

Next Steps