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:
- Java (1.6 or 1.7, but not 1.8)
- an IDE
You will need to clone these github repositories:
Build OpenMRS core 1.10.x
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
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:
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
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: