Chapter 3. Updating JBoss EAP using the jboss-eap-installation-manager

Procedure

1. Navigate to the directory containing the downloaded jboss-eap-installation-manager by using your terminal emulator.

2. Check for available updates:

   ./jboss-eap-installation-manager.sh update list --dir eap-8

3. Update JBoss EAP by running the following command

   Syntax

   ./jboss-eap-installation-manager.sh update perform --dir eap-8

   Example

   ./jboss-eap-installation-manager.sh update perform --dir eap-8
   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

   Follow the rest of the prompts to update JBoss EAP.

   Continue with update [y/N]: y
   Building updates
   
   Feature-packs resolved.
   Packages installed.
   Downloaded artifacts.
   JBoss modules installed.
   Configurations generated.
   JBoss examples installed.
   
   Build update complete!
   Applying updates
   Update complete!
   Operation completed in 60.49 seconds.

Procedure

1. Download the offline repository from Red Hat customer portal.
2. Extract the downloaded archive file.

3. Stop the server.

   Note

   Before continuing, ensure you have correctly set the path to point to the extracted Maven-repository sub-folder.

4. Perform the update.

   $ ./jboss-eap-installation-manager.sh update perform \
     --dir jboss-eap-8.0 \
     --repositories mrrc::file:<PATH_TO_EXTRACTED_REPOSITORY>/jboss-eap-8.0.1.GA-maven-repository/maven-repository \
     --offline

   Follow the remaining prompts to complete the update process for JBoss EAP.

   Updates found:
     io.undertow:undertow-core                             2.3.7.SP1-redhat-00001 ==>  2.3.8.Final-redhat-00001
   Continue with update [y/N]: y
   Building updates
   
   Feature-packs resolved.
   Packages installed.
   Downloaded artifacts.
   JBoss modules installed.
   Configurations generated.
   JBoss examples installed.
   
   Build update complete!
   Applying updates
   Update complete!
   Operation completed in 46.35 seconds.

Procedure

1. Navigate to the directory containing the jboss-eap-installation-manager by using your terminal emulator.

2. View the history of all versions of JBoss EAP, which you have installed:

   ./jboss-eap-installation-manager.sh history --dir eap-8

   Note

   This command displays all JBoss EAP installations and updates with their respective installation state ID.

3. Investigate specific changes made to JBoss EAP during an update:

   ./jboss-eap-installation-manager.sh history --dir eap-8 --revision <Installation state>

   This command displays specific JBoss EAP components that have been updated

4. Revert JBoss EAP by specifying the installation state of the JBoss EAP version in the following command:

   Syntax

   ./jboss-eap-installation-manager.sh revert perform --dir eap-8 --revision <Installation state>

   Important

   You must specify the installation state of the JBoss EAP version.

   Example

   ./jboss-eap-installation-manager.sh revert perform --dir eap-8 --revision 6a6f55eb
   Feature-packs resolved.
   Packages installed.
   Downloaded artifacts.
   JBoss modules installed.
   Configurations generated.
   JBoss examples installed.
   
   Reverted server prepared, comparing changes
   No changes found

   Follow the rest of the prompts to revert JBoss EAP updates.

   Continue with revert [y/N]: y
   Applying changes
   
   Server reverted to state ea768519.
   Operation completed in 55.39 seconds.

Procedure

1. Managing JBoss EAP installation channels

   1. Investigate the channels your JBoss EAP installation is currently subscribed to by using the following command:

      ./jboss-eap-installation-manager.sh channel list --dir eap-8

   2. Subscribe your JBoss EAP installation to a new channel by using the following command:

      ./jboss-eap-installation-manager.sh channel add --channel-name <CHANNEL_NAME> --manifest <GROUP_ID:ARTIFACT_ID> --repositories <ID::REPOSITORY_URL> --dir eap-8

   3. unsubscribe your JBoss EAP installation from a channel using the following command:

      ./jboss-eap-installation-manager.sh channel remove --channel-name <CHANNEL_NAME> --dir eap-8

   4. Export a server snapshot by using the following command:

      ./jboss-eap-installation-manager.sh clone export --dir=<directory> --path=<target_archive>