Show Table of Contents
Chapter 3. RT-Gov
RT-Gov provides runtime governance functionality. Installation includes both the server and client component packages. The
jboss-rtgov-6.3.0.redhat-2-server-installer.jar is a bundle of RTGov server and client components together and jboss-rtgov-6.3.0.redhat-2-client-installer.jar consists only a client.
If you need to use only the RTGOV server component, you can install
jboss-rtgov-6.3.0.redhat-2-server-installer.jar on a JBoss EAP instance without switchyard. This configuration does not use incorporated client and only collects information from the rtgov-client located on some other remote JBoss EAP instance.
If you need RTGov Client then the RTGov client needs to be installed on the JBoss EAP instance which also has SwitchYard so that it can gather information from SwitchYard.
Prerequisites
Before you install the RT-Gov server and client packages, you need to install on an instance of JBoss EAP 6.4:
- The Red Hat JBoss Fuse 6.3.0 on EAP base package, which installs JBoss Fuse 6.3See the section called “Installing JBoss Fuse 6.3 on JBoss EAP” for details.
- The
kie-eap-installer-6.4.0.Final-redhat-10.jar, which installs the required Drools componentsSee the section called “Installing kie-eap on JBoss EAP” for details.
Important
Because The RT-Gov server and RT-Gov client components must be installed on their own instance of JBoss EAP, you need to make sure that port numbers on these JBoss EAP instances do not clash when they are installed on the same host machine. To do so, use the port offset facility, as described in Configuring Port Offsets in the Red Hat JBoss EAP Administration and Configuration Guide.
Accessing the JBoss Fuse 6.3.0 software download page
If you have not already registered an account, you will be prompted to do so before you access the Software Downloads page
- Click here to access the Red Hat JBoss Fuse Software Downloads page.
- Log in to your account, or register to open an account if you do not have one and then log in.
- Make sure that appears in the Product drop-down menu and appears in the Version drop-down menu.All of the downloads for the selected version appear in the download files table.
Accessing the JBoss Fuse Service Works 6.3.0 software download page
If you have not already registered an account, you will be prompted to do so before you access the Software Downloads page.
- Click here to access the Red Hat JBoss Fuse Software Downloads page.
- Log in to your account, or register to open an account if you do not have one and then log in.
- Expand the Product drop-down menu, and select from the list of available products.
- Make sure that appears in the Version drop-down menu.All of the downloads for the selected version appear in the download files table.
Installing JBoss Fuse 6.3 on JBoss EAP
- Access the Fuse Service Works 6.3.0 software download page (see the section called “Accessing the JBoss Fuse Service Works 6.3.0 software download page” for details).
- Click the link for to download the
fuse-eap-installer-6.3.0.redhat-187.jarfile. - On a fresh instance of JBoss EAP, navigate to $EAP_Home.
- Run the installer using this command:
java -jar <tempLocation>/fuse-eap-installer-6.3.0.redhat-187.jar
Installing kie-eap on JBoss EAP
- Access the Fuse 6.3.0 software download page (see the section called “Accessing the JBoss Fuse 6.3.0 software download page” for details).
- Click the link for to download the
fuse-integration-eap-full-1.5.0.redhat-630018-installer.zipfile to a temporary location on your file system and unzip it.Check that the directory contains the filekie-eap-installer-6.3.0.redhat-187.jar. - On the same instance of JBoss EAP where JBoss Fuse 6.3 is installed, navigate to $EAP_Home.
- Run the installer using this command:
java -jar <tempLocation>/kie-eap-installer-6.3.0.redhat-18.jar
Installing the RT-Gov Server Component
The RT-Gov server component must be installed on an instance of JBoss EAP that has both JBoss Fuse 6.3.0 and kie-eap installed. Before you begin, make sure the JBoss EAP server is stopped.
- Access the Fuse Service Works 6.3.0 software download page (see the section called “Accessing the JBoss Fuse Service Works 6.3.0 software download page” for details).
- Click the link for to download the
jboss-rtgov-6.3.0.redhat-2-server-installer.jarfile. - On an instance of JBoss EAP that has both JBoss Fuse 6.3.0 and kie-eap installed, navigate to $EAP_Home.
- Run the installer using following command:
java -jar <tempLocation>/jboss-rtgov-6.3.0.redhat-2-server-installer.jar - Run the post installation script to set up password vaults, using this command:
./scripts/overlord/rtgov/install-overlord.sh [--setup-db]NoteYou are prompted to enter a password for the Overlordadmin(default) user. This password is for accessing this instance of JBoss EAP, on which the RT-Gov server is installed. You will need this password when you run the client's post install script, if you install the RT-Gov client.NoteThe--setup-dbargument is optional and only works on RT-Gov server installations. When used, the scripts set up the required database tables in an H2 database. The H2 database is ideal for getting up and running with the quickstarts ($EAP_HOME/quickstarts/overlord/rtgov), but not for production. For production, Red Hat recommends that administrators use the sql found in thesql/rtgovdirectory, for one of the supported databases. - Start the JBoss EAP server in standalone-full mode, using this command:
./bin/standalone.sh -c standalone-full.xml
Installing the RT-Gov Client Component
Installing the RT-Gov client is optional. If installed, it must be on an instance of JBoss EAP that has both JBoss Fuse 6.3.0 and kie-eap installed, but on a different instance of JBoss EAP than the RT-Gov server. Before you begin, make sure the JBoss EAP server is stopped.
- Access the Fuse Service Works 6.3.0 software download page (see the section called “Accessing the JBoss Fuse Service Works 6.3.0 software download page” for details).
- Click the link for to download the
jboss-rtgov-6.3.0.redhat-2-client-installer.jarfile. - On an instance of JBoss EAP that has both JBoss Fuse 6.3.0 and kie-eap installed, but not the RT-Gov server, navigate to $EAP_Home.
- Run the installer using the following command:
java -jar <tempLocation>/jboss-rtgov-6.3.0.redhat-2-client-installer.jar - Run the post installation script to set up password vaults, using this command:
./scripts/overlord/rtgov/install-overlord.shFirst the script prompts you to enter a password for the Overlordadmin(default) user. This password is for accessing this instance of JBoss EAP, on which the RT-Gov client is installed.Next, the script prompts you to enter the username and then the password used to access the EAP instance on which the RT-Gov server is installed. These credentials are required to log into the graphical user interface and to enable the client to connect with the server. Enter the same username (default = admin) and password used when installing the RT-Gov server component. - Edit the
$EAP_Home/standalone/configuration/standalone-full.xmlfile.- Set the RESTActivityServer.serverURL property's value to the correct URL for the RT-Gov server instance by replacing rtgov-server-url with the actual URL:
<parent> <configuration name="overlord-rtgov"> <properties> ... <property name="RESTActivityServer.serverURL" value="rtgov-server-url"/> - Set
ActivityCollector.enabledto true.
- Start the RT-Gov client EAP server in standalone-full mode, using this command:
./bin/standalone.sh -c standalone-full.xml
RT-Gov Database
RT-Gov is initially configured to use an H2 database, but the configuration can be changed to use any databases from the following list:
- DB2
- Oracle 10g
- PostgreSQL
- MySQL 5 InnoDB
- SQLServer 2008
Note
In H2 database, after you run the installer, execute the following command:
>./scripts/overlord/rtgov/install-overlord.sh --setup-dbIt creates the schema automatically. However, for all other databases, you need to manually set up the database.
Procedure 3.1. Configure RT-Gov Database
- Navigate to the $EAP_HOME directory of a clean installation of JBoss EAP.
- The database schema files for each supported database are in
$EAP_HOME/sql/rtgov/. Use the appropriate file for your database to create the database schema. For example, useoverlord-rtgov.PostgreSQLDialect.sqlfor a PostgreSQL database. - Install the appropriate JDBC driver by following the instructions in EAP Datasource Management These instructions show you how to install the JDBC driver onto JBoss EAP using a number of different methods.
- To define the location of the database and provide login criteria you must update the datasource configuration file. The datasource configuration file is at
$EAP_HOME/modules/system/layers/rtgov/org/overlord/rtgov/eap/deployments/main/rtgov-ds.xml.Update the following parameters to reflect the values for your database:- connection-url - add the connection url for your database
- driver - add the JDBC driver name for your database
- user-id - add the admin logon for your database
- password - add the password for the admin logon
- To configure hibernate to use the matching dialect for the RT-Gov entities, change the hibernate.dialect property. This dialect is defined in
$EAP_HOME/standalone/configuration/standalone-full.xml. For example:<configuration name="overlord-rtgov"> <properties> ... <property name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>Here, PostgreSQLDialect is used an example. Use the correct dialect to match your installation environment needs.

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.