Getting started

A Quick start.

Hardware Requirements

A machine that has 24 RAM is advised, less than that may cause performance issues.

Software Requirements

The following tools are needed to run/deploy the stack:

• Git CLI

• WSL2 (for windows users)

• Docker

You will need first to clone the project on your machine.

• If you're a Windows user, you should limit the amount of RAM/CPU that will be used by WSL, for more details please check the following link: Limiting memory usage in WSL2.

• You should run the following command to initialize docker swarm on your machine: docker swarm init.

Prerequisites

• Docker Swarm

• Terraform (for remote deployments to AWS only)

• Ansible (for remote deployments only)

• Platform Cli

What is Cares on Platform?

Cares on Platform aims to provide a set of services working together to consume raw COVID data in FHIR format in order to produce reports and visualizations.

This service will use, transform, and flatten the data to get the expected output and produce reports.

It is aimed to be working in Single mode as well as Cluster mode with the ability to handle big data.

It is an implementation of the general project Platform and it is developed to act as a custom package alongside some of the base packages in the Platform.

What should I know before starting to develop?

It is advised to take a look at Platform CLI docs, as well as Jembi Platform docs to understand the basics of the CLI and the packages used in this project.

Quick Start for Devs

The following steps provide a quick start to Cares on platform:

1. Clone the GitHub repository for the project.
2. In your terminal, navigate to the project root directory and run the command: ./get-cli.sh to download the platform-cli executable for your operating system[linux|windows|macos]. Example: ./get-cli.sh linux to download the binary for use on Linux.
3. According to your arguments provided in the first command, it downloads one or three executable files platform-linux | platform-macos | platform.exe. Now you should edit the command in the deploy-local.sh file. It should make use of the executable suitable for your operating system (the default: platform-linux).

4. Ensure docker is installed on your machine, and run the command docker swarm init to initialize a docker swarm.

5. To start up the project run the command./deploy-local-combo.sh init .

The following options can be passed to the ./deploy-local-combo.sh command:

• init for initializing the services

• down for stopping the services

• up for bringing the services up

• destroy for removing the services

What I expect to see ?

Running the deploy-local.sh script will spin up the services. You can run: docker service ls to view the current running services.

You can check the sub-section Local deployment to check the expected running services.

Need more info ?

You can check the Overview section for more understanding.

For more info on components and services, view Design & Architecture.

The section Launching & Local Testing will detail which services should be up and running and how to test all the flow.

The section Troubleshooting & Monitoringwill explain the steps to locate and issue if you're facing one.

The section Deployment will mention more options for starting the stack.