Přeskočit na hlavní obsah

Instalovat

Jak provést počáteční nastavení ERDDAP™ na Vašem serveru

ERDDAP™ může běžet na libovolném serveru, který podporuje Java a Tomcat (a další aplikační servery jako Jetty, ale my je nepodporujeme) . ERDDAP™ byl testován na Linuxu (V tomto ohledu je třeba poznamenat, že společnost LuxSCS se domnívá, že společnost LuxSCS je v souladu se zásadou tržně jednajícího hospodářského subjektu.) , Mac, a Windows počítače.

  • Docker -- Poskytujeme ERDDAP™ v kontejneru na dok a IOOS nyní nabízí Rychlý začátek průvodce pro ERDDAP™ v kontejneru docker . Je to standard. ERDDAP™ instalace, v kontejneru Docker. Přes Docker Kompozice nabízíme snadné způsoby, jak nastavit ssl a monitorování, číst více v ven Dokovací dokumentace . Pokud již používáte Docker, budete pravděpodobně preferovat verzi Docker. Pokud hledáte spustit na cloud služby budete pravděpodobně preferovat verzi Docker.
  • Amazon -- Pokud instalujete ERDDAP™ na instanci Amazon Web Services EC2, viz Amazon Web Services Přehled Nejdřív.
  • Linux a Mac -- ERDDAP™ funguje skvěle na Linux a Mac počítače. Viz níže uvedené pokyny.
  • Okna -- Windows je v pořádku pro testování ERDDAP™ a pro osobní potřebu (viz níže uvedené pokyny) , ale nedoporučujeme ho používat pro veřejnost. ERDDAP™ Rozmístění. Běžící ERDDAP™ na Windows mohou mít problémy: zejména ERDDAP™ nemusí být schopen rychle smazat nebo přejmenovat soubory. Tohle je pravděpodobně kvůli antivirovému softwaru. (např. z McAfee a Norton) což je kontrola souborů na viry. Pokud narazíte na tento problém (které mohou být zobrazeny chybovými zprávami v log.txt soubor jako "Nelze smazat..."), změna nastavení antivirového softwaru může částečně zmírnit problém. Nebo místo toho zvažte použití serveru Linux nebo Mac.

Norma ERDDAP™ instalační pokyny pro počítače Linux, Macs a Windows jsou:

  1. Ujistěte se, že jsou nainstalovány nějaké závislosti. Na neWindows strojích (Linux a Mac) Potřebuješ Csh.

Java​

  1. Pro ERDDAP™ v2.29.0 +, nastaveno Java 25. Z bezpečnostních důvodů je téměř vždy nejlepší použít nejnovější verzi Java 25. Stáhněte si a nainstalujte nejnovější verzi Adoptium 's OpenJDK (Temurin) 25 (LTS) . Pro ověření instalace, spustit / javaJreBinDirectory / java -verze , například / usr / local / jdk- 25.0.1 + 8 / jre / bin / java -verze .

    ERDDAP™ pracuje s Java z jiných zdrojů, ale doporučujeme Adoptium, protože je hlavní, komunity- podporované, bez (jako v pivu a řeči) verze Java 25 nabízí dlouhodobou podporu (zdarma upgrady pro mnoho let po prvním vydání) . Z bezpečnostních důvodů prosím aktualizujte ERDDAP verze Java pravidelně jako nové verze Java 25 se dostane k dispozici z Adopcia.

    ERDDAP™ byl testován a používán extenzivně s 25, ne jiné verze. Z různých důvodů netestujeme ani nepodporujeme jiné verze Java .  

Tomcat​

  1. Nastavit Tomcat . Tomcat je nejpoužívanější Java Aplikační server, což je Java software, který stojí mezi síťovými službami operačního systému a Java serverový software jako ERDDAP™ . Je to svobodný a open source software (FOSS) .

Můžeš použít jiný. Java Server aplikace (např., Jetty) Ale testujeme jen s Tomcatem.

  • Stáhněte si Tomcat a vybalte jej na vašem serveru nebo PC. Z bezpečnostních důvodů je téměř vždy nejlepší použít nejnovější verzi Tomcat 10 (verze 9 a níže jsou nepřijatelné) která je určena pro práci s Java 25 nebo novější. Níže bude adresář Tomcat označen jako tomcat .

