Deprecated. Use RADAR-Kubernetes repository.
The dockerized RADAR stack for deploying the RADAR-base platform. Component repositories can be found at RADAR-base DockerHub org.
โ Important Notice |
---|
We have made a lot of improvements to the RADAR-based platform over the past years. One of the key improvements is migrating to Kubernetes based deployment to allow automated application deployment, scaling, and management. Please note that the RADAR-Docker stack is not actively maintained and will be deprecated by the end of 2021. Hence, we strongly recommend you to set-up the Kubernetes based installation of the platform. You can find the installation guidelines from the RADAR-Kubernetes repository. Please be informed that we are still working on improving our documentation. If you would like to contribute by improving the documentation or providing feedback, please contact the RADAR-base community via slack. |
To install RADAR-base stack, do the following:
-
Install Docker Engine
-
Install
docker-compose
using the installation guide or by following our wiki. -
Verify the Docker installation by running on the command-line:
docker --version docker-compose --version
This should show Docker version 1.12 or later and docker-compose version 1.9.0 or later.
-
Install git for your platform.
-
For Ubuntu
sudo apt-get install git
-
-
Clone RADAR-Docker repository from GitHub.
git clone https://github.com/RADAR-base/RADAR-Docker.git
-
Install required component stack following the instructions below.
RADAR-Docker currently offers two component stacks to run.
- A Docker-compose for components from Confluent Kafka Platform community
- A Docker-compose for components from RADAR-base platform.
Note: on macOS, remove
sudo
from alldocker
anddocker-compose
commands in the usage instructions below.
Confluent Kafka platform offers integration of the basic components for streaming such as Zookeeper, Kafka brokers, Schema registry and REST-Proxy.
Run this stack in a single-node setup on the command-line:
cd RADAR-Docker/dcompose-stack/radar-cp-stack/
sudo docker-compose up -d
To stop this stack, run:
sudo docker-compose down
In addition to Confluent Kafka platform components, RADAR-base platform offers
- RADAR-HDFS-Connector - Cold storage of selected streams in Hadoop data storage,
- RADAR-MongoDB-Connector - Hot storage of selected streams in MongoDB,
- RADAR-Dashboard,
- RADAR-Streams - real-time aggregated streams,
- RADAR-Monitor - Status monitors,
- RADAR-HotStorage via MongoDB,
- RADAR-REST API,
- A Hadoop cluster, and
- An email server.
- Management Portal - A web portal to manage patient monitoring studies.
- RADAR-Gateway - A validating gateway to allow only valid and authentic data to the platform
- Catalog server - A Service to share source-types configured in the platform. To run RADAR-base stack in a single node setup:
-
Navigate to
radar-cp-hadoop-stack
:cd RADAR-Docker/dcompose-stack/radar-cp-hadoop-stack/
-
Follow the README instructions there for correct configuration.
Set up a logging service by going to the dcompose-stack/logging
directory and follow the README there.
The two following stacks will not work on with only Docker and docker-compose. For the Kerberos stack, the Kerberos image is not public. For the multi-host setup, also docker-swarm and Docker beta versions are needed.
In this setup, Kerberos is used to secure the connections between the Kafka brokers, Zookeeper and the Kafka REST API. Unfortunately, the Kerberos container from Confluent is not publicly available, so an alternative has to be found here.
$ cd wip/radar-cp-sasl-stack/
$ docker-compose up
In the end, we aim to deploy the platform in a multi-host environment. We are currently aiming for a deployment with Docker Swarm. This setup uses features that are not yet released in the stable Docker Engine. Once they are, this stack may become the main Docker stack. See the wip/radar-swarm-cp-stack/
directory for more information.