Open-Source Code Repository links #
The release package of DAFNE is available on a dedicated Open-Source GitHub repository:
• https://github.com/DHS-DataflowNetworkEnvironment/DAFNE-Deployment/releases
Public Docker Repository links #
The relevant Docker images are available on dedicated Public Docker Hub repository:
• https://hub.docker.com/r/collaborativedhs/dafne/tags
Installation and Configuration Guidelines #
The following software must be pre-installed on the Virtual Machine:
- Docker engine (19.03.5)
- Docker compose (1.24.1)
- curl (>=7.75)
- unzip (>=6.0)
Installation #
The following commands will install a version of DAFNE software:
curl -LJO https://github.com/DHS-DataflowNetworkEnvironment/DAFNE-Deployment/archive/refs/tags/<DAFNE-VERSION>.zip
unzip DAFNE-Deployment-<DAFNE-VERSION>.zip
cd DAFNE-Deployment-<DAFNE-VERSION>
sh install.sh <DAFNE-VERSION>
In order to start the docker compose, it is then necessary to configure properly the following files:
- data/dafne/front-end/config/config.json
- data/dafne/back-end/config/db_credentials.env
- data/dafne/back-end/config/config.json
Finally, the following command starts the docker-compose:
sh start.sh &
Configuration #
Please refer to Installation and Configuration Manual for details about the configuration.
Please find it here attached.
User Guide #
The Dataflow Network Environment (DAFNE) is a web application, accessible from a Web Browser.
Very detailed information on how to use DAFNE features is present in the DAFNE Software User Manual.
Please find it here attached.
Login #
First time the user reaches the application via URL, a login dialog is displayed.
Once logged-in DAFNE, the home view appears showing the default centres configuration.
Add/Edit/Remove Centres #
Centre is the entity representing the local or remote node in the network.
Users with “Dataflow Manager” role can add, edit or remove a Center by accessing the Centers page
from the user menu.
Add/Edit/Remove Services #
Service is the DAFNE entity representing every local or remote DHS network node with an established
interface with other configured network nodes.
Users with “Dataflow Manager” role can add, edit or remove a service by clicking on the Services item
from the user menu.
Add/Edit/Remove Synchronizers #
Users with “Dataflow Manager” role can manage and configure a remote synchronization via DAFNE
Synchronizers page.
Please note that Intelligent Synchronizers (present in DHuS version >= 3.1.x) are supported too, but itis not yet possible to start, stop, modify or delete them.
Dataflow Visualization: Network View #
Once all Services and Synchronizers have been configured, DAFNE visualizes the dataflow information
of the configured network, in particular for:
- the local DHS centre rolling policy (“Archive info” panel)
- the active Data Sources (“Data sources info” panel)
- number of the DHS nodes retrieving the data from the local Centre (“DHS connected” panel)
Completeness Metric: computation and visualization #
The completeness in DAFNE is shown as the amount of product published per day on all selected Front-
End, Single-Instance or CSC services configured within DAFNE.
The visualization of the completeness information is computed using a filter. The user can select with a
checkbox if the filter should be based on a chosen mission and product-type, or if the filter should be
taken from a configured synchronizer.
Users can choose among different available charts:
- Sunburst Single
- Sunburst Stacked
- Single Bars
- Stacked Bars
- Marimekko
Service Availability Metric: computation and visualization #
The Service Availability in DAFNE is shown as the weekly or daily average of the local Centre availability,
which is recorded in a configurable interval.
Through a checkbox in the filter the operator can choose whether group the data weekly or daily. If
weekly aggregation is chosen only the bar chart is active, while both charts are available for the daily
data aggregation.
The service availability chart can be shown as a Bar Chart or a Calendar Chart.
Publication Latency Metric: computation and visualization #
The Publication Latency in DAFNE is shown as the weekly or daily average of the time difference between the local centre products Creation Date and the related synchronized Data Source products CreatiDate, which is recorded at a configurable interval.
The visualization of the Publication Latency information is computed using a filter based on a Synchronizer and a time range. The selectable Synchronizers in a dropdown menu are those present inthe Back-End services associated to the local Centre.
The publication latency chart can be shown as a Bar Chart or a Line Chart.