Steps to Install the MDR-TB Module Version 3.0
Prerequisites
You must have OpenMRS 1.9 .2 or higher installed. (Note that as of August 2012, OpenMRS (at least 1.9.2 has yet to be released... until it is released, the only way to use MDR-TB 3.0 is to run a custom build of the 1.9.x branch of OpenMRS core).
The following modules must be installed for the MDR-TB module to operate:
- Serialization XStream
- HTML Widgets
- Reporting
- Metadata Mapping
- Metadata Sharing (v1.0.9)
All these modules can be downloaded from the OpenMRS Add-Ons module repository.
Also note that module only supports Firefox. There are a few issues when using the module with Chrome; it has not been tested at all in IE.
...
Importing is done via the Metadata Sharing module. Make sure you are using v1.0.9 of the Metadata Sharing module. From the "Administration" page, select "Share Metadata" from the "Metadata Sharing" section. Click on "Import Package".
- If you are not using the MVP dictionary, import the full package "MDR-TB MODULE 2.0 CORE METADATA.zip" which you can down here:
- MDR-TB Module Core Metadata
- (Note that when importing into a fresh installation with no demo data or MVP dictionary, there will be two existing concepts for true and false. Choosing "Merge - prefer mine" will enable the metadata package to import successfully.)
- If you are using the MVP dictionary, import the MVP-specific package "MDR-TB MODULE 2.0 MVP METADATA.zip" which you can download here:
MDR-TB Install
Once that has been successfully imported, install the MDR-TB module from the OpenMRS module repository.
Once it has been installed successfully, click on the "MDR-TB Homepage" tag to go to the MDR-TB Homepage.
Note: In order to successfully enter any encounters (eg. enroll a patient with an intake form), you will need to set up at least one provider in the system. This is done by assigning a role of "Provider" to one or more users in the User Management section of Administration.
Upgrading from Version 2.0
...
The Visits section of the MDR-TB module comes with very simple intake and followup forms that just collect the basic details of the encounter, vitals, and clinician notes. It is possible, however, to include your own custom HTML Forms here. To do so, simply associate an HTML Form you create with the MDR-TB Intake or MDR-TB Followup encounter type (via Manage HTML Forms). Then, when you add a new Intake or Followup encounter for a patient, you will be asked to chose whether you want to use the "simple" form, or the custom HTML Form you have installed.