Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Info

Bahmni has been ABDM certified. This document aim to explain the repositories which contains the Bahmni-ABDM integration code and how to setup ABDM features on an existing Bahmni implementation.

Table of Contents

Pre-requisites

  1. ABDM Sandbox client ID and Secrete

  2. HIU/HIP services and Bridges defined.

Github

...

Organisation

BahmniIndiaDistro

Repositories

...

  1. NDHM-React
    This repository contains the frontend code for ABHA verification pop-up.
    Tech stack- ReactJs

...

2. HIP Service
This repository contains code to interact with ABDM gateway APIs and Database.
HIP- Health information Provider refers to clinical establishments which generate or store customer data in digital form. These include hospitals, primary or secondary health care centres, nursing homes, diagnostic centres, clinics, medical device companies and other such entities as may be identified by regulatory authorities from time to time

Tech stack- C#

3. HIP Service Backend
This module is supporting the HIP service with all necessary openmrs/bahmni-core endpoints exposed that are required by the HIP service
Tech stack- Java

4. HIU UI

This Module consist of all the UI code for HIU ( Health Information User)

...

5. HIU Backend

This module has the backend code for HIU which interacts with the ABDM gateway and Database.
Tech stack- Java

6. bahmniapps and default config
These modules are bahmni frontend modules which contains the extension point changes for ABDM.
Tech stack- angularJs

Setup Steps

...

Note

[20-July-2023] The steps mentioned below are older. The currently recommend way to Install Bahmni with ABDM modules is to use the docker-compose version of Bahmni that is packaged in this repository here: https://github.com/BahmniIndiaDistro/bahmni-india-package . Read the following instructions: Running Bahmni with ABDM Integration on Docker

The following steps can be followed to setup ABDM features on top of existing Bahmni installation:

...

...

Hip omod requires Jackson-core-2.10.0.jar (To be placed in /opt/openmrs/openmrs/WEB-INF/lib/)

...

Jackson-annotations-2.10.0.jar  To be placed in /opt/openmrs/openmrs/WEB-INF/lib/

...

Jackson-databind-2.10.0.jar  To be placed in /opt/openmrs/openmrs/WEB-INF/lib/

  1. Install Bahmni.

  2. Download ndhm artefact and place it at /var/www/

    Code Block
    #Download ndhm artefact
    yum https://github.com/BahmniIndiaDistro/ndhm-react/releases/download/Release_v1/ndhm.zip
    
    unzip ndhm.zip -d ndhm
    mv ndhm /var/www/
    chown bahmni:bahmni /var/www/ndhm

Build and deploy hip backend omod at /opt/openmrs/modules/ 

  1. Download Bahmniapps artefact and place it at /var/www/

    Code Block
    #Download bahmnniapps artefact
    yum https://github.com/BahmniIndiaDistro/ndhm-react/releases/download/Release_v1/bahmniapps.zip
    
    unzip bahmniapps.zip -d bahmniapps
    mv bahmniapps /var/www/
    chown bahmni:bahmni /var/www/bahmniapps
  2. Download bahmni_config artefact and place it at /var/www/

    Code Block
    #Download bahmni_config artefact
    yum https://github.com/BahmniIndiaDistro/ndhm-react/releases/download/Release_v1/bahmni_config.zip
    
    unzip bahmni_config.zip -d bahmni_config
    mv bahmni_config /var/www/
    chown bahmni:bahmni /var/www/bahmni_config
  3. Download hip omod artefact and place it at /opt/openmrs/modules

  4. Code Block
    #Download hip artefact
    yum https://github.com/BahmniIndiaDistro/ndhm-react/releases/download/Release_v1/hipmodule.omod
    
    mv hipmodule.omod /opt/openmrs/modules/
    chown bahmni:bahmni /opt/openmrs/modules/hipmodule.omod
  5. Deploy the following dependencies as well.

    Code Block
    yum https://github.com/BahmniIndiaDistro/ndhm-react/releases/download/Release_v1/fhir2-omod-1.0.0-SNAPSHOT.omod
    
    mv fhir2-omod-1.0.0-SNAPSHOT.omod

...

  1.  /opt/openmrs/modules/

...

Development steps can be found: https://github.com/Bahmni-Covid19/openmrs-module-hip/blob/master/omod/docs/dev-setup.md

...

  1. 
    chown bahmni:bahmni /opt/openmrs/modules/fhir2-omod-1.0.0-SNAPSHOT.omod

  2. Use the following docker-compose.yml for hip and docker-compose.yml for HIU to pull down the images(hip-service image (bahmnicovid19/health-information-provider:latest), hiu-backend(bahmnicovid19/health-information-user:latest), hiu ui( bahmnicovid19/hiu-ui:latest) from docker hub

...

4. Use the following docker-compose.yml to start up the containers:

5. Build and deploy bahmniapps ( branch stream1/master) and default config ( branch stream1/master)

...

  1. ) and start up the containers

  2. Run the following command to restart openmrs:

    Code Block
    systemctl restart openmrs
  3. Update /etc/httpd/conf.d/ssl.conf file to have the following

...

  1. Code Block
    Alias  /ndhm /var/www/ndhm
  2. Restart httpd service

    Code Block
    systemctl restart httpd

Development steps can be found in the read me of all the repositories.

Reference Material:

  1. ABDM Sandbox (for testing purposes)

  2. ABDM Ecosystem

  3. ABDM Checklist for certified products like Bahmni

  4. ABDM HIP use-cases

  5. ABDM HIU use-cases