Rechercher

Ce contenu n'est pas disponible dans la langue sélectionnée.

Chapter 7. Reverting your JBoss EAP server updates using the Management CLI

download PDF

You can revert updates applied to your JBoss EAP server using the Management CLI. To revert the changes applied to your JBoss EAP server, use the installer history command to view the previous versions of JBoss EAP installations on your server. Once you have confirmed the correct version of JBoss EAP you want to revert to, prepare a candidate server using the installer revert command. After preparing the candidate server, restart your JBoss EAP server to complete the revert process.

For more information see how to view the history of JBoss EAP installations on your server.

7.1. Reverting your JBoss EAP server updates in a stand-alone server or a managed domain

You can revert your JBoss EAP server installation in a stand-alone server or a managed domain using the JBoss EAP Management CLI. The following steps outline the phases of the revert process.

  • Prepare revert: In this phase, the JBoss EAP installation is prepared for the revert on the target machine. The candidate server is prepared in the server temporal directory, which is the directory represented by the file system path jboss.domain.temp.dir in a managed domain or jboss.server.temp.dir in stand-alone server mode. Once this phase is completed, no further server preparations can be performed on the same candidate server. However, you can clean the installation manager cache, which allows you to prepare a different installation if needed. For more information, see Cleaning the installer.
  • Apply revert: Once you have completed the revert process, restart your JBoss EAP server to apply the candidate server prepared to revert your installation.

Procedure

  1. Launch the Management CLI:

    EAP_HOME/bin/jboss-cli.sh
  2. Revert your JBoss EAP server:

    Note

    Use the installer history command to view the installation state you want to revert your installation to.

    1. Revert your JBoss EAP server updates in a stand-alone server:

      [standalone@localhost:9990 /] installer revert --revision=abcd1234
    2. Revert your JBoss EAP server updates in a managed domain:

      [domain@localhost:9990 /] installer revert --host=target-host --revision=abcd1234
      Note

      For more information about additional command options use the help command.

  3. Restart your JBoss EAP server to complete the revert process:

    Note

    You must ensure that no other processes are launched from the JBOSS_EAP/bin folder, such as JBOSS_EAP/bin/jconsole.sh and JBOSS_EAP/bin/appclient.sh, when restarting the server with the --perform-installation option. This precaution prevents conflicts in writing files that might be in use by other processes during the server’s revert.

    1. Restart your JBoss EAP server in a stand-alone server:

      [standalone@localhost:9990 /] shutdown --perform-installation
    2. Restart your JBoss EAP server in a managed domain:

      [domain@localhost:9990 /] shutdown --host=target-host --perform-installation

Additional resources

7.2. Reverting your JBoss EAP server installation offline using the Management CLI

The following example describes how to use the Management CLI to revert your JBoss EAP installation offline in a stand-alone server and a managed domain. This is useful in scenarios where the target server installation lacks access to external Maven repositories. You can use the Management CLI to revert your JBoss EAP server installation. To do so, you need to specify the location of the Maven repository that contains the required artifacts to revert your server. You can download the Maven repository for your update from the Red Hat Customer Portal.

Prerequisite

  • You have the Maven archive repository containing the required artifacts locally on your machine.

Procedure

  1. Launch the Management CLI:

    EAP_HOME/bin/jboss-cli.sh
  2. Revert JBoss EAP installation offline:

    1. Revert JBoss EAP installation offline in a stand-alone server:

      [standalone@localhost:9990 /] installer revert --revision=abcd1234 --maven-repo-files=<An absolute or a relative path pointing to the local archive file that contains a maven repository>
    2. Revert JBoss EAP offline in a managed domain:

      [domain@localhost:9990 /] installer revert --host=target-host --revision=abcd1234 --maven-repo-files=<An absolute or a relative path pointing to the local archive file that contains a maven repository>
      Note

      For more information about additional command options use the help command.

  3. Restart your JBoss EAP server to complete the revert process:

    Note

    You must ensure that no other processes are launched from the JBOSS_EAP/bin folder, such as JBOSS_EAP/bin/jconsole.sh and JBOSS_EAP/bin/appclient.sh, when restarting the server with the --perform-installation option. This precaution prevents conflicts in writing files that might be in use by other processes during the server’s revert.

    1. Restart your JBoss EAP server in a stand-alone server:

      [standalone@localhost:9990 /] shutdown --perform-installation
    2. Restart your JBoss EAP server in a managed domain:

      [domain@localhost:9990 /] shutdown --host=target-host --perform-installation
Red Hat logoGithubRedditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez leBlog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

© 2024 Red Hat, Inc.