Varování! Pokud již máte Tomcat běží některé jiné webové aplikace (Obzvláště HISDDS) , doporučujeme nainstalovat ERDDAP™ n druhý Tomcat , protože ERDDAP™ potřebuje různá nastavení Tomcat a neměl by se potýkat s jinými aplikacemi na paměť.

  • Na Linuxu, stáhnout "Core" "tar .gz "Rozdělení Tomcat a vybalte to. Doporučujeme vybalovat v / usr / lokální .
  • Na Mac, Tomcat je pravděpodobně již nainstalován / Knihovna / Tomcat , ale měl by ji aktualizovat na nejnovější verzi Tomcat10. Když to stáhnete, stáhnout "Core" "tar .gz "Rozdělení Tomcat a vybalit / Knihovna / Tomcat .
  • Na Windows, můžete stahovat "Core" "zip" Tomcat distribuce (který nezahrává s registrem Windows a který ovládáte z příkazové řádky DOS) a vybalte ji v příslušném adresáři. (Pro rozvoj používáme "Core" "zip" distribuci. Uděláme / programy adresář a rozbalte ho tam.) Nebo si můžete stáhnout "Core" "64-bit Windows zip" distribuci, která obsahuje více funkcí. Pokud je distribuce instalátorem Windows, bude pravděpodobně Tomcat v, například, / Programové soubory / apache- tomcat- 10.0.23 .  

server.xml​

  • server.xml - V tomcat / conf / server.xml soubor, existují dvě změny, které byste měli provést na každé z obou <Connector> štítky (jeden pro &lt; konektor port = "8080" a jeden pro &lt; Contector port = "8443" ) .
    1. (Doporučené) Zvýšit připojení Timeout hodnota parametru, možná až 300000 (milisekundy, což je 5 minut) .
    2. (Doporučené) Přidat nový parametr: RelaxaceQueryChars = "[] | " . Toto je volitelné a mírně méně bezpečné, ale odstraňuje potřebu uživatelů zakódovat tyto znaky, pokud se objeví v parametrech URL žádosti uživatele.  

obsah​

  • context.xml -- Zdroje Cache - in tomcat / conf / context.xml , těsně před </Context> tag, změna značky Zdroje (nebo to přidejte, pokud už tam není.) Nastavení cache Parametr MaxSize na 80000: 
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Vyhýbá se tak četným varováním v Catalině. ven, že všechno začíná

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

 

Timeout Apache​

  • Na Linuxových počítačích změňte nastavení Apache timeout tak, aby časově náročné uživatelské požadavky netimeout (s tím, co se často jeví jako "Proxy" nebo "Bad Gateway" chyba) . Jako kořenový uživatel:
    • Změnit Apache http d.conf soubor (obvykle íp / etc / http d / conf / ) :
      • Změnit existující <Timeout> nastavení (nebo přidat jeden na konci souboru) až 3600 (sekund) , místo výchozího 60 nebo 120 sekund.
      • Změnit existující <ProxyTimeout> nastavení (nebo přidat jeden na konci souboru) až 3600 (sekund) , místo výchozího 60 nebo 120 sekund.
    • Restartovat Apache: / usr / sbin / apachectl -K půvabný (ale někdy je v jiném adresáři.) .

