ashaban/openhim-mediator-mhero-tanzania

mHero Mediator ============== This mediator synchronises data between the mHero systems. In particular, it pulls providers from an OpenInfoMan server and pushes those providers to RapidPro as contacts. Then, it queries RapidPro for contacts and loads those contacts into a new Document in the OpenInfoMan as providers. The providers now have a RapidPro contact ID attached so that the OpenInfoMan may be queried for uses where providers need to be linked to RapidPro contacts. Getting started guide --------------------- The easiest way to install this mediator is to use the debian package which will install the OpenHIM-core as well as the medaitor. ```sh $ sudo add-apt-repository ppa:openhie/release $ sudo apt-get update $ sudo apt-get install openhim-mediator-mhero-liberia openhim-console ``` **Note**: If you change the root@openhim.org password (e.g. on first login) __after__ installing the mediator then the mediator config has to be changed here to reflect that: `/usr/share/openhim-mediator-mhero-liberia/config/config.json` When the mediator starts, it registers itself with the OpenHIM-core. Once, this is done you may configure the mediator directly from the OpenHIM-console by going to Mediator > mHero Mediator. Here you will need to setup the following: * RapidPro Server * URL - The base URL of the RapidPro server * Slug - The unique identifying part of the assigning authority, this will be combined with the base URL * Authentication Token - The authentication token for the RapidPro API * Group Name - (optional) Restricts searching for RapidPro contacts to only this group * OpenInfoMan Server * URL - The base URL of the OpenInfoMan server * Provider query document - The CSD document to query providers from in order to send to RapidPro * RapidPro contacts document - The CSD document to store contacts retrieved from RapidPro The mediator will automatically install 3 polling channels to control the synchronisation, you must also configure these channels to suit …