DHIS2 Migration Issue: 2.40.8 → 2.41.5 - Blank page after login

Support - Assistance technique
1

Hello,

I am facing an issue after migrating DHIS2.

  • Previous version: DHIS2 2.40.8

  • Target version: DHIS2 2.41.5

  • OS: Windows Server 2022

  • Java: Oracle JDK 17.0.12 (migrated from Java 11)

  • Tomcat: 9.0.89

  • Database: PostgreSQL 16

After installation and configuration, the login page loads correctly. However, after entering the credentials, I only get a blank page.

Steps already taken

  • Upgraded Java from 11 to 17 and reconfigured Tomcat

  • Deployed dhis-2.41.5.war

  • Cleared Tomcat caches (work/ and temp/)

  • Verified the dhis.conf configuration file

Symptoms

  • Browser console (F12) shows the following error:

    Uncaught SyntaxError: Invalid or unexpected token

  • No critical errors in Tomcat logs (only some warnings)

  • The ROOT folder is not always properly generated during deployment

Question

Could this issue be related to a compatibility problem between DHIS2 2.41.5 and PostgreSQL 16,
or is it more likely a Tomcat/Java deployment issue?

Any guidance to resolve this blank page problem after login would be greatly appreciated.

Thanks in advance for your help. @Gassim @ellen

2

Hi @DRABO_Seydou

Welcome to the DHIS2 Community of Practice!

May I ask you please if you tried to login using the browser’s Guest mode? Testing the Guest mode ensures that the issue isn’t related to browser cache.

If you’re still facing an issue after testing in Guest mode then could you please check the Network requests in the Network tab from the DevTools in your browser (F12 → Network), please share the request/response for the ones that have errors (you can remove the top-level-domain).

Thanks!

3

Hello.

I have the same problem in a clean installation on Windows 2025 Server.
Tomcat 9, DHIS2 2.40.12, java 17.

image

No errors on logs (catalina or dhis). Just that error.

I would apreciate a lot any clue.

Thanks!!

4

Hello all.
I found a solution:
1 - Install java jdk 21 version
2 - Configure Environment variable JAVA_HOME and registry key HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\Tomcat9\Parameters\Java\jvm so they point to the new instalation (in my case “C:\Program Files\Java\latest\jdk-21” for the environment variable and C:\Program Files\Java\latest\jdk-21\bin\server\jvm.dll for the Registry key).
3 - Search and install all pending windows updates.
4 - Restart system.

5

Hi @JaimeLopez

Thanks for sharing the solution! I’m glad you found it.. :folded_hands: