Issues Upgrading From 2.38 to 2.42

In our standard installation, we use LXD containers, each running its own operating system—typically Ubuntu LTS releases. These container or guest operating systems are immutable, meaning once the OS is set during initial deployment, it cannot be changed later by simply modifying the guest_os=24.04 parameter.

To upgrade to DHIS2 version 42, there are key prerequisites:

  1. Tomcat 10
  2. Java 17

An implied requirement is Ubuntu 24.04, since Tomcat 10 is only available via apt on this version of Ubuntu.

Summary:

You cannot perform an in-place upgrade from DHIS2 version 2.41 or earlier. Instead, you must provision a new guest environment—either an LXD container or VM—running Ubuntu 24.04, and migrate your instance there.