第3章 Using the Red Hat Decision Manager installer
This section describes how to install Decision Server and the headless Decision Manager controller using the installer JAR file. The JAR file is an executable file that installs Red Hat Decision Manager in an existing Red Hat JBoss Web Server 5.1.0 server installation. You can run the installer in interactive or command line interface (CLI) mode.
Next steps:
Follow the instructions in one of the following sections:
3.1. Using the installer in interactive mode
The installer for Red Hat Decision Manager is an executable JAR file. You can use it to install Red Hat Decision Manager in an existing Red Hat JBoss Web Server 5.1.0 server installation.
For security reasons, you should run the installer as a non-root user.
Prerequisites
- A supported JDK is installed. For a list of supported JDKs, see Red Hat Process Automation Manager 7 Supported Configurations.
- A backed-up Red Hat JBoss Web Server 5.1.0 server installation is available.
Sufficient user permissions to complete the installation are granted.
注記Ensure that you are logged in with a user that has write permission for Tomcat.
The JAR binary is included in
$PATHenvironment variable. On Red Hat Enterprise Linux, it is included in thejava-$JAVA_VERSION-openjdk-develpackage.注記Red Hat Decision Manager is designed to work with UTF-8 encoding. If a different encoding system is used by the underlying JVM, unexpected errors might occur. To ensure UTF-8 is used by the JVM, use the
"-Dfile.encoding=UTF-8"system property.
Procedure
In a terminal window, navigate to the directory where you downloaded the installer JAR file and enter the following command:
java -jar rhdm-installer-7.5.1.jar
注記When running the installer on Windows, you may be prompted to provide administrator credentials during the installation. To prevent this requirement, add the
izpack.mode=privilegedoption to the installation command:java -Dizpack.mode=privileged -jar rhdm-installer-7.5.1.jar
Furthermore, when running the installer on a 32-bit Java virtual machine, you might encounter memory limitations. To prevent this issue, run this command:
java -XX:MaxHeapSize=4g -jar rhdm-installer-7.5.1.jar
The graphical installer displays a splash screen and a license agreement page.
- Click I accept the terms of this license agreement and click Next.
- Specify the Red Hat JBoss Web Server 5.1.0 server home where you want to install Red Hat Decision Manager and click Next.
Select the components that you want to install and click Next.
You cannot install Business Central on Red Hat JBoss Web Server. You can only install it on Red Hat JBoss EAP. However, you can install Decision Server and the headless Decision Manager controller on Red Hat JBoss Web Server. The headless Decision Manager controller is used to manage Decision Server. Install the headless Decision Manager controller if you plan to manage multiple Decision Server instances.
Create a user and click Next. By default, if you install both Business Central and Decision Server on the same server the new user is given the
admin,kie-server, andrest-allroles. If you install only Decision Server, the user is given thekie-serverrole. Thekie-serverrole is required to acces Decision Server REST capabilities.注記Make sure that the specified user name is not the same as an existing user, role, or group. For example, do not create a user with the user name
admin.The password must have at least eight characters and must contain at least one number and one non-alphanumeric character, but not & (ampersand).
Make a note of the user name and password. You will need them to access Business Central and Decision Server.
- On the Installation Overview page, click Next to start the installation. The Installation Overview page lists the components that you will install.
- When the installation has completed, click Next.
- When Processing finished appears at the top of the screen, click Next to complete the installation.
Optionally, click Generate Installation Script and Properties File to save the installation data in XML files, and then click Done.
The installer generates two files. The
auto.xmlfile automates future installations and theauto.xml.variablesfile stores user passwords and other sensitive variables. Use theauto.xmlfile on multiple systems to easily repeat a Red Hat Decision Manager installation on the same type of server with the same configuration as the original installation. If necessary, update theinstallpathparameter in theauto.xmlfile. Enter the following command to perform an installation with the XML file:java -jar rhdm-installer-7.5.1.jar <path-to-auto.xml-file>
You have successfully installed Red Hat Decision Manager using the installer.