OpenMRS Ebola Development Environment

Owned by Darius Jazayeri
Last updated: Feb 24, 2015
2 min read

OpenMRS Ebola involves taking the OpenMRS 2.x reference application, and adding an Ebola module on top of it. The instructions at Setting Up a Development Environment for OpenMRS 2.x are relevant, and more thorough, but the key points are summarized here:

Prerequisites

  • Java (1.6 or 1.7, but not 1.8)
  • Maven
  • Git
  • MySQL
  • bower
  • an IDE

Downloads:

You will need to clone these github repositories:

You also need to get the MVP-CIEL Concept Dictionary, which is distributed as a .sql dump. (either via Dropbox, as described in the link, or by asking another dev for it.)

Build OpenMRS core 1.10.x

git clone https://github.com/openmrs/openmrs-core.git
cd openmrs-core
git checkout -b 1.10.x origin/1.10.x
mvn clean install -DskipTests

Let OpenMRS create an empty database for you

You probably want to do this in your IDE, with VM settings like these: -Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m

cd .../openmrs-core/webapp
mvn jetty:run

Go through the first-time installation wizard choosing Advanced, and No Demo Data.

Let the OpenMRS Reference Application set up its data

Get all the Reference Application modules (except for "reference demo data") and install these:

git clone https://github.com/djazayeri/openmrs-distro-ebola-kerrytown.git
cd openmrs-distro-ebola-kerrytown
mvn clean package -DskipTests
cp package/target/distro/*.omod ~/.OpenMRS/modules
rm ~/.OpenMRS/modules/referencedemodata*.omod

Restart jetty.

Wait for several minutes while various OpenMRS modules create data.

Install the CIEL concept dictionary

Get the MVP-CIEL Concept Dictionary, which is a .sql dump file.

Using whichever mysql client, run this on top of your openmrs database (which will drop, re-create, and populate the concept* tables).

Install the Ebola module

git clone https://github.com/openmrs/openmrs-module-ebolaexample.git
cd openmrs-module-ebolaexample
mvn clean install
cp omod/target/*.omod ~/.OpenMRS/modules

Restart jetty.

When OpenMRS is available, you should see a login screen giving you the option of choosing from a few locations (currently they are "Assessment" and "Inpatient Wards", but you should not see "Outpatient Clinic").

A Few More Things

You need to use the system with a user account that has a provider attached to it. Either create yourself a new OpenMRS user, or use the admin one, and go to http://localhost:8080/openmrs/admin/provider/index.htm and do Add Provider.

After the installation is done, the command bellow can provide you a easy way to make changes in the local repository and get it running without recompiling the full module:

mvn jetty:run -DuiFramework.development.ebolaexample=/path/to/your/openmrs-module-ebolaexample