Platform Release Notes 2.0.0

On this page:

Introducing OpenMRS Platform 2.0.0

When OpenMRS reached 2.0, we decided to allow the platform – application programmer interface (API) and web services – to develop and grow separately from the web application.  As a result, we have named the API and web services "OpenMRS Platform" and will continue to call our web-based medical record system "OpenMRS".

  • OpenMRS – this continues to refer to our web-based medical record system.

  • OpenMRS Platform – going forward, this refers to the API, REST Web Services, together with the FHIR and Open Web Apps modules.  The user interface components have been removed from the platform and released as a separate legacyui module.

This release is the "OpenMRS Platform 2.0.0" – it is the release version of the under-the-hood OpenMRS API that follows the OpenMRS 1.12.x line. 

The next release of the reference application 2.5 will use this platform version.

Note: This platform release requires Java 1.8 and above.

Release date: Thursday, 28 July 2016

Release ManagerMayank Sharma

What's in OpenMRS Platform 2.0.0?

OpenMRS Platform 2.0.0 is shipped with 201 bug fixes, 65 new features and other issues.

All methods and classes which were deprecated as per 1.11.0 have been removed.

The major milestones accomplished in this release include :

  1. Migrate to latest tech-stack : Java8, Hibernate 4.x, Spring 4.x
  2. Add FHIR support
  3. Add support for Open Web Apps (OWA)
  4. Introduce Allergy API in core
  5. Removal of deprecated methods
  6. Support all core services via REST-WS module
  7. Support Legacy-UI as a module

Bug Fixes

key summary status resolution

Unable to locate Jira server for this macro. It may be due to Application Link configuration.

New Features

key summary status resolution

Unable to locate Jira server for this macro. It may be due to Application Link configuration.


key summary status resolution

Unable to locate Jira server for this macro. It may be due to Application Link configuration.

Database Changes:

* Updating layout.address.format global property

* Removing dashboard.regimen.standardRegimens global property

* Encrypting the users.secret_answer column

* Temporarily removing foreign key constraint from person_attribute_type.edit_privilege column

* Temporarily removing foreign key constraint from role_privilege.privilege column

* Increasing the size of the privilege column in the privilege table

* Adding foreign key constraint to person_attribute_type.edit_privilege column

* Increasing the size of the privilege column in the role_privilege table

* Adding foreign key constraint to role_privilege.privilege column

* Adding foreign key on patient_identifier.patient_id column

* Add changed_by column to encounter_type table

* Add date_changed column to encounter_type table

* Create allergy table

* Create allergy_reaction table

* Add allergy_status field to the patient table

* Custom changeset to migrate allergies from old to new tables

* Removing the active_list_problem table (active_list feature removed)

* Removing the active_list_allergy table (active_list feature removed)

* Removing the active_list table (active_list feature removed)

* Removing the active_list_type table (active_list feature removed)

* Adding address columns (7-15) to person_address and location

* Removing a column value_boolean from obs table

* Converting values in drug_order.dosing_type column from SIMPLE to org.openmrs.SimpleDosingInstructions (TRUNK-4845)

* Converting values in drug_order.dosing_type column from FREE_TEXT to org.openmrs.FreeTextDosingInstructions(TRUNK-4845)

* Creating concept_attribute_type table

* Creating concept_attribute table

* Add "Get Visits" privilege

* Add "Get Providers" privilege

* Add "Add Visits" privilege

* Add "Get Visits" privilege to the roles having "Get Encounter"

* Add "Get Providers" privilege to the roles having "Get Encounter"

* Add "Add Visits" privilege to the roles having "Add Encounters"

* Add "Add Visits" privilege to the roles having "Edit Encounters"


Bundled Modules:

These modules are bundled with OpenMRS Platform 2.0.0. They are started automatically and can be removed if desired.


MVP Dictionary:

  • openmrs_concepts_1.11.2_20160711


Download OpenMRS 2.0.0


  • Unzip the downloaded OpenMRS Platform 2.0.0 zip file. (For linux users; this needs to be in an ext file system type, most partitions created with and having windows formats will not work since the installation needs to change file permissions which ubuntu allows for only ext file systems - TODO add reference)
  • Change directory into the openmrs-standalone-2.0.0 folder and then run the standalone using the java -jar openmrs-standalone.jar command.
  • The openmrs standalone window will show up and you can proceed from there.
  • The installation provide you three options but most the times you will use either the demonstration or fresh installation (comes with the above mentioned concept dictionary).


Below are some key conditions that need to be satisfied before attempting an upgrade because they are guaranteed to halt the upgrade if they are not.

