Skip to main content

Installieren

Wie man die erste Aufstellung von ERDDAP™ auf Ihrem Server

ERDDAP™ kann auf jedem Server laufen, der unterstützt Java und Tomcat (und andere Anwendungsserver wie Jetty, aber wir unterstützen sie nicht) . ERDDAP™ wurde auf Linux getestet (auch auf Amazon's AWS) , Mac und Windows-Computer.

  • Docker -- Wir bieten ERDDAP™ in einem Docker-Container und IOOS bietet nun Quick Start Guide für ERDDAP™ in einem Docker Container . Es ist der Standard ERDDAP™ Installation, in einem Docker Container. Über Docker Zusammenfassend bieten wir einfache Möglichkeiten, ssl und Monitoring einzurichten, weiterlesen Docker Dokumentation . Wenn Sie Docker bereits verwenden, werden Sie wahrscheinlich die Docker-Version bevorzugen. Wenn Sie auf Cloud-Services laufen möchten, werden Sie wahrscheinlich die Docker-Version bevorzugen.
  • Amazon -- Wenn Sie installieren ERDDAP™ auf einer Amazon Web Services EC2 Instanz, siehe dies Amazon Web Services Überblick zuerst.
  • Linux und Macs -- ERDDAP™ funktioniert super auf Linux- und Mac-Computern. Siehe unten die Anweisungen.
  • Windows -- Windows ist gut für Tests ERDDAP™ und für den persönlichen Gebrauch (siehe die folgenden Anweisungen) , aber wir empfehlen es nicht für die Öffentlichkeit zu verwenden ERDDAP™ Bereitstellungen. Laufen ERDDAP™ unter Windows kann Probleme haben: insbesondere ERDDAP™ kann Dateien schnell löschen und/oder umbenennen können. Dies ist wahrscheinlich auf Antivirus-Software zurückzuführen (z.B. von McAfee und Norton) die die Dateien für Viren überprüft. Wenn Sie in dieses Problem laufen (die durch Fehlermeldungen in der Pressemitteilung Datei wie "Unable to delete ..."), das Ändern der Antivirus-Software-Einstellungen kann das Problem teilweise lindern. Oder betrachten Sie stattdessen einen Linux- oder Mac-Server.

Der Standard ERDDAP™ Installationsanweisungen für Linux, Macs und Windows-Computer sind:

  1. Stellen Sie sicher, dass alle Abhängigkeiten installiert sind. Auf Nicht-Windows-Maschinen (Linux und Mac) Sie brauchen Csh.

Java​

  1. Für ERDDAP™ v2.19+, eingerichtet Java 21. Aus Sicherheitsgründen ist es fast immer am besten, die neueste Version von Java 21. Bitte laden und installieren Sie die neueste Version OpenJDK von Adoptium (Temurin) ANHANG (LTS) . Um die Installation zu überprüfen, laufen /javaJreBinDirectory/java -Version z.B. /usr/local/jdk-21.0.3+9/jre/bin/java -Version .

    ERDDAP™ Arbeiten mit Java aus anderen Quellen, aber wir empfehlen Adoptium, weil es die wichtigste, gemeinschaftlich unterstützt, kostenlos (wie in Bier und Sprache) Version von Java 21 die Long Term Support bietet (kostenlose Upgrades seit vielen Jahren über die erste Veröffentlichung) . Aus Sicherheitsgründen, bitte aktualisieren Sie Ihre ERDDAP 's Version von Java periodisch als neue Versionen Java 21 von Adoptium erhältlich.

    ERDDAP™ wurde intensiv mit 21 nicht anderen Versionen getestet und verwendet. Aus verschiedenen Gründen testen wir weder mit anderen Versionen von Java .  

Tomcat​

  1. Einrichten Tomcat . Tomcat ist die am häufigsten verwendete Java Anwendungsserver, die Java Software, die zwischen den Netzdiensten des Betriebssystems steht und Java Serversoftware wie ERDDAP™ . Es ist Freie und Open Source Software (FOSS) .

Sie können einen anderen verwenden Java Anwendungsserver (z.B., Jetty) , aber wir testen und unterstützen Tomcat.

  • Laden Sie Tomcat herunter und entpacken Sie es auf Ihrem Server oder PC. Aus Sicherheitsgründen ist es fast immer am besten, die neueste Version von Tomcat 10 zu verwenden (Version 9 und unten sind nicht akzeptabel) die mit Java 21 oder neuer. Im Folgenden wird das Tomcat-Verzeichnis als Tomcat .

Warning!_ Wenn Sie bereits einen Tomcat mit einer anderen Web-Anwendung haben (insbesondere THREDDS) , wir empfehlen Ihnen zu installieren ERDDAP™ in Eine zweite Tomcat , weil ERDDAP™ verschiedene Tomcat-Einstellungen und sollte nicht mit anderen Anwendungen für Speicher konten müssen.

  • Auf Linux, den "Core" "Tar" herunterladen .gz " Tomcat Verteilung und auspacken. Wir empfehlen das Entpacken in /usr/local .
  • Auf einem Mac ist Tomcat wahrscheinlich bereits installiert in /Library/Tomcat , aber sollte es auf die neueste Version von Tomcat 10 aktualisieren. Wenn Sie es herunterladen, den "Core" "Tar" herunterladen .gz " Tomcat Verteilung und auspacken /Library/Tomcat .
  • Unter Windows können Sie die "Core" "zip" Tomcat Distribution herunterladen (die nicht mit der Windows-Registrierung übereinstimmt und die Sie von einer DOS-Befehlszeile steuern) und in einem entsprechenden Verzeichnis auspacken. (Für die Entwicklung verwenden wir die "Core" "zip" Distribution. Wir machen /Programme verzeichnis und entpacken es dort.) Oder Sie können die "Core" "64-bit Windows zip" Distribution herunterladen, die mehr Funktionen beinhaltet. Wenn die Distribution ein Windows-Installer ist, wird es wahrscheinlich Tomcat in, zum Beispiel /Programme/Appache-tomcat-10.0.23 .  

Server.xml​

  • Server.xml - In der tomcat/conf/server.xml Datei, es gibt zwei Änderungen, die Sie zu jedem der beiden machen sollten <Connector> Tags (für &lt;Connector port="8080" und eins für &lt;Conector port="8443" ) .
    1. (Empfohlen) Erhöhung der Verbindung Zeit Parameterwert, vielleicht auf 300000 (Millisekunden, 5 Minuten) .
    2. (Empfohlen) Einen neuen Parameter hinzufügen: entspanntQueryChars="[] | " . Dies ist optional und etwas weniger sicher, aber entfernt die Notwendigkeit, dass Benutzer diese Zeichen prozentual kodieren, wenn sie in den Parametern der Anfrage-URL eines Benutzers auftreten.  

Inhalt.xml​

  • kontext.xml -- Ressourcen Cache - In tomcat/conf/context.xml , direkt vor der </Context> tag, ändern Sie das Ressourcen-Tag (oder hinzufügen, wenn es nicht schon da ist) den Cache einstellen MaxSize-Parameter auf 80000: 
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Dies vermeidet zahlreiche Warnungen in Catalina. das alles beginnt

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

 

Apache Timeout​

  • Ändern Sie auf Linux-Computern die Apache-Timeout-Einstellungen, so dass zeitraubende Benutzeranfragen nicht Timeout (mit dem, was oft als "Proxy" oder "Bad Gateway"-Fehler erscheint) . Als root-Benutzer:
    • Ändern der Apache http d.conf Datei (in der Regel /etc/ http d/conf/ ) :
      • Ändern der bestehenden <Timeout> Einstellung (oder eine am Ende der Datei hinzufügen) bis 3600 (Sekunden) , anstatt der Standard 60 oder 120 Sekunden.
      • Ändern der bestehenden <ProxyTimeout> Einstellung (oder eine am Ende der Datei hinzufügen) bis 3600 (Sekunden) , anstatt der Standard 60 oder 120 Sekunden.
    • Neuart Apache: /usr/sbin/apachectl -k anmutig (aber manchmal ist es in einem anderen Verzeichnis) .

Sicherheit​

 

  • Sicherheitsempfehlung: Vgl. Diese Anweisungen die Sicherheit zu erhöhen Ihre Tomcat-Installation, insbesondere für öffentliche Server.  
  • Für die Öffentlichkeit ERDDAP™ Installationen auf Linux und Macs, ist es am besten, Tomcat einzurichten (das Programm) als Zugehörigkeit zum Benutzer Tomcat (einem separaten Benutzer mit begrenzten Berechtigungen, hat kein Passwort ) . Somit kann nur der Superbenutzer als Benutzer wechseln Tomcat . Dies macht es für Hacker unmöglich, sich als Benutzer an Ihrem Server anzumelden Tomcat . Und in jedem Fall sollten Sie es so machen, dass die Tomcat Benutzer hat sehr begrenzte Berechtigungen auf dem Dateisystem des Servers (read+write+execute Privilegien für die apache-tomcat Verzeichnisbaum und <bigParentDirectory> und lesen Sie nur Privilegien für Verzeichnisse mit Daten, die ERDDAP™ müssen Zugang zu).
    • Sie können die Tomcat Benutzerkonto (die kein Passwort haben) mit dem Befehl: 
      sudo useradd tomcat -s /bin/bash -p '*'
    • Sie können als Benutzer wechseln Tomcat mit dem Befehl 
      sudo su - tomcat
      (Es wird Sie um das Superuser-Passwort bitten, um dies zu tun.)
      • Sie können die Arbeit als Benutzer-Tomcat durch den Befehl stoppen
      exit
      • Den größten Teil des restlichen Tomcat und ERDDAP™ Anleitung als Benutzer Tomcat . Später, lauf die Start.sh und Abschalten. &#33; Skripte als Benutzer Tomcat so dass Tomcat die Erlaubnis hat, in seine Protokolldateien zu schreiben.
      • Nach dem Auspacken Tomcat, von den Eltern der apache-tomcat Verzeichnis:
        • Ändern Sie das Eigentum an dem apache-tomcat-Verzeichnisbaum zum tomcat-Benutzer. 
          chown -R tomcat apache-tomcat-10.0.23
          (aber ersetzen Sie den tatsächlichen Namen Ihres tomcat Verzeichnisses) .
        • Ändern Sie die "Gruppe" tomcat, Ihren Benutzernamen oder den Namen einer kleinen Gruppe, die tomcat und alle Administratoren von Tomcat/ ERDDAP : 
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Ändern Sie die Berechtigungen, damit Tomcat und die Gruppe lesen, schreiben, Privilegien ausführen: 
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Entfernen Sie die Berechtigungen von "anderen" Benutzern zum Lesen, Schreiben oder Ausführen: 
          chmod -R o-rwx apache-tomcat-10.0.23

Dies ist wichtig, weil es verhindert, dass andere Benutzer möglicherweise sensible Informationen in ERDDAP™ Dateien einrichten.

Speichermedien​

Set Tomcats Umweltvariablen

  • Auf Linux und Macs: Erstellen einer Datei tomcat/bin/setenv.sh (oder in Red Hat Enterprise Linux \[ RHEL \] , bearbeiten ~tomcat/conf/tomcat10.conf ) Tomcats Umgebungsvariablen einstellen. Diese Datei wird von tomcat/bin/startup.sh und Abschalten. &#33; . Die Datei sollte etwas wie:

    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

    (aber ersetzen Sie die Verzeichnisnamen von Ihrem Computer) . (Wenn Sie vorher festlegen JREHOME , Sie können das entfernen.) Auf Macs müssen Sie wahrscheinlich nicht festlegen JAVA_HOME .

  • Unter Windows: Erstellen einer Datei tomcat\bin\\setenv.bat Tomcats Umgebungsvariablen einstellen. Diese Datei wird von tomcat\bin\\startup.bat und shutdown.bat . Die Datei sollte etwas wie:

    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"

    (aber ersetzen Sie die Verzeichnisnamen von Ihrem Computer) . Wenn dies nur für lokale Tests ist, entfernen Sie "-server". (Wenn Sie vorher festlegen JREHOME , Sie können das entfernen.)

Die -Xmx und - Xms Speichereinstellungen sind wichtig, weil ERDDAP™ arbeitet besser mit mehr Erinnerung. Immer eingestellt - Xms den gleichen Wert wie -Xmx .

  • Für 32 Bit Betriebssysteme und 32 Bit Java : 64 Bit Java ist viel besser als 32 Bit Java , aber 32 Bit Java wird funktionieren, solange der Server nicht wirklich beschäftigt ist. Je mehr physische Speicher im Server desto besser: 4+ GB ist wirklich gut, 2 GB ist okay, weniger wird nicht empfohlen. mit 32 Bit Java , auch mit reichlich physischem Gedächtnis, Tomcat und Java wird nicht laufen, wenn Sie versuchen zu setzen -Xmx viel über 1500M (1200M auf einigen Computern) . Wenn Ihr Server weniger als 2 GB Speicher hat, reduzieren Sie die -Xmx Wert (in 'M'egaBytes) bis 1/2 des physischen Gedächtnisses des Computers.

  • Für 64 Bit Betriebssysteme und 64 Bit Java : 64 Bit Java wird nur an einem 64-Bit-Betriebssystem arbeiten.

    • mit Java 8, Sie müssen hinzufügen -d64 auf den Tomcat CATALINA_OPTS Parameter in wohnzimmer .
    • mit Java 21, Sie wählen 64 Bit Java wenn Sie eine Version herunterladen Java markiert "64 bit".

mit 64 Bit Java , Tomcat und Java kann sehr hoch sein -Xmx und - Xms Einstellungen. Je physischer Speicher im Server desto besser. Als vereinfachender Vorschlag: wir empfehlen Ihnen die Einstellung -Xmx und - Xms bis (in 'M'egaBytes) bis 1/2 (oder weniger) der physischen Erinnerung des Computers. Sie können sehen, ob Tomcat, Java , und ERDDAP™ werden in der Tat in 64-Bit-Modus durch die Suche nach "Bit" in ERDDAP 's Daily Report E-Mail oder BigParentDirectory/logs/ [Pressemitteilung](/docs/server-admin/additional-information#log) Datei ( BigParentDirectory wird angegeben in Setup.xml ) .

Müllsammlung​

  • In ERDDAP™ ' Pressemitteilung Datei, Sie werden viele sehen "GC (Verlagerungsversagen) " Nachrichten. Dies ist in der Regel kein Problem. Es ist eine häufige Nachricht von einem normalerweise arbeitenden Java sagen, dass es gerade einen kleinen Müll beendet Sammlung, weil es aus dem Raum in Eden lief (der Abschnitt des Java Heap für sehr junge Objekte) . Normalerweise zeigt die Nachricht Sie MemoryUseBefore-&gt;memoryUseAfter . Wenn diese beiden Zahlen zusammen sind, bedeutet das, dass die Müllsammlung nicht produktiv war. Die Nachricht ist nur ein Zeichen von Schwierigkeiten, wenn es sehr häufig ist (alle paar Sekunden) , nicht produktiv, und die Zahlen sind groß und nicht wächst, die zusammen angeben, Java braucht mehr Speicher, ist kämpfen, um Speicher freizugeben, und ist nicht in der Lage, Speicher freizugeben. Dies kann während einer stressigen Zeit geschehen, dann verschwinden. Aber wenn es fortdauert, ist das ein Zeichen von Ärger.
  • Wenn Sie sehen java.lang.OutOfMemoryError in ERDDAP™ ' Pressemitteilung Datei, siehe Ausgewählt für Tipps zur Diagnose und Lösung der Probleme.  

Genehmigungen​

chmod +x *.sh

Schriften​

Wenn Sie nicht die DejaVu Schriftarten verwenden möchten, müssen Sie die SchriftartFamilieneinstellung in setup.xml ändern. <fontFamily> SansSerif </fontFamily> , die mit allen Java Verteilungen. Wenn Sie <fontFamily> dem Namen einer Schrift, die nicht verfügbar ist, ERDDAP™ wird nicht geladen und wird eine Liste der verfügbaren Schriftarten in der Pressemitteilung Datei. Sie müssen eine dieser Schriftarten verwenden.

Wenn Sie die DejaVu-Schriften verwenden möchten, stellen Sie bitte sicher, dass <fontFamily> Einstellung in setup.xml ist <fontFamily> DejaVu Sans </fontFamily> .

Um die DejaVu Schriften zu installieren, laden Sie bitte herunter DejaVuFonts .zip (5,522,795 Bytes, MD5=33E1E61FAB06A547851ED308B4FFEF42) und entpacken Sie die Schriftdateien in ein temporäres Verzeichnis.

  • Auf Linux:
    • Für Linux Adoptium Java Verteilungen, siehe Diese Anweisungen .
    • mit anderen Java Verteilungen: Als Tomcat Benutzer, kopieren Sie die Schriftdateien in $JAVA_HOME/lib/fonts also Java die Schriftarten finden. Denken Sie daran: wenn/wenn Sie später auf eine neuere Version upgraden Java , Sie müssen diese Schriften neu installieren.
  • Auf Macs: für jede Schriftdatei, Doppelklick auf sie und klicken Sie dann auf Install Font.
  • Unter Windows 7 und 10: Wählen Sie im Windows Explorer alle Schriftdateien aus. Rechtsklick. Klicken Sie auf Installieren.  

Test Tomcat​

  • Testen Sie Ihre Tomcat Installation.
    • Linux:
    • Mac (tomcat als Systemadministrator-Benutzer ausführen) :
      • Laufen tomcat/bin/startup.sh .
      • Ihre URL anzeigen + ":8080/" in Ihrem Browser (z.B., http://coastwatch.pfeg.noaa.gov:8080/ ) . Beachten Sie, dass Ihr Tomcat standardmäßig nur von Ihnen erreichbar ist. Es ist nicht öffentlich zugänglich.
    • Windows localhost:
      • Klicken Sie mit der rechten Maustaste auf das Tomcat-Symbol im System-Tablet und wählen Sie "Start-Service".
      • Blick http://127.0.0.1:8080/ oder vielleicht http://localhost:8080/ , in Ihrem Browser. Beachten Sie, dass Ihr Tomcat standardmäßig nur von Ihnen erreichbar ist. Es ist nicht öffentlich zugänglich.

Sie sollten die Tomcat "Glückwünsche" Seite sehen.

Wenn es Probleme gibt, sehen Sie die Tomcat-Log-Datei an tomcat/logs/catalina.out .

Probleme mit der Tomcat-Installation?​

  • Auf Linux und Mac, wenn Sie nicht Tomcat oder ERDDAP™ (oder vielleicht können Sie sie nicht von einem Computer außerhalb Ihrer Firewall erreichen) , Sie können testen, ob Tomcat Port 8080 hört, indem Sie tippen (als Wurzel) auf einer Befehlszeile des Servers:

    netstat -tuplen | grep 8080

Das sollte eine Zeile mit etwas wie:

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

(wenn # ist etwas) , angeben, dass a Java Verfahren (Vermutlich Tomcat) hört auf Port "8080" für "tcp" Verkehr. Wurden keine Zeilen zurückgegeben, ist die zurückgegebene Zeile deutlich anders, oder wurden zwei oder mehr Zeilen zurückgegeben, so kann es ein Problem mit den Porteinstellungen geben.

  • Siehe die Tomcat Log-Datei tomcat/logs/catalina.out . Tomcat Probleme und einige ERDDAP™ Startup-Probleme werden dort fast immer angezeigt. Dies ist üblich, wenn Sie zuerst einrichten ERDDAP™ .

  • Siehe Tomcat Website oder suchen Sie das Internet nach Hilfe, aber bitte informieren Sie uns die Probleme, die Sie hatten und die Lösungen, die Sie gefunden haben.

  • Sehen Sie uns Abschnitt zum Erhalt zusätzlicher Unterstützung .  

ERDDAP™ Inhalt​

  1. Einrichten der tomcat/content/erddap Konfigurationsdateien. Auf Linux, Mac und Windows herunterladen ErddapContent .zip und entpacken Tomcat Verzeichnis, erstellen tomcat/content/erddap .

Version 1.0.0, 20333 bytes, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, datiert 2024-10-14

Einige vorherige Versionen sind ebenfalls verfügbar:

  • 2.17 (19,792 Bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, datiert 2022-02-16)
  • 2.18 (19,792 Bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, datiert 2022-02-16)
  • KAPITEL 1 (19,810 Bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, datiert 2022-10-09)
  • TEIL 2 (19,810 Bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, datiert 2022-12-08)
  • KAPITEL 3 (19,810 Bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, datiert 2023-02-27)

Sonstiges Verzeichnis​

Für Red Hat Enterprise Linux (RHEL) oder für andere Situationen, in denen Sie das Tomcat-Verzeichnis nicht ändern dürfen oder wo Sie wollen/benötigt haben um die ERDDAP™ Inhaltsverzeichnis in einem anderen Ort aus anderen Gründen (zum Beispiel, wenn Sie Jetty anstelle von Tomcat verwenden) , Entpacken ErddapContent .zip in das gewünschte Verzeichnis (nur die Tomcat Benutzer hat Zugriff) und die erddapContentDirectory Systemimmobilie (z. erddapContentDirectory =~tomcat/content/erddap ) also ERDDAP™ finden Sie dieses neue Content-Verzeichnis.

Setup.xml​

Für die erste Einrichtung müssen Sie diese Einstellungen zumindest ändern:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> Einstellungen
  • <admin...> Einstellungen
  • <baseHttpsUrl> (wenn Sie einrichten https )

Wenn Sie das BigParentDirectory erstellen, aus dem Stammverzeichnis von bigParentDirectory:

  • Mach das. Tomcat Benutzer der Eigentümer der BigParentDirectory : 
    chown -R tomcat bigParentDirectory
  • Ändern Sie die "Gruppe" tomcat, Ihren Benutzernamen oder den Namen einer kleinen Gruppe, die tomcat und alle Administratoren von Tomcat/ ERDDAP : 
    chgrp -R yourUserName bigParentDirectory
  • Ändern Sie die Berechtigungen, damit Tomcat und die Gruppe lesen, schreiben, Privilegien ausführen: 
    chmod -R ug+rwx bigParentDirectory
  • Entfernen Sie die Berechtigungen von "anderen" Benutzern zum Lesen, Schreiben oder Ausführen. Dies ist wichtig, um das Lesen möglicherweise sensibler Informationen zu verhindern in ERDDAP™ Log-Dateien und Dateien mit Informationen über private Datensätze. 
    chmod -R o-rwx bigParentDirectory

Umweltvariablen​

Beginnen mit ERDDAP™ V2.13, ERDDAP™ Administratoren können jeden Wert in setup.xml überschreiben, indem eine Umgebungsvariable angegeben wird benannt ERDDAP _valueName Vor dem Laufen ERDDAP™ . Zum Beispiel, verwenden ERDDAP Ich bin nicht da. überwiegt die <baseUrl> Wert. Dies kann bei der Bereitstellung hilfreich sein ERDDAP™ mit einem Container wie Docker, wie Sie Standardeinstellungen in setup.xml setzen können und dann spezielle Einstellungen über Umgebungsvariablen liefern. Wenn Sie geheime Informationen angeben ERDDAP™ über dieses Verfahren, überprüfen, ob die Informationen geheim bleiben. ERDDAP™ nur einmal pro Start Umgebungsvariablen liest, in der ersten Sekunde des Starts, so ist eine Möglichkeit, dies zu verwenden: die Umgebungsvariablen festlegen, starten ERDDAP , bis ERDDAP™ wird gestartet, dann die Umgebungsvariablen nicht mehr.

datasets.xml​

  • Lesen Sie die Kommentare in Arbeiten mit dem datasets.xml Datei . Später, nachdem Sie bekommen haben ERDDAP™ Laufen zum ersten Mal (in der Regel mit nur den Standarddatensätzen) , Sie werden das XML in tomcat/content/erdap/ datasets.xml alle von Ihnen gewünschten Datensätze angeben ERDDAP™ zu dienen. Hier verbringen Sie den Großteil Ihrer Zeit während der Einrichtung ERDDAP™ und später, während Sie Ihre ERDDAP™ .

Sie können ein Beispiel sehen datasets.xml auf GitHub .  

  • (Anders als) Jetzt oder (etwas wahrscheinlicher) in der Zukunft, wenn Sie die CSS-Datei von erddap ändern möchten, kopieren tomcat/content/erdap/images/erddapStart2.css bis tomcat/content/erdap/images/erddap2.css und dann Änderungen daran vornehmen. Änderungen an Erddap2.css nur wirksam werden, ERDDAP™ wird neu gestartet und erfordert oft auch den Benutzer, die Cache-Dateien des Browsers zu löschen.   ERDDAP™ wird nicht korrekt funktionieren, wenn die setup.xml oder datasets.xml Datei ist keine gut ausgebildete XML-Datei. Also, nachdem Sie diese Dateien bearbeitet haben, es ist eine gute Idee, zu überprüfen, ob das Ergebnis gut gebildet XML ist, indem der XML-Text in einen XML-Checker wie xmlvalidierung .  

Installieren Sie das Erddap. Kriegsakte​

  1. Auf Linux, Mac und Windows, __download Erddap.war Ich bin in der Lage. tomcat/webapps :

Version 2.28.1, 622,676,238 Bytes, MD5=48b4226045f950c8a8d69ef9521b9bc9, datiert 2025-09-05_

Die .war-Datei ist groß, weil sie hochauflösende Küste, Grenze und Höhendaten enthält, die benötigt werden, um Karten zu erstellen.

Einige vorherige Versionen sind ebenfalls verfügbar.

  • 2.17 (551.068,245 Bytes, MD5=5FEA912B5D42E50EAB9591F773EA848D, datiert 2022-02-16)
  • 2.18 (551.069,844 Bytes, MD5=461325E97E7577EC671DD50246CCFB8B, datiert 2022-02-23)
  • KAPITEL 1 (568,644,411 Bytes, MD5=F2CFF805893146E932E498FDDBD519B6, datiert 2022-10-09)
  • TEIL 2 (567,742,765 Bytes, MD5=2B33354F633294213AE2AFDDCF4DA6D0, datiert 2022-12-08)
  • KAPITEL 3 (572,124,953 Bytes, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, datiert 2023-03-03)
  • 2.24 (568,748,187 Bytes, MD5=970fbee172e28b0b8a07756eecbc898e, datiert 2024-06-07)
  • 2.2.2. (592,292,039 Bytes, MD5=652AFC9D1421F00B5F789DA2C4732D4C, datiert 2024-11-07)
  • 2.26 (607,404,032 Bytes, MD5=99a725108b37708e5420986c16a119, datiert 2025-03-31)
  • 2.27.0 (620,554,403 Bytes, MD5=3b2086c659ee4145ca2dff447bf4ef7, datiert 2025-06-11)

Proxy konfigurieren (spezifisch)​

ERDDAP™ wird typischerweise hinter einem Webserver-Reverse-Proxy bereitgestellt, um es auf Standard-HTML-Ports zu bedienen (80 und 443) . SSL/TLS-Terminierung wird häufig auch an der Webserver-Proxyschicht hanlded. Spezifika sind abhängig von den Anforderungen jeder Bereitstellung.

Apache​

  1. Stellen Sie sicher, dass Mod. und Mod_proxy_ http werden geladen:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Ändern der bestehenden <VirtualHost> Tag (wenn es eine gibt) , oder fügen Sie eine am Ende der Datei hinzu:
<VirtualHost *:80>
   ServerName YourDomain.org
   ProxyRequests Off
   ProxyPreserveHost On
   ProxyPass /erddap http://localhost:8080/erddap
   ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

wenn ERDDAP™ auf einem anderen Weg als /erddap , auch die X-Forwarded-Prefix Kopfzeile zum Pfadsegment vor /erddap . Diese Einstellung wäre für eine ERDDAP™ serviert /subpath/erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Dann neu starten Apache: /usr/sbin/apachectl -k anmutig (aber manchmal ist es in einem anderen Verzeichnis) .  

NGINX​

In der nginx config-Datei, setzen Sie diese Header:

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;

wenn ERDDAP™ auf einem anderen Weg als /erddap , auch die X-Forwarded-Prefix Kopfzeile zum Pfadsegment vor /erddap . Diese Einstellung wäre für eine ERDDAP™ serviert /subpath/erddap :

proxy_set_header X-Forwarded-Prefix /subpath

Um NGINX zu erhalten und ERDDAP™ richtig arbeiten mit https , Sie müssen den folgenden Snippet in den Tomcat Server.xml setzen <Host> Block:

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

 

Starten Sie Tomcat​

  • (Ich empfehle nicht, den Tomcat Web Application Manager zu verwenden. Wenn Sie nicht vollständig abschalten und starten Tomcat, früher oder später haben Sie PermGen Speicherprobleme.)
  • (In Linux oder Mac OS, wenn Sie einen speziellen Benutzer erstellt haben, um Tomcat laufen, z.B. tomcat, erinnern Sie sich, die folgenden Schritte zu tun, wie dieser Benutzer.)
  • Wenn Tomcat schon läuft, schalte Tomcat mit (in Linux oder Mac OS) tomcat/bin/shutdown.sh oder (in Windows) tomcat\bin\\ shutdown.bat

Auf Linux verwenden ps -ef | grep tomcat vor und nach Abschalten. &#33; um sicherzustellen, dass der tomcat-Prozess gestoppt ist. Der Prozess sollte vor der Stilllegung aufgeführt und schließlich nicht nach der Stilllegung aufgeführt werden. Es kann eine Minute oder zwei für ERDDAP™ um vollständig abzuschalten. Sei geduldig. Oder wenn es aussieht, als würde es nicht allein aufhalten, verwenden Sie: Kill -9 <processID>

  • Start Tomcat mit (in Linux oder Mac OS) tomcat/bin/startup.sh oder (in Windows) tomcat\bin\\startup.bat

I ERDDAP™ Laufen?​

Verwenden Sie einen Browser, um anzuzeigenhttp://www.YourServer.org/erddap/status.html. ERDDAP™ startet ohne geladene Datensätze. Datensätze werden in einem Hintergrundfaden geladen und werden so einzeln verfügbar.

Fehlerbehebung​

  • Wenn eine Anfrage von einem Benutzer kommt, geht es nach Apache (auf Linux und Mac OS Computern) Dann Tomcat. ERDDAP™ .
  • Sie können sehen, was zu Apache kommt (und damit verbundene Fehler) in den Apache-Log-Dateien.
  • Du sehen, was zu Tomcat kommt (und damit verbundene Fehler) in den Tomcat Log-Dateien ( tomcat/logs/catalina.out und andere Dateien in diesem Verzeichnis) .
  • Du kann sehen, was kommt ERDDAP , diagnostische Nachrichten aus ERDDAP , und Fehlermeldungen von ERDDAP in der ERDDAP™ <bigParentDirectory> /logs/log.txt Datei.
  • Tomcat fängt nicht an ERDDAP™ bis Tomcat eine Anfrage für ERDDAP™ . So können Sie in den Tomcat Protokolldateien sehen, wenn es begann ERDDAP™ oder wenn eine mit diesem Versuch verbundene Fehlermeldung vorliegt.
  • Wann ERDDAP™ beginnt, es umbenannt die alten ERDDAP™ log.txt Datei ( Pressemitteilungen <CurrentTime> .txt ) und erstellt eine neue log.txt-Datei. Und wenn Pressemitteilung Datei ist alt, es ist ein Zeichen, dass ERDDAP™ hat nicht vor kurzem neu gestartet. ERDDAP™ schreibt Log-Info zu einem Puffer und schreibt nur den Puffer in die Log-Datei periodisch, aber Sie können zwingen ERDDAP™ um den Puffer in die Log-Datei zu schreiben, indem Sie /erddap/status.html .

Probleme: Alte Version Java​

Wenn Sie eine Version von Java das ist zu alt für ERDDAP , ERDDAP™ wird nicht ausgeführt und Sie werden eine Fehlermeldung in Tomcats Log-Datei wie sehen

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

Die Lösung ist, die neueste Version zu aktualisieren Java und stellen Sie sicher, dass Tomcat es verwendet.

Probleme: langsames Startup Erstes Mal​

Tomcat muss zum ersten Mal eine Anwendung wie ERDDAP™ wird gestartet; vor allem muss es die Erddap.war Datei (die wie ein .zip Datei) . Auf einigen Servern, der erste Versuch, zu sehen ERDDAP™ Stände (30 Sekunden?) bis diese Arbeit beendet ist. Auf anderen Servern wird der erste Versuch sofort scheitern. Aber wenn Sie 30 Sekunden warten und wieder versuchen, wird es erfolgreich sein, wenn ERDDAP™ wurde korrekt installiert.

Dafür gibt es keine Lösung. So funktioniert Tomcat einfach. Aber es tritt nur das erste Mal, nachdem Sie eine neue Version installieren ERDDAP™ .

Abschalten und Neustart​

In der Zukunft, zu stillen (und Neustart) ERDDAP™ , siehe Wie schalte ich die Klappe und stelle Tomcat und ERDDAP .

Ärger?​

Probleme beim Installieren von Tomcat oder ERDDAP™ ? Sehen Sie uns Abschnitt zum Erhalt zusätzlicher Unterstützung .

E-Mail-Benachrichtigung über neue Versionen von ERDDAP​

Wenn Sie eine E-Mail erhalten möchten, wann immer eine neue Version von ERDDAP™ ist verfügbar oder wichtig ERDDAP™ Ankündigungen, du kannst mitmachen ERDDAP™ Liste der Ankündigungen Hier. . Diese Liste durchschnittlich etwa eine E-Mail alle drei Monate.

Anpassen​

  • Passen Sie Ihre ERDDAP™ Ihre Organisation hervorzuheben (nicht NOAA ERD ) .
  • Ändern Sie das Banner, das an der Spitze aller erscheint ERDDAP™ .html-Seiten durch Bearbeiten der <startBodyHtml5> Tag in Ihrem datasets.xml Datei. (Wenn es keinen gibt, kopieren Sie den Standard aus ERDDAP™ ' tomcat/webapps/erdap/WEB-INF/classes/gov/noaa/pfel/erdap/util/messages.xml Datei in datasets.xml und bearbeiten.) Zum Beispiel:
    • Verwenden Sie ein anderes Bild (d.h. das Logo Ihrer Organisation) .
    • Ändern Sie die Hintergrundfarbe.
    • " ERDDAP™ " zu "YourOrganization's ERDDAP™ "
    • Ändern Sie den "leichteren Zugang zu wissenschaftlichen Daten" zu "leichteren Zugriff auf _YourOrganization_s Daten".
    • Ändern Sie die "Brought to you by" Links, um Links zu Ihrer Organisation und Finanzierungsquellen zu sein.
  • Ändern Sie die Informationen auf der linken Seite der Startseite, indem Sie die <theShortDescriptionHtml> Tag in Ihrem datasets.xml Datei. (Wenn es keinen gibt, kopieren Sie den Standard aus ERDDAP™ ' tomcat/webapps/erdap/WEB-INF/classes/gov/noaa/pfel/erdap/util/messages.xml Datei in datasets.xml und bearbeiten.) Zum Beispiel:
    • Beschreiben Sie, was Ihre Organisation und/oder Gruppe tut.
    • Beschreiben Sie, welche Art von Daten diese ERDDAP™ hat.
    • Um das Symbol zu ändern, das auf Browser-Tabs erscheint, setzen Sie Ihr Unternehmen favicon. ico in tomcat/content/erdap/images/ . Vgl.https://en.wikipedia.org/wiki/Favicon.