The reference application can be configured to connect to a Master Patient Index(MPI), allowing patient information to be shared. This feature is still in active development and testing, and will be released soon.
The registration app is configured with default settings to allow it to connect to OpenEMPI. OpenEMPI is an Enterprise Master Patient Index developed by Sysnet International. It provides both a REST API and PIX/PDQ Server. Patient Identifier Cross-referencing(PIX) and Patient Demographics Query(PDQ) is done using the HL7 v2 Standard.
OpenHIM has to be installed to act as a reverse proxy for OpenHIE.
Install the latest stable Nodejs LTS release(Nodejs v4 or later): https://nodejs.org/en/download/package-manager/
Install Mongodb(compatible with v2.6 to v3.4): https://docs.mongodb.com/v3.4/administration/install-community/
Ensure that Mongodb is running after installation.
Assuming npm is installed with Nodejs, run the npm command for installing openhim-core globally.
$ sudo npm install openhim-core -g
Before starting openhim-core, the api port has to be changed from its default of Port 8080, to prevent conflicts with OpenMRS and OpenEMPI. The config files can be found in node_modules/openhim-core/config.md and node_modules/openhim-core/default.json. Your node_modules folder is in the node install directory by default, and can be found based on this npm documentation.
In both files, change the port under api→ httpsPort from port 8080 to another port(e.g. Port 8085).
After the port has been configured, openhim-core can be run from anywhere using the following command.
More information regarding OpenHIM setup can be found at https://openhim.readthedocs.io/en/latest/getting-started.html
Follow the OpenHIM guide on "Installing the OpenHIM Console": https://openhim.readthedocs.io/en/latest/getting-started.html#installing-the-openhim-console
Releases can be found on the OpenHIM Console Github Page: https://github.com/jembi/openhim-console
OpenHIM Console has to be configured to connect to the openhim-core API Port. The config can be found in the directory openhim-console was extracted to, under config/default.json. The port has to match the API port configured in openhim-core in Step 3.
Ensure your web server is running before accessing the web console.
Once installed, the OpenHIM console can be accessed at your web server's default port (Ubuntu apache2 and nginx: Port 80). Login with the default details:
You will be prompted to change the password upon successful login. If running for the first time with the default configuration, there may be an error logging in due to the use of a self signed certificate. Follow the instructions in the error or the instructions under "Getting Started with OpenHIM Console" on the Github Page if needed.
After logging in, go to Export/Import, and Import the following configuration: openhim-openempi-default.json
This will setup channels for PIX and PDQ, forwarding traffic from OpenMRS to the necessary ports for OpenEMPI. It also converts the HL7 over HTTP to HL7 over MLLP. Lastly, it creates a client with the credentials admin:admin, to allow OpenMRS to connect.
More information on OpenHIM Configuration can be found in the OpenHIM Documentation.
Download OpenEMPI from the OpenEMPI Website: https://www.openempi.org/openempi-downloads/index.html
Install OpenEMPI using OpenEMPI Wiki Instructions: http://www.openempi.org/confluence/display/openempi30/Installation+Instructions
After OpenEMPI is installed, it has to be configured to work with OpenMRS.
By default, OpenEMPI uses Port 8080 as the port for the administration webpage. This will cause a conflict as OpenMRS and OpenHIM also have Port 8080 as default ports. In order to prevent this conflict, the config file can be modified to change the port to another port(e.g. port 8090). OpenEMPI installs to a user's home directory, and the config file can be found in openempi/conf/server.xml.
The API ports that OpenEMPI uses for PIX/PDQ Communication can also be changed if needed. By default, PIX uses Port 3600 and PDQ uses Port 3700. The PDQ port can be changed in openempi/openempi-entity-x.x.xc/conf/PdSupplierConnections.xml(where x.x.x is the version number) and the PIX port can be changed in openempi/openempi-entity-x.x.xc/conf/PixConsumerConnections.xml and openempi/openempi-entity-x.x.xc/conf/PixManagerConnections.xml
Once the Admin Port has been changed, start openempi by running the appropriate script in the openempi/bin folder.
Unix based systems: startup.sh
The openempi admin can then be accessed through your web browser at localhost:8080/openempi-admin, where 8080 is replaced by the port you have configured in Step 1.
Login to OpenEMPI. Default:
Go to Edit→Edit Identifier Domains
Here we can add and change the identifier domains the OpenEMPI uses. The OpenEMPI GID is the default global identifier domain used in the MPI. The OpenMRS ID has to be added to OpenEMPI through "Add Identifier Domain".
Here the OpenMRS ID can be added with the following values:
Once this has been added, OpenEMPI has been configured for use with OpenMRS.
Further information on configuring OpenEMPI can be found in the OpenEMPI Documentation. Hapi TestPanel is an HL7v2 message editor, transmitter and receiver that can be used to test that OpenEMPI is configured correctly and working.
In order to use an MPI, the following Global Properties must be configured:
In order to allow interoperability between various MPIs, a TypeMap global property is created such that the Uuid of each Patient Identifier in OpenMRS can be converted to the ID format used by the MPI. OpenEMPI uses an Object Identifer(OID) based system with HL7 OIDs. The default global properties thus do a mapping from an OpenMRS Uuid to the OpenEMPI ID. The map has three sections:
By default, there are two TypeMaps configured for use with OpenEMPI:
In order to authenticate with the MPI, you have to add two properties to the .OpenMRS/openmrs-runtime.properties file. These have to be the credentials configured within the MPI you are using.