/
OpenHIE Facility Sandbox - Demo Installation Instructions
OpenHIE Facility Sandbox - Demo Installation Instructions
Background
These instructions allow you to locally install and run a demo of the OpenLMIS-OpenHIE facility registry interoperability. See OpenLMIS v3 - TZ Facility Registry with mCSD and OpenLMIS Facility Registry Software Requirements Specification for background info.
Prerequisites
- Git
- Docker and Docker Compose - for installation info, see Step 1 in Getting Started of New Developer Onboarding with OpenLMIS
- npm
- Sufficient RAM to run OpenLMIS, OpenHIM, and HEARTH; we suggest 16+GB of RAM
To Run OpenLMIS with a HEARTH microservice
- Build a Docker image for HEARTH with consul support
git clone https://github.com/eliasmu/openlmis-hearth
- This Git repository is a Docker image based on the jembi/hearth image with additions for consul so it can run as a microservice inside OpenLMIS.
cd openlmis-hearth
./build.sh
- The result is a built Docker container (which we will run below).
- Add HEARTH and MongoDB to the openlmis-ref-distro
git clone https://github.com/OpenLMIS/openlmis-ref-distro
- If you already have the openlmis-ref-distro checked out, you can use that.
- edit docker-compose.yml to add the following lines:
mongo:
image: mongo
depends_on: [consul]
hearth:
image: openlmis/openlmis-hearth
depends_on: [consul, mongo]
volumes:
- 'service-config:/config'
./start-local.sh
- Congratulations! You are now running OpenLMIS with HEARTH and MongoDB as additional microservices.
- To confirm the HEARTH FHIR server is running, open a browser to http://localhost/fhir/Location
- You will see an XML result. It is a Bundle with an empty set of Locations like this:
<Bundle><id value="1fd62c60-97d8-11e8-8825-3d30fa0c2830"/><meta><lastUpdated value="2018-08-04T11:18:34.172+00:00"/></meta><type value="searchset"/><total value="0"/><link><relation value="self"/><url value="http://localhost/3447/fhir/Location"/></link></Bundle>
- TO BE CONTINUED...
To Run OpenHIM, HEARTH and MongoDB
- Install and run OpenHIM and HEARTH using Docker:
git clone https://github.com/brandonbowersox/openhim-and-hearth.git
cd openhim-and-hearth
docker-compose build && docker-compose up -d
- Note: These steps are equivalent to using the public Docker images and instructions here:
- Install and run OpenHIM using Docker - see https://openhim.readthedocs.io/en/latest/getting-started.html#installation-using-docker
- Note: OpenHIM will start a MongoDB container which we also want to use for HEARTH; the git repo above combines HEARTH into the same docker-compose file as OpenHIM so they can both share one MongoDB database.
- Install and run HEARTH using Docker - see https://hub.docker.com/r/jembi/hearth/
docker run jembi/hearth
- Install and run OpenHIM using Docker - see https://openhim.readthedocs.io/en/latest/getting-started.html#installation-using-docker
- Log in to OpenHIM and reset the root password - see https://openhim.readthedocs.io/en/latest/getting-started.html#logging-in-to-the-openhim-console
- Congratulations! You now have OpenHIM and HEARTH, which both use a MongoDB, all running together.
, multiple selections available,
Related content
OpenLMIS Reporting Stack DevOps Training
OpenLMIS Reporting Stack DevOps Training
More like this
Stand-up and Configure the Reporting Stack
Stand-up and Configure the Reporting Stack
More like this
841: Add Server Service Discovery
841: Add Server Service Discovery
More like this
Working around OpenLMIS Reference Distribution container registration failures
Working around OpenLMIS Reference Distribution container registration failures
More like this
Getting Started
Getting Started
More like this
Nifi User Guide
Nifi User Guide
More like this
OpenLMIS: the global initiative for powerful LMIS software