KenyaEMR Installation Guide

KenyaEMR can be installed in the following ways

As a developer from the source code (see the KenyaEMR Developer Guide)
As an implementer from a distribution release (See the KenyaEMR installation guide). You can also find a video instruction from here.

KenyaEMR Installation environment is supported on both Ubuntu server and Ubuntu Desktop. The current KenyaEMR version (17.3.3) can be installed on Ubuntu Version 16.04LTS and 18.04LTS respectively.

Requirements

OpenMRS 1.9.7 or higher
MySQL server 5.6
Java JDK 7 or higher
Tomcat 7 or 8
Web browser

If you do not have a suitable OpenMRS installation, then you can follow these instructions for Prerequisites setup.

Don't install the demo data during OpenMRS installation as this will conflict with the metadata included in KenyaEMR. There should be no pre-existing data in OpenMRS prior to installation.

Installing from a distribution release

Some of the modules included in KenyaEMR require the scheduler.username and scheduler.password settings (formerly Global Properties from platform 1.8 downwards) to be set correctly. If these are not set correctly you may end up locked out of OpenMRS.

Distribution releases for KenyaEMR v12.x to 15.x are available from this Google Drive folder while the latest version is available in the KenyaHMIS GitHub link. Each release consists of two archives - the distro and the SQL dump containing the required concepts for that release.

Stop Tomcat
Extract the concepts SQL dump file from the SQL archive. Run this on the OpenMRS database which you will use with KenyaEMR
Delete all existing .omods from your OpenMRS modules folder
Extract the distro archive into your OpenMRS modules folder
Start Tomcat

Note:

For implementers distributions, most of the above processes have been fairly automated for non-technical users. During upgrades, the users only need to execute a simple shell script that deploys all the required dependencies in the correct places. Refer to user guide on KenyaEMR upgrade here.