Release Checklist v3.19.2

Target Release Date: 2025-11-28

Services

Released versions:

Auth 4.4.0
Requisition 8.5.0
Reference Data 15.4.0
Notification 4.4.0
Fulfillment 9.3.0
Stock Management 5.3.0
Report 1.5.0
CCE 1.4.0
BUQ 1.1.0
Diagnostics (SKIPPED)
DHIS2 Integration 1.1.0
Hapifhir 2.1.0

Auth

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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 (Skipped due to no commits)

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update CHANGELOG if needed

Bump up version to RC1

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Released versions (RC1):

dev-ui 9.0.8-RC1
openlmis-ui-components 7.2.14-RC1
openlmis-auth-ui 6.2.16-RC1
openlmis-ui-layout 5.2.9-RC1
openlmis-referencedata-ui 5.6.17-RC1
openlmis-stockmanagement-ui 2.1.9-RC1
openlmis-cce-ui 1.1.8-RC1
openlmis-report-ui 5.2.15-RC1
openlmis-offline-ui 1.0.8-RC1
openlmis-fulfillment-ui 6.1.7-RC1
openlmis-requisition-ui 7.0.15-RC1
one-network-integration-ui 0.0.7-RC1
openlmis-reference-ui 5.2.12-RC1

Released version (3.20):

dev-ui 9.0.8
openlmis-ui-components 7.2.14
openlmis-auth-ui 6.2.16
openlmis-ui-layout 5.2.9
openlmis-referencedata-ui 5.6.17
openlmis-stockmanagement-ui 2.1.9
openlmis-cce-ui 1.1.8
openlmis-report-ui 5.2.15
openlmis-offline-ui 1.0.8
openlmis-fulfillment-ui 6.1.7
openlmis-requisition-ui 7.0.15
one-network-integration-ui 0.0.7
openlmis-reference-ui 5.2.12

Dev UI

Update CHANGELOG if needed

Bump up version to RC1 (project.properties)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Update CHANGELOG if needed

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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

Update Release Notes

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

Bump up version to RC1 (project.properties and docker-compose.yml)

Confirm Build was successful

Create Pre-Release TAG with RC1

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. https://github.com/OpenLMIS/openlmis-ref-distro/blob/master/docs/source/releases/index.rst

Update links in collect-docs.py file. https://github.com/OpenLMIS/openlmis-ref-distro/blob/master/docs/source/collect-docs.py

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 https://openlmis.atlassian.net/wiki/spaces/OP/pages/3084484644.

Let the community know about the release

OpenLMIS: the global initiative for powerful LMIS software