You are viewing the RapidMiner Hub documentation for version 10.1 - Check here for latest version
Table of system settings for RapidMiner Server
This table gives an overview over all properties which can be set via environment variables. This application is a Spring Boot application and therefore those property values can be also applied, e.g.
SPRING_APPLICATION_NAME=Test
would change the Spring's application name to Test.
Other properties not listed here should not be changed and have reasonable defaults.
Add clustered
to SPRING_PROFILES_ACTIVE
for using clustered scheduler, e.g. default,clustered
.
If you're behind a proxy, you can also add SERVER_FORWARD_HEADERS_STRATEGY=framework
which will change headers
X-Forwarded-*
to actual headers and removing the forwarded headers.
Backend
Property | Default | Description |
---|---|---|
DB_HOST |
The host for the postgres database | |
DB_PORT |
The port for the postgres database | |
DB_NAME |
The schema/db name for the postgres database | |
DB_USER |
The user for the postgres database | |
DB_PASSWORD |
The password for the postgres database | |
KEYCLOAK_AUTH_SERVER_URL |
URL to Keycloak | |
KEYCLOAK_SSL_REQUIRED |
NONE |
If connections to Keycloak enforce SSL |
AUTH_REALM |
AIHub |
The realm to use for Keycloak |
AUTH_SERVICE_CLIENT_ID |
aihub-backend |
The Keycloak client id |
AUTH_SERVICE_CLIENT_SECRET |
The secret for the configured Keycloak client | |
AUTH_CLIENTS_FRONTEND_CLIENT_ID |
aihub-frontend |
The default client id for the frontend |
AUTH_CLIENTS_FRONTEND_AUTH_URL |
Derived from KEYCLOAK_AUTH_SERVER_URL |
|
AUTH_CLIENTS_FRONTEND_REALM |
Derived from AUTH_REALM |
|
AUTH_CLIENTS_STUDIO_CLIENT_ID |
aihub-studio |
The default client id for studio |
AUTH_CLIENTS_STUDIO_AUTH_URL |
Derived from KEYCLOAK_AUTH_SERVER_URL |
|
AUTH_CLIENTS_STUDIO_REALM |
Derived from AUTH_REALM |
|
AUTH_CLIENTS_JUPYTER_CLIENT_ID |
aihub-jupyter |
The default client id for jupyter |
AUTH_CLIENTS_JUPYTER_AUTH_URL |
Derived from KEYCLOAK_AUTH_SERVER_URL |
|
AUTH_CLIENTS_JUPYTER_REALM |
Derived from AUTH_REALM |
|
AIHUB_BASE_DIR |
/aihub (docker image) |
The base dir of AI Hub, other directory paths are derived from this base directory. |
AIHUB_HOME_DIR |
$baseDir/home |
The home dir of AI Hub. |
AIHUB_CONFIG_DIR |
$homeDir/config |
The config dir of AI Hub. |
AIHUB_DATA_DIR |
$homeDir/data |
The data dir of AI Hub. |
RAPIDMINER_USER_DIR |
$homeDir |
A .RapidMiner folder will be created in the $homeDir |
RAPIDMINER_EXTENSION_DIR |
$homeDir/resources/extensions |
The extensions folder, also used for sync. |
RAPIDMINER_JDBC_PROPERTIES_FILE |
$homeDir/resources/jdbc/jdbc_properties.xml |
The JDBC properties file used for legacy connections. |
RAPIDMINER_REGISTER_DEFAULT_SYMMETRIC_ENCRYPTION_CONTEXT_ENABLED |
false |
Allows to register a RapidMiner Studio encryption context with default name) |
RAPIDMINER_REGISTER_DEFAULT_SYMMETRIC_ENCRYPTION_CONTEXT_KEY_LOCATION |
${RAPIDMINER_USER_DIR}/.RapidMiner/encryption/symmetric/default-local-context.rmek |
Location to the RapidMiner Studio encryption key file |
RAPIDMINER_PROPERTIES_FILE |
rapidminer.properties |
The properties file for RapidMiner Studio properties loaded on main application start |
SPRING_LIQUIBASE_ENABLED |
true |
If liquibase database migration is enabled |
SPRING_LIQUIBASE_CONTEXTS |
prod |
The liquibase contexts used during database migration |
SPRING_QUARTZ_PROPERTIES_* |
Define custom org.quartz.* properties |
|
SPRING_QUARTZ_PROPERTIES_ORG_QUARTZ_THREAD_POOL_THREAD_COUNT |
5 |
The thread pool for schedules |
SPRING_QUARTZ_PROPERTIES_ORG_QUARTZ_THREAD_POOL_THREAD_PRIORITY |
5 |
The thread priority for schedules |
SCHEDULER_DEFAULT_QUEUE |
DEFAULT |
The default queue for schedules |
SCHEDULER_DRY_RUN |
false |
Dry run mode for scheduler |
SCHEDULER_FREQUENCY_THRESHOLD |
1 |
The frequency threshold |
SCHEDULER_FREQUENCY_INTERVAL |
1440 |
The frequency interval in minutes |
SCHEDULER_STARTUP_CHECK_ENABLED |
true |
If the start up check is enabled to verify everything's up and running before the scheduler starts |
SCHEDULER_STARTUP_CHECK_POLLING_INTERVAL |
5000 |
Defines interval in milliseconds polling for new triggers |
SCHEDULER_STARTUP_CHECK_INITIAL_POLLING_DELAY |
500 |
Defines initial delay for starting to poll |
SCHEDULER_STARTUP_TASK_SCHEDULER_POOL_SIZE |
1 |
The thread pool size dedicated for schedules |
SCHEDULER_STARTUP_TASK_SCHEDULER_THREAD_PRIORITY |
5 |
The thread priority size dedicated for schedules |
JOBSERVICE_LOGGING_JOB_RETRIEVE_TIMEOUT |
30000 |
Time in milliseconds when a job log request failed |
JOBSERVICE_SCHEDULED_AGENT_STATUS_UPDATE |
10000 |
Time in milliseconds to check for unreachable Job Agents |
JOBSERVICE_SCHEDULED_AGENT_TIMEOUT_AFTER |
30000 |
Time in milliseconds when a Job Agent is marked as unreachable |
JOBSERVICE_SCHEDULED_JOB_STATUS_UPDATE |
10000 |
Time in milliseconds to check for timed out jobs |
JOBSERVICE_SCHEDULED_JOB_TIMEOUT_AFTER |
30000 |
Time in milliseconds when a job is marked as timed out |
JOBSERVICE_SCHEDULED_STOP_REQUEST_RESEND |
5000 |
Time in milliseconds when a job will be send a second stop requested |
JOBSERVICE_SCHEDULED_ARCHIVE_ENABLED |
true |
If Job archiving functionality is enabled. Archiving means that jobs in a final state will get moved to dedicated archive tables. |
JOBSERVICE_SCHEDULED_ARCHIVE_CRON_EXPRESSION |
* */5 * * * * |
When job archiving will be invoked. |
JOBSERVICE_SCHEDULED_ARCHIVE_MAX_AGE |
300 |
Max age of jobs in seconds before they get archived. |
JOBSERVICE_SCHEDULED_ARCHIVE_JOB_CLEANUP_ENABLED |
false |
If archived jobs should be cleaned up (removed from the archive). |
JOBSERVICE_SCHEDULED_ARCHIVE_JOB_CLEANUP_JOB_CRON_EXPRESSION |
If job should be cleaned up. | |
JOBSERVICE_SCHEDULED_ARCHIVE_JOB_CLEANUP_JOB_CONTEXT_CRON_EXPRESSION |
When jobs should be cleaned up. | |
JOBSERVICE_SCHEDULED_ARCHIVE_JOB_CLEANUP_MAX_AGE |
When jobs contexts should be cleaned up. | |
JOBSERVICE_SCHEDULED_ARCHIVE_JOB_CLEANUP_JOB_BATCH_SIZE |
How many jobs contexts to clean up in one batch. | |
JOBSERVICE_SCHEDULED_ARCHIVE_JOB_CLEANUP_JOB_CONTEXT_BATCH_SIZE |
How many jobs to clean up in one batch. | |
JOBSERVICE_QUEUE_AGENT_PERSISTENCE |
__agentPersistence (exclusive) |
ActiveMQ persistence topic for handling agent updates. |
JOBSERVICE_QUEUE_AGENT_COMMAND |
__agentCommand |
ActiveMQ persistence topic for handling agent commands. |
JOBSERVICE_QUEUE_AGENT_HEARTBEAT |
__agentHeartbeat |
ActiveMQ persistence topic for handling agent heartbeats. |
JOBSERVICE_QUEUE_JOB_LOG |
__jobLog |
ActiveMQ persistence topic for handling agent log requests. |
JOBSERVICE_QUEUE_JOB_STATUS |
__jobBatchUpdate (exclusive) |
ActiveMQ persistence topic for handling job states. |
JOBSERVICE_QUEUE_JOB_DEFAULT_QUEUE_NAME |
DEFAULT |
Default Job Agent queue name. |
JOBSERVICE_QUEUE_JOB_DEFAULT_QUEUE_GROUPS |
[ users ] |
Default Job Agent group names. |
JOBSERVICE_QUEUE_RECEIVE_TIMEOUT |
5000 |
JMS receive timeout. |
JOBSERVICE_QUEUE_CACHE_LEVEL |
4 |
JMS cache level. |
JOBSERVICE_QUEUE_PURGE_HEARTBEAT_TIMEOUT |
10000 |
Timeout definition for purging queues in milliseconds. |
JOBSERVICE_QUEUE_PURGE_HEARTBEAT_UPDATE_DELAY |
1000 |
Heartbeat update delay in milliseconds. |
JOBSERVICE_QUEUE_PURGE_JOB_UPDATE_BATCH_SIZE |
100 |
How many jobs are handled in batch |
JOBSERVICE_TASK_SCHEDULER_POOL_SIZE |
10 |
Task scheduler pool size for the main application |
JOBSERVICE_TASK_SCHEDULER_THREAD_PRIORITY |
5 |
Task scheduler thread priority for the main application |
REPORTING_ERROR_TYPE |
noop |
Reporting type, possible values are noop , logging and mail |
REPORTING_ERROR_MAIL_TO |
Only active when mail is the reporting type |
|
REPORTING_ERROR_MAIL_SUBJECT_PREFIX |
[RapidMiner AI Hub Execution Error Report] |
Only active when mail is the reporting type |
REPORTING_ERROR_MAIL_FROM_ADDRESS |
Only active when mail is the reporting type |
|
REPORTING_ERROR_MAIL_FROM_NAME |
RapidMiner AI Hub |
Only active when mail is the reporting type |
SYNC_ENABLED |
true |
If resource synchronization is enabled. |
SYNC_BASE_DIR |
$homeDir |
... |
SYNC_EXTENSION_DIR |
$syncBaseDir/resources/extensions |
... |
SYNC_JDBC_DIR |
$syncBaseDir/resources/jdbc |
... |
SYNC_LIBS_DIR |
$syncBaseDir/resources/libs |
... |
SYNC_LICENSE_DIR |
$syncBaseDir/resources/licenses |
... |
SYNC_EXECUTION_CONTEXT_DIR |
$syncBaseDir/.RapidMiner |
... |
SYNC_EXTENSION_EXCLUSIONS |
List of exception to exclude during synchronization for this type | |
SYNC_JDBC_EXCLUSIONS |
List of exception to exclude during synchronization for this type | |
SYNC_LIBS_EXCLUSIONS |
List of exception to exclude during synchronization for this type | |
SYNC_LICENSE_EXCLUSIONS |
List of exception to exclude during synchronization for this type | |
SYNC_EXECUTION_CONTEXT_EXCLUSIONS |
[extensions/workspace] |
List of exception to exclude during synchronization for this type |
SYNC_TMP_DIR_BASE_DIR |
$syncBaseDir/tmp |
Temporary folder for synchronization |
SYNC_TMP_DIR_EXTENSION_DIR |
$syncTmpBaseDir/extension |
Temporary folder for synchronization |
SYNC_TMP_DIR_JDBC_DIR |
$syncTmpBaseDir/jdbc |
Temporary folder for synchronization |
SYNC_TMP_DIR_LIBS_DIR |
$syncTmpBaseDir/lib |
Temporary folder for synchronization |
SYNC_TMP_DIR_LICENSE_DIR |
$syncTmpBaseDir/license |
Temporary folder for synchronization |
SYNC_TMP_DIR_EXECUTION_CONTEXT_DIR |
$syncTmpBaseDir/executionContext |
Temporary folder for synchronization |
SYNC_QUEUE_COMMAND |
__agentCommand |
ActiveMQ topic for sync commands |
CONNECTIONS_BASE_DIR |
$dataDir/connections |
Base directory for connection actions |
CONNECTIONS_TMP_DIR |
$connectionsBaseDir/connections |
Temporary directory for connection actions |
REPOSITORIES_BASE_DIR |
$dataDir/repositories |
Base data directory for repositories/Projects |
REPOSITORIES_INITIAL_AUTHOR |
RapidMiner AI Hub |
When a Project is created, the author of the commit |
REPOSITORIES_INITIAL_AUTHOR_MAIL |
noreply@rapidminer.com |
When a Project is created, the mail of the commit |
REPOSITORIES_INITIAL_MESSAGE |
Initialized project |
When a Project is created, the message of the commit |
REPOSITORIES_INITIAL_REFERENCE_NAME |
master |
When a Project is created, the default git reference of the commit |
REPOSITORIES_SAMPLE_ENABLED |
true |
If sample Projects are enabled and will be created during first start |
REPOSITORIES_SECRET_ALGORITHM |
AES256_GCM |
Algorithm used for secret encryption of a Project |
REPOSITORIES_BRANCH_PRIORITIES |
develop, dev, patch, master |
List branch priorities to go through for during reference lookup |
REPOSITORIES_CONTENT_RETRIEVAL_THRESHOLD |
5000 |
Maximum threshold in milliseconds to wait before timeout is responded with during content/ZIP creation |
REPOSITORIES_AUDIT_COMMIT_COUNT |
10 |
If audit is enabled, the maximum amount of commits to show in the audit log |
REPOSITORIES_MAX_UPLOAD_SIZE |
5120MB |
The maximum upload size |
REPOSITORIES_GIT_ENABLE_DISKSPACE_CHECK_HOOK |
true |
If main application should check available disk space during content upload |
REPOSITORIES_GIT_DISKSPACE_CHECK_THRESHOLD |
5120MB |
The minimum required available space during disk space check during content upload |
REPOSITORIES_LFS_ENABLE_DISKSPACE_CHECK |
true |
If main application should check available disk space during LFS content upload |
REPOSITORIES_MIN_LFS_DISKSPACE_CHECK_THRESHOLD |
5120MB |
The minimum required available space during disk space check during content upload |
REPOSITORIES_LFS_ENBLE_UPLOAD_SIZE_CHECK |
true |
If main application should verify that the uploaded LFS file has been stored correctly and sizes match |
REPOSITORIES_LFS_ENBLE_UPLOAD_CHECKSUM_CHECK |
true |
If main application should verify that the uploaded LFS file has been stored correctly and checksums match |
REPOSITORIES_LFS_REMOVE_UNSUCCESSFUL_UPLOADS |
true |
If main application should delete unsuccessful LFS uploads when an error popped up (size or checksum) |
AUDIT_ENABLED |
false |
If audit is enabled to see additional information about user changes |
REST_CLIENT_READ_TIMEOUT |
5000 |
Internally, the main application uses REST for some actions. Define the timeout in milliseconds. |
REST_CLIENT_CONNECTION_TIMEOUT |
5000 |
Internally, the main application uses REST for some actions. Define the timeout in milliseconds. |
PERMISSIONS_SCHEDULED_GROUP_CLEAN_UP_ENABLED |
true |
Enable check to verify if all groups present inside the main application's entities like Projects and Queues exist inside the external Identity Provider |
PERMISSIONS_SCHEDULED_GROUP_CLEAN_UP_INTERVAL |
3600000 |
Interval in milliseconds how frequently to check for group existence |
ENCRYPTION_SECRET_LOCATION |
$configDir/.secret |
File reference where the secret used for encryption of database rows is located |
LICENSE_AGENT_PROXY_URL |
The URL the License Agent will use to report to | |
LICENSE_AGENT_PROXY_CONNECTION_TIMEOUT |
30 |
The connection timeout to the proxy used by the License Agent |
LICENSE_AGENT_PROXY_RESPONSE_TIMEOUT |
30 |
The response timeout to the proxy used by the License Agent |
LICENSE_AGENT_MACHINE_ID |
The applications machine id, must be unique across different host machines, but can be identical for applications running on the same host | |
LICENSE_AGENT_APPLICATION_NAME |
AI Hub |
The application name the License Agent will report |
LICENSE_AGENT_POOL_SIZE |
5 |
The executor threads used by the License Agent to invoke heartbeats |
LICENSE_MODE |
ALTAIR_UNIT |
Enabled by default to use Altair Unit licensing. Requires *_LICENSE_AGENT_* and *_AUTH_* settings. Setting RAPIDMINER falls back to RapidMiner licensing |
LICENSE_LICENSE |
Directly set a RapidMiner license string | |
LICENSE_LOCATION |
By default, points to the parent folder where licenses reside in, e.g. $appHome/resources/licenses inside the Docker container |
|
LOGGING_... |
Set logging, e.g. LOGGING_LEVEL_COM_RAPIDMINER=DEBUG for debug logs of all RapidMiner classes |
|
BROKER_ACTIVEMQ_HOST |
localhost |
Define broker host |
BROKER_ACTIVEMQ_PORT |
61616 |
Define broker port |
BROKER_ACTIVEMQ_USERNAME |
Define broker user | |
BROKER_ACTIVEMQ_PASSWORD |
Define broker password | |
BROKER_ACTIVEMQ_URI |
Define broker URI | |
AIHUB_CONNECTION_PROTOCOL |
http |
Define AI Hub protocol for internal or external connectivity |
AIHUB_CONNECTION_HOST |
localhost |
Define AI Hub host for internal or external connectivity |
AIHUB_CONNECTION_PORT |
8080 |
Define AI Hub port for internal or external connectivity |
AIHUB_CONNECTION_CONTEXT_PATH |
api/v1/ |
Define AI Hub context path for internal or external connectivity |
Liquibase is used for schema creation and applies migrations automatically for context prod
.
Frontend
Property | Default | Description |
---|---|---|
REACT_APP_API_URL |
The URL to the main backend including the prefix, e.g. http://domain.tld:port/api/v1/ |
|
REACT_APP_KEYCLOAK_BASE_URL |
The URL to the identity provider, e.g. http://keycloak.domain.tld:port/ |
|
REACT_APP_KEYCLOAK_REALM |
AIHub |
The Keycloak realm |
REACT_APP_KEYCLOAK_CLIENT_ID |
aihub-frontend |
Frontend client id |
REACT_APP_KEYCLOAK_ON_LOAD |
login-required |
Frontend on load behavior |
REACT_APP_KEYCLOAK_SSL_REQUIRED |
NONE |
Frontend keycloak SSL behavior |
REACT_APP_LICENSE_CHECK |
300 |
Frontend configuration how frequently license expiration is checked and shown inside the UI |
REACT_APP_SCHEDULER_INFO_REFRESH |
10000 |
Frontend configuration how frequently scheduler information is checked inside the UI |
REACT_APP_HEADER_REDIRECT_ROOT |
true |
Frontend configuration if the top logo should redirect to / instead of the UI's default context path |
PUBLIC_URL |
/aihub/fe |
Do not change! Frontend context path which is used during build time |
Broker ActiveMQ
The following table outlines default producer and consumers used for internal communication between AI Hub Server and Job Agent components.
Please also the Job Agent's settings overview which use these broker queues.
Queue Name | Exclusive | Description | Queue Type | Consumer | Producer |
---|---|---|---|---|---|
DEFAULT |
false |
Default queue for job execution | Anycast | Job Agent | Job Service |
JobAgent.$JOB_AGENT_ID.__jobDeletion |
false |
Queue for each Job Agent for job deletion requests | Anycast | Job Agent | Job Service |
__agentHeartbeat |
false |
Queue for Job Agent heartbeat messages | Anycast | Job Service | Job Agent |
__agentCommand |
false |
Queue for command message, e.g. sync-, log- and stop requests, activation and deactivation messages | Multicast (PubSub) | Job Agent | Job Service |
__agentPersistence |
true |
Job Agent persistence queue | Anycast | Job Service | Job Agent |
__jobBatchUpdate |
true |
Queue for job update batch messages | Anycast | Job Service | Job Agent |
__jobLog |
false |
Queue for log messages | Anycast | Job Service | Job Agent |