Nainstalovat
Jak udělat počáteční nastavení ERDDAP™ na Vašem serveru
ERDDAP™ může běžet na jakémkoli serveru, který podporuje Java a Tomcat (a další servery jako Jetty, ale my je nepodporujeme.) . ERDDAP™ byla testována na Linuxu (včetně AWS Amazonu) , Mac a Windows počítače.
- Docker -- Poskytujeme ERDDAP™ v kontejneru Docker a IOOS nyní nabízí Návod k rychlému startu pro ERDDAP™ v kontejneru Docker . Je to standard. ERDDAP™ instalace v kontejneru Docker. Přes Dockera Kompozit poskytujeme jednoduché způsoby, jak nastavit ssl a monitoring, číst více ven Dokumentace dockerů . Pokud již používáte Docker, budete pravděpodobně preferovat Docker verzi. Pokud hledáte spustit na cloud služby budete pravděpodobně preferovat verzi Docker.
- Amazon -- Pokud instalujete ERDDAP™ v případě Amazon Web Services EC2: Přehled webových služeb Amazon Nejdřív.
- Linux a Macs -- ERDDAP™ funguje skvěle na Linux a Mac počítače. Viz pokyny níže.
- Okna -- Windows je v pořádku pro testování ERDDAP™ a pro osobní použití (viz níže uvedené pokyny) , ale nedoporučujeme ho používat pro veřejnost. ERDDAP™ nasazení. Běh ERDDAP™ na Windows mohou mít problémy: zejména: ERDDAP™ nemusí být schopen rychle smazat a/nebo přejmenovat soubory. To je pravděpodobně kvůli antivirovému softwaru. (např. z McAfee a Norton) který kontroluje soubory na viry. Pokud narazíte na tento problém (které lze vidět chybovými zprávami v log.txt soubor jako "Neschopen odstranit ..."), změna nastavení antivirového softwaru může částečně zmírnit problém. Nebo místo toho používejte Linux nebo Mac server.
Standard ERDDAP™ návod k instalaci počítačů Linux, Macs a Windows jsou:
- Ujistěte se, že jsou nainstalovány jakékoli závislosti. Na nevětrných strojích (Linux a Mac) Potřebuješ csh.
Java
-
Pro ERDDAP™ v2.19+, nastaveno Java 21. Z bezpečnostních důvodů je téměř vždy nejlepší použít nejnovější verzi Java 21. Stáhnout a nainstalovat nejnovější verzi Adoptium OpenJDK (Temurin) 21 (LTS) . Pro ověření instalace spusťte
/javaJreBinDirectory/java -verze
, například/usr/local/jdk-21.0.3+9/jre/bin/java -verze
.ERDDAP™ spolupracuje s Java z jiných zdrojů, ale doporučujeme Adoptium, protože je to hlavní, komunitně podporované, volný (jako pivo a řeč) verze Java 21, která nabízí dlouhodobou podporu (bezplatné upgrady pro mnoho let po počáteční vydání) . Z bezpečnostních důvodů, prosím aktualizujte ERDDAP 's verzí Java pravidelně jako nové verze Java 21 bude k dispozici z Adoptia.
ERDDAP™ byl testován a používán rozsáhle s 21, nikoli s jinými verzemi. Z různých důvodů netestujeme s jin ými verzemi Java .
Tomcat
- Připravit Tomcat . Tomcat je nejvíce používaný 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 otevřený zdrojový software (FOSS) .
Můžeš použít jiný. Java Aplikační server (např. Jetty) Ale testujeme jen s Tomcatem a podporujeme ho.
- Stáhněte si Tomcat a vybalte ho na server 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 nejsou přijatelné)
která je určena pro práci s Java 21 nebo novější. Níže bude adresář Tomcat označován jako
tomcat
.
__ Varování!_ Pokud již máte Tomcat spuštěnou jinou webovou aplikaci (zejména THREDDS) , Doporučujeme vám nainstalovat ERDDAP™ v druhý Tomcat , protože ERDDAP™ potřebuje různé nastavení Tomcat a neměl by se muset potýkat s jinými aplikacemi pro paměť.
- Na Linuxu, stáhnout "Core" "tar .gz " Distribuce Tomcat a vybalit.
Doporučujeme vybalit
/usr/local
. - Na Mac, Tomcat je pravděpodobně již nainstalován v
/Knihovna/Tomcat
, ale měl by ji aktualizovat na nejnovější verzi Tomcat 10. Když to stáhneš, stáhnout "Core" "tar .gz " Distribuce Tomcat a vybalit/Knihovna/Tomcat
. - Na Windows, můžete stáhnout "Core" "zip" Tomcat distribuce
(který nezahrává s registrem Windows a který ovládáte z příkazového řádku DOS) a vybalit ji do vhodného adresáře.
(Pro vývoj používáme distribuci "Core" "zip." Uděláme
/programy
adresář a vybalit ho tam.) Nebo si můžete stáhnout distribuci "Core" "64-bit Windows zip," která obsahuje více funkcí. Pokud je distribuce instalátorem Windows, bude pravděpodobně dát Tomcat do, 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 udělat pro každou z obou<Connector>
značky (jeden pro<Connector port="8080"
a jeden pro<Konektorový port="8443"
) .- (Doporučené) Zvýšit
spojení Timeout
hodnota parametru, možná 300000 (milisekundy, což je 5 minut) . - (Doporučené) Přidat nový parametr:
relaxQueryChars="[] | "
. Toto je volitelné a o něco méně bezpečné, ale odstraňuje potřebu, aby uživatelé procentně kódovali tyto znaky, když se objeví v parametrech požadavku uživatele URL.
- (Doporučené) Zvýšit
obsah.xml
- context.xml -- Zdroje Cache - In
tomcat/conf/context.xml
, těsně před</Context>
tag, změna značky Resources (nebo přidejte, pokud už tam není.) nastavit cache MaxSize parametr to 80000:<Resources cachingAllowed="true" cacheMaxSize="80000" />
Tím se v Catalině vyhýbáme mnoha varováním. ven, že všechny začínají s
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ěnit nastavení timeout Apache tak, aby časově náročné požadavky uživatelů netimeout
(s tím, co často vypadá jako chyba "Proxy" nebo "Bad Gateway") . Jako uživatel kořene:
- Upravit Apače
http d.conf
soubor (obvykle v/etc/ http d/conf/
) :- Změnit existující
<Timeout>
nastavení (nebo přidat jeden na konci souboru) do 3600 (sekund) , místo výchozí 60 nebo 120 sekund. - Změnit existující
<ProxyTimeout>
nastavení (nebo přidat jeden na konci souboru) do 3600 (sekund) , místo výchozí 60 nebo 120 sekund.
- Změnit existující
- Restartovat Apache:
/usr/sbin/apachectl - K elegantní.
(ale někdy je v jiném adresáři) .
- Upravit Apače
Bezpečnost
- Bezpečnostní doporučení: Viz Tyto pokyny zvýšit bezpečnost Vaše instalace Tomcat, zejména pro veřejné servery.
- Pro veřejnost ERDDAP™ instalace na Linux a Macs, je nejlepší nastavit Tomcat (program) jako součást uživatele
tomcat
(samostatný uživatel s omezeným oprávněním a který nemá žádné heslo ) . Tak, jen super uživatel může přejít k jednání jako uživateltomcat
. To znemožňuje hackerům přihlásit se na váš server jako uživateltomcat
. A v každém případě byste to měli udělat tak, abytomcat
uživatel má v systému souboru serveru velmi omezená oprávnění (read+write+execute privilegia) proapache-tomcat
adresářový strom a<bigParentDirectory>
a práva pouze pro čtení pro adresáře s daty, která ERDDAP™ vyžaduje 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(Požádá vás o heslo pro superuživatele, abyste to mohli udělat.)sudo su - tomcat
- Můžete přestat pracovat jako uživatel tomcat pomocí příkazu
exit
- Udělat většinu zbytku Tomcat a ERDDAP™ nastavit návod k nastavení jako uživatel
tomcat
. Později, spusťtestartup.
aVypnout. s
skripty jako uživateltomcat
aby měl Tomcat povolení napsat do svých logových souborů. - Po vybalení Tomcat, od rodiče
apache-tomcat
adresář:- Změna vlastnictví adresáře apache-tomcat na uživatele tomcat.
(ale nahraďte skutečný název vašeho adresáře) .
chown -R tomcat apache-tomcat-10.0.23
- Změňte "skupina" být tomcat, vaše uživatelské jméno, nebo název malé skupiny, která zahrnuje tomcat a všechny správce Tomcat/ ERDDAP :
chgrp -R yourUserName apache-tomcat-10.0.23
- Změnit oprávnění tak, aby Tomcat a skupina četli, psali, prováděli práva:
chmod -R ug+rwx apache-tomcat-10.0.23
- Odstranit "ostatní" uživatelská oprávnění ke čtení, zápisu nebo spuštění:
chmod -R o-rwx apache-tomcat-10.0.23
- Změna vlastnictví adresáře apache-tomcat na uživatele tomcat.
- Můžete vytvořit
To je důležité, protože to brání ostatním uživatelům číst možná citlivé informace v ERDDAP™ nastavit soubory.
paměť
Nastavit proměnné prostředí Tomcat
-
Na Linuxu a Macu: Vytvořit soubor
Tomcat/bin/setenv.sh
(nebo v Red Hat Enterprise Linux \[ RHEL \] , upravit~tomcat/conf/tomcat10.conf
) nastavit Tomcatovy proměnné prostředí. Tento soubor bude použittomcat/bin/startup.sh
aVypnout. s
. Soubor by měl obsahovat něco jako: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(ale nahradit názvy adresářů z počítače) . (Pokud jste již dříve nastaven
JRE_HOME
Můžeš to odstranit.) Na Macs, pravděpodobně nemusíte nastavitJAVA_ DOMŮ
. -
Na Windows: Vytvořit soubor
Tomcat\bin\\setenv.bat
nastavit Tomcatovy proměnné prostředí. Tento soubor bude použitTomcat\bin\\ startup.bat
ashutdown.bat
. Soubor by měl obsahovat něco jako: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"(ale nahradit názvy adresářů z počítače) . Pokud je to jen pro místní testování, odstraňte "-server." (Pokud jste již dříve nastaven
JRE_HOME
Můžeš to odstranit.)
The - Xmx
a - Xms
nastavení paměti je důležité, protože ERDDAP™ lépe funguje s více paměti.
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 tak dlouho, dokud nebude server zaneprázdněn. Čím více fyzické paměti na serveru, tím lépe: 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če, když se pokusíte nastavit
- Xmx
vysoko nad 1500M (1200M na některých počítačích) . Pokud má váš server méně než 2GB paměti, snižte- Xmx
hodnota (v 'M'egaBytech) na 1/2 fyzické paměti počítače. -
Pro 64 bitů operačních systémů a 64 bitů Java : 64 bitů Java bude fungovat pouze na 64 bitovém operačním systému.
- S Java 8, musíte přidat
-d64
TomcatoviCATALINA_OPTS
parametr vsetenv.bat
. - S Java 21, vyberete 64 bitů. Java při stažení verze Java označené "64 bit."
- S Java 8, musíte přidat
Se 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
až (v 'M'egaBytech) až 1/2 (nebo méně) fyzické paměti počítače.
Uvidíš, jestli Tomcat, Java a ERDDAP™ jsou skutečně běží v 64 bitovém režimu hledáním " bit," v ERDDAP 's Daily Report email
nebo bigDirectory/logs/ [log.txt](/docs/server-admin/additional-information#log)
soubor ( velkýRodič rodičů
je uvedeno v setup.xml ) .
Sběr odpadků
- In ERDDAP™ 's log.txt soubor, uvidíte mnoho "GC (Selhání přidělení) "zprávy.
Tohle obvykle není problém. Je to častou zprávou od normálně fungujícího Java že právě dokončila menší odpad.
sbírka, protože jí došel prostor v Edenu (část Java hromada pro velmi mladé předměty) . Obvykle vám zpráva ukazuje
PaměťPoužítPřed->paměťPo použití
. Pokud jsou ta dvě čísla blízko sebe, znamená to, že odpadky nebyly produktivní. Zpráva je jen známkou problémů, 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 nemůže uvolnit paměť. To se může stát během stresující doby a pak odejít. Ale pokud bude pokračovat, je to známka problémů. - Pokud uvidíte
java.lang.OutOfMemoryError
s v ERDDAP™ 's log.txt soubor, viz OutOfMemoryError pro tipy, jak diagnostikovat a řešit problémy.
Povolení
- Na Linux a Macs, změnit oprávnění ze všech
*.sh
soubory vtomcat/bin/
musí být spustitelný vlastníkem:
chmod +x *.sh
Písma
- Písma pro obrázky: Rozhodně dáváme přednost svobodným. DejaVu písma na druhou Java písma. Používání těchto písem se důrazně doporučuje, ale nevyžaduje se.
Pokud se rozhodnete nepoužívat písma DejaVu, musíte změnit písmoFamily nastavení v setup.xml na <fontFamily> SansSerif </fontFamily>
,
který je k dispozici se všemi Java distribuce. Při nastavení <fontFamily>
na jméno písma, které není k dispozici, ERDDAP™ Nenabíjí.
a vytiskne seznam dostupných písem v log.txt
Složka. Musíte použít jedno z těch písm.
Pokud se rozhodnete použít písma DejaVu, ujistěte se, že <fontFamily>
nastavení v setup.xml je <fontFamily> DejaVu Sans </fontFamily>
.
Pro instalaci písem DejaVu si stáhněte DejaVuFonts .zip (5,522,795 bytes, MD5=33E1E61FAB06A547851ED308B4FFEF42) a rozepnout soubory s písmem do dočasného adresáře.
- Na Linuxu:
- Pro Linux Adoptium Java distribuce, viz Tyto pokyny .
- Ostatní Java distribuce: Jako
tomcat
uživatel, zkopírovat soubory písma do$JAVA_HOME/LIB/fonts
tak Java může najít písma. Pamatujte: pokud/když později upgrade na novější verzi Java , musíte reinstalovat tato písma.
- Na Macs: pro každý soubor s písmem dvakrát klikněte na něj a pak klikněte na Install Font.
- Na Windows 7 a 10: ve Windows Exploreru vyberte všechny soubory písma. Pravým tlačítkem. Klikněte na Install.
Test Tomcat
- Otestujte si instalaci Tomcat.
- Linux:
- Jako uživatel "tomcat," spustit
tomcat/bin/startup.sh
. - Zobrazit své URL + ":8080/" ve svém prohlížeči (např. http://coastwatch.pfeg.noaa.gov:8080/ ) .
- Jako uživatel "tomcat," spustit
- Mac (spustit tomcat jako uživatel správce systému) :
- Utíkej.
tomcat/bin/startup.sh
. - Zobrazit své 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í je váš Tomcat přístupný pouze vámi. Není veřejně přístupná.
- Utíkej.
- Localhost Windows:
- Klikněte pravým tlačítkem na ikonu Tomcat v systémové podnose a vyberte "Spustit službu."
- Pohled http://127.0.0.1:8080/ nebo snad http://localhost:8080/ Ve vašem prohlížeči. Všimněte si, že ve výchozím nastavení je váš Tomcat přístupný pouze vámi. Není veřejně přístupná.
- Linux:
Měli byste vidět stránku Tomcat "Gratulujeme."
Jestli se něco stane, podívejte se do souboru Tomcat. Tomcat/logs/catalina.out
.
Problémy s instalací Tomcat?
-
Na Linux a Mac, pokud nemůžete dosáhnout Tomcat nebo ERDDAP™ (nebo se k nim možná nedostanete z počítače mimo váš firewall.) , můžete testovat, zda Tomcat poslouchá port 8080, psaním (jako kořen) na příkazovém řádku serveru:
netstat -tuplen | grep 8080
To by mělo vrátit jeden řádek s něčím jako:
tcp 0 0 :::8080 :::* LISTEN ## ##### ####/java
(kde #
je nějaká číslice) , s uvedením, že a kava
postup (pravděpodobně Tomcat) poslouchá v přístavu "8080" pro "tcp" provoz.
Pokud nebyly vráceny žádné linky, pokud se řádek výrazně liší, nebo pokud byly vráceny dvě nebo více řádků, pak může být problém s nastavením portu.
-
Viz soubor s logem Tomcat
Tomcat/logs/catalina.out
. Tomcat problémy a některé ERDDAP™ startup problémy jsou téměř vždy uvedeny tam. To je běžné, když jste poprvé nastavení ERDDAP™ . -
Viz Tomcat webové stránky nebo hledat web o pomoc, ale prosím dejte nám vědět problémy, které jste měli a řešení jste našli.
-
Podívejte se na naše oddíl o získání dodatečné podpory .
ERDDAP™ Obsah
- Připravit
Tomcat/content/erddap
Konfigurační soubory. Na Linux, Mac a Windows, stáhnout erddapContent .zip a rozepnout dotomcat
adresář, vytvářeníTomcat/content/erddap
.
Version 1.0.0, 20333 bytes, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, dated 2024-10-14
Některé předchozí verze jsou také k dispozici:
- 2. 17 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, dat. 2022-02-16)
- 2. 18 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, dat. 2022-02-16)
- 2. 21 (19,810 bytes, MD5=1E26F62E7A06191,EE6868C40B9A29362, dat. 2022-10-09)
- 2. 22 (19,810 bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, dat. 2022-12-08)
- 2. 23 (19,810 bytes, MD5=1E26F62E7A06191,EE6868C40B9A29362, dat. 2023-02-27)
Další adresář
Pro Red Hat Enterprise Linux (RHEL) nebo pro jiné situace, kdy není dovoleno upravovat adresář Tomcat nebo kde chcete/potřebujete
dát ERDDAP™ adresář obsahu 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 ERDDAP™ může najít tento nový adresář obsahu.
setup.xml
- Přečti si komentáře
tomcat/content/erddap/setup.xml
a provést požadované změny. setup.xml je soubor se všemi nastaveními, které určují, jak ERDDAP™ Chová se slušně.
Pro počáteční nastavení musíte alespoň změnit tato nastavení:
<bigParentDirectory>
<emailEverythingTo>
<baseUrl>
<email...>
nastavení<admin...>
nastavení<baseHttpsUrl>
(Když jste to nachystali https )
Když vytvoříte velký Rodič Directory, z rodičovského adresáře bigParentDirectory:
- Make the
tomcat
uživatel majitelevelkýRodič rodičů
:chown -R tomcat bigParentDirectory
- Změňte "skupina" být tomcat, vaše uživatelské jméno, nebo název malé skupiny, která zahrnuje tomcat a všechny správce Tomcat/ ERDDAP :
chgrp -R yourUserName bigParentDirectory
- Změnit oprávnění tak, aby Tomcat a skupina četli, psali, prováděli práva:
chmod -R ug+rwx bigParentDirectory
- Odstraňte "jiné" uživatelské oprávnění ke čtení, zápisu nebo spuštění. To je důležité, aby se zabránilo čtení potenciálně citlivých informací
v ERDDAP™ log soubory a soubory s informacemi o soukromých datových souborech.
chmod -R o-rwx bigParentDirectory
Proměnné prostředí
Začneme s ERDDAP™ v2.13, ERDDAP™ Správci mohou přepsat jakoukoli hodnotu v setup.xml zadáním proměnné prostředí
jméno ERDDAP _hodnotaNázev
před spuštěním ERDDAP™ . Například použití ERDDAP _baseUrl
Přepíše <baseUrl>
hodnota.
To může být užitečné při nasazení ERDDAP™ s kontejnerem jako je Docker, jak můžete dát standardní nastavení do setup.xml
a pak dodat speciální nastavení pomocí proměnných prostředí. Pokud poskytnete tajné informace ERDDAP™ pomocí této metody,
Ujistěte se, že informace zůstanou v tajnosti. ERDDAP™ pouze čte proměnné prostředí jednou za spuštění,
v první sekundě startupu, takže jeden způsob, jak to použít, je: nastavit proměnné prostředí, začít ERDDAP ,
Počkej. ERDDAP™ je spuštěn, pak odnastavit proměnné prostředí.
datasets.xml
- Přečti si komentáře Práce s datasets.xml Soubor . Později, až se dostaneš ERDDAP™ běží
poprvé (obvykle pouze s výchozími soubory dat) , budete modifikovat XML v
tomcat/content/erddap/ datasets.xml
k určení všech souborů dat, které chcete ERDDAP™ sloužit. Tady budeš trávit většinu času. při nastavení ERDDAP™ a později při zachování ERDDAP™ .
Můžete vidět příklad datasets.xml na GitHubu .
- (Nepravděpodobné) Teď nebo (o něco pravděpodobnější) v budoucnu, pokud chcete změnit soubor Erddap CSS, kopírujte
Tomcat/content/erddap/images/erddapStart2.cs
ažTomcat/content/erddap/images/erddap2.cs
a pak udělat změny. Změnyerddap2.css
nabývají účinku pouze tehdy, ERDDAP™ je restartován a často také vyžaduje, aby uživatel vymazal cachované soubory prohlížeče. ERDDAP™ nefunguje správně, pokud nastavení.xml nebo datasets.xml soubor není dobře vytvořený XML soubor. Takže, po editaci těchto souborů, je dobrý nápad ověřit, že výsledek je dobře vytvořený XML vložením XML textu do XML checkeru, jako je xmlvalidace .
Nainstalujte erddap. válečný soubor
- Na Linuxu, Macu a Windows, __download erddap.war __ do
Tamcat/webaps
:
Version 2.28.1, 622,676,238 bytes, MD5=48b4226045f950c8a8d69ef9521b9bc9, dated 2025-09-05
Soubor .war je velký, protože obsahuje pobřeží s vysokým rozlišením, hranice a nadmořské výšky potřebné k vytvoření map.
Některé předchozí verze jsou také k dispozici.
- 2. 17 (551,068,245 bytes, MD5=5FEA912B5D42E50EAB9591F773EA848D, dat. 2022-02-16)
- 2. 18 (551,069,844 bytes, MD5=461325E97E7577EC671DD50246CCFB8B, dat. 2022-02-23)
- 2. 21 (568,644,411 bytes, MD5=F2CFF805893146E932E498FDDB519B6, dat. 2022-10-09)
- 2. 22 (567,742,765 bytes, MD5=2B33354F633294213AE2AFDDCF4DA6D0, dat. 2022-12-08)
- 2. 23 (572,124,953 bytes, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, dat. 2023-03-03)
- 2. 24 (568,748,187 bytes, MD5=970fbee172e28b0b8a07756eecbc898e, dat.2024-06-07e)
- 2. 25 (592,292,039 bytes, MD5=652AFC9D1421F00B5F789DA2C4732D4C, datováno 2024-11-07)
- 2. 26 (607,404,032 bytes, MD5=99a725108b37708e5420986c1616a119, dat. 2025-03-31)
- 2, 27. 0 (620,554,403 bytes, MD5=3b2086c659eee4145ca2dff447bf4ef7, dat. 2025-06-11)
Nastavit proxy (specifické nasazení)
ERDDAP™ je obvykle nasazen za webserveru reverzní proxy, aby bylo možné jej obsloužit na standardních HTTP portech (80 a 443) . Ukončení SSL/TLS je často zahaleno i ve vrstvě proxy serveru. Specifikace závisí na požadavcích každého nasazení.
Apač
- Zajistit, aby
mod_ proxy
amod_proxy_ http
jsou naloženy:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
- Upravit existující
<VirtualHost>
Značka (pokud nějaký 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™ se podává na jiné cestě než /erddap
, také nastavit X- Forward- Prefix
hlavička k
úsek cesty před /erddap
. Toto nastavení by bylo vhodné pro ERDDAP™ podávané v
/subpath/erddap
:
RequestHeader set X-Forwarded-Prefix /subpath
- Pak restartujte Apache:
/usr/sbin/apachectl - K elegantní.
(ale někdy je v jiném adresáři) .
NGINX
V konfiguračním souboru zadejte 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™ se podává na jiné cestě než /erddap
, také nastavit X- Forward- Prefix
hlavička k
úsek cesty před /erddap
. Toto nastavení by bylo vhodné pro ERDDAP™ podávané v
/subpath/erddap
:
proxy_set_header X-Forwarded-Prefix /subpath
Pro získání NGINX a ERDDAP™ správně pracovat s https , musíte dát následující úryvek do 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 úplně nevypnete a nespustíte Tomcat, dříve nebo později budete mít problémy s permGen pamětí.)
- (V Linuxu nebo Mac OS, pokud jste vytvořili speciálního uživatele ke spuštění Tomcat, např. Tomcat, nezapomeňte udělat následující kroky jako tento uživatel.)
- Pokud Tomcat už běží, zavřete Tomcat s (v Linuxu nebo Mac OS)
Tomcat/bin/shutdown.sh
nebo (ve Windows)tomcat\bin\\ shutdown.bat
U Linuxu použijte ps -ef | grep tomcat
před a po Vypnout. s
aby se ujistil, že proces tomcat přestal.
Proces by měl být uveden před vypnutím a po vypnutí by nakonec nebyl uveden.
To může trvat minutu nebo dvě pro ERDDAP™ úplně vypnuto. Buď trpělivý. Nebo pokud to vypadá, že to sám nezastaví, použijte:
zabít - 9 <processID>
- Začněte s Tomcat (v Linuxu nebo Mac OS)
tomcat/bin/startup.sh
nebo (ve Windows)Tomcat\bin\\ startup.bat
Je ERDDAP™ Běhat?
Pro zobrazení použijte prohlížečhttp://www.YourServer.org/erddap/status.html. ERDDAP™ Začíná bez načtení dat. Datasety jsou načteny v podkladovém vlákně, takže jsou dostupné jedno po druhém.
Řešení problémů
- Když přijde žádost uživatele, jde do Apache (na počítačích Linux a Mac OS) , pak Tomcat, pak ERDDAP™ .
- Můžete vidět, co přijde do Apače (a související chyby) v záznamech Apache.
- Ty. může vidět, co přijde na Tomcat (a související chyby)
v souborech protokolu Tomcat (
Tomcat/logs/catalina.out
a další soubory v tomto adresáři) . - Ty. může vidět, co přijde na ERDDAP , diagnostické zprávy z ERDDAP ,
a chybové zprávy z ERDDAP , v ERDDAP™
<bigParentDirectory> /logs/log.txt
Složka. - Tomcat nezačíná. ERDDAP™ dokud Tomcat nedostane žádost o ERDDAP™ . Takže můžete vidět v záznamech Tomcat, pokud to Začalo ERDDAP™ nebo pokud existuje chybová zpráva související s tímto pokusem.
- Kdy? ERDDAP™ Začíná to, přejmenovává staré ERDDAP™ log.txt soubor (
logArchivedAt <CurrentTime> .txt
) a vytvoří nový log.txt soubor. Takže pokudlog.txt
soubor je starý, je to znamení, že ERDDAP™ Ještě se nevrátil. ERDDAP™ zapíše informace o záznamu do bufferu a pouze pravidelně píše buffer do log souboru, ale můžete nutit ERDDAP™ napsat buffer do souboru protokolu návštěvou/erddap/status.html
.
Problém: Stará verze Java
Pokud používáte verzi Java To je příliš staré na ERDDAP , ERDDAP™ nebude běžet a uvidíte chybovou zprávu v Tomcat je log souboru jako
Exception in thread "main" java.lang.UnsupportedClassVersionError:
_some/class/name_: Unsupported major.minor version _someNumber_
Řešením je aktualizovat na nejnovější verzi Java A ujisti se, že ji Tomcat používá.
Problém: Pomalé spuštění poprvé
Tomcat musí udělat hodně práce, když poprvé aplikace jako ERDDAP™ je zahájena; zejména musí vybalit erddap.war
soubor
(což je jako .zip soubor) . Na některých serverech, první pokus o zobrazení ERDDAP™ stánky (30 sekund?) Dokud ta práce neskončí.
Na jiných serverech první pokus okamžitě selže. Ale když počkáte 30 sekund a zkusíte to znovu, uspěje to, pokud ERDDAP™ byla nainstalována správně.
Na tohle není řešení. Takhle prostě Tomcat pracuje. Ale to nastane pouze poprvé poté, co nainstalujete novou verzi ERDDAP™ .
Vypnout a restartovat
V budoucnosti, zavřít (a restartovat) ERDDAP™ , viz Jak vypnout a znovu nastartovat Tomcat a ERDDAP .
Problémy?
Potíže s instalací Tomcat nebo ERDDAP™ ? Podívejte se na naše oddíl o získání dodatečné podpory .
E-mailové oznámení nových verzí ERDDAP
Pokud chcete dostávat e-mail, kdykoli nová verze 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 má průměr zhruba jeden e-mail každé tři měsíce.
Přizpůsobit
- Přizpůsobte si svůj ERDDAP™ zvýraznit vaši organizaci (ne NOAA ERD ) .
- Změňte banner, který se objeví nahoře ERDDAP™ .html stránky editací
<startBodyHtml5>
tag in yourdatasets.xml
Složka. (Pokud žádný není, zkopírujte výchozí z ERDDAP™ 'sTomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/ messages.xml
soubor dodatasets.xml
a upravit.) Například byste mohli:- Použít jiný obrázek (tj. logo vaší organizace) .
- Změňte barvu pozadí.
- Změna " ERDDAP™ "na "VašeOrganizace ERDDAP™ "
- Změňte "jednodušší přístup k vědeckým datům" na "jednodušší přístup k datům YourOrganization."
- Změňte odkazy "Přivedl k vám" na odkazy na vaši organizaci a zdroje financování.
- Změnit informace na levé straně domovské stránky editací
<theShortDescriptionHtml>
tag in yourdatasets.xml
Složka. (Pokud žádný není, zkopírujte výchozí z ERDDAP™ 'sTomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/ messages.xml
soubor dodatasets.xml
a upravit.) Například byste mohli:- Popište, co vaše organizace a/nebo skupina dělá.
- Popište jaká data to jsou. ERDDAP™ Ano.
- Chcete-li změnit ikonu, která se objeví na záložce prohlížeče, vložte do vaší organizace favicon. ico in
Tomcat/content/erddap/images/
. Vizhttps://en.wikipedia.org/wiki/Favicon.