Home
Welcome to the MetaData Synchronization (MDSync) user manual
If you work within the DHIS2 ecosystem, you are already aware that each instance of DHIS2 is a self-contained environment and sharing data and metadata across multiple implementations can be a challenging and laborious process.
MetaData Sync is a DHIS2 application that has been conceived and designed to simplify and automate the process of sending data and metadata from one DHIS2 instance to one or several other DHIS2 implementations, however different they might be.
This tool will save you a lot of time and effort syncing data and metadata between diverse DHIS2 instances.
MD Sync can synchronize:
- Metadata
- Events
- Aggregated data
An instance running MD Sync can send data towards other instances (push) or retrieve data from other instances (pull). In this document we assume that we are configuring a the local instance to push data toward other instances
Through this guide you will learn how to install and use it in your processes.
First, a quick overview of this guide:
-
With Instance Configuration you will learn how to setup the destination instance
-
Mapping is a great feature that allows you to synchronize data between instances with different metadata.
-
The synching chapter is a comprehensive guide to learn how to create synchronization processes for aggregated data, events and metadata.
-
Finally the rules section explains how to save and schedule synchronizations.
-
History is about keeping track of the synching operations you have made.
The typical setup and use workflow with Metadata Sync involves these steps, and requires different roles: Sysadmin, DHIS admin, MDSync configurator and MDSync run-only user
With this diagram in mind now this main panel will make sense for you
Metadata Sync development is sustainable thanks to the partners for which we build customized DHIS2 solutions. This application has been funded by the WHO Global Malaria Programme, Medecins Sans Frontières (MSF), Samaritan’s Purse, Health Information Systems Program South Africa and the U.S. President’s Malaria Initiative (PMI) to support countries in strengthening the collection and use of health data by using DHIS2.
It has also been funded by WHO and the WHO Integrated Data Platform (WIDP), where several WHO departments and units share a dedicated hosting and maintenance provided by EyeSeeTea, back some specific new features. The Long Term Agreement EyeSeeTea holds with WHO for this maintenance includes maintenance of this application, ensuring that it will always work at least with the last version of WIDP. We are passionate about both DHIS2 and open source, so giving back to the community through dedicated open-source development is and will always be part of EyeSeeTea’s commitment.
You can also support our work through a one-time contribution or becoming a regular github sponsor
Like every other EyeSeeTea software, this is open source (GNU General Public License v3.0) Use it at your own responsibility as much as you want.
The source code is available at GitHub We are very happy to receive any contribution, so please if you have yours, don't hesitate to send us your code.
MetaData Synchronization is compatible with DHIS2 V2.30 to 2.38
