Chapter 1. JBoss EAP XP for the latest MicroProfile capabilities


If you want to install JBoss EAP XP 6.0 without first pre-installing JBoss EAP 8.1 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 :

    $ ./bin/jboss-eap-installation-manager.sh install --profile eap-xp-6.0 --dir eap-xp-6

You can add an additional JBoss EAP XP 6.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 6.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.1 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:

    $ ./bin/jboss-eap-installation-manager.sh channel add \
     --channel-name eap-xp-6.0 \
     --repositories=mrrc-ga::https://maven.repository.redhat.com/ga \
     --manifest org.jboss.eap.channels:eap-xp-6.0 \
     --dir eap-xp-6.0
  3. Install JBoss EAP XP extension by executing:

    $ ./bin/jboss-eap-installation-manager.sh feature-pack add \
     --fpl org.jboss.eap.xp:wildfly-galleon-pack \
     --layers layer-one,layer-two \
     --dir eap-xp-6.0

You can add additional JBoss EAP XP 6.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 6.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.1 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.1 and JBoss EAP XP 6.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:

    $ ./bin/jboss-eap-installation-manager.sh channel add \
     --channel-name eap-xp-6.0 \
     --repositories=mrrc-ga::https://maven.repository.redhat.com/ga \
     --manifest org.jboss.eap.channels:eap-xp-6.0 \
     --dir eap-xp-6.0
  3. Install JBoss EAP XP and use the --repositories parameter to specify the offline repositories:

    $ ./bin/jboss-eap-installation-manager.sh feature-pack add \
     --fpl org.jboss.eap.xp:wildfly-galleon-pack \
     --layers layer-one,layer-two \
     --dir eap-xp-6.0 \
     --repositories <JBOSS_EAP_XP_OFFLINE_REPO_PATH>,<JBOSS_EAP_8.1_OFFLINE_REPO_PATH>
    Note

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

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.1 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:

    $ ./bin/jboss-eap-installation-manager.sh update list --dir eap-xp-6.0
  4. Update JBoss EAP by running the following command:

    Syntax

    $ ./bin/jboss-eap-installation-manager.sh update perform --dir eap-xp-6.0

    Example

    $ ./bin/jboss-eap-installation-manager.sh update perform --dir eap-xp-6.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

You can use the jboss-eap-installation-manager to update the JBoss EAP XP 6.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.1 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.1 and JBoss EAP XP 6.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:

    $ ./bin/jboss-eap-installation-manager.sh update perform \
     --dir eap-xp-6.0  \
     --repositories <JBOSS_EAP_XP_OFFLINE_REPO_PATH>,<FEATURE_PACK_OFFLINE_REPO>,<JBOSS_EAP_8.1_OFFLINE_REPO_PATH>

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.1 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:

    $ ./bin/jboss-eap-installation-manager.sh history --dir eap-xp-6.0
  3. Stop the JBoss EAP XP server.
  4. Revert your to a version before JBoss EAP XP extension has been added:

    $ ./bin/jboss-eap-installation-manager.sh revert perform \
     --revision <REVISION_HASH> \
     --dir eap-xp-6.0

Additional resources

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

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.

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 Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top