Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 1. JBoss EAP XP for the latest MicroProfile capabilities

1.1. Installing JBoss EAP XP 5.0 without a pre-existing JBoss EAP 8.0 server

If you want to install JBoss EAP XP 5.0 without first pre-installing JBoss EAP 8.0 server, follow the procedure below.

Prerequisites

  • You have access to the internet.
  • You have created an account on the Red Hat customer portal and are logged in.
  • You have downloaded the jboss-eap-installation-manager.

Procedure

  1. Open the terminal emulator and navigate to the jboss-eap-installation-manager directory.

  2. Install JBoss EAP XP by running the following command from the jboss-eap-installation-manager directory :

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh install --profile eap-xp-5.0 --dir eap-xp-5

1.2. Adding JBoss EAP XP 5.0 feature packs to an existing JBoss EAP 8.0 installation

You can add an additional JBoss EAP XP 5.0 feature pack to an existing JBoss EAP installation using the jboss-eap-installation-manager.

Prerequisites

  • You have an account on the Red Hat Customer Portal and are logged in.
  • You have reviewed the supported configurations for JBoss EAP XP 5.0.
  • You have installed a supported JDK.
  • You have downloaded the jboss-eap-installation-manager. For more information about downloading jboss-eap-installation-manager, see the Installation Guide.
  • You have downloaded or installed JBoss EAP 8.0 using one of the supported methods. For more information about downloading JBoss EAP, see the Installation Guide.
Note

Installing the JBoss EAP XP extension will automatically perform a server update to receive the latest component updates.

Procedure

  1. Open the terminal emulator and navigate to the jboss-eap-installation-manager directory.

  2. Run this script from the jboss-eap-installation-manager directory to subscribe the server to the JBoss EAP XP channel by executing:

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh channel add \
 --channel-name eap-xp-5.0 \
 --repositories=mrrc-ga::https://maven.repository.redhat.com/ga \
 --manifest org.jboss.eap.channels:eap-xp-5.0 \
 --dir eap-xp-5.0

  3. Install JBoss EAP XP extension by executing:

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh feature-pack add \
 --fpl org.jboss.eap.xp:wildfly-galleon-pack \
 --dir eap-xp-5.0

1.3. Adding JBoss EAP XP 5.0 feature packs to an existing JBoss EAP 8.0 installation offline

You can add additional JBoss EAP XP 5.0 feature pack to an existing JBoss EAP installation offline using the jboss-eap-installation-manager.

Prerequisites

  • You have reviewed the supported configurations for JBoss EAP XP 5.0.
  • You have installed a supported JDK.
  • You have downloaded the jboss-eap-installation-manager. For more information about downloading jboss-eap-installation-manager, see the Installation Guide.
  • You have downloaded or installed JBoss EAP 8.0 using one of the supported methods. For more information about downloading JBoss EAP, see the Installation Guide.
  • You have downloaded and extracted the latest offline repositories for JBoss EAP 8.0 and JBoss EAP XP 5.0.

Procedure

  1. Open the terminal emulator and navigate to the jboss-eap-installation-manager directory.
  2. Run this script from the jboss-eap-installation-manager directory to subscribe the server to the JBoss EAP XP channel by executing:
Copy to Clipboard Toggle word wrap 
./bin/jboss-eap-installation-manager.sh channel add \
 --channel-name eap-xp-5.0 \
 --repositories=mrrc-ga::https://maven.repository.redhat.com/ga \
 --manifest org.jboss.eap.channels:eap-xp-5.0 \
 --dir eap-xp-5.0
  1. Install JBoss EAP XP and use the --repositories parameter to specify the offline repositories:
Copy to Clipboard Toggle word wrap 
./bin/jboss-eap-installation-manager.sh feature-pack add \
 --fpl org.jboss.eap.xp:wildfly-galleon-pack \
 --dir eap-xp-5.0 \
 --repositories <JBOSS_EAP_XP_OFFLINE_REPO_PATH>,<JBOSS_EAP_8.0_OFFLINE_REPO_PATH>
