3.19.1 Release Notes - April 07, 2025

Status: Stable

Version 3.19.1 has been released to address a critical migration issue identified after the 3.19 deployment.

New Features

  • No new features have been added since version 3.19.

Improvements

  • No improvements have been added since version 3.19.

Bug Fixes

  • Fixed migration issue: Resolved an issue where migration scripts were failing for implementations using SUPERSET. Due to this, the Reference Data Service was unable to start after the upgrade. The migration process has been corrected to ensure a smooth upgrade and that all services, including the Reference Data Service, start and function correctly.

Compatibility

Important Notice for Implementers Using a Custom Reports Service Forked from Core: If you are using a forked version of the core reports service, ensure your implementation is updated to include the latest changes required for Dashboard reports in version 3.19.1.

For the necessary updates, refer to the following repository: OpenLMIS Reports - https://github.com/OpenLMIS/openlmis-report/tree/rel-1.4.0-hotfix

All other changes to OpenLMIS 3.x remain backwards-compatible. Any changes to data or schemas are accompanied by automated migrations from previous versions back to version 3.0.1.

All Changes by Component

Version 3.19.1 of the Reference Distribution contains updated versions of the components listed below. The Reference Distribution bundles these components together using Docker to create a complete OpenLMIS instance. Each component has its own public GitHub repository (source code) and DockerHub repository (release image). The Reference Distribution and components are versioned independently.

  • BE Components:

    • Reference Data Service 15.3.0-hotfix - ReferenceData CHANGELOG

    • Report Service 1.4.0-hotfix - Report CHANGELOG

      • This service provides reporting functionality for other components to use. Built-in reports in OpenLMIS 3.4.0 are still powered by their own services. In future releases, they may be migrated to this centralized report service.

      • Warning: Developers should note that the design of this service will be changing in future releases. The 1.4.x version is not recommended for building additional reports.

Components with No Changes

Upgrading from Older Versions

If you are upgrading from OpenLMIS 3.0.x or 3.1.x (without first upgrading to 3.2.x), please review the 3.2.0 Release Notes for important compatibility information about a required PostgreSQL extension and data migrations.

For information about upgrade paths from OpenLMIS 1 and 2 to version 3, see the 3.0.0 Release Notes.

If you are upgrading to version 3.19.1, the SUPERSET reports will need to be added manually by system administrators. A short manual is available here:

Test Coverage

Version 3.19.1 was released due to the critical migration issue identified after 3.19. Full regression testing was conducted for version 3.19. Since version 3.19.1 contains no new features and only fixes the migration issue, full regression testing was not required.

Download or View on GitHub

OpenLMIS Reference Distribution 3.19.1

Known Issues

Bug reports are collected in Jira for troubleshooting, analysis, and resolution on an ongoing basis. See OpenLMIS 3.19.1 Bugs for the current list of known bugs.

To report a bug, see Reporting Bugs.

Contributions

Many organizations and individuals around the world have contributed to OpenLMIS version 3 by serving on committees (Governance, Product, and Technical), requesting improvements, suggesting features, and writing code and documentation. Please visit our GitHub repositories to see the list of individual contributors to the OpenLMIS codebase. If anyone who contributed on GitHub is missing, please contact the Community Manager. Technical development of OpenLMIS is conducted by SolDevelo.

Further Resources

Please see the Implementer Toolkit on the OpenLMIS website to learn more about best practices in implementing OpenLMIS. Also, learn more about the OpenLMIS Community and how to get involved!