Bezpečnost​

 

  • Bezpečnostní doporučení: Viz Tyto pokyny zvýšení bezpečnosti Vaše instalace Tomcat, zejména pro veřejné servery.  
  • Pro veřejnost ERDDAP™ instalace na Linux a Mac, je nejlepší nastavit Tomcat (program) jako součást uživatele tomcat (samostatný uživatel s omezenými povoleními a nemá heslo ) . Tak, pouze super uživatel může přejít na funkci uživatele tomcat . To znemožňuje hackerům přihlásit se na váš server jako uživatel tomcat . A v každém případě byste to měli udělat tak, aby tomcat uživatel má velmi omezená oprávnění v souborovém systému serveru (čtení + zápis + výkon práv pro apache- tomcat strom adresáře a <bigParentDirectory> a read- pouze výsady pro adresáře s daty, které ERDDAP™ potřebuje přístup k).
    • Můžete vytvořit tomcat uživatelský účet (který nemá heslo) pomocí příkazu: 
      sudo useradd tomcat -s /bin/bash -p '*'
    • Můžete přejít na práci jako uživatel tomcat pomocí příkazu 
      sudo su - tomcat
      (Bude vás žádat o heslo pro superuživatele pro povolení k tomu.)
      • Můžete přestat pracovat jako uživatel tomcat pomocí příkazu
      exit
      • Udělat většinu zbytku Tomcat a ERDDAP™ Nastavit pokyny jako uživatel tomcat . Později, spusťte startup.sh a Vypnout. sh skripty jako uživatel tomcat takže Tomcat má povolení psát do svých log souborů.
      • Po vybalení Tomcat, od rodiče apache- tomcat adresář:
        • Změňte vlastnictví adresáře apache- tomcat stromu na uživatele tomcat. 
          chown -R tomcat apache-tomcat-10.0.23
          (ale nahradit skutečný název vašeho adresáře tomcat) .
        • Změňte "skupinu" na tomcat, vaše uživatelské jméno, nebo jméno malé skupiny, která obsahuje tomcat a všechny administrátory Tomcat / ERDDAP : 
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Změna oprávnění tak, že tomcat a skupina mají číst, psát, vykonávat práva: 
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Odstranit oprávnění "jiného" uživatele pro čtení, zápis nebo provedení: 
          chmod -R o-rwx apache-tomcat-10.0.23

To je důležité, protože to brání jiným uživatelům číst možná citlivé informace v ERDDAP™ Nastavit soubory.

Paměť​

Nastavit proměnné prostředí pro Tomcat

  • Na Linuxu a Macích: Vytvořit soubor tomcat / bin / setenv.sh (nebo v Red Hat Enterprise Linux \[ RHEL \] , editovat ~ tomcat / conf / tomcat10.conf ) nastavit Tomcatovy proměnné prostředí. Tento soubor bude použit tomcat / bin / startup.sh a Vypnout. sh . Soubor by měl obsahovat něco jako:

    export JAVA_HOME=/usr/local/jdk-25.0.1+8
    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

    (ale nahradit názvy adresářů z počítače) . (Jestliže JRE _ HOME Můžeš to odstranit.) Na Macovi, pravděpodobně nemusíte nastavit JAVA _ HOME .

  • Na Windows: Vytvořit soubor tomcat\\ bin\\ setenv.bat nastavit Tomcatovy proměnné prostředí. Tento soubor bude použit tomcat\\ bin\\ startup.bat a shutdown.bat . Soubor by měl obsahovat něco jako:

    SET "JAVA_HOME=\\someDirectory\\jdk-25.0.1+8"
    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"

    (ale nahradit názvy adresářů z počítače) . Pokud je to jen pro lokální testování, odstraňte "-server". (Jestliže JRE _ HOME Můžeš to odstranit.)

U -Xmx a -Xms Nastavení paměti je důležité, protože ERDDAP™ lépe pracuje s více pamětí. Vždy nastaveno -Xms na stejnou hodnotu jako -Xmx .

  • Pro 32 bitové operační systémy a 32 bitů Java : 64 bit Java je mnohem lepší než 32 bit Java , ale 32 bit Java bude fungovat, pokud server nebude mít moc práce. Čím více fyzické paměti na serveru lepší: 4 + GB je opravdu dobré, 2 GB je v pořádku, méně se nedoporučuje. S 32 bity Java , i s bohatou fyzickou pamětí, Tomcat a Java Neutečete, pokud se pokusíte nastavit -Xmx mnohem více než 1500M (1200M na některých počítačích) . Pokud váš server má méně než 2GB paměti, snížit -Xmx hodnota (In 'M' egaBytes) 1 / 2 fyzické paměti počítače.

  • Pro 64 bitové operační systémy a 64 bitů Java : 64 bit Java bude pracovat pouze na 64 bitovém operačním systému.

    • S Java 8, musíte přidat - d64 Tomcat CATALINA _ OPTS parametr in setenv.bat .
    • S Java 21, vyberete 64 bit Java při stahování verze Java značeno "64 bitů".

