Initial Setup (1.1)

After installing and configuring the Adapter, the initial setup can be made. For the initial setup of the Adapter a simple user interface is provided. This user interface may be replaced by a more comprehensive setup app in the future (has not yet been decided).

With the default configuration the initial setup user interface can be accessed in any web browser by using http://localhost:8081/setup. The web browser will ask for a username and password of a DHIS2 user that has privilege ALL or F_SYSTEM_SETTING. After successful authentication a setup form will be displayed with further instructions and examples. The initial setup can be made once only and the initial setup form will not be accessible anymore.

The setup can be made with or without a connected FHIR Server. If the setup should be made with a FHIR Server, imports must have been enabled. The snippet below contains the relevant settings.

spring:
  # Settings of the Artemis message queueing system. For a non-clustered
  # installation the embedded client can be used where the data is stored
  # on the local file system.
  artemis:
    # Settings for the embedded client, that can be used for a non-clustered
    # installation.
    embedded:
      # Specifies of the embedded client should be enabled. If the adapter
      # runs in a clustered environment the embedded client must not be enabled
      # and host, port, username and password for the Artemis broker must be
      # specified.
      enabled: true

management:
  health:
    jms:
      # JMS health check can be enabled when Artemis queue is available.
      enabled: false

dhis2.fhir-adapter:
  # Specifies if the automatic import of FHIR resources to DHIS2 is enabled.
  import-enabled: true

More comprehensive setups must be made by using the API for administration and configuration of the Adapter. It is not required to use this simple initial setup user interface to use the Adapter.