2.4. Installing Red Hat JBoss BRMS Using the Installer in CLI Mode
The installer for Red Hat JBoss BRMS can also be executed through the command-line interface (CLI). The procedure below demonstrates the steps that you are likely to encounter using this option to install Red Hat JBoss BRMS.
Prerequisite
Before attempting to install Red Hat JBoss BRMS, ensure you have already installed Red Hat JBoss EAP 6.4.7 or better, and create a back up. Ensure that your user has sufficient rights to complete the installation.
Navigate to the folder where you downloaded the installer file in a command prompt and execute the following command.
java -jar jboss-brms-6.3.0.GA-installer.jar -console
The command-line interactive process will start and display the End-User license agreement. You will be prompted to select an option at the end of this license:
press 1 to continue, 2 to quit, 3 to redisplay.
Enter
1to begin the installation and type in the parent directory of an existing Red Hat JBoss EAP installation.The location below must specify the JBOSS_HOME of an existing EAP installation. [/home/user/BRMS-6.3.0/jboss-eap-6.4]
The installer will verify the location of the Red Hat JBoss EAP installation at the provided location.
press 1 to continue, 2 to quit, 3 to redisplay.
Enter
1to confirm and continue.Create an administrative user.
Create an administrative user This user will be added to the host container's management realm for administrative purposes. It can be used to access the management console, the management CLI or other applications secured in this realm. The password must be at least eight characters long, with one alphabetic character, one digit, and one non-alphanumeric character not including &. Create an administrative user. 0 [x] Skip new administrative user creation. 1 [ ] Create a new administrative user.
Create and confirm a password for the user of the EAP management console:
Admin password: [] ********** Confirm admin password: [**********] **********
After the passwords have been entered, choose an option from the prompt below:
press 1 to continue, 2 to quit, 3 to redisplay.
Enter
1and create a Red Hat JBoss BRMS user:Create a Business Rules Management System Admin User Create a BRMS admin user. The user will be added to the ApplicationRealm, and can be used to access the Business Central Console. The User will be assigned the 'admin' application role. The BRMS username cannot be any of the following: 'admin', 'analyst', 'user', 'manager' or 'developer'. The password must be at least eight characters long, with one alphabetic character, one digit, and one non-alphanumeric character not including &. BRMS username: [brmsAdmin]
ImportantMake sure that the selected user name does not conflict with any known title of a role or a group.
For example, if there is a role called
admin, you should not create a user with the user nameadmin.Create and confirm a password for the Red Hat JBoss BRMS user:
BRMS password: [] ********** Confirm BRMS password: [**********] **********
After the passwords have been entered, choose an option from the prompt below:
press 1 to continue, 2 to quit, 3 to redisplay.
Configure the Java Security Manager.
A Java security manager offers JVM level security beyond what is provided by the application container. It enforces access rules at the JVM runtime based on one or more security policies. This installer will place two security policies in the installation directory with the filenames 'security.policy' and 'kie.policy' regardless of choice. Those policies will be enabled at runtime if the option below is selected. Please note that a security manager imposes a significant performance overhead when enabled. It is suggested the included policies be applied in production if user requirements call for a stronger measure than what is already provided by the application container's authentication and authorization mechanism. Please see the JBoss Business Rules Management System administrative documentation for further details and consideration. [ ] Enable the Java security manager Input 1 to select, 0 to deselect:
After the Java Security Manager choice, choose an option from the prompt below:
press 1 to continue, 2 to quit, 3 to redisplay.
Next, select whether to enable the IPv6 configuration.
IPv6 configuration If this computer is using a pure IPv6 configuration, please check the box below. A pure IPv6 setup requires additional configuration at runtime to ensure the proper bindings of the management and http interfaces. [ ] Enable pure IPv6 configuration Input 1 to select, 0 to deselect:
After the IPv6 configuration choice, choose an option from the prompt below:
press 1 to continue, 2 to quit, 3 to redisplay.
Configure the runtime environment by either choosing the default configuration or inputting advanced options.
Configure runtime environment Red Hat JBoss Business Rules Management System can be further customized at this time. 0 [x] Perform default configuration 1 [ ] Perform advanced configuration Input Selection:
If you select
1, Perform advanced configuration, complete the following configurations:[ ] Install password vault Input 1 to select, 0 to deselect:
[ ] Enable SSL security Input 1 to select, 0 to deselect:
[ ] Secure EAP Management Console with LDAP Input 1 to select, 0 to deselect:
[ ] Secure Business Central and Dashbuilder with LDAP Input 1 to select, 0 to deselect:
[ ] Add a security-domain Input 1 to select, 0 to deselect:
[ ] Install Business-Central Datasource Input 1 to select, 0 to deselect:
[ ] Configure Optaplanner Execution Server Input 1 to select, 0 to deselect:
Next, choose an option from the prompt below:
press 1 to continue, 2 to quit, 3 to redisplay.
-
The
.jarfile will begin to unpack and configure. After a successful installation, the command-line will ask you if you would like to generate an automatic installation script and properties file.
Installation has completed successfully. Application installed on /home/user/BRMS-6.3.0/jboss-eap-6.4 Would you like to generate an automatic installation script and properties file? (y/n) [n]:
If you select
y, provide a path for the automatic installation script:Select path for the automatic installation script: [/home/user/BRMS-6.3.0/jboss-eap-6.4/AUTO_SCRIPT_FILENAME]
This generated script will allow the user to run the installer in the following way for future installations:
java -jar jboss-brms-6.3.0.GA-installer.jar AUTO_SCRIPT_FILENAME
NoteRunning the installer in this way will result in an installation identical to the installation from which the auto script was generated. Note that sensitive values, such as passwords, will need to be provided from an external file or provided at auto installation time. The optional argument below allows the user to provide these values automatically:
-variablefile VARIABLE_FILENAME
Sensitive values can also be provided using the following argument:
-variables key1=value1,key2=value2
The command-line will provide the following message upon a successful auto script creation and/or console installation:
XML written successfully. [ Console installation done ] [BRMS_Installer]$
Start Red Hat JBoss EAP by running
standalone.shin thejboss-eap-6.4/bindirectory../standalone.sh
-
Navigate to
http://localhost:8080/business-centralin a web browser. - Log in with the correct user name/password as given to the Red Hat JBoss BRMS user in the Create and confirm a password for the Red Hat JBoss BRMS user step.

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.