Release Checklist v3.19

5 min

Target Release Date: 2025-03-31

Services

Auth

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

Requisition (Skipped, 8.4.0 version from 2025-02-28 will be used)

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

Reference Data

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

Notification

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

Fulfillment

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

Stock Management

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

Report

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

CCE

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

BUQ

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

Diagnostics

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

DHIS2 Integration

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

Hapifhir

Set Final Release Version

Update Release Notes & Changelog

Push and verify build in Jenkins & DockerHub

Ensure Build Retention & ERD Execution (Jenkins)

Create & Tag Release

Create rel-{ service_version } branch

Increment to Next Snapshot Version

UI Modules

Dev UI (Skipped, 9.0.7 version from 2025-10-31 will be used)

Change Version (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

UI-Components

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Auth UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

UI-Layout

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Reference Data UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Stock Management UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

CCE UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Report UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Offline UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Fulfillment UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Requisition UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

One Network Integration UI

Change Versions (project.properties and docker-compose.yml files)

Update Release Notes (skip if pre-release)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Reference UI

Change Versions (project.properties and docker-compose.yml files)

Verify build in Jenkins, on DockerHub

Verify Jenkins keeps the build forever

Create Tag and rel-{ service_version } branch

Increment to Next Snapshot Version (project.properties and docker-compose.yml files)

Other

Tag and release only if necessary: https://github.com/OpenLMIS/openlmis-service-util

Tag: https://github.com/OpenLMIS/openlmis-template-service (This repository is not released in the traditional sense since this repository is a template or reference repository for the Reference Distribution. It's only tagged and versioned for documentation)

Tag and release with new versions: https://github.com/OpenLMIS/openlmis-deployment

Update services to new snapshot versions: https://github.com/OpenLMIS/openlmis-contract-tests

Ref-distro

Copy the latest openlmis-ref-distro-v{version} and update for the new release. https://github.com/OpenLMIS/openlmis-ref-distro/tree/master/docs/source/releases

Add note about new release in the index.rst file. openlmis-ref-distro/docs/source/releases/index.rst at master · OpenLMIS/openlmis-ref-distro

Update links in collect-docs.py file. openlmis-ref-distro/docs/source/collect-docs.py at master · OpenLMIS/openlmis-ref-distro

Create & Tag Release

Create rel-{ service_version } branch

Go to https://readthedocs.org/projects/openlmis/, log in, build if needed and activate the released version. (Currently only @Maciej Grochalski and @Artur Lebiedziński have accounts on Read the Docs).

Prepare demo of the release and upload it to the Confluence as in [3.18] Demo recording.

Let the community know about the release

Release Checklist v3.19

Services

UI Modules

Other

Related content