Configuration

RSB is configured with a unique JSON file named rsb-configuration.json, which must be located either in /etc/rsb or at the root of the JVM classpath (for example, in Tomcat’s lib directory).

Samples

Here are a few examples of configuration files:

• Minimal configuration: the required configuration entries
• Redis statistics store: a minimal configuration with an optional Redis statistics store configured
• RPooli client pool: a minimal configuration with an optional RPooli client pool for faster R function invocations
• Full configuration: a complete configuration with examples for all the different job deposit methods

Default Configuration

If RSB can’t locate a configuration file, it will try to generate one (named rsb-configuration.json, as above) and store it either in /etc/rsb or in WEB-INF/classes. Here is the content of the default configuration:

In this configuration, $RSB_HOME is replaced by either, and in order of preference:

• The user’s home directory, if it exists and is writeable,
• The rsb.war WEB-INF directory, if it is writeable,
• The operating system temporary directory

If RSB generates such a default configuration file in WEB-INF/classes, it is recommended to review it so it uses the desired values and move it to /etc/rsb, as discussed in the previous section.

Description

Configuration attributes are documented on the persisted configuration classes.