eSaude EMR Upgrade Guide

This guide will describe how to upgrade to the various releases of eSaude EMR. To understand the difference between releases, see the eSaude EMR versions page.

Upgrade From v1.1.0 to v1.2.0

The main difference between v1.1.0 and v1.2.0 is an upgraded OpenMRS and a few added modules to support the platform functionality (i.e. RESTful web services). To upgrade, follow the same instructions as below, but use the OpenMRS v1.11.5 WAR file and the eSaude EMR Platform v1.2.0 modules.

If you are planning to use the point of care system, you will most likely have to manually make some metadata changes as described in the "Metadata Changes" sections of this wiki page.

Upgrade From v1.0.0 to v1.1.0

The main difference between eSaude EMR v1.0.0 and v1.1.0 is that the version of OpenMRS is updated to v1.11.3. The reporting and calculation module are also upgraded to support the new OpenMRS version. 

To perform this upgrade you will need to download the new OpenMRS WAR file and the new modules.

Use the following steps to perform the upgrade.
  1. Backup eSaude EMR

    $ mysqldump -uroot -p openmrs > esaude-emr-backup-`date +%y-%m-%d`.sql

  2. Stop Tomcat

    $ sudo service tomcat7 stop

  3. Replace OpenMRS WAR file

    First remove old OpenMRS

    $ sudo rm -rf /var/lib/tomcat7/webapps/openmrs*

    Copy in new WAR file

    $ sudo cp /path/to/new/openmrs.war /var/lib/tomcat7/webapps/

    Make sure the tomcat user is the owner of the file

    $ sudo chown tomcat7:tomcat7 /var/lib/tomcat7/webapps/openmrs.war

  4. Add new modules

    First remove old modules

    $ sudo rm /usr/share/tomcat7/.OpenMRS/modules/*

    Copy in new modules

    $ sudo cp /path/to/new/ /usr/share/tomcat7/.OpenMRS/modules/

    Extract modules

    cd /usr/share/tomcat7/.OpenMRS/modules/ && sudo unzip

    Make sure the tomcat user is the owner of the modules

    sudo chown tomcat7:tomcat7 /usr/share/tomcat7/.OpenMRS/modules/*

  5. Start Tomcat

    sudo service tomcat7 start

The next time you open the eSaude EMR application, you will be asked to enter the admin username and password. You will then be shown a list of database updates that need to run. Click the 
button at the bottom of the page to run the updates. When the updates are complete you will be asked to log into eSaude EMR v1.1.0.

If you see a message like: 

An error has occurred!

Clear your browser cookies and cache and try again to log in.