Tom and the Toothfairies

Note: this document is written in Markdown. While it can be easily read in a text editor, we recommend viewing our documentation on Github for maximum convenience - click-able links for example

This file contains instructions on how to install and run the project, as well as an overview of the project's design. The target platform is Ubuntu 16.04.

At the time of writing the current release is 2.0

Installing Dependencies

This project uses Docker and Docker Compose. An installation script, install-docker.sh, is provided for Ubuntu 16.04.

$ ./install-docker.sh

For platforms other than Ubuntu, follow the installation instructions on the Docker Website. Note - on other platforms, sudo is not required for Docker commands.

You can test your Docker installation by running Docker's built in hello-world:

$ sudo docker run hello-world

Running

The project can be run with Docker Compose:

$ sudo docker-compose up -d

The system is then accessible at localhost:4000.

To stop the system, run the following command

$ sudo docker-compose down

Features

Release 2

The feature list for Release 2 can be found in the Release 2 features document.

Release 1

The feature list for Release 1 can be found in the Release 1 features document.

Change Log

Changes to the project are recorded in the change log.

Architecture Overview

The system is split into three distinct services; Panacea, Asclepius and Chiron. The auxiliary service, Athloi, is used for automated testing. They each run inside a Docker container. The containers can be easily managed using docker-compose as mentioned earlier.

Panacea

Panacea is responsible for the UI and PML analysis. It is a web application that serves the UI and exposes an API for uploading PML files for analysis.

More information about Panacea can be found in the Panacea README.

Chiron

Chiron houses the DINTO data. The data is compiled into a triple store. Chiron exposes a HTTP API for querying the triple store.

More information about Chiron can be found in the Chiron README.

Asclepius

Asclepius acts as an intermediary between Panacea and Chiron. It accepts requests to identify DDIs from Panacea, creates the necessary SPARQL query and passes it on to Chiron.

More information about Asclepius can be found in the Asclepius README.

Athloi

Athloi is the service that runs our end to end tests.

More information about Athloi can be found in the Athloi README.

Building Manually

Docker Compose will pull down the required versions of each service from Docker Hub when you run the project. If for some reason you wish to build these services manually, instructions for doing so can be found in the manual build documentation.