Passer au contenu principal

Installer

Comment faire la configuration initiale de ERDDAP™ sur votre serveur

ERDDAP™ peut fonctionner sur n'importe quel serveur qui prend en charge Java et Tomcat (et d'autres serveurs d'applications comme Jetty, mais nous ne les supportons pas) . ERDDAP™ a été testé sur Linux (y compris sur Amazon's AWS) , Mac et les ordinateurs Windows.

  • Coq -- Nous fournissons ERDDAP™ dans un contenant Docker et IOOS offre maintenant Guide de démarrage rapide pour ERDDAP™ dans un contenant Docker . C'est le standard. ERDDAP™ installation, dans un conteneur Docker. Par Docker Composez nous fournir des moyens faciles à mettre en place ssl et de surveillance, lire plus Documentation Docker . Si vous utilisez déjà Docker, vous préférerez probablement la version Docker. Si vous cherchez à exécuter sur les services cloud, vous préférerez probablement la version Docker.
  • Amazonie -- Si vous installez ERDDAP™ sur une instance Amazon Web Services EC2, voir Aperçu des services Web Amazon D'abord.
  • Linux et Macs -- ERDDAP™ fonctionne bien sur les ordinateurs Linux et Mac. Voir les instructions ci-dessous.
  • Fenêtres -- Windows est parfait pour les tests ERDDAP™ et à usage personnel (voir les instructions ci-dessous) , mais nous ne recommandons pas de l'utiliser pour le public ERDDAP™ déploiements. Courir ERDDAP™ sous Windows peut avoir des problèmes: notamment, ERDDAP™ peut être incapable de supprimer et/ou renommer les fichiers rapidement. Ceci est probablement dû au logiciel antivirus (Par exemple, de McAfee et Norton) qui vérifie les fichiers pour les virus. Si vous rencontrez ce problème (qui peut être vu par des messages d'erreur dans le Log.txt fichier comme "Impossible de supprimer ..."), modifier les paramètres du logiciel antivirus peut atténuer partiellement le problème. Ou envisager d'utiliser un serveur Linux ou Mac à la place.

La norme ERDDAP™ instructions d'installation pour les ordinateurs Linux, Mac et Windows sont:

  1. Assurez-vous que toutes les dépendances sont installées. Sur les machines non Windows (Linux et Mac) Tu as besoin de Csh.

Java​

  1. Pour ERDDAP™ v2.19+, mis en place Java 21. Le Président. Pour des raisons de sécurité, il est presque toujours préférable d'utiliser la dernière version de Java 21. Le Président. Veuillez télécharger et installer la dernière version de OpenJDK d'Adoptium (Témurine) 21 (LTS) . Pour vérifier l'installation, exécutez /javaJreBinDirectory/java -version par exemple /usr/local/jdk-21.0.3+9/jre/bin/java -version .

    ERDDAP™ fonctionne avec Java d'autres sources, mais nous recommandons l'Adoptium parce qu'il est le principal, soutenu par la communauté, gratuit (comme dans la bière et le discours) des Java 21 qui offre un soutien à long terme (mises à jour gratuites pour de nombreuses années après la publication initiale) . Pour des raisons de sécurité, veuillez mettre à jour votre ERDDAP version de Java périodiquement comme nouvelles versions de Java 21 sont disponibles auprès d'Adoptium.

    ERDDAP™ a été testé et largement utilisé avec 21, pas d'autres versions. Pour diverses raisons, nous ne testons ni ne supportons d'autres versions de Java .  

Tomcat​

  1. Mise en place Tomcat . Tomcat est le plus utilisé Java Serveur d'application, qui est Java logiciels qui se situent entre les services réseau du système d'exploitation et Java logiciel serveur comme ERDDAP™ . C'est un logiciel libre et ouvert (RÉSULTATS) .

Vous pouvez utiliser un autre Java Serveur d'applications (Par exemple, Jetty) , mais nous testons seulement avec et soutenir Tomcat.

  • Téléchargez Tomcat et déballez-le sur votre serveur ou PC. Pour des raisons de sécurité, il est presque toujours préférable d'utiliser la dernière version de Tomcat 10 (version 9 et ci-dessous ne sont pas acceptables) qui est conçu pour fonctionner avec Java 21 ou plus récent. Ci-dessous, le répertoire Tomcat sera appelé Tomcat .

