Versions Compared

Key

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

...

  1. Download and install dhis-integration rpm from https://github.com/Possiblehealth/possible-artifacts/blob/master/90-artifacts/dhis-integration-1.0-1.noarch.rpm (or build latest yourself from here: https://github.com/Possiblehealth/dhis2-integration)

    Code Block
    languagebash
    themeEmacs
    yum install dhis-integration-1.0-1.noarch.rpm


  2. Update the properties file for DHIS2 integration app, located at '/etc/dhis-integration/dhis-integration.yml', with right configuration.

    KeyDescriptionExample
    openmrs.root.urlUrl to access Openmrs servicehttp://localhost:8050/openmrs/ws/rest/v1
    bahmni.login.urlWhen user isn't logged in, then user is redirected to this url.

    https://ehr.possible.org/bahmni/home/#/login?showLoginMessage

    reports.urlBahmni reports url. Used for downloading reports.https://ehr.possible.org/bahmnireports/report
    reports.json

    This file contains configurations of DHIS2 reports.

    /var/www/bahmni_config/openmrs/apps/reports/reports.json
    dhis.config.directoryThis folder contains DHIS2 integration configurations program wise./var/www/bahmni_config/dhis2/
    dhis.urlThe DHIS2 government server instance url.

    Ex. 1: http://100.100.100.100:8080/

    Ex. 2: http://200.100.20.30:8888/hmistest/

    Note that the url could be at domain or ip address level (ex1) or could be at a specific path(ex2)

    dhis.userThe username to access DHIS2 instance.

    username

    dhis.passwordThe password for the DHIS2 user.

    password

    openmrs.db.urlMysql connection url to access "openmrs" database. Set valid user and password in the url.

    jdbc:mysql://localhost/openmrs?user=openmrs-user&password=password

    submission.audit.folderAll DHIS2 submissions are stored in this directory. Ensure the directory exists and "bahmni" user has access to it, or configure a different directory.

    /dhis-integration-data

    server.portServer config. Port for server to listen to.

    8040

    server.context-pathServer config. Mapping incoming requests.

    /dhis-integration/

    log4j.config.fileServer config. Properties file for logger of dhis-integration server.

    log4j.properties


  3. Download and place the ssl.conf file.

    Code Block
    languagebash
    themeEmacs
    cd /etc/httpd/conf.d/
    wget https://raw.githubusercontent.com/Possiblehealth/possible-config/89662e8e823fac3dbcaf111aa72713a63139bb03/playbooks/roles/possible-dhis-integration/templates/dhis_integration_ssl.conf


  4. Configure Bahmni landing page to show DHIS2 integration app.
    Insert the following in "/var/www/bahmni_config/openmrs/apps/home/extension.json" file

    Code Block
    languagetext
    themeEmacs
    "possible_dhis_2_integration": {
    	"id": "possible.dhis2Integration",
    	"extensionPointId": "org.bahmni.home.dashboard",
    	"type": "link",
    	"label": "DHIS2 integration",
    	"url": "/dhis-integration/index.html",
    	"icon": "fa-book",
    	"order": 11,
    	"requiredPrivilege": "app:reports"
    }


  5. Ensure Bahmni reports service is installed and running successfully.

    Code Block
    languagebash
    themeEmacs
    service bahmni-reports status ##should be running


  6. Restart ssl and dhis-integration services.

    Code Block
    languagebash
    themeEmacs
    service httpd restart
    service dhis-integration restart


    Now the DHIS2 integration app is available on landing screen, given that the user has reporting privileges.

...