S 64 bity Java , Tomcat a Java může použít velmi vysoké -Xmx a -Xms nastavení. Čím více fyzické paměti na serveru, tím lépe. Jako zjednodušený návrh: doporučujeme nastavit -Xmx a -Xms do (In 'M' egaBytes) až 1 / 2 (nebo méně) fyzické paměti počítače. Uvidíš, jestli Tomcat, Java a ERDDAP™ skutečně běží v 64 bitovém režimu hledáním "bitu", v ERDDAP Daily Report email nebo bigParentDirectory / logs / [log.txt](/docs/server-admin/additional-information#log) soubor ( bigParentDirectory je specifikováno v setup.xml ) .

Sbírka odpadků​

  • V ERDDAP™ s log.txt soubor, uvidíte mnoho "GC (Selhání přidělování) "zprávy. Tohle obvykle není problém. Je to častá zpráva z normálně fungující Java že právě dokončil menší odpad. sbírka, protože v Edenu došlo místo (Oddíl Java hromada pro velmi mladé předměty) . Obvykle vám zpráva ukáže memoryUseBefore- &gt; memoryUseAfter . Pokud jsou ta dvě čísla blízko sebe, znamená to, že sbírka odpadků nebyla produktivní. Zpráva je jen známkou potíží, pokud je velmi častá (každých pár sekund) , není produktivní, a čísla jsou velké a nerostou, které společně naznačují, že Java potřebuje více paměti, snaží se uvolnit paměť, a není schopen uvolnit paměť. Může se to stát během stresujícího období a pak odejít. Ale pokud to trvá, je to známka potíží.
  • Pokud uvidíte java.lang.OutOfMemoryError s ERDDAP™ s log.txt soubor, viz Chyba v paměti pro tipy, jak diagnostikovat a řešit problémy.  

Povolení​

chmod +x *.sh

Písma​

Pokud se rozhodnete nepoužívat písma DejaVu, musíte změnit nastavení fontFamily v setup.xml na <fontFamily> SansSerif </fontFamily> , který je k dispozici se všemi Java Rozdělení. If you set <fontFamily> na jméno písma, které není k dispozici, ERDDAP™ nebude nabíjet. a vytiskne seznam dostupných písem log.txt Složka. Musíš použít jeden z těch fontů.

Pokud se rozhodnete používat DejaVu písma, ujistěte se prosím, že <fontFamily> nastavení v setup.xml je <fontFamily> DejaVu Sans </fontFamily> .

Chcete-li nainstalovat písma DejaVu, stáhněte si DejaVuFonts .zip (5,522,795 bajtů, MD5 = 33E1E61FAB06A547851ED308B4FFEF42) a rozepnout fontové soubory do dočasného adresáře.

  • Na Linuxu:
    • Pro Linux Adoptium Java rozdělení, viz Tyto pokyny .
    • Ostatní Java rozdělení: Jako tomcat uživatel, zkopírujte soubory písma do $JAVA _ HOME / lib / fonty Takže Java najít písma. Pamatujte: pokud / když později upgrade na novější verzi Java , musíte znovu nainstalovat tato písma.
  • Na Mac: pro každý soubor s fontem na něj dvakrát klikněte a potom klikněte na Install Font.
  • Na Windows 7 a 10: ve Windows Explorer vyberte všechny soubory písma. Pravým tlačítkem myši. Klikněte na Install.  

Test Tomcat​

  • Otestujte si instalaci Tomcat.
    • Linux:
    • Mac (spusťte tomcat jako administrátor systému uživatele) :
      • Běž. tomcat / bin / startup.sh .
      • Zobrazit URL + ": 8080 /" ve svém prohlížeči (např. http://coastwatch.pfeg.noaa.gov:8080/ ) . Všimněte si, že ve výchozím nastavení, váš Tomcat je přístupný pouze vy. Není veřejně přístupný.
    • Localhost Windows:
      • Klikněte pravým tlačítkem myši na ikonu Tomcat v systémovém panelu a zvolte "Start service".
      • Pohled http://127.0.0.1:8080/ , nebo možná http://localhost:8080/ , ve vašem prohlížeči. Všimněte si, že ve výchozím nastavení, váš Tomcat je přístupný pouze vy. Není veřejně přístupný.

Měl bys vidět stránku "Blahopřeju".

Pokud je problém, podívejte se na Tomcat log souboru na tomcat / logs / catalina.out .

Potíže s instalací Tomcat?​

  • Na Linux a Mac, pokud se nemůžete dostat Tomcat nebo ERDDAP™ (Nebo se k nim prostě nemůžete dostat z počítače mimo váš firewall.) , můžete otestovat, zda Tomcat poslouchá port 8080, zadáním (jako kořen) na příkazovém řádku serveru:

    netstat -tuplen | grep 8080

To by mělo vrátit jednu větu s něčím jako:

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

(kde # je nějaká číslice) s uvedením, že java proces (Pravděpodobně Tomcat) je poslech na portu "8080" pro "tcp" provoz. Pokud nebyly vráceny žádné řádky, pokud se vrácené řádky významně liší, nebo pokud byly vráceny dvě nebo více řádků, pak může být problém s nastavením portu.

  • Viz soubor Tomcat log tomcat / logs / catalina.out . Tomcat problémy a některé ERDDAP™ problémy se startem jsou zde téměř vždy indikovány. To je běžné, když jste první nastavení ERDDAP™ .

  • Viz Tomcat webové stránky nebo hledat na webu o pomoc, ale dejte nám prosím vědět, jaké problémy jste měli a řešení jste našli.

  • Podívejte se na naše část o získání další podpory .  

ERDDAP™ Obsah​

  1. Nastavit tomcat / content / erddap konfigurační soubory. Na Linux, Mac a Windows, stáhnout erddapContent .zip a rozepni to do tomcat adresář, tvorba tomcat / content / erddap .

_ _ Version 1.0.1, 20683 bytes, MD5 = 98a8099e7e674da59fe35e9c96efa7b5, dated 2025-06-02 _ _

K dispozici jsou i některé předchozí verze:

  • 2, 17 (19,792 bajtů, MD5 = 8F892616BAEEF2DF0F4BB036DCB4AD7C, datováno 2022- 02- 16)
  • 2, 18 (19,792 bajtů, MD5 = 8F892616BAEEF2DF0F4BB036DCB4AD7C, datováno 2022- 02- 16)
  • 2. 21 (19,810 bajtů, MD5 = 1E26F62E7A06191EE6868C40B9A29362, datováno 2022-10-09)
  • 2. 22 (19,810 bajtů, MD5 = 1E26F62E7A06191EE6868C40B9A29362, datováno 2022- 12- 08)
  • 2, 23 (19,810 bajtů, MD5 = 1E26F62E7A06191EE6868C40B9A29362, datováno 2023-02-27)

Ostatní adresář​

Pro Red Hat Enterprise Linux (RHEL) nebo pro jiné situace, kdy nemáte povoleno měnit adresář Tomcat nebo kde chcete / potřebujete dát ERDDAP™ obsah adresáře v jiném místě z nějakého jiného důvodu (například, pokud používáte Jetty místo Tomcat) , unzip erddapContent .zip do požadovaného adresáře (na které pouze tomcat uživatel má přístup) a nastavit erddapContentDirectory Vlastnost systému (např. erddapContentDirectory =~tomcat/content/erddap ) Takže ERDDAP™ najít tento nový adresář obsahu.

setup.xml​

Pro počáteční nastavení, musíte alespoň změnit tato nastavení:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> nastavení
  • <admin...> nastavení
  • <baseHttpsUrl> (Když to nastavíš https )

Když vytvoříte bigParentDirectory, z mateřského adresáře bigParentDirectory:

  • Make the tomcat uživatel majitel bigParentDirectory : 
    chown -R tomcat bigParentDirectory
  • Změňte "skupinu" na tomcat, vaše uživatelské jméno, nebo jméno malé skupiny, která obsahuje tomcat a všechny administrátory Tomcat / ERDDAP : 
    chgrp -R yourUserName bigParentDirectory
  • Změna oprávnění tak, že tomcat a skupina mají číst, psát, vykonávat práva: 
    chmod -R ug+rwx bigParentDirectory
  • Odstranit oprávnění "jiného" uživatele ke čtení, psaní nebo spuštění. To je důležité, aby se zabránilo čtení možná citlivé informace n ERDDAP™ logovat soubory a soubory s informacemi o soukromých souborech dat. 
    chmod -R o-rwx bigParentDirectory

Proměnné prostředí​

Počínaje ERDDAP™ v2.13, ERDDAP™ administrátoři mohou přepsat jakoukoli hodnotu v setup.xml specifikováním proměnné prostředí Název ERDDAP _ valueName před spuštěním ERDDAP™ . Například použít ERDDAP _ baseUrl nadchází <baseUrl> hodnota. To může být užitečné při nasazení ERDDAP™ s kontejnerem jako Docker, jak můžete dát standardní nastavení v setup.xml a pak dodat speciální nastavení přes proměnné prostředí. Pokud dodáte tajné informace ERDDAP™ pomocí této metody, Ujistěte se, že informace zůstanou tajné. ERDDAP™ přečte proměnné prostředí pouze jednou za spuštění, v první sekundě spuštění, takže jeden způsob, jak použít to je: nastavit proměnné prostředí, start ERDDAP , Počkej. ERDDAP™ je spuštěn, poté odstartuje proměnné prostředí.

datasets.xml​

  • Přečtěte si komentáře v Spolupráce s datasets.xml Soubor . Později, až budeš mít ERDDAP™ běh poprvé (obvykle jen s výchozími soubory dat) , budete modifikovat XML v tomcat / content / erddap / datasets.xml pro určení všech souborů dat, které chcete ERDDAP™ sloužit. Tady strávíš většinu svého času. při nastavení ERDDAP™ a později při zachování ERDDAP™ .

Můžete vidět příklad. datasets.xml na GitHub .  

  • (Nepravděpodobné) Teď nebo (mírně pravděpodobnější) v budoucnu, pokud chcete změnit soubor CSS erddapu, zkopírujte tomcat / content / erddap / images / erddapStart2.css do tomcat / content / erddap / images / erddap2.css a pak udělat změny. Změny erddap2.css Nabývá účinku pouze tehdy, pokud ERDDAP™ je restartován a často také vyžaduje, aby uživatel vymazal soubory v prohlížeči.   ERDDAP™ pokud setup.xml nebo datasets.xml soubor není dobře vytvořený XML soubor. Takže, až upravíte tyto soubory, je dobrý nápad ověřit, že výsledek je dobře tvořen XML tím, že vložení XML text do XML checker jako je xmlvalidation .  

Nainstalujte erddap. válečný spis​

  1. Na Linux, Mac a Windows _ _ download erddap.war _ _ tomcat / webové aplikace :

_ _ Version 2.30.0, 706,939,121 bytes, MD5 = CDC4B3D82A20B33A6623B85312F6DC21, dated 2026-04-06 _

.war soubor je velký, protože obsahuje vysoké rozlišení pobřeží, hranice a nadmořská výška data potřebná k vytvoření mapy.

K dispozici jsou i některé předchozí verze.

  • 2, 17 (551,068,245 bajtů, MD5 = 5FEA912B5D42E50EAB9591F773EA848D, datováno 2022-02-16)
  • 2, 18 (551,069,844 bajtů, MD5 = 461325E97E7577EC671DD50246CFB8B, datováno 2022- 02- 23)
  • 2. 21 (568,644,411 bajtů, MD5 = F2CF805893146E932E498FDDBD519B6, dat. nar.)
  • 2. 22 (567,742,765 bajtů, MD5 = 2B33354F633294213AE2AFDDCF4DA6D0, dat. nar.)
  • 2, 23 (572,124,953 bajtů, MD5 = D843A043C506725EBD6F8EFDCCA8FD5F, datováno 2023-03-03)
  • 2. 24 (568,748,187 bajtů, MD5 = 970fbee172e28b0b8a07756eecbc898e, dat. nar.)
  • 2, 25 (592,292,039 bajtů, MD5 = 652AFC9D1421F00B5F789DA2C4732D4C, datováno 2024- 11- 07)
  • 2. 26 (607,404,032 bajtů, MD5 = 99a725108b37708e5420986c1616a119, datováno 2025-03-31)
  • 2. 27. 0 (620,554,403 bajtů, MD5 = 3b2086c659eee4145ca2dff447bf4ef7, datováno 2025-06-11)
  • 2, 28, 1 (622,676,238 bajtů, MD5 = 48b4226045f950c8a8d69ef9521b9bc9, datováno 2025-09-05)
  • 2. 29. 0 (706,788,135 bajtů, MD5 = A5ED0DCC8D46CA27640FFEB8CE4A8560, datováno 2025-12-15)

Nastavit proxy (Specifické nasazení)​

ERDDAP™ je obvykle nasazen za webserver reverzní proxy, aby bylo možné sloužit na standardních HTTP portech (80 a 443) . Výpověď SSL / TLS je často i na proxy vrstvě webserveru. Specifika závisí na požadavcích každého nasazení.

Apache​

  1. Zajistit, aby mod _ proxy a mod _ proxy _ http jsou naloženy:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Změnit stávající <VirtualHost> značka (pokud existuje) , nebo přidat jeden na konci souboru:
<VirtualHost *:80>
   ServerName YourDomain.org
   ProxyRequests Off
   ProxyPreserveHost On
   ProxyPass /erddap http://localhost:8080/erddap
   ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Pokud ERDDAP™ je podávána na jiné cestě než / erddap , také nastavit X- Forwarded- Prefix záhlaví segment cesty _ před _ / erddap . Toto nastavení by bylo vhodné pro ERDDAP™ podáváno v / subpath / erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Pak restartujte Apache: / usr / sbin / apachectl -K půvabný (ale někdy je v jiném adresáři.) .  

NGINX​

V konfiguračním souboru nginx nastavte tyto hlavičky:

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;

Pokud ERDDAP™ je podávána na jiné cestě než / erddap , také nastavit X- Forwarded- Prefix záhlaví segment cesty _ před _ / erddap . Toto nastavení by bylo vhodné pro ERDDAP™ podáváno v / subpath / erddap :

proxy_set_header X-Forwarded-Prefix /subpath

S cílem získat NGINX a ERDDAP™ správně pracovat s https , musíte dát následující snippet uvnitř Tomcat server.xml <Host> blok:

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

 

Spustit Tomcat​

  • (Nedoporučuji používat Tomcat Web Application Manager. Pokud nebudete plně vypnout a nastartovat Tomcat, dříve či později budete mít problémy s pamětí PermGen.)
  • (V Linuxu nebo Mac OS, pokud jste vytvořili speciální uživatele pro spuštění Tomcat, např. tomcat, nezapomeňte udělat následující kroky jako tento uživatel.)
  • Pokud Tomcat už běží, vypněte Tomcat s (v Linuxu nebo Mac OS) tomcat / bin / shutdow.sh nebo (ve Windows) tomcat\\ bin\\ shutdown.bat

Na Linux použijte ps- ef | kočkodan obecný před a po Vypnout. sh aby se ujistil, že proces tomcat skončil. Proces by měl být uveden před ukončením a nakonec by neměl být uveden po ukončení. To může trvat minutu nebo dvě na ERDDAP™ úplně vypnout. Buď trpělivý. Nebo pokud to vypadá, že se nezastaví sám, použijte: zabít -9 <processID>

  • Spusťte Tomcat s (v Linuxu nebo Mac OS) tomcat / bin / startup.sh nebo (ve Windows) tomcat\\ bin\\ startup.bat

Je ERDDAP™ Běhání?​

Pomocí prohlížeče se pokusíte zobrazit http://www.YourServer.org/erddap/status.html.

ERDDAP™ začne bez načtení datových souborů. Datasety jsou načteny do záhlaví a tak jsou k dispozici jeden-by-jeden.

Řešení problémů​

  • Když přijde žádost uživatele, jde do Apache (na počítačích Linux a Mac OS) Pak Tomcat. ERDDAP™ .
  • Můžete vidět, co přijde do Apache (a související chyby) v záznamech Apache.
  • Ty. vidět, co přijde na Tomcat (a související chyby) v souborech Tomcat log ( tomcat / logs / catalina.out a další soubory v tomto adresáři) .
  • Ty. vidět, co přijde na ERDDAP , diagnostické zprávy od ERDDAP , a chybové zprávy z ERDDAP , ERDDAP™ <bigParentDirectory> / logs / log.txt Složka.
  • Tomcat nezačíná. ERDDAP™ dokud Tomcat nedostane žádost ERDDAP™ . Takže můžete vidět v Tomcat log soubory, pokud to spuštěn ERDDAP™ nebo pokud existuje chybová zpráva týkající se tohoto pokusu.
  • Kdy ERDDAP™ začíná, přejmenovává staré ERDDAP™ log.txt soubor ( logArchivedat <CurrentTime> .txt ) a vytvoří nový log.txt soubor. Takže pokud log.txt Soubor je starý, je to znamení, že ERDDAP™ v poslední době nebyl znovu zahájen. ERDDAP™ zapisuje informace o záznamu do bufferu a pouze píše buffer do logového souboru pravidelně, ale můžete vynutit ERDDAP™ napsat buffer do souboru záznamu návštěvou /erddap/status.html .

Problémy: Stará verze Java​

Pokud používáte verzi Java Na to je moc starý. ERDDAP , ERDDAP™ nebude běžet a uvidíte chybovou zprávu v Tomcat log souboru jako

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

Řešení je aktualizovat na nejnovější verzi Java a ujisti se, že ho Tomcat používá.

Problém: Pomalý start poprvé​

Tomcat musí udělat hodně práce při první aplikaci jako ERDDAP™ je zahájena; zejména musí vybalit erddap.war soubor (který je jako .zip soubor) . Na některých serverech, první pokus vidět ERDDAP™ stánky (30 vteřin?) dokud tato práce neskončí. Na jiných serverech, první pokus selže okamžitě. Ale pokud počkáte 30 sekund a zkusíte to znovu, uspěje to, když ERDDAP™ byl nainstalován správně.

Na to není žádná náprava. Takhle prostě Tomcat funguje. Ale to se vyskytuje pouze poprvé po instalaci nové verze ERDDAP™ .

Vypnout a restartovat​

V budoucnosti, vypnutí (a restartovat) ERDDAP™ , viz Jak vypnout a obnovit Tomcat a ERDDAP .

Problémy?​

Potíže s instalací Tomcat nebo ERDDAP™ ? Podívejte se na naše část o získání další podpory .

E-mailové oznámení nových verzí ERDDAP​

Pokud chcete dostávat e-mail kdykoliv novou verzi ERDDAP™ je k dispozici nebo jiné důležité ERDDAP™ oznámení, můžete se připojit k ERDDAP™ Seznam oznámení Tady. . Tento seznam představuje zhruba jeden e-mail každé tři měsíce.

Přizpůsobit​

  • Přizpůsobte si ERDDAP™ zvýraznit vaši organizaci (ne NOAA ERD ) .
  • Změnit banner, který se objeví na vrcholu všeho ERDDAP™ .html stránky editací <startBodyHtml5> Značka ve vašem datasets.xml Složka. (Pokud žádný není, zkopírujte výchozí z ERDDAP™ s tomcat / webapps / erddap / WEB-INF / classes / gov / noaa / pfel / erddap / util / messages.xml soubor do datasets.xml ) Například byste mohli:
    • Použít jiný obrázek (tedy logo vaší organizace) .
    • Změňte barvu pozadí.
    • Změnit " ERDDAP™ "to" _ YourOrganization _ 's ERDDAP™ "
    • Změna "Snadnější přístup k vědeckým údajům" na "Snadnější přístup k údajům _ YourOrganization _ '."
    • Změňte "Přinesl vám" odkazy být odkazy na vaši organizaci a zdroje financování.
  • Změnit informace na levé straně domovské stránky editací <theShortDescriptionHtml> Značka ve vašem datasets.xml Složka. (Pokud žádný není, zkopírujte výchozí z ERDDAP™ s tomcat / webapps / erddap / WEB-INF / classes / gov / noaa / pfel / erddap / util / messages.xml soubor do datasets.xml ) Například byste mohli:
    • Popište, co vaše organizace a / nebo skupina dělá.
    • Popište, jaké údaje to jsou ERDDAP™ má.
    • Chcete-li změnit ikonu, která se objeví na záložkách prohlížeče, dejte si favicon vaší organizace. ico tomcat / content / erddap / images / . Viz https://en.wikipedia.org/wiki/Favicon.