You are viewing the RapidMiner Server documentation for version 9.1 - Check here for latest version

Job Agents

The RapidMiner Server preconfigures the agent with some of the properties it can guess before you download the distribution. You can edit these properties after downloading and unpacking the agent.

Agent Properties

You can alter this configuration by changing home/config/ Each property has a comment before which explains what effect the configuration has on the agent.

Container Properties

The content inside home/config/rapidminer/ is going to be copied into each job directory before container start:

  • home/config/rapidminer/.RapidMiner: Place your own configuration files into this directory if you need it for your extensions.
  • home/config/rapidminer/ the properties in this file are going to be set as system properties for the Job Container. The agent will also add RapidMiner Server's address properties to this file automatically before the container starts. Use this file to provide your custom properties (e.g. extension properties) for the container.


JDBC connections can be defined in the home/resources/jdbc/jdbc_properties.xml file.


Extensions are provided from home/resources/extensions/ directory, they aren't copied because of their size, but provided as a reference to each Job Container. Place your extensions into this directory if you want to be available for execution.

To keep the extension installation effort and maintenance for RapidMiner Server and Job Agent to a minimum share the server’s extension directory between both. If it is not located on the same machine use your systems capabilities to enable a network share to provide the Job Agent access to the server’s extension directory. Open the Job Agent’s configuration at home/config/ and add the path to the extension directory (jobagent.container.extensionsDir).

Custom libraries

Custom libraries are Java libraries which you can be used in a RapidMiner process, for example within the Execute Script operator. You can add these libraries to the home/resources/libs/ folder and then they're automatically available for execution. If you like to change the directory to a custom location outside of the Job Agent's home directory, adjust your configuration at home/config/ and set jobagent.container.customLibsDir to the location where you've placed your custom libraries.

Don't confuse custom libraries with JDBC drivers or extensions.


The Job Agent distribution's home/resources/licenses/ directory already contains your licenses installed in RapidMiner Server. It can happen however that some of your extensions need extra licenses to execute properly and those licenses can't be found in the Job Agent's directory. Place your licenses into this directory to make it available to your containers.

You can define the number of spawned Job Containers (jobagent.container.count) for each Job Agent and the memory per Job Container (jobagent.container.memoryLimit) in the home/config/ file. Keep in mind that these settings need to comply with your current server license.