Bahmni-OpenIMIS Integration System Installation guide

Bahmni-OpenIMIS Integration System Installation guide
Overview of OpenIMIS integration system
OpenIMIS Integration system consists of the following modules:

1. bahmni/bahmni-insurance-connect: an app/service for openIMIS integration (java)

2. bahmni/bahmni-insurance-odoo : a insurance module for odoo (python)

3. bahmni/openmrs-module-insurance-integration : a openmrs module for insurance (java)

4. bahmi ui apps custom changes : This is available only for NepalEHR-Custom-UI

Installation and configuration steps

  1. Installing and configuring Bahmni-insurance-connect service :

              a. Download insurance-integration rpm from https://github.com/Possiblehealth/possible-artifacts/tree/master/92-artifacts

              b. Install the rpm:

                       i. rpm -ivh insurance-integration-0.0.1-1.noarch.rpm

              c. Update the configuration properties as required at location : /etc/insurance-integration/insurance-integration.properties

                       i. Refer : https://github.com/Bahmni/bahmni-insurance-connect/blob/master/src/main/resources/application.properties

              d. Status check : service insurance-integration status and restart as required

              e. Check logs : tail -f /var/log/insurance-integration/insurance-integration.log

   2. Installing openmrs-module-insurance-integration

              a. Get the Omod from https://github.com/Possiblehealth/possible-artifacts/tree/master/92-artifacts

              b. Install the omod form openmrs/admin https://wiki.openmrs.org/display/docs/Administering+Modules

   4. Installing bahmni-insurance-odoo module

             a. Get the latest codebase from https://github.com/Bahmni/bahmni-insurance-odoo

                       i. Go to location /opt/bahmni-insurance-addons/ where /opt/bahmni-insurance-addons is Location for custom-addons

                       ii. Git clone https://github.com/Bahmni/bahmni-insurance-odoo

                       iii. Git checkout develop (for Dev and QA env)

                       iv. Git pull origin develop (for Dev and QA env)

                       v. Git checkout master /git pull origin master (for Prod env)

             b. Point the above location in odoo-addons path

                       i.  Goto /etc/odoo.conf

                       ii.  Add location of bahmni insurance module in addons-section as:

                            addons_path = /opt/bahmni-erp/bahmni-addons,/opt/bahmni-erp/odoo/addons,/usr/lib/python2.7/site-packages,/opt/bahmni-insurance-addons/

             c. Install insurance application from odoo apps

             d. Restart odoo : service odoo restart

5. Installing openIMIS ssl certificate for accessing HTTPS

             a. Get the SSL certificate file from the openimis site : which is the site with which you are trying to integrate

             b. Go inside $JAVA_HOME/bin i.e goto the java installation directory within bin directory

             c. Import the downloaded certificate

                 keytool -import -alias imiscert -keystore ../lib/security/cacerts -file /root/openimis.cer

             d. Password: changeit

   6. Http.d Changes in server

             a. Create insurance_integration_ssl.conf file inside /etc/httpd/conf.d/

             b. Content of insurance_integration_ssl.conf should be :

                #for insurance-int
                ProxyPass /insurance-integration http://localhost:8092/insurance-integration/
                ProxyPassReverse /insurance-integration {+}http://localhost:8092/insurance-integration/

             c. Service httpd restart

             d. Service insurance-integration restart

7. Post Installation Check:

  The Bahmni-OpenIMIS Integration System Installation can be checked as follows:

            a. Browsing the swagger UI  https://localhost/insurance-integration/swagger-ui.html#/request-processor

                       i. Log In to the Swagger and check any of the function listed under request-processor.