You are viewing the RapidMiner Hub documentation for version 10.0 - 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_SECRET |
The secret for aihub-backend 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?consumer.exclusive=true |
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 |
__jobUpdate?consumer.exclusive=true |
ActiveMQ persistence topic for handling job states. |
JOBSERVICE_QUEUE_JOB_DELETION |
VirtualTopic.__jobDeletion |
ActiveMQ persistence topic for handling job deletion. |
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_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 |