You are viewing the RapidMiner Deployment documentation for version 9.7 - Check here for latest version
Image Architecture
RapidMiner Server cloud images are implemented as Docker images. We provide a base CentOS image with a Docker layer installed, and we start the additional components, including
- the PostgreSQL database,
- RapidMiner Server, and
- the Job Agent
as three separate Docker containers, using a Docker Compose definition
similar to the sample docker-compose.yml
configuration provided for the
RapidMiner Server Docker image.
The PostgreSQL Docker container functions as the database backend for these images;
the database username and password can be found in the file /rapidminer/docker/docker-compose.yml
.
Connect to the instances using SSH
Authentication
Both the Amazon AWS and Microsoft Azure cloud platforms provide SSH access to the server instances.
- On Amazon AWS, you can specify the SSH key-pair to use, and the SSH username is fixed (
centos
) in the image. - On Microsoft Azure, you can specify the ssh username and password or SSH key within the instance creation wizard.
Filesystem layout
After you connect to the image, you will find the RapidMiner Server files located in the /rapidminer
subfolder.
docker/docker-compose.yml
defines the Docker containers, the network connections, the volumes and the required enviroment variables.docker/rapidminer-home
contains the volume holding the persistent data in the RapidMiner Server home directory.docker/pgsql
contains the volume holding the persistent data in the the PostgreSQL database.
Configure RapidMiner Server
To configure RapidMiner Server, you follow one of two paths:
- The usual way: the RapidMiner Server home directory page describes the location of extensions, JDBC drivers and licenses.
The Docker way: in the
docker-compose.yml
configuration file, you can change the predefined values of the environment variables:- Define an external database (e.g. use an RDS instance in AWS) by setting the database-related environment variables in the
rapidminer-server
service. - Redefine the resource allocation for Job Agents by setting the environment variables in the
job-agent
service.
- Define an external database (e.g. use an RDS instance in AWS) by setting the database-related environment variables in the
Restart the Docker instances
After any configuration changes, you should restart RapidMiner Server or the Job Agents by restarting the Docker containers, with (in the simplest cases) the following commands:
sudo docker-compose -f /rapidminer/docker/docker-compose.yml down
sudo docker-compose -f /rapidminer/docker/docker-compose.yml up -d
Check the logs
The logs for RapidMiner Server, Job Agent, or PostgreSQL database are written to the Docker container's console. The logs for RapidMiner Server are also written to rapidminer-home/log/server.log
. To check the Docker container console outputs, you can execute one of the following commands (and terminate it by hitting Ctrl+C):
sudo docker-compose -f /rapidminer/docker/docker-compose.yml logs -f rapidminer-server
sudo docker-compose -f /rapidminer/docker/docker-compose.yml logs -f job-agent
sudo docker-compose -f /rapidminer/docker/docker-compose.yml logs -f database