Chapter 1. JBoss EAP XP upgrades

1.1. Upgrades and migrations

Use the steps outlined in the JBoss EAP XP upgrade and migration guide to prepare, upgrade, and migrate your JBoss EAP XP 2.0.x product to the JBoss EAP XP 3.0.0 product. JBoss EAP XP 3.0.0 is compatible with only JBoss EAP 7.4. If you operate servers on JBoss EAP 7.3 and you want to apply the JBoss EAP XP 3.0.0 patch on it, you must first upgrade your JBoss EAP 7.3 instance to JBoss EAP 7.4.

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 2.0.x release to JBoss EAP XP 3.0.0, you can begin to implement any applications migrations for your JBoss EAP 7.4 instance.

Additional resources

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 3.0.0, some backward compatibility might exist for JBoss EAP XP 2.0.x applications. However, if your application uses features that were deprecated or functionality that was removed from JBoss EAP XP 2.0.x, you might need to make changes to your application code.

Please review the following new items before you begin the migration process:

  • JBoss EAP XP features added in the JBoss EAP XP 3.0.0 release.
  • MicroProfile capabilities added in the JBoss EAP XP 3.0.0.
  • Enhancements to existing MicroProfile capabilities.
  • Capabilities and features that are deprecated in the JBoss EAP XP 3.0.0.
  • Capabilities and features that have been removed from JBoss EAP XP 3.0.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 3.0.0.

You can now upgrade your current JBoss EAP XP 2.0.x release to JBoss EAP XP 3.0.0. You can implement any applications migrations after the upgrade process

Additional resources

1.3. New JBoss EAP XP capabilities

The JBoss EAP XP 3.0.0 includes new features that enhance the use of Red Hat implementation of the MicroProfile specification for JBoss EAP applications.

Note

The MicroProfile Reactive Messaging subsystem supports Red Hat AMQ Streams. This feature implements the MicroProfile Reactive Messaging 1.0 API and Red Hat provides the feature as a technology preview for JBoss EAP XP 3.0.0.

Red Hat tested Red Hat AMQ Streams 2021.Q2 on JBoss EAP. However, check the Red Hat JBoss Enterprise Application Platform supported configurations page for information about the latest Red Hat AMQ Streams version that has been tested on JBoss EAP XP 3.0.0.

JBoss EAP XP 3.0.0 includes the following new features in its release:

  • Run CLI scripts after you have started your application.
  • Use the --cli-script=<path to CLI script> argument to update the server configuration of a bootable JAR file at runtime.
  • Use the MicroProfile Reactive Messaging 1.0 API to send and receive messages between microservices.
  • Use the MicroProfile Reactive Messaging 1.0 API to write and configure a user application, so the application can send, receive, and process event streams efficiently and asynchronously.
  • Enable MicroProfile Reactive Messaging functionality in your server configuration, as MicroProfile Reactive Messaging only comes pre-installed on your server.

  • View the MicroProfile Reactive Messaging with MicroProfile Reactive Messaging with Kafka quickstart to learn how you can complete the following tasks on your server:

    • Enable the MicroProfile Reactive Messaging subsystem.
    • Run and test applications by using MicroProfile Reactive Messaging to send data and receive data from Red Hat AMQ Streams.

Additional resources

  • For information about Red Hat AMQ Streams, see Overview of AMQ Streams in the Using AMQ Streams on OpenShift guide.
  • For information about Technology Preview features. see Technology Preview Features Support Scope on the Red Hat Customer Portal.
  • For information on the Red Hat AMQ Streams versions, see Red Hat AMQ on the Product Documentation page.
  • For more information about the MicroProfile Reactive Messaging with Kafka quickstart, see jboss-eap-quickstarts and select the listed MicroProfile Reactive Messaging with Kafka quickstart.

1.4. Enhancements to MicroProfile capabilities

The JBoss EAP XP 3.0.0 release includes support for the following MicroProfile 4.0 components:

  • MicroProfile Config
  • MicroProfile Fault Tolerance
  • MicroProfile Health
  • MicroProfile JWT
  • MicroProfile Metrics
  • MicroProfile OpenAPI
  • MicroProfile OpenTracing
  • MicroProfile REST Client

Additional resources

  • For more information about MicroProfile 4.0 and its specifications, see MicroProfile 4.0 on GitHub.
  • For more information about MicroProfile 4.0 specification components, see About JBoss EAP XP in the Using JBoss EAP XP 3.0.0 guide.

1.5. Deprecated and unsupported MicroProfile capabilities

Before you migrate your application to JBoss EAP XP 3.0.0 be aware that some features that were available in JBoss EAP XP 2.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 3.0.0 Release Notes guide and the 7.4.0 Release Notes guide for any unsupported and deprecated features.

Additional resources

  • For more information about any unsupported and deprecated features for JBoss EAP XP 3.0.0, see the Using JBoss EAP XP 3.0.0 guide.
  • For more information about any unsupported and deprecated features for JBoss EAP 7.4, see the 7.4.0 Release Notes guide.