R Service Bus – Getting Started

Documentation: Installation

Mon, 01 Jan 0001 00:00:00 +0000

Snapshot Debian Packages

Should you want to get started with the latest RSB snapshot and have all the required packages and dependencies installed in a convenient manner, simply run the following command:

sudo apt-get install rsb-snapshot r-properties r-rsbxml r-rsbjson

These packages are found in this repository: deb.openanalytics.eu. Follow this guide to add this repository to your system.

Prerequisites

RSB needs R, several R packages and also relies on RPooli for interacting with R.

If you haven’t installed R already, consider doing so using the r-base and r-rj packages from deb.openanalytics.eu

The R packages can be installed in two ways:

    install.packages(c("properties", "RSBXml", "RSBJson"), repos = "http://repos.openanalytics.eu", type = "source")

Install the Debian packages: r-properties, r-rsbxml, r-rjsonio and r-rsbjson from deb.openanalytics.eu

RPooli is bundled with RSB in its full distribution (which also contains a Tomcat web container).

If you chose not to use the full distribution of RSB, you’ll need to install RPooli yourself, which is easily done with the RPooli package from deb.openanalytics.eu

WAR-only Deployment

RSB should deploy fine on any Java web-container supporting Servlet 3.1 running with Java 11 or newer.

To ensure an RSB instance is running and can access its default RPooli pool, browse to or curl:

http://${RSB host}/rsb/api/rest/system/health/check

If all is good, RSB should respond: OK

Full Distribution Installation

Simply unzip the distribution Zip archive in your preferred location and ensure the files in the bin directory are executable.

Documentation: Administration

Mon, 01 Jan 0001 00:00:00 +0000

JMX

RMI

RSB exposes MBeans accessible with JMX locally and over RMI.

By default, the remote process URI is: service:jmx:rmi://127.0.0.1:9098/jndi/rmi://localhost:9099/myconnector.

HTTP

All the MBeans are also accessible over HTTP.

By default, the (browsable) HTTP URL is: http://localhost:8889.

Documentation: Build

Mon, 01 Jan 0001 00:00:00 +0000

Prerequisites

Sun/Oracle JDK 1.6
Maven 3

To produce rsb.war, run:

mvn clean install

Note that this war embeds javax dependencies and is designed to be deployed on web containers (like Tomcat or Jetty).

To produce a rsb.war that can be deployed on application servers, run:

mvn -P-javax-dependencies clean install

Packaged Distribution

To build a complete distribution consisting of Tomcat with both the RPooli and RSB web application deployed in it, run:

mvn -Pjavax-dependencies,tomcat-distribution clean package

Test Run

On Linux/OS X, you can easily start RSB for a quick ride with:

mvn jetty:run

to start RSB configured to use a locally running RPooli.

Similarly, if you have a locally running RPooli, it’s also possible to quickly try RSB with Tomcat by running:

mvn -Pjavax-dependencies,tomcat cargo:run

Press Control+C when you’ll be done with testing.

In both cases, RSB is accessible at this URL: http://localhost:8888/rsb.

Integration Tests

RPooli must be running locally before starting the integration tests.

If that is the case, then run:

mvn -Pjavax-dependencies,it -Dit.test=SuiteITCase clean verify

Documentation: Upgrade

Mon, 01 Jan 0001 00:00:00 +0000

From version 5.x to 6.x

The JobStatisticsHandler has been modified in a non backwards compatible fashion. The change is trivial: the storeJobStatistics method now takes a Job interface as a parameter from which the application name and job ID, previously passed as distinct arguments, can be retrieved.