This guide is to help people to setup the OpenHIE reference applications for the first time. It goes through the steps needed to setup and configure the applications to work together.

Install the applications

1. Install OpenHIM and the required mediators
   
   1. You will need to install both the OpenHIM-core (the server) and the OpenHIM-console (the web interface)
   2. To install the OpenHIM-core follow the steps found here: https://github.com/jembi/openhim-core-js#installation-and-development
   3. To install the OpenHIM-console follow the steps found here: https://github.com/jembi/openhim-console#production-deployment
   4. You will also need to install the xds-mediator. (This can be on a separate server or on the same server as the OpenHIM)
      1. This mediator is a Mule ESB application, you can find it here: https://github.com/jembi/ohie-xds-mediator
      2. Compile this application by running 'mvn package'
      3. Download Mule ESB standalone: https://repository.mulesoft.org/nexus/content/repositories/releases/org/mule/distributions/mule-standalone/3.5.0/mule-standalone-3.5.0.tar.gz
      4. Extract the Mule Standalone download and copy the .zip file that was produced when we compiled the application to the /apps folder.
      5. Start mule by running ./mule start
   5. If you run into trouble ask for help in the interoperability layer community: https://groups.google.com/forum/?hl=en&fromgroups#!forum/openhie-interoperability-layer
2. Install OpenSHR
   
   1. First you will need to install OpenMRS v1.10 which is the platform on which the OpenSHR is built, you can find the step here: https://wiki.openmrs.org/display/docs/Installing+OpenMRS
   2. Secondly you will need to compile and load each of the following OpenMRS modules:
      1. https://github.com/jembi/openmrs-module-shr-xds-b-repository#setup
      2. https://github.com/jembi/openmrs-module-shr-contenthandler
      3. https://github.com/jembi/openmrs-module-shr-odd
      4. https://github.com/jembi/openmrs-module-shr-cdahandler
      5. https://github.com/jembi/openmrs-module-shr-atna
   3. Next, you will need to install an XDS.b registry (together the XDS.b registry and OpenMRS with the above modules, which make it an XDS.b repository implementation, together make up the OpenSHR)
      1. We suggest the use of OpenXDS to provide the XDS.b registry component, you can find the instruction for installing this tool here: https://www.projects.openhealthtools.org/sf/go/page1120
   4. If you run into trouble ask for help in the shared health record community: https://groups.google.com/forum/?hl=en&fromgroups#!forum/openhie-shr
3. Install OpenInfoMan
   1. See steps here: https://github.com/openhie/openinfoman/wiki/Install-Instructions
   2. If you run into trouble ask for help in the health worker registry community: https://groups.google.com/forum/?hl=en&fromgroups#!forum/provider-registry
4. Install OpenEMPI or Mohawk CR
   1. Ask the OpenHIE client registry community for help getting setup: https://groups.google.com/forum/?hl=en&fromgroups#!forum/client-registry

Configure the applications to work together

1. Configure OpenHIM
   
   1. Login to the OpenHIM console web app
   2. You will need to create a few channel and add some client that can access those channels, for more information on doing this see: https://github.com/jembi/openhim-console/wiki/Getting-started-guide
   3. The first channel you will need to add is a channel that communicates with the xds-mediator
      1. Go to channel and click '+ channel' to add a new channel
      2. Enter the following details:
         1. name: OHIE: XDS repository and registry
         2. URL pattern: /xdsrepository|/xdsregistry
         3. Allowed roles and client: ohie
         4. Under the routes tab, add a new route with:
            1. Name: XDS.b Mediator
            2. Primary: True
            3. Type: HTTP
            4. Secured: Not Secured
            5. Host: <host_of_the_machine_running_xds-mediator>
            6. Port: 8081
         5. Save the channel
   4. The second channel that you will need to add enables HL7 v2 message to be passed through to the Client Registry
      1. Go to channel and click '+ channel' to add a new channel
      2. Enter the following details:
         1. Name: OHIE: PIX/PDQ
         2. URL pattern: /pixpdq
         3. Channel Type: select 'TCP'
         4. TCP Host: 0.0.0.0
         5. TCP Port: 8989
         6. Allowed roles and client: ohie
         7. Under the routes tab, add a new route with:
            1. Name: CR
            2. Primary: True
            3. Type: TCP
            4. Secured: Not Secured
            5. Host: <host_of_the_machine_running_client_registry>
            6. Port: <port_of_client_registry>
            7. Path: /test
         8. Save the channel
   5. You will need to setup a few clients with the role ohie that can access these channels
   6. If you run into trouble ask for help in the interoperability layer community: https://groups.google.com/forum/?hl=en&fromgroups#!forum/openhie-interoperability-layer
2. Configure OpenSHR
   1. Ask the SHR community for help: https://groups.google.com/forum/?hl=en&fromgroups#!forum/openhie-shr
3. Configure OpenInfoMan
   1. Ask the HWR community for help: https://groups.google.com/forum/?hl=en&fromgroups#!forum/provider-registry
4. Configure OpenEMPI or Mohawk CR
   1. Ask the HWR community for help: https://groups.google.com/forum/?hl=en&fromgroups#!forum/client-registry

Related articles