/
Example: DRC EMR: Offline or Air-Gapped Installations SOP

Example: DRC EMR: Offline or Air-Gapped Installations SOP

Overview

In situations where the instance running the project is not connected to the internet we provide pre-packaged images which can be loaded on the instance. To obtain the image check under the Releases section and download the path-drc-emr-images-bundle.tgz file.

Pre-Requisites

Minimum Hardware Requirements

We recommend selecting your hardware and system requirements based on real-world needs, such as the number of users or expected patient records.

These specifications assume a bare metal installation of the OS. Running OpenMRS as a VM on a Windows computer for any production use is NOT recommended.

  • Minimum (1-10 users): Quad-core or higher desktop-class processor, 8 GB RAM, 100+GB HDD

  • Recommended (10+ users): 8 Core+ processor, 16 GB RAM, 100+ GB HDD in RAID configuration, with backup facilities

Internet Connectivity

Not required. Implementors are advised to download the path-drc-emr-images-bundle.tgz , the docker-compose.yml and the docker-compose-restore.yml file on a flush disk and copy the files to the offline environment. The actual installation does not require internet connectivity

Getting Started with Offline Installation

  1. Create a folder on your environment

offline 1.png

  1. Copy the docker-compose.yml, docker-compose-restore.yml and the path-drc-emr-images-bundle.zip files to the folder

offline 2.png

  1. Open the folder on terminal. A simple list command shows the content of the folder

offline 3.png

  1. Unzip the bundled images by typing the command:

    unzip path-drc-emr-images-bundle.zip
offline 4.png

  1. List the content of the folder the bundled images that have been unzipped have a .tgz extention

offline 5.png

  1. Unzip the .tgz extension bundle containing the images by typing the command:

offline 6.png
offline 7.png

  1. List the content of the folder and change the directory to the folder that contains the unzipped images.

offline 8.png

  1. List the content of the folder then load the images by typing the command:

    ./load-images.sh
offline 9.png

images will be loaded successfully

offline 10.png

  1. Change directory back to the installation folder and type the command:

docker compose up
offline 11.png

the offline containers will be spined up. Notice the machine does not require an internet connection

offline 12.png

  1. OpenMRS Legacy UI is accessible at http://localhost/openmrs

offline 13.png

Upon successful installation the login page will be displayed

offline 14.png

  1. The new OpenMRS UI is accessible at http://localhost/openmrs/spa

offline 15.png