Este conteúdo não está disponível no idioma selecionado.

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.
Note

Use jboss-eap-installation-manager from Update 02 or later. Download the correct version from the JBoss EAP 8.0 patches page on the Red Hat Customer Portal, or update an existing installation by running the following command:

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

Verify the version of your installation manager by running the following command:

./bin/jboss-eap-installation-manager.sh --version
Copy to Clipboard Toggle word wrap

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-5.0 --dir eap-xp-5
    Copy to Clipboard Toggle word wrap

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:

    ./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
    Copy to Clipboard Toggle word wrap
  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 \
     --dir eap-xp-5.0
    Copy to Clipboard Toggle word wrap

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:
./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
Copy to Clipboard Toggle word wrap
  1. 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 \
 --dir eap-xp-5.0 \
 --repositories <JBOSS_EAP_XP_OFFLINE_REPO_PATH>,<JBOSS_EAP_8.0_OFFLINE_REPO_PATH>
Copy to Clipboard Toggle word wrap
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:

    ./bin/jboss-eap-installation-manager.sh update list --dir eap-xp-5.0
    Copy to Clipboard Toggle word wrap
  4. Update JBoss EAP by running the following command:

    Syntax

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

    Example

    ./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
    Copy to Clipboard Toggle word wrap

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:

    ./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>
    Copy to Clipboard Toggle word wrap

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:

    ./bin/jboss-eap-installation-manager.sh history --dir eap-xp-5.0
    Copy to Clipboard Toggle word wrap
  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-5.0
    Copy to Clipboard Toggle word wrap

Additional resources

Voltar ao topo
Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2025 Red Hat