The Archives.xml can be used to configure the connection between your sa,oc or fss with the archive. For an sa or oc the configuration only consists of the catalogueUrl in case you have configured the archve according the standard (which is usually the case).
An example is given below.
Data from the Open Delft-FEWS Archive can be used in a Stand Alone or Operator Client FEWS client; this functionality is called seamless integration. The Archives.xml file, located in the SystemConfigFiles folder, is used to add this seamless integration functionality to the Delft-FEWS system. Seamless integration between the Open Delft-FEWS Archive and the Operational Delft-FEWS Database means that when data is not found in the operational database, FEWS will search for this data in the Open Archive.
The seamless integration functionality is now available in the Time Series Display for external historical scalar time series. Additional functionality for simulations and external historical time series in included in the FEWS pi-services.
Below an example of the content an Archives.xml configuration file:
Note that a very common mistake made in configuring the Archives.xml is that the catalogueURL does not end with catalogue!
The only configuration needed in the Archives.xml is the location of the catalogue and thredds:
- The catalogue used for seamless integration is the internal elastic search catalogue (not the Geonetwork catalogue). The catalogue is used by the FEWS client to find archived data.
- The fileserver used for seamless integration in the THREDDS server. The fileserver is used to download the data from the archive.
The datafolder is optional. It is used by the pi-service (rest and soap) to read the data. If the datafolder is configured the data is read from the folder directly and not from THREDDS. Reading the data directly from disk is faster than reading the data from THREDDS. So the datafolder should be the root of the datafolder of the archive as it is on the server on which the pi-service is configured.
Test of the Archive configuration
To test if the catalogue url is correct, paste the url in an internet browser. If the config is correct the response below will be visible (or something similar)
To test if the fileServer url is correct append /catalog.html to the url configured and paste this url in an intenet browser. If the url is correct a list of the files and directories in the root of the data folder in the archive will be visible.