1.6. 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 JBoss BRMS.
Prerequisite

Before attempting to install JBoss BRMS, ensure you have already installed Red Hat JBoss EAP 6.4 or better.

  1. Navigate to the folder where you downloaded the installer file in a command prompt and execute the following command. 
    java -jar jboss-brms-6.1.0.GA-installer.jar -console
  2. 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.
  3. Enter 1 to begin the installation and type in the parent directory of an existing EAP installation. 
    The location below must specify the JBOSS_HOME of an existing EAP installation.

[/home/user/BRMS-6.1.0/jboss-eap-6.4]
    The installer will verify the location of the JBoss EAP installation at the provided location. 
    press 1 to continue, 2 to quit, 3 to redisplay.
    Enter 1 to confirm and continue.
  4. 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.
  5. Create and confirm a password for the user of the EAP management console: 
    Admin password: []
**********
Confirm admin password: [**********]
**********
  6. After the passwords have been entered, choose an option from the prompt below: 
    press 1 to continue, 2 to quit, 3 to redisplay.
  7. Enter 1 then create a 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]
  8. Create and confirm a password for the JBoss BRMS user: 
    BRMS password: []
**********
Confirm BRMS password: [**********]
**********
  9. After the passwords have been entered, choose an option from the prompt below: 
    press 1 to continue, 2 to quit, 3 to redisplay.
  10. 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:
  11. After the Java Security Manager choice, choose an option from the prompt below: 
    press 1 to continue, 2 to quit, 3 to redisplay.
  12. 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:
  13. After the IPv6 configuration choice, choose an option from the prompt below: 
    press 1 to continue, 2 to quit, 3 to redisplay.
  14. 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 with LDAP
Input 1 to select, 0 to deselect:
    •   [ ] Add a security-domain
Input 1 to select, 0 to deselect:
  15. Next, choose an option from the prompt below: 
    press 1 to continue, 2 to quit, 3 to redisplay.
  16. The .jar file will begin to unpack and configure.
  17. 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.1.0/jboss-eap-6.4
Would you like to generate an automatic installation script and properties file?
(y/n) [n]:
  18. If you select [ y ], provide a path for the automatic installation script: 
    Select path for the automatic installation script: [/home/user/BRMS-6.1.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.1.0.GA-installer.jar <auto script filename>

    Note

    Running 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
  19. 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]$
  20. Start JBoss EAP by running standalone.sh in the jboss-eap-6.4/bin directory. 
    ./standalone.sh
  21. Navigate to http://localhost:8080/business-central in a web browser.
  22. Login with the correct username/password as given to the JBoss BRMS user in the "Create and confirm a password for the JBoss BRMS user" step.