Note

The feature pack will be added to the JBoss EAP installation passed in the --dir option.

1.4. Updating JBoss EAP XP installation using the jboss-eap-installation-manager

You can update JBoss EAP XP periodically if new updates are available after you have downloaded and installed it.

Prerequisites

  • You have access to the internet.
  • You have installed a supported JDK.
  • You have downloaded the jboss-eap-installation-manager. For more information about downloading jboss-eap-installation-manager, see the Installation Guide.
  • You have downloaded or installed JBoss EAP 8.0 using one of the supported methods. For more information about downloading JBoss EAP, see the Installation Guide.

Procedure

  1. Extract the jboss-eap-installation-manager you have downloaded.
  2. Open the terminal emulator and navigate to the jboss-eap-installation-manager directory you have extracted.

  3. Run this script from the jboss-eap-installation-manager directory to check for available updates:

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh update list --dir eap-xp-5.0

  4. Update JBoss EAP by running the following command:

    Syntax

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh update perform --dir eap-xp-5.0

    Example

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh update perform --dir eap-xp-5.0
Updates found:
  org.wildfly.galleon-plugins:wildfly-galleon-plugins    6.3.1.Final-redhat-00001 ==>  6.3.2.Final-redhat-00001
  org.wildfly.wildfly-http-client:wildfly-http-transaction-client    2.0.1.Final-redhat-00001 ==>  2.0.2.Final-redhat-00001

1.5. Updating JBoss EAP XP installation offline using the jboss-eap-installation-manager

You can use the jboss-eap-installation-manager to update the JBoss EAP XP 5.0 installation offline.

Prerequisites

  • You have installed a supported JDK.
  • You have downloaded the jboss-eap-installation-manager. For more information about downloading jboss-eap-installation-manager, see the Installation Guide.
  • You have downloaded or installed JBoss EAP 8.0 using one of the supported methods. For more information about downloading JBoss EAP, see the Installation Guide.
  • You have downloaded and extracted the latest offline repositories for JBoss EAP 8.0 and JBoss EAP XP 5.0.

Procedure

  1. Stop the JBoss EAP server.
  2. Open the terminal emulator and navigate to the jboss-eap-installation-manager directory.

  3. Run this script from the jboss-eap-installation-manager directory to update the server components:

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh update perform \
 --dir eap-xp-5.0  \
 --repositories <JBOSS_EAP_XP_OFFLINE_REPO_PATH>,<FEATURE_PACK_OFFLINE_REPO>,<JBOSS_EAP_8.0_OFFLINE_REPO_PATH>

Additional resources

1.6. Reverting your JBoss EAP XP server to JBoss EAP

You can use the jboss-eap-installation-manager to revert your JBoss EAP XP installation.

Prerequisites

  • You have access to the internet.
  • You have installed a supported JDK.
  • You have downloaded the jboss-eap-installation-manager. For more information about downloading jboss-eap-installation-manager, see the Installation Guide.
  • You have downloaded or installed JBoss EAP 8.0 using one of the supported methods. For more information about downloading JBoss EAP, see the Installation Guide.

Procedure

  1. Open the terminal emulator and navigate to the jboss-eap-installation-manager directory.

  2. Run this script from the jboss-eap-installation-manager directory to investigate the history of all feature packs added to your JBoss EAP XP server:

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh history --dir eap-xp-5.0
  3. Stop the JBoss EAP XP server.

  4. Revert your to a version before JBoss EAP XP extension has been added:

    Copy to Clipboard Toggle word wrap 
    ./bin/jboss-eap-installation-manager.sh revert perform \
 --revision <REVISION_HASH> \
 --dir eap-xp-5.0

Additional resources

Back to top
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

© 2025 Red Hat, Inc.