eSaude EMR Install Guide

This guide will describe how to install eSaude EMR on Ubuntu. To understand the difference between eSaude EMR Platform and eSaude EMR POC see the versions page.

eSaude EMR Platform

Follow the instruction below to manually install the eSaude EMR Platform. To automatically set up an environment using Docker, see the instructions here (or here if you want to include the POC system in the Docker setup).

1. Install Prerequisite Software

  • Java
    • See downloads here. Java 7 is recommended for now, but Java 8 should also work.
    • To install on Ubuntu run sudo apt-get install openjdk-7-jdk.
    • See this wiki page for instructions on how to allocate more memory for Tomcat. On Ubuntu you can copy this script to /usr/share/tomcat7/bin/ and restart Tomcat.
  • Apache Tomcat 7
    • See generic install instructions here.
    • To install on Ubuntu run sudo apt-get install tomcat7.
  • MySQL Server 5.6
    • Download MySQL Server for Windows and Mac here.
    • To install on Ubuntu run sudo apt-get install mysql-server.

2. Configure Database

Connect to MySQL server on the command line as follows:

$ mysql -uroot -p

You will have to enter the root password you chose when installing MySQL server.

Create a database called openmrs and a user called esaude with password, say, esaude. This can be done by executing the following command:

CREATE USER 'esaude'@'localhost' IDENTIFIED BY 'esaude';

Grant the esaude user all permissions on the openmrs database:

GRANT ALL ON openmrs.* TO 'esaude'@'localhost' IDENTIFIED BY 'esaude';

Finally, download the latest eSaude EMR Platform database from here, extract it and import it as follows:

$ mysql -uroot -p openmrs < esaude-platform-database.sql

3. Deploy eSaude EMR Platform

First we need to create a working directory for OpenMRS called .OpenMRS (note the .). On Ubuntu it should be located at /usr/share/tomcat7/.OpenMRS. See this wiki page for the location on other platforms.

Create the eSaude EMR Platform runtime settings file at /usr/share/tomcat7/.OpenMRS/ with the content listed below.


Make sure connection.username and connection.password match the MySQL user you created above.

Download the eSaude EMR Platform modules here and copy all of the .omod files into the /usr/share/tomcat7/.OpenMRS/modules/ folder.

Lastly, copy the openmrs.war file from here into the /var/lib/tomcat7/webapps/ folder and restart Tomcat. On Ubuntu, this is done as follows:

$ sudo service tomcat7 restart

4. Access

  • user: admin
  • pass: eSaude123

eSaude EMR Point of Care

To set up the eSaude EMR POC system automatically with Docker (including eSaude EMR Platform) see this repository. To manually install the POC system see the instructions in the repository README.