Skip to content

Commit b40a42b

Browse files
alebiedzinskialebiedzinski
authored
Create openlmis-red-distro-v3.16.0.rst
1 parent e8b8513 commit b40a42b

1 file changed

Lines changed: 237 additions & 0 deletions

File tree

‎docs/source/releases/openlmis-red-distro-v3.16.0.rst‎

Lines changed: 237 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,237 @@
1+
====================================
2+
3.16.0 Release Notes - November 7, 2023
3+
====================================
4+
5+
Status: Stable
6+
===============
7+
8+
3.16.0 is a stable release, and all users of `OpenLMIS version 3
9+
<https://openlmis.atlassian.net/wiki/spaces/OP/pages/88670325/3.0.0+Release+-+1+March+2017>`_ are
10+
encouraged to adopt it.
11+
12+
Release Notes
13+
=============
14+
The OpenLMIS Community is excited to announce the **3.15.0 release** of OpenLMIS! It is another major milestone in the version 3 `re-architecture <https://openlmis.atlassian.net/wiki/display/OP/Re-Architecture>`_ that allows more functionality to be shared among the community of OpenLMIS implementers.
15+
16+
For a full list of features and bug-fixes since 3.16.0, see `OpenLMIS 3.16.0 Jira tickets
17+
<https://openlmis.atlassian.net/issues/?jql=status%20in%20(Done%2C%20DONE)%20AND%20fixVersion%20%3D%203.16%20ORDER%20BY%20%22Epic%20Link%22%20asc%2C%20key%20ASC>`_.
18+
19+
For information about future planned releases, see the `Living Product Roadmap
20+
<https://openlmis.atlassian.net/wiki/display/OP/Living+Product+Roadmap>`_. Pull requests and
21+
`contributions <http://docs.openlmis.org/en/latest/contribute/contributionGuide.html>`_ are welcome.
22+
23+
Compatibility
24+
-------------
25+
26+
Unless noted here, all other changes to OpenLMIS 3.x are backwards-compatible. All changes to data
27+
or schemas include automated migrations from previous versions back to version 3.0.1. All new or
28+
altered functionality is listed in the sections below for New Features and Changes to Existing
29+
Functionality.
30+
31+
Upgrading from Older Versions
32+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33+
34+
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
35+
Release Notes <http://docs.openlmis.org/en/latest/releases/openlmis-ref-distro-v3.2.0.html>`_ for
36+
important compatibility information about a required PostgreSQL extension and data migrations.
37+
38+
For information about upgrade paths from OpenLMIS 1 and 2 to version 3, see the `3.0.0 Release
39+
Notes <https://openlmis.atlassian.net/wiki/spaces/OP/pages/88670325/3.0.0+Release+-+1+March+2017>`_.
40+
41+
Download or View on GitHub
42+
--------------------------
43+
44+
`OpenLMIS Reference Distribution 3.16.0
45+
<https://github.com/OpenLMIS/openlmis-ref-distro/releases/tag/v3.16.0>`_
46+
47+
Known Bugs
48+
==========
49+
50+
Bug reports are collected in Jira for troubleshooting, analysis and resolution on an ongoing basis. See `OpenLMIS 3.16.0
51+
Bugs <https://openlmis.atlassian.net/issues/?jql=type%20%3D%20Bug%20and%20project%20%3D%20%22OpenLMIS%20General%22%20AND%20status%20not%20in%20(Done%2CCanceled)&startIndex=200>`_ for the current list of known bugs.
52+
53+
To report a bug, see `Reporting Bugs
54+
<http://docs.openlmis.org/en/latest/contribute/contributionGuide.html#reporting-bugs>`_.
55+
56+
New Features
57+
============
58+
The OpenLMIS community focused on the following work in version 3.16.0:
59+
60+
**Data import from UI**-Functionality allows users to import system data from UI. Before, if a user wanted to extract system data i.e. names of all currently stocked products, it had to be done by database. Functionality will be assigned to a specific role - Administrator.
61+
**Bug fixes**
62+
Chrome API fixes - the most critical part of this patch release. These changes were introduced due to the recent Chrome release which API changes. Now users are able to use OpenLMIS properly on Chrome browser
63+
Approve buttons not visible when trying to approve requisition - we've fixed the problem with requisition service. There was a problem with the approve button which wasn't visible for users with proper permissions.
64+
Stock Out Days was not showing the proper values even after its recent release. Currently it's fixed and values are properly calculated.
65+
66+
67+
Reference the `3.16 epics <https://openlmis.atlassian.net/issues/?filter=20614&jql=issuetype%20%3D%20Epic%20AND%20status%20in%20(Done%2C%20%22In%20Progress%22)%20AND%20fixVersion%20%3D%203.15%20ORDER%20BY%20created%20DESC>`_ for more details.
68+
69+
Changes to Existing Functionality
70+
=================================
71+
72+
See `all 3.16 issues tagged 'UIChange' in Jira <https://openlmis.atlassian.net/issues/?jql=status%3DDone%20AND%20project%3DOLMIS%20AND%20fixVersion%3D3.15%20and%20type!%3DTest%20and%20type!%3DEpic%20and%20labels%20IN%20(UIChange)%20ORDER%20BY%20type%20ASC%2C%20priority%20DESC%2C%20key%20ASC>`_.
73+
74+
API Changes
75+
===========
76+
77+
API changes can be found in each service CHANGELOG.md file, found in the root directory of the service repository.
78+
79+
Performance
80+
========================
81+
82+
The performance of version 3.16 is similar to 3.15 with some modest improvements. Performance remains a high priority for the OpenLMIS community and we continue to review the overall performance picture and look for opportunities for improvements.
83+
84+
OpenLMIS conducted manual performance tests of the same user workflows with the same test data we used in testing v3.2.1 to establish that last-mile performance characteristics have been retained at a minimum. For details on the test results and process, please see `this wiki page <https://openlmis.atlassian.net/wiki/spaces/OP/pages/116949318/Performance+Metrics>`_.
85+
86+
The following chart displays the UI loading times in seconds for 3.10, 3.11, 3.12, and 3.13 using the same test data.
87+
88+
89+
Test Coverage
90+
=============
91+
92+
OpenLMIS 3.16.0 was tested using the established OpenLMIS Release Candidate process. As part of this process, full manual test cycles were executed for each release candidate published. Any critical or blocker bugs found during the release candidate were resolved in a bug fix cycle with a full manual test cycle executed before releasing the final version 3.15.0. Manual tests were conducted using a set of 97 QAlity tests tracked in Jira and 7 manual tests for reporting. For more details about test executions and bugs found for this release please see `the 3.15 QA Release and Bug Triage wiki page <https://openlmis.atlassian.net/wiki/spaces/OP/pages/2320269316/The+3.15+Regression+and+Release+Candidate+Test+Plan>`_.
93+
94+
All Changes by Component
95+
========================
96+
97+
Version 3.16.0 of the Reference Distribution contains updated versions of the components listed
98+
below. The Reference Distribution bundles these component together using Docker to create a complete
99+
OpenLMIS instance. Each component has its own own public GitHub repository (source code) and
100+
DockerHub repository (release image). The Reference Distribution and components are versioned
101+
independently; for details see `Versioning and Releasing
102+
<http://docs.openlmis.org/en/latest/conventions/versioningReleasing.html>`_.
103+
104+
Auth Service 4.3.3
105+
------------------
106+
107+
`Auth CHANGELOG <https://github.com/OpenLMIS/openlmis-auth/blob/master/CHANGELOG.md>`_
108+
109+
CCE Service 1.3.2
110+
-----------------
111+
112+
`CCE CHANGELOG <https://github.com/OpenLMIS/openlmis-cce/blob/master/CHANGELOG.md>`_
113+
114+
Fulfillment Service 9.0.3
115+
-------------------------
116+
117+
`Fulfillment CHANGELOG <https://github.com/OpenLMIS/openlmis-fulfillment/blob/master/CHANGELOG.md>`_
118+
119+
Notification Service 4.3.3
120+
--------------------------
121+
122+
`Notification CHANGELOG <https://github.com/OpenLMIS/openlmis-notification/blob/master/CHANGELOG.md>`_
123+
124+
Reference Data Service 15.2.3
125+
-----------------------------
126+
127+
`ReferenceData CHANGELOG <https://github.com/OpenLMIS/openlmis-referencedata/blob/master/CHANGELOG.md>`_
128+
129+
Report Service 1.2.2
130+
--------------------
131+
132+
This service is intended to provide reporting functionality for other components to use. Built-in
133+
reports in OpenLMIS 3.4.0 are still powered by their own services. In future releases, they may be
134+
migrated to a new version of this centralized report service.
135+
136+
**Warning**: Developers should take note that the design of this service will be changing with
137+
future releases. Developers and implementers are discouraged from using this 1.2.x version to build
138+
additional reports.
139+
140+
`Report CHANGELOG <https://github.com/OpenLMIS/openlmis-report/blob/master/CHANGELOG.md>`_
141+
142+
Requisition Service 8.3.4
143+
-------------------------
144+
145+
`Requisition CHANGELOG <https://github.com/OpenLMIS/openlmis-requisition/blob/master/CHANGELOG.md>`_
146+
147+
Stock Management 5.1.6
148+
----------------------
149+
150+
`Stock Management CHANGELOG <https://github.com/OpenLMIS/openlmis-stockmanagement/blob/master/CHANGELOG.md>`_
151+
152+
Reference UI 5.2.3
153+
------------------
154+
155+
`The Reference UI <https://github.com/OpenLMIS/openlmis-reference-ui/>`_
156+
is the web-based user interface for the OpenLMIS Reference Distribution. This user interface is
157+
a single page web application that is optimized for offline and low-bandwidth environments.
158+
The Reference UI is compiled together from module UI modules using Docker compose along with the
159+
OpenLMIS dev-ui. UI modules included in the Reference UI are:
160+
161+
Reference Data-UI 5.6.6
162+
~~~~~~~~~~~~~~~~~~~~~~~
163+
164+
`ReferenceData-UI CHANGELOG <https://github.com/OpenLMIS/openlmis-referencedata-ui/blob/master/CHANGELOG.md>`_
165+
166+
Auth-UI 6.2.8
167+
~~~~~~~~~~~~~
168+
169+
`Auth-UI CHANGELOG <https://github.com/OpenLMIS/openlmis-auth-ui/blob/master/CHANGELOG.md>`_
170+
171+
CCE-UI 1.1.1
172+
~~~~~~~~~~~~
173+
174+
`CCE-UI CHANGELOG <https://github.com/OpenLMIS/openlmis-cce-ui/blob/master/CHANGELOG.md>`_
175+
176+
Fulfillment-UI 6.1.1
177+
~~~~~~~~~~~~~~~~~~~~
178+
179+
`Fulfillment-UI CHANGELOG <https://github.com/OpenLMIS/openlmis-fulfillment-ui/blob/master/CHANGELOG.md>`_
180+
181+
Report-UI 5.2.8
182+
~~~~~~~~~~~~~~~
183+
184+
`Report-UI CHANGELOG <https://github.com/OpenLMIS/openlmis-report-ui/blob/master/CHANGELOG.md>`_
185+
186+
Requisition-UI 7.0.7
187+
~~~~~~~~~~~~~~~~~~~~
188+
189+
`Requisition-UI CHANGELOG <https://github.com/OpenLMIS/openlmis-requisition-ui/blob/master/CHANGELOG.md>`_
190+
191+
Stock Management-UI 2.1.2
192+
~~~~~~~~~~~~~~~~~~~~~~~~~
193+
194+
`Stock Management-UI CHANGELOG <https://github.com/OpenLMIS/openlmis-stockmanagement-ui/blob/master/CHANGELOG.md>`_
195+
196+
UI-Components 7.2.7
197+
~~~~~~~~~~~~~~~~~~~
198+
199+
`UI-Components CHANGELOG <https://github.com/OpenLMIS/openlmis-ui-components/blob/master/CHANGELOG.md>`_
200+
201+
UI-Layout 5.2.1
202+
~~~~~~~~~~~~~~~
203+
204+
`UI-Layout CHANGELOG <https://github.com/OpenLMIS/openlmis-ui-layout/blob/master/CHANGELOG.md>`_
205+
206+
Dev UI 9.0.3
207+
~~~~~~~~~~~~
208+
209+
The `Dev-UI CHANGLOG <https://github.com/OpenLMIS/dev-ui/blob/master/CHANGELOG.md>`_
210+
211+
Components with No Changes
212+
==========================
213+
214+
The components that have not changed are:
215+
216+
- `Service Util <https://github.com/OpenLMIS/openlmis-service-util>`_
217+
- `Logging Service <https://github.com/OpenLMIS/openlmis-rsyslog>`_
218+
- Consul-friendly distribution of `nginx <https://github.com/OpenLMIS/openlmis-nginx>`_
219+
- Docker `Postgres 9.6-postgis image <https://github.com/OpenLMIS/postgres>`_
220+
- Docker `scalyr image <https://github.com/OpenLMIS/openlmis-scalyr>`_
221+
222+
Contributions
223+
=============
224+
225+
Many organizations and individuals around the world have contributed to OpenLMIS version 3 by
226+
serving on our committees (Governance, Product and Technical), requesting improvements, suggesting
227+
features and writing code and documentation. Please visit our GitHub repos to see the list of
228+
individual contributors on the OpenLMIS codebase. If anyone who contributed in GitHub is missing,
229+
please contact the Community Manager.
230+
231+
Thanks to the Malawi implementation team who has continued to contribute a number of changes
232+
that have global shared benefit.
233+
234+
Further Resources
235+
=================
236+
237+
Please see the Implementer Toolkit on the `OpenLMIS website <http://openlmis.org/get-started/implementer-toolkit/>`_ to learn more about best practicies in implementing OpenLMIS. Also, learn more about the `OpenLMIS Community <http://openlmis.org/about/community/>`_ and how to get involved!

0 commit comments

Comments
 (0)