Server Running Issues

1

Hi, I am nipun and am new to openmrs. I want to develop my own module and currently I am trying to learn about openmrs. I have pasted all the omod files necessary for ref app 2.11 in the modules directory but now the jetty server is not running or it is stuck at a particular place.

Screenshot 2025-06-03 161029
Screenshot 2025-06-03 161029897×138 4.08 KB
Earlier I had installed lesser number of modules and that was working just fine but now its completely halted, so should I wait longer or should I kill the program?

2

So sorry! Kindly can we try troubleshooting by following the following steps?

  1. Check the Logs

Go to your OpenMRS runtime directory (e.g., ~/.OpenMRS), and open the log file and look for the following:

  • SEVERE, ERROR, or Exception messages
  • Cyclic dependencies between modules
  • Missing module dependencies
  • Hibernate or Liquibase errors

If you’re stuck at “Starting OpenMRS” or “Refreshing Context”, you will see the problem in the logs.

  1. Check for Missing or Incompatible Module Dependencies

When you copy .omod files directly, it’s easy to miss dependencies or introduce version conflicts.

  • Go to WEB-INF/bundledModules/ or your ~/.OpenMRS/modules/ directory
  • Remove all .omod files
  • Add them back one at a time, starting from core RefApp 2.11 modules
  • Watch which module causes Jetty to hang or crash

Use the OpenMRS Add-Ons index to ensure module versions are compatible with RefApp 2.11.

  1. Kindly try cleaning the Cache please (Sometimes the database or module cache gets corrupted) by:

  2. Delete:

  • ~/.OpenMRS/.openmrs-lib-cache
  • ~/.OpenMRS/modules/ (or remove only the ones you added)
  1. Restart Jetty or SDK.
3

Thank you for your help, i tried by attaching each module one at a time and it turns out that the ‘attachment module’ and the ‘atlas module’ are creating some kind of an issue.

ERROR - CommonsLoggingOutput.error(75) |2025-06-04T15:46:41,742| Line=362 The content of element type “dwr” must match “(init?,allow?,signatures?)”. ERROR - CommonsLoggingOutput.error(75) |2025-06-04T15:46:41,771| Parameter mismatch parsing signatures section in dwr.xml on line: DWRHtmlFormEntryService.checkIfLoggedIn() ERROR - CommonsLoggingOutput.error(75) |2025-06-04T15:46:41,773| Parameter mismatch parsing signatures section in dwr.xml on line: DWRAtlasService.disableAtlasModule()

This happened after loading the atlas module while the attachment module is not uploading or if I directly copy paste it to OpenMRS/modules/ the jetty server is halted or stuck at the previously mentioned stage.

Rest are working fine.

Could you guide me as to what to do next or should I not download the ‘attachment module’?

4

I am so happy for the progress. This is my recommendation and I stand to be corrected :

  1. Based on this ERROR - ...Parameter mismatch parsing signatures section in dwr.xml ... Atlas Module is deprecated and not required for RefApp 2.11 to function.

  2. Attachment Module: if Jetty is hanging or the module is failing to load, it means a missing or incompatible dependency not necessarily a problem in the module itself. Kindly use the version compatible with RefApp 2.11(attachments-2.4.0.omod) .

cc @dkayiwa , @ibacher

5

It’d be better if you could post the full log to a service like pastebin or something similar.