Chapter 2. Installing JBoss EAP 8.1 using the jboss-eap-installation-manager

Procedure

1. Open your terminal emulator and navigate to the directory containing the downloaded jboss-eap-installation-manager.

2. Install JBoss EAP by running the following command:

   Syntax

   $ ./jboss-eap-installation-manager.sh install --profile eap-8.0 --dir eap-8

   Example

   $ ./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/

   Review the end user license agreement, and follow the rest of the prompts to install JBoss EAP.

   Accept the agreement(s) [y/N]y
   
   Feature-packs resolved.
   Packages installed.
   Downloaded artifacts.
   JBoss modules installed.
   Configurations generated.
   JBoss examples installed.

   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.

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. Extract the Maven repository archive file.
2. Open your terminal emulator and navigate to the directory containing the extracted Maven repository file.

3. 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

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>

      Note

      Any modifications you have made to configuration files will not be exported.

Procedure

1. Open a terminal or command prompt.

2. Set the JAVA_OPTS environment variable to include the desired language and country codes:

   Example: To set the localization to French on Linux/macOS

   $ export JAVA_OPTS="-Duser.language=fr -Duser.country=FR"

   Example: To set the localization to German on Windows with Command Prompt

   $ set JAVA_OPTS="-Duser.language=de -Duser.country=DE"

   Example: To set the localization to Japanese on Windows PowerShell

   $env:JAVA_OPTS="-Duser.language=ja -Duser.country=JP"

3. Run the Installation Manager. Change to the directory where the Installation Manager executable is located and run it.

   For Linux/macOS

   $ ./jboss-eap-installation-manager.sh

   For Windows

   $ jboss-eap-installation-manager.bat

   The installer interface displays in the specified language.

   Alternatively, for Linux only, use the system environment variables, which the Java application inherits.

1. Open your Linux terminal.

2. Set the LANG and LC_ALL environment variables to your desired locale:

   Example: To set the locale to Simplified Chinese

   $ export LANG=zh_CN.utf8
   $ export LC_ALL=zh_CN.utf8

3. Run the Installation Manager. Change to the directory where the Installation Manager executable is located and run it.

   $ ./jboss-eap-installation-manager.sh

   The output from the installer now attempts to display in the specified language.