Attention ! Si vous avez déjà un Tomcat exécutant une autre application web (en particulier) , nous vous recommandons d'installer ERDDAP™ en un deuxième Tomcat Parce que ERDDAP™ nécessite différents paramètres Tomcat et ne devrait pas avoir à faire face à d'autres applications pour la mémoire.

  • Sur Linux, télécharger le "Core" "tar .gz Distribution Tomcat et déballer. Nous vous recommandons de le déballer /usr/local .
  • Sur un Mac, Tomcat est probablement déjà installé dans /Bibliothèque/Tomcat , mais devrait le mettre à jour à la dernière version de Tomcat 10. Si vous le téléchargez, télécharger le "Core" "tar .gz Distribution Tomcat et déballer /Bibliothèque/Tomcat .
  • Sous Windows, vous pouvez télécharger la distribution "Core" "zip" Tomcat (qui ne gâche pas le registre Windows et que vous contrôlez depuis une ligne de commande DOS) et le décompresser dans un répertoire approprié. (Pour le développement, nous utilisons la distribution "Core" "zip". Nous faisons une /programmes et décompresser.) Ou vous pouvez télécharger la distribution "Core" "64 bits Windows zip", qui comprend plus de fonctionnalités. Si la distribution est un installateur Windows, il mettra probablement Tomcat dans, par exemple, /Program Files/apache-tomcat-10.0.23 .  

serveur.xml​

  • serveur.xml - Dans le tomcat/conf/server.xml fichier, il y a deux changements que vous devriez faire à chacun des deux <Connector> balises (une pour &lt;Portonnector=8080" et un pour "Porte-conducteur" 8443" ) .
    1. (Recommandation) Accroître connexion Délai valeur du paramètre, peut-être jusqu'à 300000 (millisecondes, soit 5 minutes) .
    2. (Recommandation) Ajouter un nouveau paramètre : détenduQueryChars[] | " . Ceci est facultatif et légèrement moins sûr, mais supprime la nécessité pour les utilisateurs d'encoder ces caractères en pourcentage lorsqu'ils se produisent dans les paramètres de l'URL de demande d'un utilisateur.  

contenu.xml​

  • contexte.xml -- Ressources Cache - In tomcat/conf/context.xml , juste avant le </Context> tag, modifier l'étiquette Ressources (ou l'ajouter si elle n'est pas déjà là) pour définir le cache Paramètre MaxSize à 80000: 
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Cela évite de nombreuses mises en garde en catalina. Tout commence par

WARNING [main] org.apache.catalina.webresources.Cache.getResource Unable to add the resource at [/WEB-INF/classes/...]

 

Heure d'arrêt Apache​

  • Sur les ordinateurs Linux, modifiez les paramètres de timeout d'Apache de sorte que les requêtes d'utilisateurs qui prennent beaucoup de temps ne s'arrêtent pas (avec ce qui apparaît souvent comme une erreur "Proxy" ou "Bad Gateway") . En tant qu'utilisateur racine :
    • Modifier l'Apache http d.conf fichier (généralement dans /etc/ http d/conf/ ) :
      • Modifier l'actuel <Timeout> réglage (ou en ajouter un à la fin du fichier) à 3600 (secondes) , au lieu des 60 ou 120 secondes par défaut.
      • Modifier l'actuel <ProxyTimeout> réglage (ou en ajouter un à la fin du fichier) à 3600 (secondes) , au lieu des 60 ou 120 secondes par défaut.
    • Redémarrer Apache & #160;: /usr/sbin/apachectl -K gracieux (mais parfois il est dans un répertoire différent) .

