Chapter 3. Installation Options

Navigate to the folder where you downloaded the installer file in a command prompt and execute the following command.

java -jar jboss-bpmsuite-6.3.0.GA-installer.jar

java -Dizpack.mode=privileged -jar jboss-bpmsuite-6.3.0.GA-installer.jar

java -XX:MaxHeapSize=4g -jar jboss-bpmsuite-6.3.0.GA-installer.jar

The graphical installer will execute and display a splash screen and a license agreement page.

In the next screen, provide the parent location of an existing Red Hat JBoss EAP where Red Hat JBoss BPM Suite must be installed. The screenshot below depicts an example directory path:

Figure 3.1. Red Hat JBoss BPM Suite for JBoss EAP Directory Path

In the next two screens, create two users: the first one for the management console of the Red Hat JBoss EAP (ManagementRealm) and the second one for managing Red Hat JBoss BPM Suite itself (ApplicationRealm).

Creation of the first user for the management console of Red Hat JBoss EAP is optional and you may skip it if it is not required.

Make a note of these user names and passwords as you will need them to access the Red Hat JBoss EAP server (if you do decide to create it) and the Red Hat JBoss BPM Suite application respectively.

Unless advanced configuration is performed, the Red Hat JBoss BPM Suite user password will be used as the default password for both client and server JMS SSL keystores, as well as password vault keystores.

Configure runtime environment.

This step provides the option of using a default configuration or specifying an advanced configuration.

Navigate to the folder where you downloaded the installer file in a command prompt and execute the following command.

java -jar jboss-bpmsuite-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 1 to 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/BPMSuite-6.3.0/jboss-eap-6.4]

The installer will verify the location of the Red Hat JBoss EAP installation at the provided location. Enter 1 to confirm and continue.

Optional: create a user for the management console of Red Hat JBoss EAP (ManagementRealm):

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.

Enter 0 to skip creating a new administrative user or 1 to create one. If you do decide to create one, then follow these steps:

After this user has been created successfully, continue to the next step.

Create a Red Hat JBoss BPM Suite administrator user.

Create a Business Process Management Suite Admin User
Create a BPM Suite 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 roles. The BPM Suite username cannot be any of the following: 'admin', 'analyst', 'user', 'manager' or 'developer'.

BPM Suite username: [bpmsAdmin]

Enter a user name for this user and then create and confirm a password.

The password must have at least 8 characters, and contain at least one number and one non-alphanumeric symbol (not including the character &).

BPM Suite password: []

Confirm BPM Suite password: [****************]

After the passwords have been entered and confirmed, you will be given an optional step to define other roles for this user (besides the admin role). Enter these roles in a comma-separated list or just press Enter to skip this part.

(Optional) You can add this user to additional roles that will be used for task management.  These roles are custom named and used again when building your processes with human tasks.  Add your custom named roles in a comma separated list below.

Additional user roles: []

Configure the Java Security Manager by either pressing 1 to select it or 0 to deselect it.

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 Process Management Suite 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.

Specify whether or not you are using IPv6.

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 selecting or deselecting IPv6 configuration, select one of the following options:

press 1 to continue, 2 to quit, 3 to redisplay.

Configure the runtime environment by either choosing the default configuration or advanced options.

Configure runtime environment
Red Hat JBoss Business Process Management Suite can be further customized at this time.
0  [x] Perform default configuration
1  [ ] Perform advanced configuration

If you select 1, Perform advanced configuration, complete the following configurations:

Next, choose an option from the prompt below:

press 1 to continue, 2 to quit, 3 to redisplay.

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/BPMSuite-6.3.0/jboss-eap-6.4
Would you like to generate an automatic intallation 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/BPMSuite-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-bpmsuite-6.3.0.GA-installer.jar AUTO_SCRIPT_FILENAME

-variablefile VARIABLE_FILENAME

-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 ]
[BPMS_Installer]$