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
-
$ 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