DHIS2 Implementation Guide

2.24

Warranty:  THIS DOCUMENT IS PROVIDED BY THE AUTHORS ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS MANUAL AND PRODUCTS MENTIONED HEREIN, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

License:  Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the source of this documentation, and is available here online: http://www.gnu.org/licenses/fdl.html.

Revision History
Revision 25942016-11-23 11:04:16
Version 2.24

Table of Contents

About this guide
1. Recommendations for National HIS Implementations
1.1. Database development
1.2. Import and mapping of existing databases
1.3. Securing necessary resources for the implementation
1.4. Integration of parallel systems
1.5. Setup of a reliable online national server
1.6. Pilot phase
1.7. Roll out
1.8. Training
1.9. Decentralization of data capture and management
1.10. Review and extension
2. Conceptual Design Principles
2.1. All meta data can be added and modified through the user interface
2.2. A flexible data model supports different data sources to be integrated in one single data repository
2.3. Data input != Data output
2.4. Indicator-driven data analysis and reporting
2.5. Maintain disaggregated facility-data in the database
2.6. Support data analysis at any level in the health system
3. Setting Up a New Database
3.1. Strategies for getting started
3.2. Controlled or open process?
3.3. Steps for developing a database
3.3.1. The organisational hierarchy
3.3.2. Data Elements
3.3.3. Data sets and data entry forms
3.3.4. Validation rules
3.3.5. Indicators
3.3.6. Report tables and reports
3.3.7. GIS (Maps)
3.3.8. Charts and dashboard
4. Deployment Strategies
4.1. Offline Deployment
4.2. Online deployment
4.3. Hybrid deployment
4.4. Server hosting
5. DHIS2 as Data Warehouse
5.1. Data warehouses and operational systems
5.2. Aggregation strategy in DHIS2
5.3. Data storage approach
6. End-user Training
6.1. What training is needed
6.2. Strategies for training
6.2.1. Training of trainers
6.2.2. Workshops and on-site training
6.2.3. Continuation of training
6.3. Material and courses
7. Integration
7.1. Integration and interoperability
7.2. Benefits of integration
7.3. What facilitates integration and interoperability
7.4. Architecture of interoperable HIS
8. Installation
8.1. Introduction
8.2. Server specifications
8.3. Server setup
8.3.1. Creating a user to run DHIS2
8.3.2. Creating the configuration directory
8.3.3. Setting server time zone and locale (optional)
8.3.4. PostgreSQL installation
8.3.5. PostGIS installation
8.3.6. PostgreSQL performance tuning (optional)
8.3.7. Database configuration
8.3.8. File store configuration (optional)
8.3.9. Google service account configuration (optional)
8.3.10. Java installation
8.3.11. Install Tomcat and DHIS2
8.3.12. Running DHIS2
8.3.13. Starting tomcat at boot-time
8.4. Reverse proxy configuration
8.4.1. Basic setup for nginx
8.4.2. Enabling SSL on nginx
8.4.3. Enabling caching and SSL on nginx
8.4.4. Additional resources on SSL
8.4.5. Making resources available with nginx
8.4.6. App setup with nginx
8.4.7. Basic reverse proxy setup with Apache
8.4.8. SSL encryption with Apache
8.5. LDAP configuration
8.6. Encryption setup
8.6.1. Java Cryptography Extension
8.6.2. Password configuration
8.6.3. Considerations
8.7. DHIS2 configuration reference
8.8. Application logging
8.9. Working with the PostgreSQL database
8.10. DHIS2 Live setup
9. Support
9.1. Home page: dhis2.org
9.2. Collaboration platform: launchpad.net/dhis2
9.3. Reporting a problem
10. Organisation Units
10.1. Organisation unit hierarchy design
10.2. Organisation unit groups and group sets
11. Data Elements and Custom Dimensions
11.1. Data elements
11.2. Categories and custom dimensions
11.3. Data element groups
12. Data Sets and Forms
12.1. What is a data set?
12.2. What is a data entry form?
12.2.1. Types of data entry forms
12.3. From paper to electronic form - Lessons learned
12.3.1. Identify self-contained data elements
12.3.2. Leave calculations and repetitions to the computer - capture raw data only
13. Data Quality
13.1. Measuring data quality
13.2. Reasons for poor data quality
13.3. Improving data quality
13.4. Using DHIS2 to improve data quality
13.4.1. Data input validation
13.4.2. Min and max ranges
13.4.3. Validation rules
13.4.4. Outlier analysis
13.4.5. Completeness and timeliness reports
14. Indicators
14.1. What is an indicator?
14.2. Purpose of indicators
14.3. Indicator-driven data collection
14.4. Managing indicators
15. Users and User Roles
15.1. Users
15.2. User Roles
16. Data Analysis Tools Overview
16.1. Data analysis tools
16.1.1. Standard reports
16.1.2. Data set reports
16.1.3. Data completeness report
16.1.4. Static reports
16.1.5. Organisation unit distribution reports
16.1.6. Report tables
16.1.7. Charts
16.1.8. Web Pivot tables
16.1.9. GIS
16.1.10. My Datamart and Excel Pivot tables
17. Pivot Tables and the MyDataMart tool
17.1. Pivot table design
17.2. Connecting to the DHIS2 database
17.3. Dealing with large amounts of data
18. DHIS2 as a platform
18.1. Web portals
18.2. Apps
18.3. Information Systems
19. Localization concepts
19.1. DHIS2 i18n tool
19.2. Using the DHIS2 translation server
19.3. Important localization concepts
20. DHIS2 Tools Guide
20.1. Overview
20.2. Architecture
20.3. Installation
20.4. DHIS2 tools reference
dhis2-instance-create — Creates a new dhis2 instance
dhis2-startup — Starts a dhis2 instance
dhis2-shutdown — Stops a dhis2 instance
dhis2-clone — Clones the database of one instance to another instance
dhis2-deploy-war — Deploys a war file
dhis2-logview — Shows log file
dhis2-logtail — Shows the bottom log file in real time. Type Ctrl-C to exit.
dhis2-create-admin — Create a user for administering dhis2 instances
20.5. Troubleshooting guide
21. DHIS2 Documentation Guide
21.1. DHIS2 Documentation System Overview
21.2. Introduction
21.3. Getting started with GitHub
21.4. Getting the document source
21.5. Editing the documentation
21.6. DHIS2 Bibliography
21.7. Using images
21.8. Linking documents together
21.9. Handling multilingual documentation
21.10. Building the documentation
21.10.1. Building the documentation with Apache maven
21.10.2. Building with xmlto
21.11. Committing your changes back to GitHub

List of Figures

20.1. Single machine all-in-one installation

List of Tables

14.1. Indicator examples
20.1. Troubleshooting guide