Chapter 2. Installing JBoss EAP 8.0 using the jboss-eap-installation-manager
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-manager installation method. The GUI installer. The archive installation method. The RPM installation method. Note 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 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 Download jboss-eap-installation-manager CLI tool . 2.2. Installing JBoss EAP using the jboss-eap-installation-manager 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 Example Review the end user license agreement, and follow the rest of the prompts to install JBoss EAP. Note 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 Download jboss-eap-installation-manager . 2.3. Reverting JBoss EAP updates using the jboss-eap-installation-manager 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-manager by 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 Note This 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> 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 Important You must specify the installation state of the JBoss EAP version. Example Follow the rest of the prompts to revert JBoss EAP updates. 2.4. Installing JBoss EAP 8.0 Offline 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-manager from 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 2.5. Managing JBoss EAP installation channels 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-manager from 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 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 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 Export a server snapshot by using the following command: ./jboss-eap-installation-manager.sh clone export --dir=<directory> --path=<target_archive> Note Any modifications you have made to configuration files will not be exported. Additional resources Red Hat Customer Portal
./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-8 Installing profile: eap-8.0 Using channels: eap-8.0 manifest: org.jboss.eap.channels:eap-8.0 repositories: id: mrrc url: https://maven.repository.redhat.com/ga/ Accept the agreement(s) [y/N]y Feature-packs resolved. Packages installed. Downloaded artifacts. JBoss modules installed. Configurations generated. JBoss examples installed. ./jboss-eap-installation-manager.sh history --dir eap-8 ./jboss-eap-installation-manager.sh history --dir eap-8 --revision <Installation state> ./jboss-eap-installation-manager.sh revert perform --dir eap-8 --revision <Installation state> ./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 Continue with revert [y/N]: y Applying changes Server reverted to state ea768519. Operation completed in 55.39 seconds. ./jboss-eap-installation-manager.sh install --profile eap-8.0 --dir eap-8 --repositories file:maven-repository ./jboss-eap-installation-manager.sh channel list --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-8 ./jboss-eap-installation-manager.sh channel remove --channel-name <CHANNEL_NAME> --dir eap-8 ./jboss-eap-installation-manager.sh clone export --dir=<directory> --path=<target_archive>