OpenMRS acts as the back end system for user management, auditing and reporting. This page provides the steps necessary to configure a fresh OpenMRS server. Note that the docker setup and docker compose setup instructions include a pre-configured OpenMRS server. Start there if you're just trying to stand up a demo.
...
The following modules are required for the OpenMRS server. Note that all of these modules are available for download as a single tarball from Source Forge.
Module name | Minimum Version | Source Code | Download Link or Build from Source | Description |
atomfeed | 3.0.1a | Build from Source | This module provides an atom feed for every patient and encounter transaction in the system | |
calculation | 1.1 | This is the standard OpenMRS calculation module. | ||
cohort | 2.0 | Build from Source | This module allows you to define a cohort of patients within OpenMRS | |
dhislocation | 0.1-SNAPSHOT | Build from Source | This module pulls the location information from DHIS2 so we don't have to manage the locations in OpenMRS | |
dhisreport | 2.1-SNAPSHOT | Build from Source | This module allows us to push aggregate information from the OpenMRS server to DHIS2. | |
htmlformentry | 2.5 | This module allows us to easily define html forms in OpenMRS. | ||
htmlwidgets | 1.6.7 | This module displays the widgets within the HTML forms that we define in the htmlformentry module. | ||
idgen | 3.2 | This module allows you to generate identifiers within OpenMRS. | ||
idgen-webservices | 1.1-SNAPSHOT | Build from Source | This module allows you to access the ids that were generated through an API, which allows us to create unique identifiers across all components from a single source. | |
reporting | 0.9.8.1 | This is the standard OpenMRS reporting module. | ||
reportingrest | 1.5 | This module allows us to access reports through a REST API. | ||
scheduletracker | 0.1-SNAPSHOT | Build from Source | This module allows us to upload a patient alert schedule into OpenMRS and view those who enroll in automated alerts in OpenSRP. | |
serialization.xstream | 0.2.7 | This module allows OpenMRS to serialize XML objects. | ||
sync | 1.2 | This module allows OpenMRS to sync with parent and child servers. | ||
teammodule | 0.1.0A | Build from Source | This module allows us to assign team members to a particular location and share patients. | |
uiframework | 3.3.1 | This module provides the user interface framework for other modules. | ||
webservices.rest | 2.12.0 | This module is the standard REST API for OpenMRS |
OpenMRS Setup Script
This script allows you to install OpenMRS on Ubuntu 14.04. After running the script, you need to navigate to http://localhost:8080/openmrs and continue the OpenMRS setup process.
...
After setup, we need to create locations, users and teams to ensure the user can login:
- Setup a location within openmrs under Administration>Locations tab>Manage Locations.
- Create a new User(s) in Administration>Manage Users>Create User.
- Create a team under the Team management module.
- Assign the user to the Team that was created.
- To verify whether the user is authenticated, within the browser type "localhost:8080/opensrp/security/authenticate" and fill in the user credentials created in openmrs. A JSON file should appear indicating the user details.
- Make sure the logged in user has the ability to get identifiers from the OpenMRS idgen module. This can be achieved under the Manage patient Identifier sources to Auto-Generations Options and set the Location in line with the one set initially, then the Source to Auto-generate From and set it to "OPENMRS_OPENSRP" as well as selecting all the options below and then save.
- With all that in place, open up the client App in the settings tab change the URL to that of your local machine for example "http://10.
...