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. OpenMRS.org account: This is not your OpenMRS ID, it is a WordPress account where you will need to create a blog post once you release the OpenMRS version. Create a new case at OpenMRS helpdesk requesting access for the OpenMRS.org account. Help desk will create the account for you.
  3. 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.
  4. 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 Reference Application, Reference Application distro, Reference Application, reference demo data, reference metadata, 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.
  8. 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:

  1. 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  requesting the access for the account. CIEL dictionary is an SQL dump file.
  2. mdsbuilder: It is an OpenMRS server and you would need access to the server, an account in the OpenMRS account and also the mysql openmrs_user/root credentials, 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).

Release steps:

...

  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 creating a new case at OpenMRS helpdesk requesting the setup of the server.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.

...

  1. Release all modules to be included in the distribution
    1. Go to https://github.com/openmrs/openmrs-distro-referenceapplication/blob/master/pom.xml and look for SNAPSHOT dependencies
    2. Change preparing.refapp.distro.release bamboo variable to 'true' (if it's not already set).
    3. Release all SNAPSHOT dependencies. Verify that the released version shows up in https://github.com/openmrs/openmrs-distro-referenceapplication/blob/master/pom.xml
    4. Release all SNAPSHOT dependencies and update their versions in https://github.com/openmrs/openmrs-distro-referenceapplication/blob/master/ui-tests/pom.xml
    5. Make sure all declared versions of modules are the latest compatible versions
  2. Release the distribution from CI
    1. Go to https://ci.openmrs.org/browse/REFAPP-OMODDISTRO
    2. Every build stops/pauses at the release stage(you can observe this in the left side column nearing the bottom of the page with section titled Release having a small right-arrow/play symbol beside it).
    3. After verifying the artifacts trigger the release by clicking on the play/right-arrow button next to the Release section located to the left bottom. At this point, you have the opportunity to override the variables on release version (maven.release.version) and the next snapshot on the pom file (maven.development.version); otherwise, maven release plugin will just use its default values. This begins the process of releasing the OpenMRS 2.x version in maven and packaging the released modules and generating the openmrs-standalone.zip.
    4. After a successful Release, confirm that preparing.refapp.distro.release bamboo variable is set to 'false'.
    5. Verify that demo.openmrs.org has been updated to the latest released version and it runs correct modules.
    6. Verify that modules-refapp.openmrs.org has been updated to the latest released version and it runs correct modules.
    7. Verify that standalone, modules and war were correctly published at https://sourceforge.net/projects/openmrs/files/releases/ and work as expected.

...

  1. Make a copy of the current "Reference Application (version)" documentation page (e.g the one for RefApp 2.5 is here), and name it for the next release. Add a note that this version is not yet released.
  2. Remove a note from the current "Reference Application (version)" documentation page that this version is not yet released.
  3. Edit the OpenMRS Reference Application 2.x Implementer Documentation page so that includes the "Reference Application (version)" page for the new release.
  4. Maintain the list of Contributors for the release.
  5. Create the Release notes:
    1. Create a release notes child page in Release Notes with the release version name.
    2. Update the Release Notes page meta tag with the new page you created.
  6. Announcing the Release
    1. Create a blog post in OpenMRS.org announcing the release, using your WordPress account. If you need an account, create a help desk case at https://help.openmrs.org/customer/portal/emails/new. The announcement can be similar to the ones created beforeAnnounce the release in OpenMRS Talk similar to the blog post. Please do not forget to include the list of contributors in the announcement.Announce the release in OpenMRS Talk similar to the blog post.
    2. .Create a new case at OpenMRS helpdesk requesting to update demo.openmrs.org, the theOpenMRS.org home page and downloads page to the latest release. Please provide links to the downloads.  DO NOT mark the Impact of your case as anything other than Routine.
  7. Release in JIRA
    1. 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. Ensure that all tickets are in the ACCEPTED state, before you release in JIRA.
    2. Go to this link - https://issues.openmrs.org/plugins/servlet/project-config/RA/versions and enter the date beside the version you are about to release and click on the small settings icon indicating a dropdown that appears when you point the mouse over  the list value for the version and select release.
  8. Update the Release Process wiki with the latest changes if any.

...

  1. Release all modules to be included in the maintenance distribution from CI, see releasing a module from bamboo and update the modules' releases in jira.
  2. Release the platform if necessary from bamboo, see platform release process.
  3. Create a maintenance branch off the latest released tag if it doesn't exist, forintsance if the current release of the reference application is 2.6 or 2.6.0, create a 2.6.x branch, below are the steps;
    • On the command line, navigate to the root of the distro project and run the commans below assumming you've already cloned the reference application distro project from git.

      Code Block
      languagebash
      git checkout -b new_branch_name tag_name


    • Change the version in the pom files in all the sub projects to a snapshot version e.g if the latest release is 2.6 or 2.6.0 and the branch name is 2.6.x, then the new version in the pom files would be 2.6.1-SNAPSHOT and commit the changes.

    • Then push the new branch out to origin and upstream.

  4. Release the distribution from CI
    1. Go to https://ci.openmrs.org/browse/REFAPP-OMODDISTRO
    2. At the top of the page in the title section, there is a drop down to switch build branches, you need to set it to the branch you created above.
    3. You need to override the maven variables for the branch build, click the Actions button and select Configure branch from the drop down, at this point you have the opportunity to set the plan variables below otherwise, maven release plugin will just use its default values;
      1. preparing.refapp.distro.release: true
      2. maven.release.version: The maintenance version you intend to release
      3. maven.development.version: The next snapshot version in the pom files
      4. openMRSVersion: The version number of the platform you intend to package
    4. To start the release process, you need to click the Run button from the build plan page, and select Run branch option from the drop down.
    5. Every build stops/pauses at the release stage (you can observe this in the left side column nearing the bottom of the page with section titled Release having a small right-arrow/play symbol beside it).
    6. Trigger the release by clicking on the play/right-arrow button next to the Release section located to the left bottom, this begins the process of releasing the OpenMRS 2.x version in maven and packaging the released modules and generating the openmrs-standalone.zip.
    7. After a successful Release, confirm that  preparing.refapp.distro.release bamboo variable is set to 'false'.
    8. Verify that the artifacts have been uploaded to sourceforge i.e the openmrs war file, read me file, the reference application standalone and modules zip files.
    9. Verify that demo.openmrs.org has been updated to the latest released version and it runs correct modules.
    10. Verify that modules-refapp.openmrs.org has been updated to the latest released version and it runs correct modules.
    11. Verify that standalone, modules and war were correctly published at https://sourceforge.net/projects/openmrs/files/releases/ and work as expected.

...