Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Documentation

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed unused panels and cleaned up Overview.

...

  • Modules can be managed through the web application. While modules can be stopped, started, upgraded, removed, etc. without restarting the server, note that each time an action is taken on a module, the OpenMRS context is restarted — i.e., actions taken on modules (starting, stopping, upgrading, removing) will interrupt any active processes. For example, if Module A is listening on a port for messages and you start or stop Module B, Module A will be briefly interrupted as the change is applied.
  • The file extension for OpenMRS modules is ".omod".A module
  • Individual module documentation can be found at the Module Documentation page.
  • Developers can find more information about writing modules on the module development page.


  • Modules can be loaded into OpenMRS by one of two methods:

    1. Dropping the .omod file into the defined module repository folder (the module repository folder is defined by the system's runtime settings).

      Image Added

      Navigate into the modules folder located in your OpenMRS server folder.
      Image Added


      Place the .omod file into this folder. The module will be installed and usable the next time the web application is restarted.


    2. Uploading the module via the form on Manage Modules administration page in the web application.

      Image Added

      Navigate to the home page of OpenMRS then click on System Administration.

      Image Added

      Then click on Advanced Administration.

      Image Added

      This will bring you to the Administration page. Click on Manage Modules under the Modules section.

      Image Added

      Click on Add or Upgrade Modules.

      Image Added

      Click on Browse to pull up a file explorer to add a module. After selecting your module, click Upload. The module will be ready to use immediately.



Panel

Installing of modules through the web interface is disabled by default (for security purposes). To enable it, set the 'module.allow_web_admin' runtime property to <tt>true</tt> and restart the web application.*BE CERTAIN THAT YOU HAVE CHANGED THE DEFAULT ADMIN PASSWORD BEFORE ALLOWING MODULE UPDATES VIA THE WEB; OTHERWISE, ANYONE COULD UPLOAD AND RUN CODE ON YOUR SERVER

...

...