38.10 Synchronization settings

The following settings are used for both data and metadata synchronization.

Note

For more information about how you configure metadata synchronization, refer to Configure metadata synchronizing

Synchronization settings

Setting

Description

Remote server URL

Defines the URL of the remote server running DHIS2 to upload data values to.

It is recommended to use of SSL/HTTPS since user name and password are sent with the request (using basic authentication).

The system will attempt to synchronize data once every minute.

The system will use this setting for metadata synchronization too.

Note

To enable data and metadata synchronization, you must also enable Data synchronization and Metadata synchronization in the Data administration app > Scheduling .

Remote server user name

The user name of the DHIS2 user account on the remote server to use for data synchronization.

Note

If you’ve enabled metadata versioning, you must make sure that the configured user has the authority “F_METADATA_MANAGE”.

Remote server password

The password of the DHIS2 user account on the remote server. The password will be stored encrypted.

Enable versioning for metadata sync

Defines whether to create versions of metadata when you synchronize metadata between central and local instances.

Don’t sync metadata if DHIS versions differ

The metadata schema changes between versions of DHIS2 which could make different metadata versions incompatible.

When enabled, this option will not allow metadata synchronization to occur if the central and local instance(s) have different DHIS2 versions. This apply to metadata synchronization done both via the user interface and the API.

The only time it might be valuable to disable this option is when synchronizing basic entities, for example data elements, that have not changed across DHIS2 versions.

Best effort

A type of metadata version which decides how the importer on local instance(s) will handle the metadata version.

Best effort means that if the metadata import encounters missing references (for example missing data elements on a data element group import) it ignores the errors and continues the import.

Atomic

A type of metadata version which decides how the importer on local instance(s) will handle the metadata version.

Atomic means all or nothing - the metadata import will fail if any of the references do not exist.