Sécurité​

 

  • Recommandation en matière de sécurité : Voir les présentes instructions pour renforcer la sécurité votre installation Tomcat, spécialement pour les serveurs publics.  
  • Pour public ERDDAP™ installations sur Linux et Macs, il est préférable de configurer Tomcat (le programme) comme appartenant à l'utilisateur Tomcat (un utilisateur séparé avec des permissions limitées et qui n'a pas de mot de passe ) . Ainsi, seul le super utilisateur peut passer à agir comme utilisateur Tomcat . Cela rend impossible pour les pirates de se connecter à votre serveur en tant qu'utilisateur Tomcat . Et en tout cas, vous devriez le faire pour que le Tomcat l'utilisateur a des permissions très limitées sur le système de fichiers du serveur (read+write+execute privilèges pour apache-tomcat arborescence des répertoires et <bigParentDirectory> et des privilèges en lecture seule pour les répertoires avec des données qui ERDDAP™ a besoin d'accès à).
    • Vous pouvez créer le Tomcat compte utilisateur (qui n'a pas de mot de passe) en utilisant la commande & #160;: 
      sudo useradd tomcat -s /bin/bash -p '*'
    • Vous pouvez passer à travailler comme utilisateur Tomcat en utilisant la commande 
      sudo su - tomcat
      (Il vous demandera le mot de passe du superutilisateur pour obtenir la permission de le faire.)
      • Vous pouvez arrêter de travailler comme utilisateur tomcat en utilisant la commande
      exit
      • Faites la plupart du reste du Tomcat et ERDDAP™ instructions de configuration en tant qu'utilisateur Tomcat . Plus tard, lancez le startup.sh et Arrêt. sh scripts comme utilisateur Tomcat afin que Tomcat ait la permission d'écrire dans ses fichiers journaux.
      • Après avoir déballé Tomcat, du parent du apache-tomcat répertoire & #160;:
        • Changer la propriété de l'arborescence du répertoire apache-tomcat pour l'utilisateur tomcat. 
          chown -R tomcat apache-tomcat-10.0.23
          (mais remplacez le nom réel de votre répertoire tomcat) .
        • Modifier le "groupe" pour être tomcat, votre nom d'utilisateur ou le nom d'un petit groupe qui inclut tomcat et tous les administrateurs de Tomcat/ ERDDAP : 
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Changer les permissions pour que Tomcat et le groupe aient lu, écrit, exécuté les privilèges: 
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Supprimer les permissions d'un autre utilisateur pour lire, écrire ou exécuter : 
          chmod -R o-rwx apache-tomcat-10.0.23

Ceci est important, car il empêche d'autres utilisateurs de lire des informations ERDDAP™ configurer les fichiers.

Mémoire​

Définir les variables d'environnement de Tomcat

  • Sur Linux et Macs : Créer un fichier tomcat/bin/setenv.sh (ou dans Red Hat Enterprise Linux \[ RHEL \] , modifier ~tomcat/conf/tomcat10.conf ) pour définir les variables d'environnement de Tomcat. Ce fichier sera utilisé par tomcat/bin/startup.sh et Arrêt. sh . Le fichier devrait contenir quelque chose comme :

    export JAVA_HOME=/usr/local/jdk-21.0.3+9
    export JAVA_OPTS='-server -Djava.awt.headless=true -Xmx1500M -Xms1500M'
    export TOMCAT_HOME=/usr/local/apache-tomcat-10.0.23
    export CATALINA_HOME=/usr/local/apache-tomcat-10.0.23

    (mais remplacez les noms de répertoires de votre ordinateur) . (Si vous avez déjà défini JE SUIS Tu peux enlever ça.) Sur Macs, vous n'avez probablement pas besoin de définir JAVA_HOME .

  • Sous Windows : Créer un fichier tomcat\bin\\setenv.bat pour définir les variables d'environnement de Tomcat. Ce fichier sera utilisé par tomcat\bin\\startup.bat et shutdown.bat . Le fichier devrait contenir quelque chose comme :

    SET "JAVA_HOME=\\someDirectory\\jdk-21.0.3+9"
    SET "JAVA_OPTS=-server -Xmx1500M -Xms1500M"
    SET "TOMCAT_HOME=\\Program Files\\apache-tomcat-10.0.23"
    SET "CATALINA_HOME=\\Program Files\\apache-tomcat-10.0.23"

    (mais remplacez les noms de répertoires de votre ordinateur) . Si c'est juste pour les tests locaux, supprimer "-serveur". (Si vous avez déjà défini JE SUIS Tu peux enlever ça.)

Les - Xmx et - Xms les paramètres de mémoire sont importants parce que ERDDAP™ fonctionne mieux avec plus de mémoire. Toujours réglé - Xms à la même valeur que - Xmx .

  • Pour les systèmes d'exploitation 32 bits et 32 bits Java : 64 bits Java est beaucoup mieux que 32 bits Java mais 32 bits Java fonctionnera aussi longtemps que le serveur n'est pas vraiment occupé. La mémoire plus physique dans le serveur le mieux: 4 Go+ est vraiment bon, 2 Go est correct, moins n'est pas recommandé. Avec 32 bits Java , même avec une mémoire physique abondante, Tomcat et Java ne courra pas si vous essayez de définir - Xmx beaucoup plus de 1500M (1200M sur certains ordinateurs) . Si votre serveur a moins de 2 Go de mémoire, réduisez - Xmx valeur (dans 'M'egaBytes) à la moitié de la mémoire physique de l'ordinateur.

  • Pour les systèmes d'exploitation 64 bits et 64 bits Java : 64 bits Java fonctionnera uniquement sur un système d'exploitation 64 bits.

    • Avec Java 8, vous devez ajouter -d64 au Tomcat _OPTS DE CATALINE paramètre dans setenv.bat .
    • Avec Java 21, vous choisissez 64 bits Java lorsque vous téléchargez une version de Java marquée "64 bits".

Avec 64 bits Java , Tomcat et Java peut utiliser très haut - Xmx et - Xms paramètres. Plus la mémoire physique du serveur est bonne. Comme suggestion simpliste: nous vous recommandons de définir - Xmx et - Xms à (dans 'M'egaBytes) à 1/2 (ou moins) de la mémoire physique de l'ordinateur. Tu peux voir si Tomcat, Java et ERDDAP™ sont en effet en mode 64 bits en cherchant "bit", dans ERDDAP 's Daily Report courriel ou dans les bigParentDirectory/logs/ [Log.txt](/docs/server-admin/additional-information#log) fichier ( BigParent Directory est spécifié dans configuration.xml ) .

Collecte des ordures​

  • En ERDDAP™ 's Log.txt fichier, vous verrez beaucoup "GC (Défaut de répartition) " des messages. Ce n'est généralement pas un problème. C'est un message fréquent d'un fonctionnement normal Java disant que ça vient de finir une petite poubelle collection parce qu'elle a manqué de place à Eden (de la section Java tas pour objets très jeunes) . Habituellement, le message vous montre mémoireUtilisationAvant-&gt;mémoireUtilisationAprès . Si ces deux chiffres sont rapprochés, cela signifie que la collecte des ordures n'était pas productive. Le message n'est qu'un signe d'ennui s'il est très fréquent (toutes les quelques secondes) , pas productif, et les nombres sont grands et ne croissent pas, qui indiquent ensemble que Java a besoin de plus de mémoire, peine à libérer la mémoire, et est incapable de libérer la mémoire. Cela peut se produire pendant une période stressante, puis partir. Mais s'il persiste, c'est un signe de trouble.
  • Si vous voyez Java.lang.Extrait de MémoireErreur s en ERDDAP™ 's Log.txt fichier, voir De mémoire pour des conseils sur la façon de diagnostiquer et résoudre les problèmes.  

Autorisations​

chmod +x *.sh

Polices​

  • Polices pour images: Nous préférons fortement le libre Polices DejaVu à l'autre Java polices. L'utilisation de ces polices est fortement recommandée mais pas nécessaire.

Si vous choisissez de ne pas utiliser les polices DejaVu, vous devez changer le paramètre fontFamily dans setup.xml pour <fontFamily> SansSerif </fontFamily> , qui est disponible avec tous Java distributions. Si vous définissez <fontFamily> au nom d'une police qui n'est pas disponible, ERDDAP™ ne chargera pas et imprimera une liste des polices disponibles Log.txt fichier. Vous devez utiliser une de ces polices.

Si vous choisissez d'utiliser les polices DejaVu, assurez-vous que <fontFamily> setup.xml est <fontFamily> DejaVu Sans </fontFamily> .

Pour installer les polices DejaVu, veuillez télécharger DejaVuFonts .zip (5 522 795 octets, MD5=33E1E61FAB06A547851ED308B4FFEF42) et décompresser les fichiers de police vers un répertoire temporaire.

  • Sur Linux :
    • Pour Linux Adoptium Java distributions, voir les présentes instructions .
    • Avec d'autres Java distributions: Comme Tomcat utilisateur, copie les fichiers de police dans $JAVA_HOME/lib/fonds donc Java peut trouver les polices. Rappelez-vous : si/lorsque vous passez à une version plus récente de Java , vous devez réinstaller ces polices.
  • Sur Macs : pour chaque fichier de police, double-cliquez dessus et puis cliquez sur Installer la police.
  • Sous Windows 7 et 10: dans Windows Explorer, sélectionnez tous les fichiers de police. Clic droit. Cliquez sur Installer.  

Essai Tomcat​

  • Testez votre installation Tomcat.
    • Linux :
    • Mac (exécuter tomcat en tant qu'utilisateur administrateur système) :
      • Cours tomcat/bin/startup.sh .
      • Affichez votre URL + ":8080/" dans votre navigateur (Par exemple, http://coastwatch.pfeg.noaa.gov:8080/ ) . Notez que par défaut, votre Tomcat n'est accessible que par vous. Elle n'est pas accessible au public.
    • Windows localhost & #160;:
      • Faites un clic droit sur l'icône Tomcat dans le plateau du système, et choisissez "Démarrer le service".
      • Affichage http://127.0.0.1:8080/ ou peut-être http://localhost:8080/ , dans votre navigateur. Notez que par défaut, votre Tomcat n'est accessible que par vous. Elle n'est pas accessible au public.

Vous devriez voir la page des félicitations Tomcat.

S'il y a des problèmes, voir le fichier journal Tomcat à tomcat/logs/catalina.out .

Des problèmes avec l'installation de Tomcat ?​

  • Sur Linux et Mac, si vous ne pouvez pas atteindre Tomcat ou ERDDAP™ (ou peut-être que vous ne pouvez pas les atteindre à partir d'un ordinateur en dehors de votre pare-feu) , vous pouvez tester si Tomcat écoute le port 8080, en tapant (comme racine) sur une ligne de commande du serveur :

    netstat -tuplen | grep 8080

Cela devrait revenir à une ligne avec quelque chose comme:

tcp 0 0 :::8080 :::* LISTEN ## ##### ####/java

(où ♪ est un chiffre) , indiquant que java processus (Probablement Tomcat) est à l'écoute sur le port "8080" pour le trafic "tcp". Si aucune ligne n'a été retournée, si la ligne renvoyée est significativement différente, ou si deux lignes ou plus ont été retournées, alors il peut y avoir un problème avec les paramètres du port.

  • Voir le fichier journal Tomcat tomcat/logs/catalina.out . Problèmes de Tomcat et certains ERDDAP™ Les problèmes de démarrage y sont presque toujours indiqués. C'est courant quand vous êtes en première mise en place ERDDAP™ .

  • Voir Tomcat site web ou rechercher de l'aide sur le web, mais s'il vous plaît laissez-nous savoir les problèmes que vous avez eus et les solutions que vous avez trouvées.

  • Voir notre section sur l'obtention d'un soutien supplémentaire .  

ERDDAP™ Contenu​

  1. Mettre en place le tomcat/content/erddap fichiers de configuration. Sur Linux, Mac et Windows, télécharger Contenu .zip et décompresser dans le Tomcat répertoire, création tomcat/content/erddap .

Version 1.0.0, 20333 octets, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, datée 2024-10-14

Certaines versions antérieures sont également disponibles:

  • 2.17 (19 792 octets, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, daté du 2022-02-16)
  • 2.18 (19 792 octets, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, daté du 2022-02-16)
  • 2.21 (19 810 octets, MD5=1E26F62E7A06191EE6868C40B9A29362, daté du 2022-10-09)
  • 2.22 (19,810 octets, MD5=1E26F62E7A06191EE6868C40B9A29362, daté du 2022-12-08)
  • 2.23 (19 810 octets, MD5=1E26F62E7A06191EE6868C40B9A29362, daté du 2023-02-27)

Autres répertoires​

Pour Red Hat Enterprise Linux (RHEL) ou pour d'autres situations où vous n'êtes pas autorisé à modifier le répertoire Tomcat ou où vous voulez / besoin pour mettre le ERDDAP™ répertoire de contenu dans un autre emplacement pour une autre raison (par exemple, si vous utilisez Jetty au lieu de Tomcat) , décompresser Contenu .zip dans le répertoire souhaité (dont seulement le Tomcat l'utilisateur a accès) et définir le erddapContentDirectory propriété du système (Par exemple erddapContentDirectory =~tomcat/content/erddap ) donc ERDDAP™ peut trouver ce nouveau répertoire de contenu.

configuration.xml​

Pour la configuration initiale, vous DEVEZ au moins modifier ces paramètres :

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> paramètres
  • <admin...> paramètres
  • <baseHttpsUrl> (quand vous avez installé https )

Lorsque vous créez le bigParentDirectory, à partir du répertoire parent de bigParentDirectory:

  • Faire le Tomcat utilisateur le propriétaire de la BigParent Directory : 
    chown -R tomcat bigParentDirectory
  • Modifier le "groupe" pour être tomcat, votre nom d'utilisateur ou le nom d'un petit groupe qui inclut tomcat et tous les administrateurs de Tomcat/ ERDDAP : 
    chgrp -R yourUserName bigParentDirectory
  • Changer les permissions pour que Tomcat et le groupe aient lu, écrit, exécuté les privilèges: 
    chmod -R ug+rwx bigParentDirectory
  • Supprimer les permissions d'un autre utilisateur pour lire, écrire ou exécuter. Ceci est important pour empêcher la lecture possible d'informations sensibles en ERDDAP™ log des fichiers et des fichiers avec des informations sur les ensembles de données privés. 
    chmod -R o-rwx bigParentDirectory

Variables d'environnement​

En commençant par ERDDAP™ v2.13, ERDDAP™ les administrateurs peuvent surcharger n'importe quelle valeur dans setup.xml en spécifiant une variable d'environnement Nommé ERDDAP _Nom de la valeur avant de courir ERDDAP™ . Par exemple, utiliser ERDDAP _baseUrl remplace la <baseUrl> valeur. Cela peut être pratique lors du déploiement ERDDAP™ avec un conteneur comme Docker, comme vous pouvez mettre les paramètres standard dans setup.xml et ensuite fournir des paramètres spéciaux via des variables d'environnement. Si vous fournissez des renseignements secrets à ERDDAP™ par cette méthode, s'assurer que l'information restera secrète. ERDDAP™ ne lit que les variables d'environnement une fois par démarrage, dans la première seconde de démarrage, donc une façon d'utiliser ceci est: définir les variables d'environnement, démarrer ERDDAP , Attendez jusqu'à ERDDAP™ est démarré, puis désactive les variables d'environnement.

datasets.xml​

  • Lire les commentaires en Travailler avec les datasets.xml Fichier . Plus tard, après que vous ayez ERDDAP™ Exécution pour la première fois (généralement avec juste les ensembles de données par défaut) , vous modifierez le XML dans tomcat/content/erddap/ datasets.xml pour spécifier tous les ensembles de données que vous souhaitez ERDDAP™ pour servir. C'est là que vous passerez la majeure partie de votre temps pendant la mise en place ERDDAP™ et plus tard tout en maintenant votre ERDDAP™ .

Vous pouvez voir un exemple datasets.xml sur GitHub .  

  • (Peu probable) Maintenant ou (légèrement plus probable) à l'avenir, si vous voulez modifier le fichier CSS d'erddap, copiez tomcat/content/erddap/images/erddapStart2.css à tomcat/content/erddap/images/erddap2.css puis y apporter des changements. Modifications apportées erddap2.css ne prendre effet que lorsque ERDDAP™ est redémarré et nécessite souvent aussi l'utilisateur pour effacer les fichiers en cache du navigateur.   ERDDAP™ ne fonctionnera pas correctement si setup.xml ou datasets.xml fichier n'est pas un fichier XML bien formé. Donc, après avoir modifié ces fichiers, c'est une bonne idée de vérifier que le résultat est bien formé XML en collant le texte XML dans un vérificateur XML comme xmlvalidation .  

Installez l'erddap. fichier de guerre​

  1. Sous Linux, Mac et Windows, _télécharger Guerre _dans tomcat/webapps :

Version 2.28.1, 622,676,238 octets, MD5=48b426045f950c8a8d69ef9521b9bc9, datée 2025-09-05

Le fichier .war est grand parce qu'il contient des données de littoral, de limite et d'altitude à haute résolution nécessaires pour créer des cartes.

Certaines versions antérieures sont également disponibles.

  • 2.17 (551 068 245 octets, MD5=5FEA912B5D42E50EAB9591F773EA848D, daté du 2022-02-16)
  • 2.18 (551 069 844 octets, MD5=461325E97E7577EC671DD50246CCFB8B, daté du 2022-02-23)
  • 2.21 (568,644,411 octets, MD5=F2CFF805893146E932E498FDBD519B6, daté du 2022-10-09)
  • 2.22 (567 742 765 octets, MD5=2B33354F633294213AE2AFDDCF4DA6D0, daté du 2022-12-08)
  • 2.23 (572 124 953 octets, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, daté du 2023-03-03)
  • 2.24 (568 748 187 octets, MD5=970fbee172e28b0b8a07756eecbc898e, daté du 2024-06-07)
  • 2,25 (592,292,039 octets, MD5=652AFC9D1421F00B5F789DA2C4732D4C, daté du 2024-11-07)
  • 2.26 (607 404 032 octets, MD5=99a725108b37708e5420986c1616a119, daté 2025-03-31)
  • 2.27.0 (620 554 403 octets, MD5=3b2086c659eee4145ca2dff447bf4ef7, daté 2025-06-11)

Configurer le proxy (spécifique au déploiement)​

ERDDAP™ est généralement déployé derrière un serveur web proxy inversé pour lui permettre d'être servi sur des ports HTTP standard (80 et 443) . La terminaison SSL/TLS est souvent hantée sur la couche proxy du serveur web. Les détails dépendent des besoins de chaque déploiement.

Apache​

  1. Veiller à ce que mod_proxy et mod_proxy_ http sont chargés:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Modifier l'actuel <VirtualHost> étiquette (s'il y en a un) , ou en ajouter un à la fin du fichier:
<VirtualHost *:80>
   ServerName YourDomain.org
   ProxyRequests Off
   ProxyPreserveHost On
   ProxyPass /erddap http://localhost:8080/erddap
   ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Si ERDDAP™ est servi sur un chemin autre que /erddap , aussi définir le Préfixe des X en-tête de la segment de chemin avant /erddap . Ce cadre serait approprié pour ERDDAP™ servi à /sous-path/erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Puis redémarrez Apache : /usr/sbin/apachectl -K gracieux (mais parfois il est dans un répertoire différent) .  

NGINX​

Dans le fichier de configuration nginx, définissez ces en-têtes :

proxy_set_header Host              $http_host;
proxy_set_header X-Real-IP         $remote_addr;
proxy_set_header REMOTE_ADDR       $remote_addr;
proxy_set_header HTTP_CLIENT_IP    $remote_addr;
proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

Si ERDDAP™ est servi sur un chemin autre que /erddap , aussi définir le Préfixe des X en-tête de la segment de chemin avant /erddap . Ce cadre serait approprié pour ERDDAP™ servi à /sous-path/erddap :

proxy_set_header X-Forwarded-Prefix /subpath

Pour obtenir NGINX et ERDDAP™ fonctionnant correctement avec https , vous devez mettre l'extrait suivant dans le serveur Tomcat.xml <Host> bloc:

<Valve className="org.apache.catalina.valves.RemoteIpValve"
  remoteIpHeader="X-Forwarded-For"
  protocolHeader="X-Forwarded-Proto"
  protocolHeaderHttpsValue="https" />

 

Démarrer Tomcat​

  • (Je ne recommande pas d'utiliser le Tomcat Web Application Manager. Si vous ne vous arrêtez pas complètement et ne démarrez pas Tomcat, tôt ou tard vous aurez des problèmes de mémoire PermGen.)
  • (Dans Linux ou Mac OS, si vous avez créé un utilisateur spécial pour exécuter Tomcat, par exemple, tomcat, rappelez-vous de faire les étapes suivantes en tant qu'utilisateur.)
  • Si Tomcat est déjà en marche, fermez Tomcat avec (dans Linux ou Mac OS) tomcat/bin/shutdown.sh ou (dans Windows) tomcat\bin\\ shutdown.bat

Sur Linux, utilisez ps -ef | Tombeau grep avant et après Arrêt. sh pour s'assurer que le processus tomcat a cessé. Le processus devrait être énuméré avant l'arrêt et éventuellement non après l'arrêt. Ça peut prendre une minute ou deux. ERDDAP™ d'arrêter complètement. Soyez patient. Ou si on dirait qu'il ne s'arrêtera pas seul, utilisez : tuer -9 <processID>

  • Commencez par Tomcat (dans Linux ou Mac OS) tomcat/bin/startup.sh ou (dans Windows) tomcat\bin\\startup.bat

Est ERDDAP™ courir ?​

Utilisez un navigateur pour essayer de voirhttp://www.YourServer.org/erddap/status.html. ERDDAP™ démarre sans aucun ensemble de données chargé. Les ensembles de données sont chargés dans un fil de fond et deviennent donc disponibles un par un.

Dépannage​

  • Lorsqu'une requête d'un utilisateur entre en jeu, elle est adressée à Apache (sur les ordinateurs Linux et Mac OS) , puis Tomcat, alors ERDDAP™ .
  • Vous pouvez voir ce qui vient à Apache (et erreurs connexes) dans les fichiers journaux Apache.
  • Toi peut voir ce qui vient à Tomcat (et erreurs connexes) dans les fichiers journaux Tomcat ( tomcat/logs/catalina.out et d'autres fichiers dans ce répertoire) .
  • Toi peut voir ce qui vient à ERDDAP , messages de diagnostic de ERDDAP , et messages d'erreur de ERDDAP , dans ERDDAP™ <bigParentDirectory> /logs/log.txt fichier.
  • Tomcat ne commence pas. ERDDAP™ jusqu'à ce que Tomcat obtienne une demande pour ERDDAP™ . Donc vous pouvez voir dans les fichiers journaux Tomcat si elle commencé ERDDAP™ ou s'il existe un message d'erreur lié à cette tentative.
  • Quand ERDDAP™ commence, il renomme l'ancien ERDDAP™ fichier log.txt ( logArchivéÀ <CurrentTime> .txt ) et crée un nouveau fichier log.txt. Donc si le Log.txt fichier est vieux, c'est un signe que ERDDAP™ n'a pas redémarré récemment. ERDDAP™ écrit des informations de journal dans un tampon et écrit le tampon dans le fichier journal périodiquement, mais vous pouvez forcer ERDDAP™ pour écrire le tampon dans le fichier journal en visitant /erddap/status.html .

Problème: Ancienne version de Java​

Si vous utilisez une version de Java trop vieux pour ERDDAP , ERDDAP™ vous verrez un message d'erreur dans le fichier journal de Tomcat comme

Exception in thread "main" java.lang.UnsupportedClassVersionError:
_some/class/name_: Unsupported major.minor version _someNumber_

La solution est de mettre à jour la version la plus récente de Java et assurez-vous que Tomcat l'utilise.

Problème: démarrage lent Première fois​

Tomcat doit faire beaucoup de travail la première fois une application comme ERDDAP™ est commencé; notamment, il doit déballer le Guerre fichier (qui est comme un .zip fichier) . Sur certains serveurs, la première tentative de voir ERDDAP™ étalons (30 secondes ?) jusqu'à ce que ce travail soit terminé. Sur d'autres serveurs, la première tentative échouera immédiatement. Mais si vous attendez 30 secondes et essayez encore, il réussira si ERDDAP™ a été correctement installé.

Il n'y a pas de solution. C'est simplement comme ça que Tomcat fonctionne. Mais il ne se produit que la première fois après avoir installé une nouvelle version de ERDDAP™ .

Arrêt et redémarrage​

À l'avenir, fermer (et redémarrer) ERDDAP™ Voir Comment fermer et redémarrer Tomcat et ERDDAP .

Des problèmes ?​

Problèmes d'installation de Tomcat ou ERDDAP™ ? Voir notre section sur l'obtention d'un soutien supplémentaire .

Notification par courriel des nouvelles versions ERDDAP​

Si vous voulez recevoir un email chaque fois qu'une nouvelle version de ERDDAP™ est disponible ou autre important ERDDAP™ annonces, vous pouvez rejoindre le ERDDAP™ Liste des annonces ici . Cette liste est en moyenne d'environ un courriel tous les trois mois.

Personnaliser​

  • Personnalisez votre ERDDAP™ pour souligner votre organisation (pas NOAA ERD ) .
  • Changer la bannière qui apparaît en haut de tous ERDDAP™ .html pages en éditant <startBodyHtml5> marque dans votre datasets.xml fichier. (S'il n'y en a pas, copiez la valeur par défaut ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml fichier dans datasets.xml et le modifier.) Par exemple, vous pourriez :
    • Utiliser une image différente (i.e., le logo de votre organisation) .
    • Changer la couleur de fond.
    • Changer " ERDDAP™ "à "Votre Organisation" ERDDAP™ "
    • Changez « Meilleur accès aux données scientifiques » pour « Meilleur accès aux données de _Votre organisation ».
    • Changez les liens « créés par » pour être des liens vers votre organisation et des sources de financement.
  • Modifier les informations sur le côté gauche de la page d'accueil en éditant <theShortDescriptionHtml> marque dans votre datasets.xml fichier. (S'il n'y en a pas, copiez la valeur par défaut ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml fichier dans datasets.xml et le modifier.) Par exemple, vous pourriez :
    • Décrivez ce que fait votre organisation et/ou votre groupe.
    • Décrivez quel type de données ce ERDDAP™ l'a fait.
    • Pour modifier l'icône qui apparaît sur les onglets du navigateur, mettez le favicon de votre organisation. ico en tomcat/content/erddap/images/ . Voirhttps://en.wikipedia.org/wiki/Favicon.