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
1. ```
git clone https://github.com/eliasmu/openlmis-hearth
```
  1. 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.
2. ```
cd openlmis-hearth
```
3. ```
./build.sh
```
  1. The result is a built Docker container (which we will run below).
Add HEARTH and MongoDB to the openlmis-ref-distro
1. ```
git clone https://github.com/OpenLMIS/openlmis-ref-distro
```
  1. If you already have the openlmis-ref-distro checked out, you can use that.
2. edit docker-compose.yml to add the following lines:
  1. ```
  mongo:
    image: mongo
    depends_on: [consul]
  
  hearth:
    image: openlmis/openlmis-hearth
    depends_on: [consul, mongo]
    volumes:
      - 'service-config:/config'
```
3. ```
./start-local.sh
```
4. 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:
1. ```
git clone https://github.com/brandonbowersox/openhim-and-hearth.git
```
2. ```
cd openhim-and-hearth
```
3. ```
docker-compose build && docker-compose up -d
```
4. Note: These steps are equivalent to using the public Docker images and instructions here:
  1. Install and run OpenHIM using Docker - see https://openhim.readthedocs.io/en/latest/getting-started.html#installation-using-docker
    1. 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.
  2. Install and run HEARTH using Docker - see https://hub.docker.com/r/jembi/hearth/
    1. ```
    docker run jembi/hearth
```
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.