DHIS2 Implementer guide

2.26

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 HEAD@02efc582017-10-18 00:22:07
Version 2.26

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
8.3.4. PostgreSQL installation
8.3.5. PostgreSQL performance tuning
8.3.6. PostGIS installation
8.3.7. Database configuration
8.3.8. Java installation
8.3.9. Tomcat and DHIS2 installation
8.3.10. Running DHIS2
8.4. File store configuration
8.5. Google service account configuration
8.6. LDAP configuration
8.7. Encryption configuration
8.7.1. Java Cryptography Extension
8.7.2. Password configuration
8.7.3. Considerations for encryption
8.8. Read replica database configuration
8.9. Web server cluster configuration
8.9.1. Cluster configuration
8.9.2. Load balancing
8.10. Starting Tomcat at boot time
8.11. Reverse proxy configuration
8.11.1. Basic nginx setup
8.11.2. Enabling SSL on nginx
8.11.3. Enabling caching and SSL on nginx
8.11.4. Additional resources on SSL
8.11.5. Making resources available with nginx
8.11.6. Basic reverse proxy setup with Apache
8.11.7. SSL encryption with Apache
8.12. DHIS2 configuration reference
8.13. Application logging
8.14. Working with the PostgreSQL database
8.15. 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. About user management
15.1.1. About users
15.1.2. About user roles
15.1.3. About user groups
15.2. Workflow
15.3. Example: user management in a health system
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 of DHIS2
19.1.
19.2. DHIS2 i18n tool
19.3. Using the DHIS2 translation server
19.4. Database translation app
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
dhis2-nginx — Configure nginx with a specified or sample file
dhis2-integrity — Check database integrity of a DHIS2 instance
dhis2-restoredb — Restore a database dump to a dhis2 instance.
dhis2-backup — Create a backup of a dhis2 database
dhis2-delete-instance — Deletes the specified DHIS2 instance and its database.
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
22. Using JIRA for DHIS2 issues
22.1. Sign up to JIRA - it's open to everyone!
22.2. Report an issue
22.3. Search for issues
22.4. About filters
22.5. Create a filter
22.6. Add a filter to your profile
22.7. Remove search filter terms from your search
22.8. Communicate with us

List of Figures

20.1. Single machine all-in-one installation

List of Tables

14.1. Indicator examples
15.1. User management terms and definitions
15.2. Objects in the Users app
20.1. Troubleshooting guide

List of Examples

15.1.
15.2.