MedCo Technical Documentation
GithubDocker HubMedCoLDS
v0.2.1
v0.2.1
  • Home
  • Releases
  • System Administrator Guide
    • Specifications
    • Deployment
      • Local Test Deployment
      • Network Test Deployment
      • Local Development Deployment
    • Configuration
      • Keycloak Configuration
      • HTTPS Configuration
      • The PostgreSQL database
      • Configuring SwitchAAI Authentication
    • Loading Data
      • v0 (Genomic Data)
      • v1 (I2B2 Demodata)
    • Command-Line Interface (CLI)
    • Network Architecture
  • Developer Guide
    • System Architecture
    • Description of the default test data
Powered by GitBook
On this page
  • MedCo Stack Deployment (except Glowing Bear)
  • Glowing Bear Deployment
  • Keycloak Configuration
  • Test the deployment

Was this helpful?

Export as PDF
  1. System Administrator Guide
  2. Deployment

Local Development Deployment

Profile dev-local-3nodes

This deployment profile deploys 3 MedCo nodes on a single machine for development purposes. It is meant to be used only on your local machine, i.e. localhost. The tags of the docker images used are all dev, i.e. the ones built from the development version of the different source codes. They are available either through Docker Hub, or built locally.

MedCo Stack Deployment (except Glowing Bear)

First step is to clone the medco-deployment repository with the correct branch. This example gets the data in the home directory of the current user, but that can be changed.

$ cd ~
$ git clone -b dev https://github.com/ldsec/medco-deployment.git

Next step is to build the docker images:

$ cd ~/medco-deployment/compose-profiles/dev-local-3nodes
$ docker-compose build

Note that instead of building the dev docker images locally, it is possible to download them from Docker Hub by using docker-compose pull, but there is no guarantee on the current status of those images are they are automatically built.

Next step is to run the nodes. They will run simultaneously, and the logs of the running containers will maintain the console captive. No configuration changes are needed in this scenario before running the nodes. To run them:

$ docker-compose up

Wait some time for the initialization of the containers to be done (up to the message: “i2b2-medco-srv… - Started x of y services (z services are lazy, passive or on-demand)”), this can take up to 10 minutes. For the subsequent runs, the startup will be faster.

Glowing Bear Deployment

First step is to clone the glowing-bear repository with the correct branch.

$ cd ~
$ git clone -b dev https://github.com/ldsec/glowing-bear-medco.git

Glowing Bear is deployed separately for development, as we use its convenient live development server:

$ cd ~/glowing-bear-medco/deployment
$ docker-compose up dev-server

Note that the first run will take a significant time in order to build everything.

In order to stop the containers, simply hit Ctrl+C in all the active windows.

Keycloak Configuration

Test the deployment

PreviousNetwork Test DeploymentNextConfiguration

Last updated 5 years ago

Was this helpful?

Follow the instructions from to be able to use Glowing Bear.

In order to test that the development deployment of MedCo is working, access Glowing Bear in your web browser at http://localhost:4200 and use the credentials previously configured during the . If you are new to Glowing Bear you can watch the video.

By default MedCo loads a specific test data, refer to for expected results to queries. To load a dataset, follow the guide . For reference, the database address (host) to use during loading is localhost:5432 and the databases i2b2medcosrv0, i2b2medcosrv1 and i2b2medcosrv2.

Keycloak Configuration
Keycloak Configuration
Glowing Bear user interface walkthrough
Description of the default test data
Loading Data