Beállítás
Hogyan kell csinálni a kezdeti beállítást ERDDAP™ A szervered
ERDDAP™ futhat bármely olyan szerveren, amely támogatja Java Tomcat (más alkalmazásszerverek, mint a Jetty, de nem támogatjuk őket) ... ERDDAP™ tesztelték a Linuxot (beleértve az Amazon AWS-t) Mac és Windows számítógépek.
- Docker - Biztosítunk ERDDAP™ egy Docker konténerben IOOS most kínál egy Gyors indítási útmutató ERDDAP™ egy Docker Container ... Ez a szabvány ERDDAP™ telepítés egy Docker konténerben. Docker Könnyű módszereket biztosítunk a ssl és a monitorozás létrehozásához, többet olvasunk ki Docker dokumentáció ... Ha már használja Docker, akkor valószínűleg inkább a Docker verzió. Ha felhőszolgáltatásokat szeretne futtatni, valószínűleg inkább a Docker verziót fogja előnyben részesíteni.
- Amazon - Ha telepíti ERDDAP™ az Amazon Web Services EC2 esetben lásd ezt Amazon Web Services áttekintés először.
- Linux és Macska - ERDDAP™ nagyszerűen működik a Linux és a Mac számítógépeken. Lásd az alábbi utasításokat.
- Windows Windows - A Windows jó a teszteléshez ERDDAP™ és személyes használatra (lásd az alábbi utasításokat) , de nem javasoljuk, hogy használja a nyilvánosság számára ERDDAP™ telepítések. Running ERDDAP™ Windows-on problémák merülhetnek fel: nevezetesen, ERDDAP™ Lehet, hogy nem tudja törölni és / vagy renesz fájlokat gyorsan. Ez valószínűleg a víruskereső szoftver miatt van (pl. McAfee és Norton) amely ellenőrzi a vírusok fájljait. Ha belefutsz erre a problémára (amelyet hibaüzenetek láthat a Log.txt fájl, mint "Lehetetlen törölni..."), a víruskereső szoftver beállításainak megváltoztatása részben enyhítheti a problémát. Vagy inkább egy Linux vagy Mac szerver használata.
A szabvány ERDDAP™ telepítési utasítások Linux, Macs és Windows számítógépek:
- Győződjön meg róla, hogy minden függőséget telepítenek. A nem Windows gépeken (Linux és Mac) csh.
Java
-
Mert ERDDAP™ v2.19+, létrehozva Java 21. Biztonsági okokból szinte mindig a legjobb, ha a legújabb verziót használja Java 21. Kérjük, töltse le és telepítse a legújabb verziót Adoptium OpenJDK (Temurin) 21. (LTS) ... A telepítés ellenőrzése, futás
/javaJreBinDirectory/java - Verzió
Például/usr/local/jdk-21.0.3+9/jre/bin/java - Verzió
...ERDDAP™ munkával Java más forrásokból, de javasoljuk az Adoptiumot, mert ez a fő, közösségi támogatott, szabad (mint a sör és a beszéd) verzió Java 21, amely hosszú távú támogatást kínál (ingyenes frissítések sok éven át a kezdeti kiadás) ... Biztonsági okokból, kérjük, frissítse a ERDDAP "A verzió Java rendszeresen, mint új verziók Java 21 elérhetővé válik az Adoptiumtól.
ERDDAP™ Tesztelt és használt széles körben 21, nem más verziók. Különböző okokból nem tesztelünk, és nem támogatunk más verziókat Java ...
Tomcat
- Beállítás Tomcat ... Tomcat a legszélesebb körben használt Java Application Server, ami Java olyan szoftver, amely az operációs rendszer hálózati szolgáltatásai és Java szerver szoftver, mint például ERDDAP™ ... Ez ingyenes és nyílt forráskódú szoftver (FOSS) ...
Használhat másikat Java Application Server (pl. Jetty) De csak teszteljük és támogatjuk a Tomcatot.
- Tomcat letöltése és kicsomagolása a szerverén vagy a PC-n.
Biztonsági okokból szinte mindig a legjobb, ha a Tomcat 10 legújabb verzióját használja (a 9. és az alábbi verzió nem elfogadható)
amelynek célja, hogy együtt dolgozzon Java 21 vagy újabb. Az alábbiakban a Tomcat könyvtárat úgy fogják említeni, mint
Tomcat
...
Warning! Ha már van egy Tomcat fut más webes alkalmazás (különösen a THREDDS) Javasoljuk, hogy telepítse ERDDAP™ benne egy második Tomcat mert ERDDAP™ különböző Tomcat beállításokra van szüksége és nem kell más memóriaalkalmazásokkal folytatni.
- Linuxon, Töltse le a "Core" "tar .gz Tomcat elosztás és kicsomagolja.
Javasoljuk, hogy csomagolja be
/usr/local
... - Egy Mac-en a Tomcat valószínűleg már telepítve van
/ Könyvtár / Tomcat
De frissítenie kell a Tomcat 10 legújabb verziójára. Ha letölti, Töltse le a "Core" "tar .gz Tomcat elosztás és kicsomagolja/ Könyvtár / Tomcat
... - Windows-on, akkor lehet letölteni a "Core" "zip" Tomcat elosztást
(amely nem zavarja a Windows-nyilvántartást, és amelyet egy DOS parancssorból irányít) és egy megfelelő könyvtárba csomagolja.
(A fejlesztéshez használjuk a "Core" "zip" elosztást. Készítünk
/programok
rendező és kicsomagolja ott.) Vagy letöltheti a "Core" "64 bites Windows zip" elosztást, amely több funkciót tartalmaz. Ha a disztribúció Windows-berendezés, akkor valószínűleg a Tomcat-ot fogja bevezetni, például,/Program Files/apache-tomcat-10.0.23
...
szerver.xml
- szerver.xml - A
tomcat/conf/server.xml
fájl, van két változás, hogy meg kell tennie az egyes két<Connector>
Tagok (Egy<Connector port="8080"
és egy<Conector port="8443"
) ...- (Ajánlott) Növelje a
kapcsolat Időzítés
paraméterérték, talán 300000 (milliseconds, ami 5 perc) ... - (Ajánlott) Adjon hozzá egy új paramétert:
relaxálóQueryChars="[] | "..."
... Ez opcionális és kissé kevésbé biztonságos, de eltávolítja a felhasználók szükségességét, hogy százalékban kódolja ezeket a karaktereket, amikor a felhasználó kérésére URL paramétereiben fordulnak elő.
- (Ajánlott) Növelje a
tartalom.xml
- kontextus.xml - Resources Cache - In
tomcat/conf/context.xml
Jobb, mielőtt</Context>
tag, változtassa meg az erőforrások címkéjét (vagy add hozzá, ha már nincs ott) beállítani a cache MaxSize paraméter 80000:<Resources cachingAllowed="true" cacheMaxSize="80000" />
Ez számos figyelmeztetést elkerül a katalinában. ki, hogy minden kezdődik
WARNING [main] org.apache.catalina.webresources.Cache.getResource Unable to add the resource at [/WEB-INF/classes/...]
Apache Timeout
- A Linux számítógépeken változtassa meg az Apache-idő beállításokat, hogy az időigényes felhasználói kérések ne ütközzenek
(ami gyakran úgy tűnik, mint egy "Proxy" vagy "Bad Gateway" hiba) ... Mint a gyökérfelhasználó:
- Módosítsa az Apache
http d.conf
fájl (általában/etc/ http d/conf/
) :- Változtassa meg a meglévő
<Timeout>
beállítás (vagy adjon hozzá egyet a fájl végén) 3600-ig (másodpercek) Az alapértelmezett 60 vagy 120 másodperc helyett. - Változtassa meg a meglévő
<ProxyTimeout>
beállítás (vagy adjon hozzá egyet a fájl végén) 3600-ig (másodpercek) Az alapértelmezett 60 vagy 120 másodperc helyett.
- Változtassa meg a meglévő
- Restart Apache:
/usr/sbin/apachectl - k kegyes
(de néha más könyvtárban van) ...
- Módosítsa az Apache
biztonság
- Biztonsági ajánlás: Lásd Ezek az utasítások a biztonság növelése a Tomcat telepítése, különösen a nyilvános szerverek számára.
- A nyilvánosság számára ERDDAP™ telepítések Linux és Macs, a legjobb, hogy hozzon létre Tomcat (a program) a felhasználóhoz tartozás
Tomcat
(egy külön felhasználó korlátozott engedélyekkel, és amely nincs jelszó ) ... Így csak a szuper felhasználó válthat arra, hogy felhasználóként cselekedjenTomcat
... Ez lehetetlenné teszi a hackerek számára, hogy bejelentkezzenek a szerverre, mint felhasználóTomcat
... És mindenesetre meg kell tennie, hogy aTomcat
A felhasználónak nagyon korlátozott engedélyei vannak a szerver fájlrendszerén (read+write+execute kiváltságok MertApache-tomcat
rendező fa és<bigParentDirectory>
és kizárólag kiváltságok a könyvtárak számára olyan adatokkal, amelyek ERDDAP™ hozzáférést igényel).- Létrehozhatja a
Tomcat
felhasználói fiók (amelynek nincs jelszava) a parancs használatával:sudo useradd tomcat -s /bin/bash -p '*'
- A felhasználóként dolgozhat
Tomcat
a parancs használatával(Azt fogja kérni, hogy a szuperfelhasználó jelszava engedélyt, hogy ezt.)sudo su - tomcat
- Megállíthatja a munkát felhasználói tomcatként a parancs használatával
exit
- Tedd a Tomcat többi részét, és ERDDAP™ beállítási utasítások felhasználóként
Tomcat
... Később futtassa astartup.sh
ésleállítás. Árnyék
Szövegek felhasználókéntTomcat
hogy a Tomcat engedélyt kapjon a naplófájljainak írására. - Tomcat kicsomagolása után, a szülőtől
Apache-tomcat
Rendező:- Változtassa meg az apache-tomcat könyvtár tulajdonosát a tomcat felhasználó számára.
(de helyettesítse a tomcat könyvtárának tényleges nevét) ...
chown -R tomcat apache-tomcat-10.0.23
- Változtassa meg a "csoport" tomcat, a felhasználónév, vagy a neve egy kis csoport, amely magában foglalja a tomcat és az összes adminisztrátorok Tomcat / ERDDAP :
chgrp -R yourUserName apache-tomcat-10.0.23
- Változtassa meg az engedélyeket, hogy a tomcat és a csoport olvassa, írja, végrehajtsa a kiváltságokat:
chmod -R ug+rwx apache-tomcat-10.0.23
- Távolítsa el a "másik" felhasználó engedélyeit az olvasáshoz, íráshoz vagy végrehajtáshoz:
chmod -R o-rwx apache-tomcat-10.0.23
- Változtassa meg az apache-tomcat könyvtár tulajdonosát a tomcat felhasználó számára.
- Létrehozhatja a
Ez fontos, mert megakadályozza, hogy más felhasználók olvassák esetleg érzékeny információkat ERDDAP™ beállítás fájlok.
Memory
Állítsa be Tomcat környezeti változóit
-
Linuxon és Mac-en: Készítsen fájlt
Tomcat/bin/setenv.sh
(vagy a Red Hat Enterprise Linuxban \[ RHEL \] szerkesztésTomcat/conf/tomcat10.conf
) a Tomcat környezeti változóinak beállítása. Ezt a fájlt használjukTomcat/bin/startup.sh
ésleállítás. Árnyék
... A fájlnak tartalmaznia kell valamit: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(de helyettesítse a könyvtár neveit a számítógépről) ... (Ha korábban
JRE_HOME
Ezt eltávolíthatja.) Macskákon valószínűleg nem kell beállítaniJAVA_HOME
... -
Windows: Készítsen fájlt
Tomcat\bin\\setenv.bat
a Tomcat környezeti változóinak beállítása. Ezt a fájlt használjukTomcat\bin\\startup.bat
ésshutdown.bat
... A fájlnak tartalmaznia kell valamit: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"(de helyettesítse a könyvtár neveit a számítógépről) ... Ha ez csak a helyi tesztek, távolítsa el a "szervert". (Ha korábban
JRE_HOME
Ezt eltávolíthatja.)
A -Xmx
és -Xms
a memória beállításai fontosak, mert ERDDAP™ jobban működik több memóriával.
Mindig beállítás -Xms
ugyanazzal az értékkel, mint -Xmx
...
-
32 bites operációs rendszer és 32 bit Java : 64 bit Java sokkal jobb, mint 32 bit Java 32 bit Java addig fog működni, amíg a szerver nem igazán elfoglalt. Minél több fizikai memória a szerverben jobb: 4+ GB nagyon jó, 2 GB rendben van, kevésbé ajánlott. 32 bit Java Még bőséges fizikai memóriával, Tomcattal és Java Nem fog futni, ha megpróbálja beállítani
-Xmx
sokkal több, mint 1500M (1200M néhány számítógépen) ... Ha a szerver kevesebb, mint 2 GB memória, csökkenti a-Xmx
érték (M'egaBytes) a számítógép fizikai memóriájának 1/2. -
64 bites operációs rendszer és 64 bit Java : 64 bit Java csak egy 64 bites operációs rendszeren fog működni.
- Ezzel Java 8, hozzá kell adnia
-d64
a TomcatCATALINA_OPTS
paramétersetenv.bat
... - Ezzel Java 21, 64 bitet választasz Java ha letölt egy verziót Java jelzett "64 bit".
- Ezzel Java 8, hozzá kell adnia
64 bit Java Tomcat és Java Használhat nagyon magas -Xmx
és -Xms
beállítások. Minél több fizikai memória a szerverben jobb.
Egyszerű javaslatként: javasoljuk, hogy állítsa be -Xmx
és -Xms
a (M'egaBytes) 1/2 (vagy kevesebb) a számítógép fizikai memóriája.
Láthatja, hogy Tomcat, Java és ERDDAP™ valóban 64 bites módban fut, ha "harcot" keresünk ERDDAP Daily jelentés e-mail
vagy a bigParentDirectory/logs/ [Log.txt](/docs/server-admin/additional-information#log)
fájl ( bigParentDirectory[szerkesztés]
meg van határozva setup.xml ) ...
Garbage Collection
- Inkább ERDDAP™ A Log.txt fájl, látni fogja sok "GC (Elosztási hiba) Üzenetek.
Ez általában nem probléma. Ez egy gyakori üzenet egy normális működésből Java azt mondta, hogy csak befejezte a kis szemetet
gyűjtemény, mert kifutott a szobából Edenben (a szakasz a Java nagyon fiatal objektumokért) ... Általában az üzenet megmutatja neked
memóriaUseBefore-> memóriaUseAfter
... Ha ez a két szám közel van egymáshoz, az azt jelenti, hogy a szemétgyűjtemény nem produktív. Az üzenet csak a baj jele, ha nagyon gyakori (néhány másodpercenként) nem termelő, és a számok nagyok és nem növekszik, ami együtt jelzi, hogy Java Több memóriára van szükség, küzd a memória felszabadítására, és képtelen felszabadítani a memóriát. Ez stresszes idő alatt megtörténhet, majd elmész. De ha továbbra is fennáll, ez a baj jele. - Ha látod
java.lang.OutOfMemoryError
S. ERDDAP™ A Log.txt fájl, lásd: OutOfMemoryError tippek a problémák diagnosztizálására és megoldására.
Engedélyek
- A Linuxon és a Mac-eken megváltoztatja az engedélyeket minden
*.sh
fájlokTomcat/bin/
végrehajtható a tulajdonos:
chmod +x *.sh
Fonts
- Fonts for images: Erősen előnyben részesítjük a szabad DejaVu betűk a másik Java betűk. Ezeket a betűtípusokat erősen ajánlott, de nem szükséges.
Ha úgy dönt, hogy nem használja a DejaVu betűtípusokat, meg kell változtatnia a betűtípust Családi beállítás beállítás a setup.xml-ben <fontFamily> SansSerif </fontFamily>
,
amely mindennel elérhető Java elosztás. Ha beállítás <fontFamily>
egy olyan betűtípus neve, amely nem áll rendelkezésre, ERDDAP™ Nem tölt
és kinyomtatja a rendelkezésre álló betűk listáját a Log.txt
fájl. Használnia kell az egyik ilyen betűtípust.
Ha úgy dönt, hogy használja a DejaVu betűk, kérjük, győződjön meg róla, hogy <fontFamily>
beállítás a setup.xml <fontFamily> DejaVu Sans </fontFamily>
...
A DejaVu betűk telepítéséhez kérjük, töltse le DejaVuFonts .zip (5,522,795 bytes, MD5=33E1E61FAB06A547851ED308B4FEF42) és zip a betűtípus fájlokat egy ideiglenes könyvtárba.
- Linuxon:
- Linux Adoptium Java elosztás, lásd Ezek az utasítások ...
- Másokkal Java elosztás: Mint a
Tomcat
felhasználó, másolja a betű fájlokatJAVA_HOME/lib/fonts
így Java megtalálhatja a betűket. Ne feledje: ha később frissítesz egy újabb verzióra Java újra kell telepíteni ezeket a betűtípusokat.
- Macskákon: minden betűtípushoz kettős kattintson rá, majd kattintson az Install Fontra.
- Windows 7 és 10: a Windows Explorerben válassza ki az összes betűkészletet. Jobb kattintson. Kattintson az Installra.
Tomcat teszt
- Tesztelje meg a Tomcat telepítését.
- Linux:
- Mint felhasználó "tomcat", futás
Tomcat/bin/startup.sh
... - Nézd meg az URL + ":8080/" böngésződben (pl.: http://coastwatch.pfeg.noaa.gov:8080/ ) ...
- Mint felhasználó "tomcat", futás
- Mac (Tomcat mint rendszer adminisztrátor felhasználó) :
- Run
Tomcat/bin/startup.sh
... - Nézd meg az URL + ":8080/" böngésződben (pl.: http://coastwatch.pfeg.noaa.gov:8080/ ) ... Ne feledje, hogy alapértelmezetten a Tomcat csak Ön számára hozzáférhető. Nem nyilvánosan hozzáférhető.
- Run
- Windows helyihost:
- Jobb kattintson a Tomcat ikonra a rendszer tálcájában, és válassza a "Start szolgáltatást".
- Megtekintés http://127.0.0.1:8080/ vagy talán http://localhost:8080/ , a böngészőben. Ne feledje, hogy alapértelmezetten a Tomcat csak Ön számára hozzáférhető. Nem nyilvánosan hozzáférhető.
- Linux:
Látnia kell a Tomcat "Congratulálok" oldalát.
Ha baj van, lásd a Tomcat logfájlt tomcat/logs/catalina.out
...
Hiba a Tomcat telepítéssel?
-
Linuxon és Mac-en, ha nem éri el a Tomcatot vagy ERDDAP™ (vagy talán nem érheti el őket egy számítógépről a tűzfalán kívül) , tesztelheti, ha a Tomcat a 8080-as portot hallgatja, ha beírja (mint gyökér) a szerver parancssorán:
netstat -tuplen | grep 8080
Ez vissza kell térnie egy sorba valami hasonlóval:
tcp 0 0 :::8080 :::* LISTEN ## ##### ####/java
(ahol #
Egyes számjegy) jelzi, hogy egy java
folyamat (feltehetően Tomcat) "8080" port hallgat a "tcp" forgalomra.
Ha nem került sor, ha a vonal visszatért jelentősen más, vagy ha két vagy több vonalat hoztak vissza, akkor problémát jelenthet a kikötőbeállításokkal.
-
Lásd a Tomcat log fájlt
tomcat/logs/catalina.out
... Tomcat problémák és néhány ERDDAP™ Az induló problémák szinte mindig ott vannak. Ez gyakori, amikor először felállították ERDDAP™ ... -
Lásd: Tomcat weboldal vagy keresse meg az internetet segítségért, de kérjük, ismerje meg a problémákat, amiket talált.
-
Lásd: rész további támogatás megszerzéséről ...
ERDDAP™ Tartalom
- Állj fel
tomcat/content/erddap
konfigurációs fájlok. Linux, Mac és Windows, letöltés erddapContent .zip és bezárja aztTomcat
rendező, létrehozástomcat/content/erddap
...
Version 1.0.0, 20333 byte, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, dátumozott 2024-10-14
Néhány korábbi verzió is elérhető:
- 2.17 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, 2022-02-16)
- 2.18 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, 2022-02-16)
- 2.21. (19 810 byte, MD5=1E26F62E7A06191EE6868C40B9A29362, 2022-10-09)
- 2.22 (19 810 byte, MD5=1E26F62E7A06191EE6868C40B9A29362, 2022-12-08)
- 2.23 (19 810 byte, MD5=1E26F62E7A06191EE6868C40B9A29362, 2023-02-27)
Egyéb könyvtár
A Red Hat Enterprise Linux (RHEL) vagy más helyzetekben, ahol nem lehet módosítani a Tomcat könyvtárat, vagy ahol akarja / szükséges
tegyük fel ERDDAP™ tartalom könyvtár egy másik helyen valamilyen más okból (Például, ha a Jetty-t használja a Tomcat helyett) ,
Zip erddapContent .zip
a kívánt könyvtárba (amely csak Tomcat
felhasználó hozzáféréssel rendelkezik) és állítsa be erddapContentDirectory
Rendszertulajdon
(pl. erddapContentDirectory =~tomcat/content/erddap
) így ERDDAP™ megtalálhatja ezt az új tartalomjegyzéket.
setup.xml
- Olvassa el a megjegyzéseket
tomcat/content/erddap/setup.xml
és a kért változásokat. setup.xml a fájl az összes olyan beállítással, amely meghatározza, hogy a ERDDAP™ viselkedik.
Az eredeti beállításhoz legalább megváltoztathatja ezeket a beállításokat:
<bigParentDirectory>
<emailEverythingTo>
<baseUrl>
<email...>
beállítások<admin...>
beállítások<baseHttpsUrl>
(Amikor létrehoztál https )
Amikor létrehozod a bigParentDirectory-t, a BigParentDirectory szülői könyvtárából:
- Készítsd el
Tomcat
felhasználó a tulajdonos abigParentDirectory[szerkesztés]
:chown -R tomcat bigParentDirectory
- Változtassa meg a "csoport" tomcat, a felhasználónév, vagy a neve egy kis csoport, amely magában foglalja a tomcat és az összes adminisztrátorok Tomcat / ERDDAP :
chgrp -R yourUserName bigParentDirectory
- Változtassa meg az engedélyeket, hogy a tomcat és a csoport olvassa, írja, végrehajtsa a kiváltságokat:
chmod -R ug+rwx bigParentDirectory
- Távolítsa el a "másik" felhasználó engedélyeit az olvasáshoz, íráshoz vagy végrehajtáshoz. Ez fontos megelőzni az olvasást esetleg érzékeny információ
benne ERDDAP™ naplófájlok és fájlok a magán adatkészletekről szóló információkkal.
chmod -R o-rwx bigParentDirectory
Környezeti lehetőségek
Kezdőlap ERDDAP™ v2.13, ERDDAP™ Az adminisztrátorok felülírhatnak bármilyen értéket a setup.xml-ben a környezet változó meghatározásával
neve ERDDAP _valueName
futás ERDDAP™ ... Például használjon ERDDAP _baseUrl
felülírja <baseUrl>
érték.
Ez hasznos lehet a telepítés során ERDDAP™ konténerrel, mint a Docker, mivel standard beállításokat lehet beállítani a setup.xml-be
majd speciális beállításokat kínál a környezeti változókon keresztül. Ha titkos információkat nyújt ERDDAP™ ezen módszeren keresztül,
győződjön meg róla, hogy az információ titokban marad. ERDDAP™ csak a környezeti változókat olvassa el az induláskor,
az indulás első második szakaszában, így az egyik módja annak, hogy ezt használja: a környezet változóit állítsa be, kezdje el ERDDAP ,
Várjon ERDDAP™ Elkezdődik, majd beállítja a környezet változóit.
datasets.xml
- Olvassa el a megjegyzéseket Együttműködés datasets.xml File ... Később, miután megkapod ERDDAP™ futás
első alkalommal (általában csak az alapértelmezett adatkészletekkel) Ön módosítja az XML-t
tomcat/content/erddap/ datasets.xml
megadni az összes adatkészletet, amit akarsz ERDDAP™ szolgálni. Ez az, ahol eltölti az idejétek tömegét beállítás közben ERDDAP™ később, miközben fenntartja a ERDDAP™ ...
Láthat egy példát datasets.xml GitHub ...
- (Valószínűleg) Most vagy (kissé valószínűbb) a jövőben, ha szeretné módosítani az erddap CSS fájlt, másolat
tomcat/content/erddap/images/erddapStart2.css
atomcat/content/erddap/images/erddap2.css
és aztán változtatni. Változásokerddap2.css
csak akkor léphet hatályba, ha ERDDAP™ újraindításra kerül, és gyakran megköveteli a felhasználótól, hogy törölje a böngésző csésze fájljait. ERDDAP™ nem működik megfelelően, ha a setup.xml vagy datasets.xml A fájl nem egy jól kialakított XML fájl. Tehát, miután szerkesztette ezeket a fájlokat, jó ötlet, hogy ellenőrizze, hogy az eredmény jól formált XML az XML szöveg beillesztése egy XML ellenőrző, mint például xmlvalidáció ...
Telepítse az erddapot. háborús fájl
- Linux, Mac és Windows, __download erddap.war Belépés
Tomcat/webapps
:
Version 2.28.1, 622.676.238 byte, MD5=48b4226045f950c8a8d69ef9521b9bc9, 2025-09-05_
A .war fájl nagy, mert magas állásfoglalási partvonalat, határt és emelési adatokat tartalmaz a térképek létrehozásához.
Néhány korábbi verzió is elérhető.
- 2.17 (551,068,245 bytes, MD5=5FEA912B5D42E50EAB9591F773EA848D, 2022-02-16)
- 2.18 (551,069,844 byte, MD5=461325E97E7577EC671D50246CCFB8B, 2022-02-23)
- 2.21. (568,644,411 bytes, MD5=F2CF805893146E932E498FDBD519B6, 2022-10-09)
- 2.22 (567,742,765 bytes, MD5=2B33354F633294213AE2AFDDCF4DA6D0, 2022-12-08)
- 2.23 (572,124,953 bytes, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, 2023-03-03)
- 2.24 (568,748,187 bytes, MD5=970fbee172e28b0b8a07756eecbc898e, 2024-06-07)
- 2.25 (592,292,039 byte, MD5=652AFC9D1421F00B5F789DA2C4732D4C, 2024-11-07)
- 2.26 (607,404,032 byte, MD5=99a725108b37708e5420986c16a119, 2025-03-31)
- 2.27.0 (620,554,403 bytes, MD5=3b2086c659ee4145ca2dff447bf4ef7, 2025-06-11)
Configure proxy (speciális telepítés)
ERDDAP™ jellemzően egy webszerver fordított proxy mögött van telepítve, amely lehetővé teszi, hogy szabványos HTTP portokon szolgáljon (80 és 443) ... Az SSL/TLS felmondást gyakran a webszerver proxy rétegben is megkötik. A specifikusok az egyes telepítések követelményeitől függnek.
Apache
- Győződjön meg róla
mod_proxy
ésmod_proxy_ http
betöltve:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
- A meglévő módosítás
<VirtualHost>
tag (ha van egy) , vagy adjon hozzá egyet a fájl végén:
<VirtualHost *:80>
ServerName YourDomain.org
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /erddap http://localhost:8080/erddap
ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>
Ha ERDDAP™ más úton szolgálnak, mint /erddap
is állítsa be X-Forwarded Profix
fejléc a
útszegmens before /erddap
... Ez a beállítás megfelelő lenne egy ERDDAP™ szolgáljon
/Subpath/erddap
:
RequestHeader set X-Forwarded-Prefix /subpath
- Ezután indítsa el az Apache-t:
/usr/sbin/apachectl - k kegyes
(de néha más könyvtárban van) ...
NGINX
A nginx konfigurációs fájlban állítsa be ezeket a fejléceket:
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;
Ha ERDDAP™ más úton szolgálnak, mint /erddap
is állítsa be X-Forwarded Profix
fejléc a
útszegmens before /erddap
... Ez a beállítás megfelelő lenne egy ERDDAP™ szolgáljon
/Subpath/erddap
:
proxy_set_header X-Forwarded-Prefix /subpath
Annak érdekében, hogy NGINX és ERDDAP™ megfelelően működik https , meg kell tenni a következő snippet belül Tomcat szerver.xml <Host>
blokk:
<Valve className="org.apache.catalina.valves.RemoteIpValve"
remoteIpHeader="X-Forwarded-For"
protocolHeader="X-Forwarded-Proto"
protocolHeaderHttpsValue="https" />
Kezdőlap Tomcat
- (Nem ajánlom a Tomcat Web Application Manager használatát. Ha nem zárja le és indítsa el a Tomcatot, előbb vagy utóbb PermGen memóriaproblémái lesznek.)
- (Linuxban vagy Mac OS-ban, ha létrehozott egy speciális felhasználót, hogy futtassa a Tomcat-ot, például tomcat-ot, ne felejtse el a következő lépéseket, mint a felhasználó.)
- Ha Tomcat már fut, zárja le Tomcat (Linux vagy Mac OS)
Tomcat/bin/shutdown.sh
vagy (Windows-ban)Tomcat\bin\\ shutdown.bat
Linuxon, használja ps -ef | grep tomcat
előtte és utána leállítás. Árnyék
annak biztosítása érdekében, hogy a tomcat folyamat leálljon.
A folyamatot a leállítás előtt kell felsorolni, és végül nem szerepel a leállítás után.
Lehet, hogy egy-két percet vesz igénybe ERDDAP™ teljesen leállni. Légy türelmes! Vagy ha úgy néz ki, mintha nem hagyja abba a sajátját, használja:
gyilkosság -9 <processID>
- Start Tomcat (Linux vagy Mac OS)
Tomcat/bin/startup.sh
vagy (Windows-ban)Tomcat\bin\\startup.bat
Az ERDDAP™ futás?
Használjon egy böngészőt, hogy megpróbálja megtekintenihttp://www.YourServer.org/erddap/status.html. ERDDAP™ elkezdődik minden adatkészlet betöltése nélkül. Az adatkészleteket háttér szálba helyezik, így elérhetővé válik egy-egy.
Hibaelhárítás
- Amikor egy felhasználó kérése érkezik, az Apache-ba megy (Linux és Mac OS számítógépeken) Aztán Tomcat, akkor ERDDAP™ ...
- Láthatja, mi jön az Apache-hoz (és kapcsolódó hibák) az Apache log fájlokban.
- Te vagy Láthatja, mi jön Tomcat (és kapcsolódó hibák)
a Tomcat log fájlokban (
tomcat/logs/catalina.out
más fájlok ebben a könyvtárban) ... - Te vagy Látni, mi jön ERDDAP diagnosztikai üzenetek ERDDAP ,
hibaüzenetek ERDDAP , a ERDDAP™
<bigParentDirectory> /log/log.txt
fájl. - Tomcat nem indul ERDDAP™ amíg Tomcat kérelmet kap ERDDAP™ ... Tehát a Tomcat logfájljaiban látható, ha kezdődött ERDDAP™ vagy ha van egy hibaüzenet, amely ehhez a kísérlethez kapcsolódik.
- Mikor ERDDAP™ kezdődik, újranevezi a régit ERDDAP™ log.txt fájl (
LogArchivedA <CurrentTime> .txt
) és létrehoz egy új log.txt fájlt. Tehát, haLog.txt
fájl régi, ez egy jel, hogy ERDDAP™ Nem nemrégiben újraindult. ERDDAP™ logisztikai információt ír egy puffernek és csak rendszeresen írja a puffert a naplófájlhoz, de kényszerítheti ERDDAP™ írni a puffert a naplófájlba látogatva/erddap/status.html
...
Trouble: Régi verzió Java
Ha egy verziót használ Java túl öreg ahhoz, hogy ERDDAP , ERDDAP™ Nem fog futni, és hibaüzenetet fog látni Tomcat logfájljában, mint
Exception in thread "main" java.lang.UnsupportedClassVersionError:
_some/class/name_: Unsupported major.minor version _someNumber_
A megoldás az, hogy frissítsük a legújabb verzióját Java és győződjön meg róla, hogy a Tomcat használja.
Hiba: Lassú indítás első alkalommal
A Tomcatnak sok munkát kell végeznie az első alkalommal, amikor egy olyan alkalmazást kell végeznie, mint ERDDAP™ kezdődnek; nevezetesen, ki kell csomagolnia erddap.war
fájl
(olyan, mint egy .zip fájl) ... Egyes szervereken az első kísérlet, hogy megtekintse ERDDAP™ Hátrányok (30 másodperc?) amíg ez a munka befejeződik.
Más szervereken az első kísérlet azonnal kudarcot vall. De ha 30 másodpercet vársz, és próbálj újra, akkor sikerül, ha ERDDAP™ megfelelően telepítették.
Nincs javítás erre. Ez egyszerűen így működik Tomcat. De csak akkor fordul elő, amikor telepít egy új verziót ERDDAP™ ...
Shut lefelé és újraindítva
A jövőben leállni (újraindítás) ERDDAP™ lásd Hogyan kell leülni és újraindítani Tomcatot ERDDAP ...
Hiba?
Tomcat vagy ERDDAP™ ? Lásd: rész további támogatás megszerzéséről ...
E-mail értesítés az új verziókról ERDDAP
Ha e-mailt szeretne kapni, amikor egy új változata ERDDAP™ elérhető vagy egyéb fontos ERDDAP™ bejelentések, csatlakozhatsz ERDDAP™ Bejelentési lista itt ... Ez a lista nagyjából egy e-mail három hónaponként.
Testreszabás
- Testreszabja ERDDAP™ Kiemelni a szervezetet (nem NOAA ERD ) ...
- Változtassa meg a bannert, amely minden tetején megjelenik ERDDAP™ .html oldalak szerkesztésével
<startBodyHtml5>
címkedatasets.xml
fájl. (Ha nincs egy, másolja az alapértelmezettet ERDDAP™ Atomcat/webapps/erddap/WEB-INF/classes/gov/noa/pfel/erddap/util/messages.xml
fájl adatasets.xml
szerkeszteni.) Például:- Használjon más képet (azaz a szervezet logója) ...
- Változtassa meg a háttér színét.
- Változás " ERDDAP™ "YourOrganization_'s ERDDAP™ "..."
- A "Könnyebb hozzáférés a tudományos adatokhoz" a "Könnyebb hozzáférés a YourOrganization adataihoz".
- Változtassa meg a "Brought to you" linkeket, amelyek kapcsolódnak a szervezetéhez és finanszírozási forrásokhoz.
- Változtassa meg az információt a honlap bal oldaláról a szerkesztés révén
<theShortDescriptionHtml>
címkedatasets.xml
fájl. (Ha nincs egy, másolja az alapértelmezettet ERDDAP™ Atomcat/webapps/erddap/WEB-INF/classes/gov/noa/pfel/erddap/util/messages.xml
fájl adatasets.xml
szerkeszteni.) Például:- Írja le, mit csinál a szervezet és/vagy csoport.
- Írja le, hogy milyen adat ez ERDDAP™ van.
- Ahhoz, hogy megváltoztassa az ikont, amely megjelenik a böngésző lapokon, helyezze a szervezet tanácsát. ico in
tomcat/content/erddap/images/
... Lásdhttps://en.wikipedia.org/wiki/Favicon.