Deployment guide

Deployment Guide

This page goes through the process of setting up the application in development and production environments. Please note that the instructions provided in this guide are not the only way this can be deployed, there are other ways (see this for example) but what we have here is what we are in a position to help with in case something goes wrong.

Standalone setup

The HIS-EMR-API integrates with various external services like LIMS and DDE, this section however focuses on setups without these components.

Requirements

• HIS-EMR-API
• MySQL 5.6 or MariaDB
• Ruby 2.5 (Ruby 2.6 should also work and 2.7 with some warnings)
• [git]
• Ubuntu 18.04 (Any other recent GNU/Linux should also work without too many issues)

The following tools may be used to ease installation of some of the requirements above

• Docker (Required for MySQL 5.6 installation)
• Ruby Version Manager (Something else like asdf or rbenv can be used, required for Ruby 2.5).

Setting up for development

Ensure that a Ruby version manager and docker have been installed before proceeding. Follow the links in the previous section to find out how to install it.

1. MySQL installation

   sudo docker run -d -p 3306:3306 --name=mysql-8 -e MYSQL_ROOT_PASSWORD=password mysql:latest

   The command above downloads and starts MySQL 5.6. It start running on port 3306 with the root user password just set to password (you want to change that before running the command). After this you can start the server manually by running sudo docker start mysql-5.6.

2. Ruby 2.5 installation

   sudo apt install build-essential
   
   rvm install ruby-2.5

3. Clone this repository