2.2. Installing Red Hat JBoss BRMS for Red Hat JBoss Enterprise Application Platform

Red Hat JBoss BRMS can be installed on JBoss Enterprise Application Platform 6.4.

Important

From JBoss BRMS 6.1 onwards, you must have JBoss EAP 6.4 or better already installed before attempting to install JBoss BRMS.

Installation on a fresh EAP instance

To install the deployable package for a Red Hat JBoss Enterprise Application Platform that has yet to be configured, do the following:
  1. Move the downloaded zip archive to the parent directory of the Red Hat JBoss Enterprise Application Platform home directory (EAP_HOME; the jboss-eap-6.4 directory).
  2. Unzip the downloaded zip archive: make sure it is merged into the EAP_HOME directory (jboss-eap-6.4).

    Warning

    This step must be performed by the same user account that was used to install EAP. This account must not be a superuser account.
  3. It is necessary to overwrite the files that already exist in the EAP_HOME directory with their versions from the downloaded zip archive. When prompted to do so, accept overwriting the original files.

Installation on an existing EAP configuration

Warning

These instructions are for installing, and NOT for updating an existing JBoss BRMS instance. Make sure that there is no existing JBoss BRMS install in the target EAP.
To install the deployable package for a previously configured Red Hat JBoss Enterprise Application Platform, do the following:
  1. Download the zip archive and prepare to manually merge files into the Red Hat JBoss Enterprise Application Platform home directory (EAP_HOME; the jboss-eap-6.4 directory).
  2. Unzip the downloaded zip archive; however, do not overwrite all of the files. Manually merge the following files into the EAP_HOME directory (jboss-eap-6.4):
    • jboss-eap-6.4/domain/configuration/*
    • jboss-eap-6.4/standalone/configuration/*
    • jboss-eap-6.4/modules/layers.conf
    • jboss-eap-6.4/bin/product.conf

    Warning

    Make sure this step is performed by the same user account that was used to install EAP. This account must not be a superuser account.
  3. Ensure the target EAP does not include a deployment with a colliding name. Copy the folder jboss-eap-6.4/standalone/deployments into the EAP_HOME directory from the JBoss BRMS distribution.
  4. Make sure no EAP module layer is already called JBoss BRMS and copy the folder jboss-eap-6.4/modules/system/layers/brms into the EAP 6.4 folder.