Search
SupportConsoleDevelopersStart a trialContact

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

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.

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.

© 2024 Red Hat, Inc.