Configuration de Erddap

Premier contact avec Erddap

Après avoir installé notre premier serveur erddap, faisons ensembles un tour de piste rapide sur les jeux de données de la NOAA proposés par défaut.

Le fichier content.zip qu’on a téléchargé contient un certain nombre de jeux de données de la NOAA accessibles grâce à l’interopérabilité de erddap

Par défaut ils sont affichés grâce à la balise active="true"

Pour les désactiver (ne plus les faire apparaitre), il suffit de mettre la balise à "active=false", ET de forcer le serveur erddap a recharger ces jeux de données en relancant le serveur Web.

Essayez de mettre un jeu de données ci dessous à "false"

    <dataset type="EDDGridFromErddap" datasetID="jplG1SST" active="true">
    <!-- GHRSST Global 1-km Sea Surface Temperature (G1SST), Global, 0.01 Degree, Daily -->
    <sourceUrl>http://coastwatch.pfeg.noaa.gov/erddap/griddap/jplG1SST</sourceUrl>
    </dataset>
    <dataset type="EDDGridFromErddap" datasetID="jplMURSST41" active="true">
    <!-- Multi-scale Ultra-high Resolution (MUR) SST analysis fv04.1, Global, 0.011 Degree, Daily -->
    <sourceUrl>http://coastwatch.pfeg.noaa.gov/erddap/griddap/ jplMURSST41</sourceUrl>
   </dataset>

et de relancer le serveur :

    $ cd ~tomcat
    $ ./bin/shutdown.html
    $ ./bin/startup.html

NB: Pour forcer le rechargement, on verra une autre méthode plus rapide un peu plus loin...

Personnaliser le serveur erddap

Toute la configuration du serveur erddap tient dans le fichier ~tomcat/content/erddap/setup.xml

On peut personnaliser son serveur erddap (changer le logo et le texte de l’entête), il faut changer certaines balises du fichier ./content/erddap/setup.xml
- la balise <startHeadHtml> contient la Balise <TITLE> du site
- la balise <startBodyHtml> : contient le Logo du site
- la balise <theShortDescriptionHtml> contient le texte introductif sur la page

Modifiez par exemple une balise ci dessous

    Modifier la balise <startHeadHtml> : Balise <TITLE> du site
    Modifier la balise <startBodyHtml> : Logo du site
    Modifier la balise <theShortDescriptionHtml> : texte introductif sur la page

et relancez le serveur tomcat, comme effectué plus haut...

Les fichiers de Logs

Les fichiers de logs sont essentiels pour comprendre un problème éventuel, notamment lorsque le chargement d'un dataset a posé problème et n’a pas pu être chargé. Il faut distinguer :

le fichier de logs du serveur tomcat (problèmes au démarrage du serveur)
```
/opt/tomcat/logs/catalina.out
```
le fichier de logs de erddap (problème dans la gestion des jeux de données par erddap)
```
/opt/tomcat/content/erddap/logs/
```
le niveau de log peut etre défini dans le fichier setup.xml
```
 "warning" (le minimum de messages), "info" (par default), or "all"
<logLevel>info</logLevel>
```
Bien entendu il faut mettre "info" pour une configuration en exploitation, et "all" lorsqu'on veut débugguer un probleme :-)

Le fichier de gestion des jeux de données

La description de tous les jeux de données gérés par erddap se fait au format XML dans un fichier unique appelé datasets.xml

/opt/tomcat/content/erddap/datasets.xml

Les types de données gérés par Erddap

Brièvement Erddap gère 2 grandes catégories de données qui représentent la majeure partie de ce qu’on peut trouver en situation réelle :

format EDDGrid : données sous forme de grille spatiale (ex. données satellite, format netcdf) :
- les données sont des tableaux multi dimensionnés.
- Il DOIT y avoir une variable qui sert d’axe pour chaque dimension dans les EDDGrid datasets, toutes les variables doivent utiliser toutes les variables des axes
- chaque dimension DOIT être ordonnée (sorted) (recommandation de CF meta standard: http://cfconventions.org/Data/cf-conventions/cf-conventions-1.6/build/cf-conventions.html )
Format EDDTable : données sous forme de tables en colonnes (bouée in situ, mesure sur une station, profil vertical, trajectoire...)
- chaque colonne est une variable
- chaque ligne est une mesure/observation de cette variable

Le détail des types de jeux de données gérés par Erddap sont décrits ici :

https://coastwatch.pfeg.noaa.gov/erddap/download/setupDatasetsXml.html#datasetTypes

Nous allons maintenant manipuler et intégrer plusieurs jeux de données dans erddap