-
Notifications
You must be signed in to change notification settings - Fork 15
UGInstallation
This section will describe how to install Overlord Runtime Governance in different environments.
This section describes how to install Overlord Runtime Governance into the JBoss Application Server.
Download the JBoss EAP distribution (version 6.1.0.Final or higher), and unpack it in a suitable location.
Download the latest release from the Overlord Runtime Governance website, selecting the distribution specific to JBoss AS/EAP. Then unpack the distribution into a suitable location.
Make sure that the JBOSS_HOME environment variable is set to the root folder of the JBoss AS/EAP environment.
The next step is to download SwitchYard (version 1.0.0.Final or higher) and install it into the JBoss AS/EAP environment. We recommend using the switchyard installer, which can be unpacked in a temporary location, and run 'ant' in the root folder to be prompted for the location of the JBoss AS/EAP environment.
The final step is to perform the installation of Overlord Runtime Governance using maven. You will need maven 3.0.4 or higher, and can be downloaded from here: http://maven.apache.org/download.html
To do the installation, use the following command from the root folder of the installation:
mvn install [ -Dtype=<installation-type> ]
The 'installation-type' value can be:
| Value | Description |
|---|---|
server |
This will result in the full server configuration being installed into the server, including activity collector (for obtaining activities generated with that server), activity server (for receiving activity information whether from a remote client or embedded app), event processor network (to analyse th events), active collections (to maintain result information) and a collection of REST services to support remote access to the information. This is the default value. |
client |
This will result in only the activity collector functionality being installed, using a RESTful client to communicate with a remote Runtime Governance server. |
The configuration for the Runtime Governance capability within a JBoss AS/EAP environment can be found in the file $JBOSS_HOME/standalone/configuration/overlord-rtgov.properties. Although there will be some properties that are independent of the installation type, some will be specific and therefore are listed in separate sections below.
The usernames and passwords are defined within the file $JBOSS_HOME/standalone/configuration/overlord-idp-users.properties.
The default user for the Runtime Governance UI, and direct access to any of the REST services, is admin with password overlord.
The common properties available across all installation types are:
| Property | Description |
|---|---|
collectionEnabled |
This property will determine whether activity information is collected when the server is initially started. This value can be changed at runtime using the ActivityCollector MBean (see the chapter on Managing the Infrastructure). |
ActivityServerLogger.maxThreads |
This property is an integer that represents the maximum number of threads that should be used to report activity events to the server (whether remote or embedded). |
| Property | Description |
|---|---|
MVELSeverityAnalyzer.scriptLocation |
Optional location of a MVEL script used to determine severity levels for nodes and links within the service overview diagram. |
When installing the full Runtime Governance server, modification to the configuration will generally only be necessary if running in a clustered environment and/or wishing to use a particular database (described below).
However, specific technologies used in the Activity Server, Event Processor Network or Active Collection modules may need to use different configuration properties to work correctly within a clustered environment. More details will be provided in sections discussing those technologies, however here we will present the common changes that may be required.
Database
The database is defined by the datasource configuration located here: $JBOSS_HOME/standalone/deployment/overlord-rtgov/rtgov-ds.xml.
The default "out of the box" H2 file based database is created during the installation of the 'server' type.
Caching
The EPN and Active Collection mechanisms both have the ability to make use of caching provided by infinispan. When running the AS7 server in clustered mode (i.e. with standalone-full-ha.xml), the server provides a default clustered cache container, which is referenced in the 'infinispan.container' property in the overlord-rtgov.properties file. Simply uncomment this property to enable the EPN and Active Collection Source configurations that do not explicitly provide a container JNDI name, to make use of this default clustered cache container.
However, to make sure the individual named caches are clustered correctly, it is necessary to add an entry for each cache into the standalone-full-ha.xml file. As an example, the following cache entry for the "Principals" cache has been defined, for use with the Policy Enforcement example:
<cache-container name="cluster" aliases="ha-partition" default-cache="default">
<transport lock-timeout="60000"/>
<replicated-cache name="default" mode="SYNC" batching="true">
<locking isolation="REPEATABLE_READ"/>
</replicated-cache>
<!-- Configuration for Runtime Governance caches -->
<replicated-cache name="Principals" mode="SYNC">
<locking isolation="REPEATABLE_READ"/>
<transaction mode="FULL_XA" locking="PESSIMISTIC"/>
</replicated-cache>
</cache-container>
This installation type is used to configure an execution environment that will be sending its activity information to a remote Runtime Governance server using REST. The relevant properties are:
| Property | Description |
|---|---|
RESTActivityServer.serverURL |
This is the URL of the activity server collecting the activity events. |
RESTActivityServer.serverUsername |
The username used to access the REST service. |
RESTActivityServer.serverPassword |
The password used to access the REST service. |