Categories

Versions

You are viewing the RapidMiner Scoring-agent documentation for version 9.6 - Check here for latest version

RapidMiner Real-Time Scoring cloud images

RapidMiner Real-Time Scoring cloud images are available for the following platforms. For details, choose a marketplace.

The preinstalled images include the components described in the Multi-container-based deployment page.

From within an AWS or Azure account, these images can be instantiated up in minutes.

There are two approaches to the license:

  1. Bring Your Own License (BYOL): use a RapidMiner license that you have already purchased, or

  2. Pay As You Go (PAYG): pay for the license as an add-on to the AWS/Azure cost.

Launch a RapidMiner Real-Time Scoring instance in the same way as any other instance on the Azure or AWS marketplaces, by selecting the appropriate AMI / Virtual Machine in the Launch Wizard.

After the AMI / Virtual Machine is ready, you can use the Web UI to:

  • provide deployments exportted from RapidMiner Server,
  • manage ssl certificates,
  • provide license (in case of BYOL),
  • manage access controll, and
  • check status of the RapidMiner Real-Time Scoring Agent.

Image architecture

As an advanced topic, the architecture of the image is described below, it can be useful if you want to tweek security or do some debugging.

RapidMiner Real-Time Scoring cloud images are constructed to use the Docker images using docker-compose.

We provide a base CentOS image with a Docker layer installed, and we start the additional components, including

  • RapidMiner Real-Time Scoring
  • a reverse proxy
  • the Web UI
  • a cron container

as separated Docker containers, using a Docker Compose definition.

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 Real-Time Scoring files located in the /rapidminer subfolder.

  • docker/docker-compose.yml defines the Docker containers, the network connections, and the volumes.

If you want additional persistent storage, for example for the access logs of the reverse proxy, you can define a new volume in the docker-compose.yml file above, and use it in the proxy container.

Restart the Docker instances

After any configuration changes outside of the Web UI, you should restart RapidMiner Real-Time Scoring by restarting its Docker container, with (in the simplest cases) the following commands:

docker-compose -f /rapidminer/docker/docker-compose.yml down
docker-compose -f /rapidminer/docker/docker-compose.yml up -d

Check the logs

The logs for RapidMiner Real-Time Scoring are written to the Docker container's console. To check the Docker container console outputs, you can execute one of the following commands (and terminate it by hitting Ctrl+C):

docker-compose -f /rapidminer/docker/docker-compose.yml logs -f real-time-scoring-agent
docker-compose -f /rapidminer/docker/docker-compose.yml logs -f nginx-proxy
docker-compose -f /rapidminer/docker/docker-compose.yml logs -f real-time-scoring-webui
docker-compose -f /rapidminer/docker/docker-compose.yml logs -f cron

Tweek reverse proxy

The default reverse proxy configuration is inside the docker image, but you can override it with a custom nginx configuration file using a volume, or a bind mount. Before doing the customizations, it's a good practice to copy the contents of the built in proxy configuration into a file in the cloud instance filesystem.

mkdir /rapidminer/nginx
docker-compose exec nginx-proxy cat /etc/nginx/conf.d/default.conf /rapidminer/nginx/custom.conf

And then edit docker/docker-compose.yml:

...
nginx-proxy:
    image: rapidminer/rapidminer-real-time-scoring-proxy:latest
    restart: "always"
    volumes:
      - uploaded:/rapidminer/uploaded/:ro
      - /rapidminer/nginx/custom.conf:/etc/nginx/conf.d/default.conf:ro
...