For the complete DHIS2 documentation index, see llms.txt.

2.38 Upgrade Notes¶

Please ensure you have read the upgrade notes from the PREVIOUS RELEASE, if upgrading from an earlier version

Java Support¶

Starting with DHIS 2.38, Java JDK version 11 is required. This means that Java 8 is no longer supported.

Java 11 has been supported for DHIS 2 since version 2.35. This means that you can upgrade your server to JDK 11 while still running DHIS 2.35 or later in preparation for the DHIS 2.38 upgrade. Java 11 has proven to be reliable and significantly faster for DHIS 2 in production.

Comme toujours, nous recommandons d'utiliser une distribution OpenJDK de Java, en raison de sa nature gratuite et open source. Les distributions OpenJDK 11 sont disponibles sur tous les principaux systèmes d'exploitation et constituent le JDK par défaut sur Ubuntu 20.04 LTS.

Base de données¶

All legacy metadata attribute values tables are now removed. Those tables have *attributevalues postfix such as categoryattributevalues or datasetattributevalues.
In table sqlview, not-null constraints have been added to the type and cachestrategy columns.
The table users are removed, and its data are migrated into the userinfo table. (This does not affect the API, which maintains backward compatibility)
For adding trigram indexes and compounding it with primitive column types, two extensions have to be created in the database. The extensions are already part of the default posgresql installation. Extensions:
```
create extension pg_trgm;
create extension btree_gin;
```
Starting in 2.38, PRVs have a value type (valueType field in the API, valuetype column on the DB table)
Since this new field cannot be null, the system assigns valueType = TEXT to all PRVs
If you happen to have PRVs of source type CALCULATED_VALUE, and they are supposed to hold a numeric value, when they are initialized by default to TEXT, some PRs are impacted.
Par exemple : Suppose PRV AgeYears is used as follows in a condition of a PR
```
#{AgeYears} > 5
```
After the upgrade to 2.38, this PR is no longer working because #{AgeYears} is of type TEXT, so comparing it against a number gives an error (or warning)
Program rule variables which are not of type TEXT must be updated with the proper valueType. In the above example, AgeYears should have the valueType set to NUMBER.

API¶

Running jobs manually using /api/jobConfigurations/execute changed from using the GET to the POST request method.
Program ID is now mandatory for program stage. Affected endpoints are /programStages, /metadata.
The GET /systemSettings endpoint returning JSONP (Accept=application/javascript) has been removed.
Several API endpoints slightly change their response root object to be in line with the majority of endpoints. The root object returned prior to 2.38 will become the member named response of the new root object returned in 2.38. Consumers can opt to either use /api/37/ to get the old behaviour or have to unpack to new response by doing <root>.response to resolve the previous root from the 2.38 response.

NOTE

In case of an error, responses will return HTTP status 409 Conflict and not 200 OK.

Voici les points de terminaison affectés :

POST /api/completeDataSetRegistrations with JSON/XML (only non async affected)
POST /api/dataValueSets avec JSON/XML/ADX/CSV (seulement les non async affectés)
POST /api/metadata avec JSON/XML/GML/CSV (seulement les non async affectés)
POST /api/predictions (seulement les non async affectés)
PUT /api/predictions (seulement les non async affectés)
PUT /api/relationships/{id}
PUT /api/users/{uid} with JSON/XML