Chapter 2. Installing JBoss EAP 8.0 using the jboss-eap-installation-manager
You can install JBoss EAP 8.0 by using one of the following installation methods:
-
The
jboss-eap-installation-managerinstallation method. - The GUI installer.
- The archive installation method.
- The RPM installation method.
This section only covers the jboss-eap-installation-manager installation method.
Prerequisites
- You have created an account on the Red Hat Customer Portal.
- You have reviewed JBoss EAP 8.0 supported configurations.
- You have installed a supported JDK.
- You have access to the internet.
2.1. Downloading the jboss-eap-installation-manager Copy linkLink copied to clipboard!
Download the jboss-eap-installation-manager CLI tool from the Red Hat Customer Portal
Prerequisites
- You have access to the internet
- You have created an account on the Red Hat customer portal and are logged in.
Procedure
-
On the Red Hat customer portal, download the
jboss-eap-installation-manager.
Additional resources
2.2. Installing JBoss EAP using the jboss-eap-installation-manager Copy linkLink copied to clipboard!
Install JBoss EAP by following the procedures 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
-
Open your terminal emulator and navigate to the directory containing the downloaded
jboss-eap-installation-manager. Install JBoss EAP by running the following command:
Syntax
./jboss-eap-installation-manager.sh install --profile eap-8.0 --dir eap-8
./jboss-eap-installation-manager.sh install --profile eap-8.0 --dir eap-8Copy to Clipboard Copied! Toggle word wrap Toggle overflow Example
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Review the end user license agreement, and follow the rest of the prompts to install JBoss EAP.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
NOTE: The jboss-eap-installation-manager is also supported on Microsoft Windows. To use this script on a Windows machine, replace the .sh with .bat in your script.
Additional resources
2.3. Reverting JBoss EAP updates using the jboss-eap-installation-manager Copy linkLink copied to clipboard!
After installing an update, you can revert back to a previously installed version of JBoss EAP.
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. - You have updated JBoss EAP.
Procedure
-
Navigate to the directory containing the
jboss-eap-installation-managerby using your terminal emulator. View the history of all versions of JBoss EAP, which you have installed:
./jboss-eap-installation-manager.sh history --dir eap-8
./jboss-eap-installation-manager.sh history --dir eap-8Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteThis command displays all JBoss EAP installations and updates with their respective installation state ID.
Investigate specific changes made to JBoss EAP during an update:
./jboss-eap-installation-manager.sh history --dir eap-8 --revision <Installation state>
./jboss-eap-installation-manager.sh history --dir eap-8 --revision <Installation state>Copy to Clipboard Copied! Toggle word wrap Toggle overflow This command displays specific JBoss EAP components that have been updated
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>
./jboss-eap-installation-manager.sh revert perform --dir eap-8 --revision <Installation state>Copy to Clipboard Copied! Toggle word wrap Toggle overflow ImportantYou must specify the installation state of the JBoss EAP version.
Example
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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.
Continue with revert [y/N]: y Applying changes Server reverted to state ea768519. Operation completed in 55.39 seconds.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.4. Installing JBoss EAP 8.0 Offline Copy linkLink copied to clipboard!
You can install JBoss EAP 8.0 offline. By choosing this method, you can install from a local or file-system Maven repository.
Prerequisites
-
You have downloaded the
jboss-eap-installation-managerfrom the Red Hat Customer Portal. - You have downloaded Maven repository archive file from the Red Hat Customer Portal.
Procedure
- Extract the Maven repository archive file.
- Open your terminal emulator and navigate to the directory containing the extracted Maven repository file.
Install JBoss EAP by running the following command:
./jboss-eap-installation-manager.sh install --profile eap-8.0 --dir eap-8 --repositories file:maven-repository
./jboss-eap-installation-manager.sh install --profile eap-8.0 --dir eap-8 --repositories file:maven-repositoryCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.5. Managing JBoss EAP installation channels Copy linkLink copied to clipboard!
After successfully setting up JBoss EAP, you can change the channels to which your JBoss EAP installation is subscribed.
Prerequisite
-
You have downloaded the
jboss-eap-installation-managerfrom the Red Hat Customer Portal.
Procedure
Managing JBoss EAP installation channels
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
./jboss-eap-installation-manager.sh channel list --dir eap-8Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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
./jboss-eap-installation-manager.sh channel add --channel-name <CHANNEL_NAME> --manifest <GROUP_ID:ARTIFACT_ID> --repositories <ID::REPOSITORY_URL> --dir eap-8Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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
./jboss-eap-installation-manager.sh channel remove --channel-name <CHANNEL_NAME> --dir eap-8Copy to Clipboard Copied! Toggle word wrap Toggle overflow Export a server snapshot by using the following command:
./jboss-eap-installation-manager.sh clone export --dir=<directory> --path=<target_archive>
./jboss-eap-installation-manager.sh clone export --dir=<directory> --path=<target_archive>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Any modifications you have made to configuration files will not be exported.
Additional resources