Chapter 1. JBoss EAP XP upgrades


1.1. Upgrades and migrations

Use the steps outlined in the JBoss EAP XP 5.0 upgrade and migration guide to prepare, upgrade, and migrate your JBoss EAP XP 3.0 or 4.0 product to the JBoss EAP XP 5.0 product. JBoss EAP XP 5.0 is compatible with only JBoss EAP 8.0. If you operate servers on JBoss EAP 7.4 and you want to install the JBoss EAP XP 5.0 on it, you must first upgrade your JBoss EAP 7.4 instance to JBoss EAP 8.0.

The guide references tools that you can use for the upgrading and migration process. These tools are as follows:

  • Migration Toolkit for Applications (MTA)
  • JBoss Server Migration Tool

After you successfully upgrade and migrate JBoss EAP XP 3.0 or 4.0 release to JBoss EAP XP 5.0, you can begin to implement any application migrations for your JBoss EAP 8.0 instance.

1.2. Preparation for upgrade and migration

After you upgrade the JBoss EAP Expansion Pack, you might have to update application code.

For JBoss EAP XP 5.0, some backward compatibility might exist for JBoss EAP XP 3.0 or 4.0 applications. However, if your application uses features that were deprecated or functionality that was removed from JBoss EAP XP 5.0, you might need to make changes to your application code.

Review the following new items before you begin the migration process:

  • JBoss EAP XP features added in the JBoss EAP XP 5.0 release.
  • MicroProfile capabilities added in the JBoss EAP XP 5.0 release.
  • Enhancements to existing MicroProfile capabilities.
  • Capabilities and features that are deprecated in the JBoss EAP XP 5.0.
  • Capabilities and features that have been removed from JBoss EAP XP 5.0.
  • Tools that you can use to migrate from one EAP XP release to another release.

After you have reviewed the listed items, analyze your environment and plan for the upgrade process and migration process. Ensure you back up any applications that you plan to migrate to JBoss EAP XP 5.0.

You can now upgrade your current JBoss EAP XP 3.0 or 4.0 release to JBoss EAP XP 5.0. You can implement any application migrations after the upgrade process.

1.3. Enhancements to MicroProfile capabilities

The JBoss EAP XP 5.0 release includes support for the following MicroProfile 6.1 components:

  • MicroProfile Config
  • MicroProfile Fault Tolerance
  • MicroProfile Health
  • MicroProfile JWT
  • MicroProfile OpenAPI
  • MicroProfile Telemetry
  • MicroProfile REST Client

Before you migrate your application to JBoss EAP XP 5.0 be aware that some features that were available in JBoss EAP XP 4.0.x might be deprecated or no longer supported.

Red Hat removed support for some technologies due to the high maintenance cost, low community interest, and much better alternative solutions.

Ensure that you review the Red Hat JBoss EAP XP 5.0 release notes and the Release notes for Red Hat JBoss Enterprise Application Platform 8.0 for any unsupported and deprecated features.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top