Consider using our upgrading guide. In summary for Standalone 1.12.x or any other upgrade to 2.0.0, follow this guide:

  • Back up your database to be on the safe side in-case something goes wrong, use either the Database Backup Module or refer to the MySQL Backup guide.
  • Stop all the Modules and logout of openmrs if possible.
  • Close the openmrs standalone window
  • Download the OpenMRS Platform 2.0.0 from sourceforge and replace the war file in your previous standalone located under tomcat/webapps folder (also delete the openmrs-standalone folder) with the newly downloaded war file.
  • Now re-run the standalone again, you will go through the database upgrade process (maintenance mode) by signing in as an administrator when prompted.
  • We have tested upgrading from Platform 1.11.6, and 1.12.0 to 2.0.0 and all those upgrades were successful. So have no worries

Module Developers

Module developers who would like to support both platform 2.0 and below, you can take a look at this guide.


Thanks to you all that have made 2.0.0 a success The people we have worked with to get 2.0.0 out and released to the whole community, Here are they by their names:

Aashna Garg, Achinta Roy, Adam GrzybkowskiAkshika Wijesundara, Alexei Grigoriev, Alexis Duque, Ankur GoyalArkadiusz Kołodziejski, Bhavana Ramasayam, Břetislav Hájek, Burke Mamlin, Cathy Chen, Chethan A, Cintia Del RioClifton McIntosh, Cosmin Ioan, Daniel Kayiwa, Darius Jazayeri, Dave Lahn, David Churcher, David DworkenErick WafulaFernando Barbosa, Filip Biedrzycki, Gaurav Narula, Geoffrey Wasilwa, Haolan Chen, Harsha Kumara, Imran Tatriev, Ivange Larry, Ivo Ulrich, Jakub Buczyński, Jakub Kondrat, James deGraft-Johnson, Jason Vena, Jennifer PariseJessica ErnJie ChenJudy Gichoya, Julius Duic, Kaweesi JosephKishore Yekkanti, Kristopher Schmidt, Lluis Martinez, MA Corrales, Manika Maheshwari, Mark Goodrich, Mayank Sharma, Michael Downey, Michael Hofer, Michael Souza, Mihir Khatwani, Mike SeatonMikko Suniala, Milan KarunarathneMyrle Krantz, Nadeeshani PathiranaNAGASOWMYA MAJETY, Namrata NeheteNicholas Folk, nilmadab mondal, Owolabi Legunsen, Pascal BrandtPaweł GutkowskiPaweł Muchowski, Peiyuan Zhaopralay ramtekePreethi SPriya Samuel, Radosław Puzdrowski, Rafal Korytkowski, Rasanjana Perera, Robert Day, Roman Zayats, Ryan Crichton, Sam Dale, sancho sebastineSandeep Raparthi, Saptarshi Purkayastha, Sashrika Waidyarathna, Satwik Reddy, Sebastian Theis, Sergey Morozov, Seth Noyes, Sharon Varghese, Shekharreddy Mittapelly, Shreyans Sheth, Shubham Rai, sravanthi naraharisetti, Stanislav Pereverziev, Stephen Senkomago Musoke, Shreyans ShethSuranga KasthurirathneTanay Abhra, Tharaka NilushanTharunya Pati, Thilo Beckmann, Thisura Thejith, Thomas Van Doren, TJ Tunnelltobias vogel, Tomasz MarzeionTomasz Mueller, Ujjwal Arora, Václav Krpec, Vaibhav AgarwalVenkata Jaswanth U, Vicente Bermúdez, Vikash Gupta, Vinay Venu, Vishnu Mechineni, wadinga leonardWesley Brown, Willa Mhawila, Wyclif Luyima, Yousef Hamza, Yuri Sintyaev, Zakaria AmineAda YeungJames ArbaughEllen BallFormer user (Deleted)Jamie ThomasAndrew Kanter

Special mention to James Arbaugh for single handedly testing the beta release and to Wyclif Luyima and Daniel Kayiwa for helping get the final release done!

End Of Life (EOL) announcement

OpenMRS 1.10 is no longer supported

As described in /wiki/spaces/RES/pages/26287677, OpenMRS can only support up to three released versions at a time (the current release and then two versions back). With the release of OpenMRS Platform 2.0.0, support is no longer provided for OpenMRS Platform 1.10.x and earlier. This announcement also serves as advance notice that support will end for OpenMRS Platform 1.11.x, concurrent with the release of OpenMRS Platform 2.1.0