Platform Release Notes 2.0.0

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 Manager: Mayank 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

New Features

Others

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

Installation

• 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).

Upgrading

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.

• Ensure that you are running Java 8
• If upgrading from 1.9, first go through the steps at https://wiki.openmrs.org/x/OALpAw
• If you plan to use the legacy user interface, put the legacyui module in your modules folder.

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.

Contributors

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 Grzybkowski, Akshika Wijesundara, Alexei Grigoriev, Alexis Duque, Ankur Goyal, Arkadiusz Kołodziejski, Bhavana Ramasayam, Břetislav Hájek, Burke Mamlin, Cathy Chen, Chethan A, Cintia Del Rio, Clifton McIntosh, Cosmin Ioan, Daniel Kayiwa, Darius Jazayeri, Dave Lahn, David Churcher, David Dworken, Erick Wafula, Fernando 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 Parise, Jessica Ern, Jie Chen, Judy Gichoya, Julius Duic, Kaweesi Joseph, Kishore Yekkanti, Kristopher Schmidt, Lluis Martinez, MA Corrales, Manika Maheshwari, Mark Goodrich, Mayank Sharma, Michael Downey, Michael Hofer, Michael Souza, Mihir Khatwani, Mike Seaton, Mikko Suniala, Milan Karunarathne, Myrle Krantz, Nadeeshani Pathirana, NAGASOWMYA MAJETY, Namrata Nehete, Nicholas Folk, nilmadab mondal, Owolabi Legunsen, Pascal Brandt, Paweł Gutkowski, Paweł Muchowski, Peiyuan Zhao, pralay ramteke, Preethi S, Priya Samuel, Radosław Puzdrowski, Rafal Korytkowski, Rasanjana Perera, Robert Day, Roman Zayats, Ryan Crichton, Sam Dale, sancho sebastine, Sandeep 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 Sheth, Suranga Kasthurirathne, Tanay Abhra, Tharaka Nilushan, Tharunya Pati, Thilo Beckmann, Thisura Thejith, Thomas Van Doren, TJ Tunnell, tobias vogel, Tomasz Marzeion, Tomasz Mueller, Ujjwal Arora, Václav Krpec, Vaibhav Agarwal, Venkata Jaswanth U, Vicente Bermúdez, Vikash Gupta, Vinay Venu, Vishnu Mechineni, wadinga leonard, Wesley Brown, Willa Mhawila, Wyclif Luyima, Yousef Hamza, Yuri Sintyaev, Zakaria Amine, Ada Yeung, James Arbaugh, Ellen Ball, user-75959, Jamie Thomas, Andrew 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