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).
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
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-INFdirectory, 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.
Configuration attributes are documented on the persisted configuration classes.