Installation de ERDDAP

L'objectif de cette partie est d'installer, et de configurer ERDDAP pour en faire un serveur de données opérationnel apte à recevoir différents jeux de données (dataset).

Deux paquetages sont nécessaires pour faire fonctionner Erddap :

    erddapContent.zip : les fichiers de configuration
    erddap.war : le servlet java binaire

ces 2 paquets sont disponibles dans la VM dans le compte ~tomcat (/opt/tomcat)

Récupérer erddapContent.zip

Récupérer les fichiers de configuration de Erddap erddapContent.zip

  • sur le site de la NOAA, voir:

        $ https://github.com/BobSimons/erddap/releases/download/v2.22/erddapContent.zip
    
  • le « dézipper » dans : /opt/tomcat (qui devrait pointer sur /opt/apache-tomcat-10.0.27, avec le lien qu'on a fait précédemment)

     $ cd ~tomcat
     $ wget https://github.com/BobSimons/erddap/releases/download/v2.14/erddapContent.zip
     $ unzip erddapContent.zip
          Archive:  erddapContent.zip
      inflating: content/erddap/datasets.xml  
      inflating: content/erddap/setup.xml  
      inflating: content/erddap/images/erddapStart2.css
    

L'archive .zip contient notamment 2 fichiers importants :

  • setup.xml pour paramétrer le serveur erddap

  • datasets.xml pour décrire les jeux de données : par défaut il contient un ensemble de jeux de données disponibles à la NOAA pour tester erddap. Par la suite c’est dans ce fichier datasets.xml qu’on placera le code XML qui va servir à décrire les jeux de données qu’on va faire gérer à Erddap.

Configuration de base

Pour pouvoir lancer le serveur ERDDAP, Il faut changer a minima quelques tags ci dessous dans le fichier setup.xml . Sans quoi il y aura des erreurs au lancement du servlet erddap.

Valeurs à modifier selon votre contexte et laboratoire, évidemment :-)

<bigParentDirectory>/opt/tomcat/content/erddap/</bigParentDirectory>

<baseUrl>http://localhost:8080</baseUrl>
<emailEverythingTo>erddap@votrelabo.fr</emailEverythingTo>
<fontFamily>SansSerif</fontFamily>
<adminInstitution>OSU Pytheas</adminInstitution>
<adminIndividualName>Libes Maurice</adminIndividualName>
<adminPosition>ERDDAP administrator</adminPosition>
<adminPhone>04860 90529</adminPhone>
<adminAddress> batiment oceanomed</adminAddress>
<adminCity>Marseille</adminCity>
<adminStateOrProvince>PACA</adminStateOrProvince>
<adminPostalCode>13009</adminPostalCode>
<adminCountry>FR</adminCountry>
<adminEmail>erddap@osupytheas.fr</adminEmail>

<adminInstitution>OSU Pytheas</adminInstitution>
<adminInstitutionUrl>http://www.osupytheas.fr <adminInstitutionUrl>

Changer le libellé du tag flagKeyKey (obligatoire)

<flagKeyKey>phrase pour recharger les datasets</flagKeyKey>
ex:
    <flagKeyKey>reload_dataset_osu</flagKeyKey>

Pour dire à Erddap de souscrire ou ne pas souscrire à des datasets gérés par des serveurs Erddap distants : laisser à "true" !!

<subscribeToRemoteErddapDataset>true</subscribeToRemoteErddapDataset>

Personnaliser le serveur erddap

On peut personnaliser a minima l'interface graphique du serveur erddap avec quelques balises dans le fichier ~tomcat/content/erddap/datasets.xml

  • On peut changer le logo et le texte de l’entête,

  • la balise <startBodyHtml5> : 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 <startBodyHtml> : Logo du site
    Modifier la balise <theShortDescriptionHtml> : texte introductif sur la page d'accueil

Récupérer le servlet "errdap.war"

le binaire Erddap se trouve dans le servlet errdap.war . (Le fichier est volumineux car il contient les traits de côte à haute résolution pour créer les cartes.)

  • voir : https://coastwatch.pfeg.noaa.gov/erddap/download/setup.html#erddap.war

  • sur le site de la NOAA

        https://github.com/BobSimons/erddap/releases/download/v2.22/erddap.war
    
  • placer le servlet erddap.war dans le répertoire ~tomcat/webapps/

  • tomcat va déployer l'archive automatiquement au lancement dans /opt/tomcat/webapps/erddap
       $ cp  erddap.war  ~tomcat/webapps/
       $ ls /opt/tomcat/webapps/erddap
    

Une fois Erddap déployé, vous pouvez tester le "run" de Erddap sur l'URL et le port définis plus haut dans setup.xml

NB: bien vérifier que vous avez le PATH de java17 dans votre variable d'environnement PATH *

    $ echo $PATH
    PATH=/opt/java/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games


    $ ~tomcat/bin/startup.sh
  • testez le serveur erddap (le lancement est un peu long qq minutes...et dépend de ce qui se trouve dans le fichier datasets.xml)
    http://localhost:8080/erddap/
    

Normalement, après ces étapes, le serveur erddap est opérationnel... et on devrait voir la page d'accueil du serveur ERDDAP

Les "logs" toujours les logs

  • Si... ca ne marche pas ?? il FAUT regarder les messages d'erreur dans les fichiers journaux, qui se trouvent dans :
     $ ls ~tomcat/logs/catalina.out  : les logs de tomcat
     $ ls ~tomcat/content/erddap/logs/log.txt : les logs de erddap