Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Documentation

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. OpenMRS ID: This is the basic account that you create when associating with OpenMRS.
  2. CI Bamboo Account: The actual release takes place here. You will need your access to this account to finally release the version. Create a new case at OpenMRS helpdesk requesting access for this account.
  3. Administrator role in JIRA for Reference Application Project: Request for being an administrator of the Reference Application project in JIRA from a current Administrator - Presently Darius Jazayeri is an administrator for the project.

Release Process

Begin the process of release management:

  1. Analyse the release stage requirements for the particular release by following  Technical Roadmap.
  2. Attend and organize Project Management Meeting and Design Forum to communicate and decide on what needs to be done throughout the release process.
  3. Create a release management process page to help you and others understand the outstanding tasks to be done.
    1. This can be done on a release tracking wiki page like this one for Ref App 2.7 release tracking.
    2. This can be done on OpenMRS Talk as done here (using the wiki has advantages, so use it if you are uncertain which to use)
  4. Search for tickets in JIRA that have the release version or having tag as OpenMRS 2.x (the version to be released)  and have them fixed before having that module released.
  5. Before people start releasing Reference Application modules, set the bamboo global variable preparing.refapp.distro.release to 'true' (by asking helpdesk if you don't have access)
  6. Make sure that for each module that needs a new version to be released, that the user documentation in the new wiki page has been updated to reflect the UI changes if necessary.
  7. Set an initial deadline to release all the modules scheduled to be included in the release and request each modules owner to release the modules in that time (make this announcement in Talk, mentioning each module owner so they get notified). Excepting the following :
    • Reference Application distro,
    • Reference Application,
    • Reference demo data,
    • Reference metadata. 
  8. All the other module can be released by this time. For the modules already existing in the release bundle check in OpenMRS github account if any new changes have been made after the previous release if don't request the any action just include it in the release management process that it is in a release ready state. If there are changes request the module owners if they would like to release a new version to be included in the new OpenMRS release.
  9. A module should be released and available via Addons to be considered released. Please verify that each module has been released properly.

Releasing the Reference Metadata module:

Each release of Reference Application should be preceded with a release of the Reference Metadata module in a version matching the Reference Application version. The release is typically done by the Reference Metadata module maintainers, but as a release manager you need to make sure it happens.

Required accounts:

CIEL dictionary dropbox account:  This account is updated with the latest CIEL dictionary and each OpenMRS 2.x release includes the latest released CIEL dictionary. 
Andrew Kanter manages the account and you would need to mail him (Please refer to his new mail here ) requesting the access for the account. CIEL dictionary is an SQL dump file

.

  1. mdsbuilder: It is an OpenMRS server and you would need access to the server.   Please create a new case requesting these accounts at OpenMRS helpdesk .
    • For requesting server access you need to have an SSH key pair. (For windows users new to using an SSH key pair for accessing a linux server , this guide might help you  create  one. You will have to request helpdesk to give access to this SSH key). 
    •  You also need need to request for  Login Credentials  with  System Developer role at  OpenMRS helpdesk  to be able to update MetaData Sharing Packages  After  Updating  the CIEL dictionary.

Release steps: 

       1 .Before You update CIEL on the  mdsbuilder , Ensure the server runs on the platform version on which the Reference Application version to be released will run. Incase the server doesn't run on the platform version as the reference application to be released , Carry out the following step below, 

  •        Check openmrs msdbuilder Docker hub repo for the latest Docker image of the  openmrs/openmrs-distro-mdsbuilder . Ensure the right version of the platform was set as per the ditro file here . And if the Server is not running on the desired platform version , Pull the updated docker image and deploy it to the server . Use commands below 
Code Block
languagebash
ssh <username>@mdsbuilder.openmrs.org
sudo -i
cd /root/docker/mdsbuilder

#Pull latest updated built image from Docker Hub
docker pull openmrs/openmrs-distro-mdsbuilder

#Deploy image to ther server
deploy-compose mdsbuilder
exit
  • Then Login into the server and complete the installation wizard

2 .Update CIEL on the mdsbuilder to the latest version using the sql dump that you download from the CIEL dictionary dropbox account.

...

  • Then Login into the server and complete the installation wizard

2 .Update CIEL on the mdsbuilder to the latest version using the sql dump that you download from the CIEL dictionary dropbox account.

Here's the list of commands needed to do the import. Replace "<username>" with your username. 

NB: Before you Upload the sql dump file to the mdsBuilder Server , ensure the sql dump file version you upload matches the Openmrs Platform version on which the mdsBuilder server run . ie Platform 2.2 would match "openmrs_concepts_2.2_20190701.sql" file  and Platform 2.0 .6 would match "openmrs_concepts_2.0_20190701.sql" file

Code Block
languagebash
scp openmrs_concepts_2.0_20181012.sql.zip <username>@mdsbuilder.openmrs.org:/tmp/openmrs_concepts_2.0_20181012.sql.zip
ssh <username>@mdsbuilder.openmrs.org
cd /tmp
unzip openmrs_concepts_2.0_20181012.sql.zip
sudo -i
cd /root/docker/mdsbuilder
docker cp /tmp/openmrs_concepts_2.0_20181012.sql mdsbuilder_db_1:/tmp/
docker exec -it mdsbuilder_db_1 /bin/bash
# copy as is, do not attempt to replace it
mysql -u ${MYSQL_USER} -p${MYSQL_PASSWORD} ${MYSQL_DATABASE} < /tmp/openmrs_concepts_2.0_20181012.sql
exit

After Updating CIEL , to have a better perfomance of the Database , Reuild the index

  •  Go to Administration -> Maintainace → Search Index → Rebuild Index

3. Update Metadata Sharing packages to the latest versions of CIEL concepts


  1. Login to mdsbuilder OpenMRS instance.
  2. Go to Administration -> Metadata Sharing -> Export Metadata and choose a package (repeat b. and c. for the following packages: Reference Application Concepts, Reference Application Diagnoses, Reference Application Order Entry and Allergies Concepts)
    1. Click New Version.
    2. Follow the creating package wizard leaving all defaults.
  3. Click Download Latest to get the zip file for that package.
  4. Export concepts using data exchange to preserve IDs for later updates of CIEL.
    1. Login to mds builder.
    2. Go to Administration -> Data Exchange Module / Export. Upload zip files from all you downloaded in 2. c, this generates an xml data set, copy the contents of the generated files to their respective xml files under https://github.com/openmrs/openmrs-module-referencemetadata/blob/master/api/src/main/resources
    3. Note that , the xml file Reference_Application_Concepts-*.xml  contains only non numeric concepts. Remove all the numeric concepts ie table name "<concept_numeric  ..  >"  and place them in the files below
      1. Reference_Application_Numeric_Concepts-*-2.xml .This will contain the numeric concepts for openmrs version 2.2 and above . They have a field  called   "allow_decimal" .
      2. Reference_Application_Numeric_Concepts-*-pre2.xml  This will contain the numeric concepts for openmrs versions below 2.2. Here rename the field "allow_decimal" to "precise" for for backward compatibility
    4. Add any missing calls to dataImporter.importData(...) in https://github.com/openmrs/openmrs-module-referencemetadata/blob/master/api/src/main/java/org/openmrs/module/referencemetadata/ReferenceMetadataActivator.java to load all files with the exported concepts.
    5. Set ReferenceMetadataConstants.METADATA_VERSION to a value higher by 1
    6. Remove zip packages containing concepts (if any) from https://github.com/openmrs/openmrs-module-referencemetadata/tree/master/api/src/main/resources and their declarations in https://github.com/openmrs/openmrs-module-referencemetadata/blob/master/api/src/main/resources/packages.xml
    7. Commit and push changes.
    8. Release the Reference Metadata Module with the version matching the release version of OpenMRS 2.x

User Acceptance Testing:

  1. Schedule a time period after the initial release deadline for releasing the modules set under the section Begin the process of release management- 4th point. Even if some modules are not released by this time the testing can begin.
  2. Setup a User Acceptance Testing(UAT) server with the OpenMRS instance having the latest released modules by deploying from CI
  3. Request the Module Owners/Implementers to verify the module's functionality individually.
  4. Organize events to encourage people to participate in testing the new version before it's release.
  5. If the UAT results in discovery of new bugs please file them and after they are fixed , request releasing a new version for the specific module where the issue has been identified.

...