Skip a fő tartalomhoz

Telepítés

Hogyan kell elvégezni a kezdeti beállítás ERDDAP™ A kiszolgáló

ERDDAP™ bármely támogató kiszolgálón futhat Java és Tomcat (és más alkalmazás szerverek, mint a Jetty, de nem támogatjuk őket) . ERDDAP™ tesztelt Linux (A LuxOpCo-nak a LuxOpCo-nak a LuxSCS-hez való csatlakozásával kapcsolatos, a LuxSCS által a LuxSCS-nek nyújtott, a LuxSCS-nek a LuxSCS-nek a LuxSCS-re történő átruházásával kapcsolatos, a LuxSCS-nek a LuxSCS-nek a LuxSCS-re történő átruházásával kapcsolatos, a LuxSCS-nek a LuxSCS-re történő átruházása.) Mac és Windows számítógépek.

  • Docker -- Mi biztosítjuk ERDDAP™ Docker tartályban és IOOS most kínál Gyorsindító útmutató ERDDAP™ Dokkoló konténerben . Ez a szabvány. ERDDAP™ beépítés, dokkoló konténerbe. Docker A kompozit egyszerű módokat kínálunk az SSL és a monitoring felállításához, többet olvashatunk ki Dokkoló dokumentáció . Ha már használja Docker, akkor valószínűleg inkább a Docker verzió. Ha felhőalapú szolgáltatásokat szeretne igénybe venni, valószínűleg a Docker verziót fogja előnyben részesíteni.
  • Amazon -- Ha telepít ERDDAP™ az Amazon Web Services EC2 esetről, lásd ezt: Amazon Web Services Overview Először.
  • Linux és Macs -- ERDDAP™ Jól működik Linux és Mac számítógépeken. Lásd az alábbi utasításokat.
  • Windows -- A Windows jó a teszteléshez. ERDDAP™ és személyes használatra (lásd az alábbi utasításokat) , De mi nem javasoljuk, hogy nyilvánosan használjuk. ERDDAP™ Bevetések. Futtatás ERDDAP™ Windows lehet problémák: különösen, ERDDAP™ nem lehet gyorsan törölni és / vagy átnevezni a fájlokat. Ez valószínűleg az antivírus szoftver miatt van. (például, a McAfee és Norton) ami a vírusokra vonatkozó fájlokat ellenőrzi. Ha belefutsz ebbe a problémába (amely látható hibaüzenetek a log.txt fájl "Nem sikerült törölni"...), az antivírus szoftver beállításainak megváltoztatása részben enyhítheti a problémát. Vagy inkább Linux vagy Mac szerver.

A szabvány ERDDAP™ Linux, Macs és Windows számítógépek telepítési utasításai:

  1. Győződjön meg róla, hogy a függések vannak telepítve. Nem-Windows gépeken (Linux és Mac) Css-re van szükséged.

Java​

  1. A ERDDAP™ v2.29.0 +, beállítás Java 25. Biztonsági okokból, szinte mindig a legjobb használni a legújabb változata Java 25. Kérjük, töltse le és telepítse a legújabb verzióját a Adoptium 's OpenJDK (Temurin) 25 (LTS) . A létesítmény ellenőrzéséhez fusson / javaJreBinDirectory / java -verzió például / usr / local / jdk- 25.0.1 + 8 / jre / bin / java -verzió .

    ERDDAP™ együtt Java más forrásokból, de javasoljuk Adoptium, mert ez a fő, közösség által támogatott, ingyenes (mint a sör és a beszéd) változat Java 25, amely hosszú távú támogatást (ingyenes frissítések sok évvel az első kiadás után) . Biztonsági okokból kérjük, frissítse a ERDDAP a Java rendszeres időközönként, mint új verziók Java az Adoptium-ból 25-re válik elérhetővé.

    ERDDAP™ 25-tel tesztelték és használták, nem más változattal. Különböző okok miatt, nem teszteljük és nem támogatjuk más verziók Java .  

Tomcat​

  1. Felszerelés Tomcat . Tomcat a leggyakrabban használt Java Alkalmazási kiszolgáló, amely Java az operációs rendszer hálózati szolgáltatásai és Java szerver szoftver, mint ERDDAP™ . Ez a szabad és nyílt forráskódú szoftver (FOSS) .

Használhatsz még egyet. Java Alkalmazási kiszolgáló (például, Jetty) De csak Tomcat-tal tesztelünk.

  • Töltse le a Tomcat-ot és csomagolja ki a szerverére vagy a számítógépére. Biztonsági okokból szinte mindig a legjobb a Tomcat 10 legújabb verzióját használni (változat nem elfogadható) amelyet arra terveztek, hogy Java 25 vagy újabb. Az alábbiakban, a Tomcat könyvtár hivatkoznak a Nincs magyar neve .

Figyelem! Ha már van egy Tomcat futó más webes alkalmazás (Különösen a THREDDS) , javasoljuk, hogy telepítse ERDDAP™ in egy második Tomcat , mert ERDDAP™ szüksége van különböző Tomcat beállítások és nem kellene más memóriaalkalmazásokkal küzdenie.

  • A Linux-on a "Core" tar letöltése .gz "Tomcat disztribúció és kicsomagolja. Javasoljuk, hogy csomagolják ki. / usr / local .
  • Egy Mac, Tomcat valószínűleg már telepített / Könyvtár / Tomcat , de frissíteni kell a legújabb változata Tomcat 10. Ha letöltöd, a "Core" tar letöltése .gz "Tomcat disztribúció és kicsomagolja. / Könyvtár / Tomcat .
  • A Windows, akkor Töltse le a "Core" "zip" Tomcat disztribúciót (ami nem zavarja a Windows regisztert, és amit egy DOS parancssorból irányítasz) és kipakolja egy megfelelő könyvtárba. (A fejlesztéshez a "Core" "zip" disztribúciót használjuk. Csinálunk egy / programok Könyvtár és csomagolja ki.) Vagy letöltheti a "Core" "64- bit Windows zip" disztribúciót, amely több funkciót tartalmaz. Ha a disztribúció egy Windows telepítő, akkor valószínűleg a Tomcat, például, / Program fájlok / apache- tomcat- 10.0.23 .  

szerver.xml​

  • szerver.xml - A tomcat / conf / server.xml file, van két változtatás, hogy meg kell tennie mind a két <Connector> Címkék (egy: &lt; Connector port = "8080" és egy: &lt; Conector port = "8443" ) .
    1. (Ajánlott) A kapcsolat Időpont paraméterérték, talán 300000-ig (milliszekundum, ami 5 perc.) .
    2. (Ajánlott) Új paraméter hozzáadása: relaxedQueryChars = "[] | " . Ez nem kötelező és kevésbé biztonságos, de eltávolítja annak szükségességét, hogy a felhasználók titkosítsák ezeket a karaktereket, amikor azok előfordulnak a paraméterekben a felhasználó kérésére URL.  

content.xml​

  • context.xml -- Források gyorsítótár - in tomcat / conf / context.xml , közvetlenül a </Context> tag, a forrás címke megváltoztatása (vagy add hozzá, ha még nincs ott.) a gyorsítótár beállítása MaxSize paraméter 80000-re: 
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Ez elkerüli a catalinai figyelmeztetéseket. Ki, hogy minden kezdődik a

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

 

Apache időszámítás​

  • Linux számítógépeken változtasd meg az Apache időkimaradási beállításokat, így az időigényes felhasználói kérések nem időznek ("Proxy" vagy "Bad Gateway" hibával) . Mint a root felhasználó:
    • Az Apache módosítása http d.conf fájl (általában / stb. / http d / conf / ) :
      • Változás a meglévő <Timeout> beállítás (vagy adjon hozzá egyet a fájl végén) 3600-3600 (másodperc) 60 vagy 120 másodperc helyett.
      • Változás a meglévő <ProxyTimeout> beállítás (vagy adjon hozzá egyet a fájl végén) 3600-3600 (másodperc) 60 vagy 120 másodperc helyett.
    • Apache újraindítása: / usr / sbin / apachectl -k kecses (de néha egy másik könyvtárban van.) .

Biztonság​

 

  • Biztonsági ajánlás: Lásd Ezek az utasítások a a Tomcat telepítés, különösen a nyilvános szerverek.  
  • A nyilvánosság számára ERDDAP™ installációk Linux és Macs, a legjobb, ha a Tomcat (a program) felhasználóként Nincs magyar neve (korlátozott jogosultsággal rendelkező, külön felhasználó, nincs jelszava ) . Így csak a szuper felhasználó válthat arra, hogy a felhasználó Nincs magyar neve . Ez lehetetlenné teszi a hackerek számára, hogy bejelentkezzenek a szerverükre felhasználóként. Nincs magyar neve . És minden esetben, meg kell tenni, hogy a Nincs magyar neve a felhasználónak nagyon korlátozott jogosultságai vannak a szerver fájlrendszerére (olvass + írj + végrehajtási jogosultságokat a következő szövegrész: apache- tomcat könyvtárfa és <bigParentDirectory> és csak olvasási jogosultságokat könyvtárak adatok ERDDAP™ hozzáférést igényel).
    • Létrehozhatja a Nincs magyar neve felhasználói fiók (amelynek nincs jelszava) a parancs használatával: 
      sudo useradd tomcat -s /bin/bash -p '*'
    • Átválthatsz arra, hogy felhasználóként dolgozz. Nincs magyar neve a parancs használatával 
      sudo su - tomcat
      (Kérni fogja a superuser jelszót, hogy engedélyezze ezt.)
      • A parancs használatával abbahagyhatja a felhasználó tomcat munkát
      exit
      • A legtöbb Tomcat és ERDDAP™ beállítási utasítások felhasználóként Nincs magyar neve . Később, futtasd a startupsh és Leállni. sh Szkriptek felhasználóként Nincs magyar neve Így Tomcat jogosult írni a naplófájljaira.
      • Miután kipakolta Tomcat, a szülő a apache- tomcat könyvtár:
        • Az apache- tomcat könyvtárfa tulajdonjogának megváltoztatása a Tomcat felhasználóra. 
          chown -R tomcat apache-tomcat-10.0.23
          (de helyettesítse a valódi nevét a tomcat könyvtár) .
        • Változtassa meg a "csoport", hogy a tomcat, a felhasználóneved, vagy a nevét egy kis csoport, amely magában foglalja tomcat és az összes adminisztrátor Tomcat / ERDDAP : 
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Az engedélyek módosítása, hogy a Tomcat és a csoport olvasson, írjon, hajtson végre jogosultságokat: 
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Távolítsa el az "egyéb" felhasználó jogosultságait olvasni, írni vagy végrehajtani: 
          chmod -R o-rwx apache-tomcat-10.0.23

Ez fontos, mert megakadályozza, hogy más felhasználók esetleg érzékeny információkat ERDDAP™ beállító fájlok.

Memória​

A Tomcat környezeti változóinak beállítása

  • A Linux és Macs: Fájl létrehozása tomcat / bin / setenv.sh (vagy Red Hat Enterprise Linux \[ RHEL \] , szerkesztés ~ tomcat / conf / tomcat10.conf ) Tomcat környezeti változóinak beállítása. Ezt a fájlt fogja használni unit description in lists és Leállni. sh . A fájlnak a következőket kell tartalmaznia:

    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

    (de helyettesítse a könyvtárneveket a számítógépéről) . (Ha korábban beállította JRE _ HOME Azt leveheted.) Macs, valószínűleg nem kell beállítanod JAVA _ HOME .

  • A Windows-on: Fájl létrehozása tomcat\\ bin\\ setenv.bat Tomcat környezeti változóinak beállítása. Ezt a fájlt fogja használni tomcat\\ bin\\ startup.bat és shutdown.bat . A fájlnak a következőket kell tartalmaznia:

    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"

    (de helyettesítse a könyvtárneveket a számítógépéről) . Ha ez csak helyi tesztelés, távolítsa el a "-server". (Ha korábban beállította JRE _ HOME Azt leveheted.)

A - Xmx és - Xms a memória beállításai fontosak, mert ERDDAP™ Több memóriával jobban működik. Mindig be van állítva - Xms ugyanakkora értékre, mint - Xmx .

  • 32 bites operációs rendszerek és 32 bites Java : 64 bit Java sokkal jobb, mint 32 bit Java , de 32 bit Java működni fog, amíg a szerver nem igazán elfoglalt. Minél több fizikai memória a szerver annál jobb: 4 + GB nagyon jó, 2 GB rendben van, kevesebb nem ajánlott. 32 bittel Java , még bőséges fizikai memória, Tomcat és Java nem fut, ha megpróbál beállítani - Xmx sokkal több mint 1500M (1200M egyes számítógépeken) . Ha a szerver kevesebb, mint 2GB memória, csökkentse a - Xmx érték (in 'M' egaBytes) a számítógép fizikai memóriájának 1 / 2-éig.

  • 64 bites operációs rendszerek és 64 bites Java : 64 bit Java csak 64 bites operációs rendszeren működik.

    • A Java 8, hozzá kell adni - d64 A Tomcat CATALINA _ OPTS paraméter setenv.bat .
    • A Java 21, te választasz 64 bitet. Java amikor letöltöd a Java 64 bites.

64 bittel Java , Tomcat és Java nagyon magas - Xmx és - Xms beállítások. Minél több fizikai memória van a szerveren, annál jobb. Leegyszerűsítő javaslatként: azt javasoljuk, hogy állítsa be - Xmx és - Xms - (in 'M' egaBytes) 1 / 2 (vagy kevesebb) a számítógép fizikai memóriájáról. Láthatod, ha Tomcat, Java , és ERDDAP™ valóban fut 64 bit módban keres "bit", ERDDAP 'Napi jelentés e-mail vagy bigParentDirectory / logs / [log.txt](/docs/server-admin/additional-information#log) fájl ( bigParentDirectory meg van határozva: szetup.xml ) .

Szemétgyűjtemény​

  • In ERDDAP™ s log.txt file, sok "GC (Kiosztási hiba) "üzenetek. Ez általában nem probléma. Ez egy gyakori üzenet egy normálisan működő Java Azt mondta, hogy most végzett egy kis szeméttel. Gyűjtemény, mert elfogyott a szoba Eden (cikk) Java halom nagyon fiatal tárgyak) . Általában az üzenet megmutatja memoryUseBefore- &gt; memoryUseAfter . Ha ez a két szám közel van egymáshoz, az azt jelenti, hogy a szemétgyűjtemény nem volt eredményes. Az üzenet csak a baj jele, ha nagyon gyakori. (másodpercenként) , nem produktív, és a számok nagy, és nem növekszik, amelyek együttesen jelzik, hogy Java szüksége van több memória, küzd, hogy felszabadítsa memória, és nem képes felszabadítani memória. Ez történhet egy stresszes időszakban, aztán menj el. De ha ez megmarad, az a baj jele.
  • Ha látod java.lang.OutOfMemoryError sz ERDDAP™ s log.txt fájl, Látod? OutOfMemoryError a problémák diagnosztizálására és megoldására vonatkozó tippeket.  

Jogosultságok​

chmod +x *.sh

Betűtípusok​

Ha úgy dönt, hogy nem használja a DejaVu betűtípusok, meg kell változtatni a fontFamily beállítás setup.xml <fontFamily> SansSerif </fontFamily> , amely elérhető az összes Java eloszlás. Ha beállít <fontFamily> egy nem elérhető betűtípus nevére, ERDDAP™ nem tölt és kinyomtat egy listát a elérhető betűtípusok a log.txt akta. Használnod kell az egyik betűtípust.

Ha úgy dönt, hogy használja a DejaVu betűtípusok, kérjük, győződjön meg arról, hogy a <fontFamily> beállítás szetup.xml <fontFamily> DejaVu Sans </fontFamily> .

A DejaVu betűtípusok telepítéséhez kérjük, töltse le DejaVuFonts .zip (5,522,795 bájt, MD5 = 33E1E61FAB06A547851ED308B4FFEF42) és húzza ki a betűtípus fájlokat egy ideiglenes könyvtárba.

  • Linux:
    • Linux Adoptium Java disztribúciók, lásd Ezek az utasítások .
    • Más Java felosztások: Mint a Nincs magyar neve felhasználó, másolja a betűtípus fájlokat $JAVA _ HOME / lib / betűtípusok így Java megtalálja a betűtípusokat. Ne feledje: ha / amikor később frissíti egy újabb verziója Java , újra kell telepíteni ezeket a betűtípusokat.
  • Macs: minden betűtípus fájl, kattintson duplán, majd kattintson Install Betűtípus.
  • Windows 7 és 10: Windows Explorer, válassza ki az összes betűtípus fájlokat. Jobb klikk. Kattintson az Install gombra.  

Test Tomcat​

  • Tesztelje a Tomcat telepítés.
    • Linux:
    • Mac (fut tomcat, mint a rendszergazda felhasználó) :
      • Fuss! unit description in lists .
      • Tekintse meg URL + ": 8080 /" a böngészőben (például: http://coastwatch.pfeg.noaa.gov:8080/ ) . Megjegyzés, hogy alapértelmezés szerint a Tomcat csak az Ön által elérhető. Nyilvánosan nem hozzáférhető.
    • Windows localhost:
      • Jobb klikk a Tomcat ikon a rendszer tálcán, és válassza "Start szolgáltatás".
      • Nézet http://127.0.0.1:8080/ , vagy talán http://localhost:8080/ a böngésződben. Megjegyzés, hogy alapértelmezés szerint a Tomcat csak az Ön által elérhető. Nyilvánosan nem hozzáférhető.

Látnod kéne a Tomcat "Gratulálunk" oldalt.

Ha baj van, nézze meg a Tomcat naplófájl tomcat / log / catalina.out .

Problémák a Tomcat telepítés?​

  • A Linux és Mac, ha nem tudja elérni Tomcat vagy ERDDAP™ (vagy talán csak nem tudod elérni őket a tűzfalon kívüli számítógépből.) , akkor tesztelje, ha Tomcat hallgat port 8080, gépeléssel (gyökér) a kiszolgáló parancssorában:

    netstat -tuplen | grep 8080

Ez egy mondatot ad vissza:

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

(ahol # egy számjegy) a Jáva folyamat (Feltehetően Tomcat) "8080" -t hallgat a "tcp" forgalom miatt. Ha nem adtak vissza vonalakat, ha a visszaadott vonal jelentősen eltér, vagy ha két vagy több sort adtak vissza, akkor probléma lehet a port beállításaival.

  • Lásd a Tomcat naplófájlt tomcat / log / catalina.out . Tomcat problémák és néhány ERDDAP™ Az indulási problémák szinte mindig jelzik. Ez gyakori, amikor az első beállítás ERDDAP™ .

  • Lásd a Tomcat website or search the web for help, but please know us the problems you had and the solutions you found.

  • Lásd a mi szakasz a kiegészítő támogatás megszerzéséről .  

ERDDAP™ Tartalom​

  1. A tomcat / tartalom / erddap konfigurációs fájlok. A Linux, Mac és Windows, letöltés erddapTartalom .zip és húzza ki a zip a Nincs magyar neve könyvtár létrehozása tomcat / tartalom / erddap .

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

Néhány korábbi verzió is elérhető:

  • 2, 17 (19,792 bájt, MD5 = 8F892616BAEEF 2DF0F4BB036DCB4AD7C, 2022- 02- 16)
  • 2, 18 (19,792 bájt, MD5 = 8F892616BAEEF 2DF0F4BB036DCB4AD7C, 2022- 02- 16)
  • 2, 21 (19,810 bájt, MD5 = 1E26F62E7A06191EE6868C40B9A29362, 2022- 10- 09)
  • 2, 22 (19,810 bájt, MD5 = 1E26F62E7A06191EE6868C40B9A29362, 2022- 12- 08)
  • 2, 23 (19,810 bájt, MD5 = 1E26F62E7A06191EE6868C40B9A29362, 2023- 02- 27)

Más könyvtár​

Red Hat Enterprise Linux (RHEL) vagy más helyzetekben, amikor nem engedélyezett a Tomcat könyvtár módosítása, vagy ahol szeretné / szükség a ERDDAP™ tartalomjegyzék más helyen valamilyen más okból (például, ha a Jetty helyett Tomcat) , unzip erddapTartalom .zip a kívánt könyvtárba (amelyhez csak Nincs magyar neve a felhasználónak hozzáférése van) és állítsa be a erddapContentDirectory rendszertulajdon (pl. erddapContentDirectory =~tomcat/content/erddap ) így ERDDAP™ megtalálja ezt az új tartalomjegyzéket.

szetup.xml​

A kezdeti beállításhoz legalább ezeket a beállításokat meg kell változtatnia:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> beállítások
  • <admin...> beállítások
  • <baseHttpsUrl> (amikor beállítasz https )

Amikor létrehozod a bigParentDirectory-t, a BigParentDirectory szülőkönyvtárából:

  • A Nincs magyar neve felhasználó a tulajdonos a bigParentDirectory : 
    chown -R tomcat bigParentDirectory
  • Változtassa meg a "csoport", hogy a tomcat, a felhasználóneved, vagy a nevét egy kis csoport, amely magában foglalja tomcat és az összes adminisztrátor Tomcat / ERDDAP : 
    chgrp -R yourUserName bigParentDirectory
  • Az engedélyek módosítása, hogy a Tomcat és a csoport olvasson, írjon, hajtson végre jogosultságokat: 
    chmod -R ug+rwx bigParentDirectory
  • Távolítsa el az "egyéb" felhasználó jogosultságát az olvasásra, írásra vagy végrehajtásra. Ez fontos, hogy megakadályozza az olvasást esetleg érzékeny információk in ERDDAP™ log fájlok és fájlok információkat a privát adatkészletek. 
    chmod -R o-rwx bigParentDirectory

Környezetvédelmi változók​

Kezdve ERDDAP™ v2.13, ERDDAP™ A rendszergazdák felülbírálhatják a setup.xml értéket egy környezeti változó megadásával Név ERDDAP _ értéknév futás előtt ERDDAP™ . Például, használat ERDDAP _ baseUrl felülírja a <baseUrl> érték. Ez hasznos lehet, amikor a telepítés ERDDAP™ egy konténer, mint a Docker, mint akkor tegye standard beállítások setup.xml majd speciális beállításokat biztosít környezeti változókkal. Ha titkos információt szolgáltat ERDDAP™ e módszerrel, Ellenőrizze, hogy az információ titokban marad-e. ERDDAP™ csak indításonként egyszer olvassa el a környezeti változókat, az első másodpercben indítás, így az egyik módja annak, hogy ezt használja: állítsa be a környezeti változók, start ERDDAP , Várj, amíg ERDDAP™ megkezdődött, majd kibontja a környezeti változókat.

datasets.xml​

  • Olvassa el a hozzászólásokat: Együttműködés a datasets.xml Fájl . Később, miután ERDDAP™ futó Most először (általában csak az alapértelmezett adatok) , módosítani fogja az XML tomcat / tartalom / erddap / datasets.xml megadni az összes adatot, amit szeretne ERDDAP™ hogy szolgáljak. Itt fogod tölteni az időd nagy részét. a felállítás alatt ERDDAP™ és később, miközben a ERDDAP™ .

Láthatsz egy példát. datasets.xml a GitHub-ról .  

  • (Nem valószínű) Most vagy (valamivel valószínűbb) a jövőben, ha módosítani szeretné az erddap CSS fájlt, másolja tomcat / content / erddap / images / erddapStart2.css - tomcat / content / erddap / images / erddap2.css aztán változtatunk rajta. Változások erddap2.css csak akkor lép hatályba, ha ERDDAP™ újraindul, és gyakran azt is megköveteli a felhasználótól, hogy törölje a böngésző tárolt fájljait.   ERDDAP™ nem működik megfelelően, ha a setup.xml vagy datasets.xml A fájl nem egy jól kidolgozott XML fájl. Szóval, miután átszerkesztetted ezeket a fájlokat, jó ötlet ellenőrizni, hogy az eredmény jól alakult XML azáltal, hogy az XML szöveg egy XML ellenőrző, mint xmlvalidation .  

Telepítsd az erddap-ot. háborús akták​

  1. A Linux, Mac és Windows, _ _ letöltés Erddap. War - Igen. tomcat / webalkalmazás :

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

A .war fájl nagy, mert tartalmaz nagy felbontású partvonal, határ, és magassági adatok szükségesek a térképek létrehozásához.

Néhány korábbi verzió is elérhető.

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

A proxy beállítása (telepítési specifikus)​

ERDDAP™ jellemzően egy webszerver fordított proxy mögött telepítik, hogy azt a standard HTTP portokon lehessen kiszolgálni (80 és 443) . SSL / TLS terminál gyakran kiosztja a webszerver proxy réteg is. A specifikációk az egyes telepítések követelményeitől függenek.

Apache​

  1. Annak biztosítása, hogy mod _ proxy és mod _ proxy _ http betöltve:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. A meglévő <VirtualHost> tag (ha van) 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™ nem / erddap , szintén be X- Forwarded- Prefix fejléc a Útvonal szegmens _ előtt _ / erddap . Ez a beállítás a ERDDAP™ kézbesítve: / subpath / erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Akkor indítsa újra az Apache-t: / usr / sbin / apachectl -k kecses (de néha egy másik könyvtárban van.) .  

NGINX​

Az nginx config 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™ nem / erddap , szintén be X- Forwarded- Prefix fejléc a Útvonal szegmens _ előtt _ / erddap . Ez a beállítás a ERDDAP™ kézbesítve: / subpath / erddap :

proxy_set_header X-Forwarded-Prefix /subpath

Annak érdekében, hogy az NGINX és ERDDAP™ megfelelően működik https , meg kell tenni a következő snippet a Tomcat server.xml <Host> blokk:

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

 

A Tomcat indítása​

  • (Nem ajánlom, hogy a Tomcat Webes Alkalmazási Menedzsert használd. Ha nem teljesen leáll és indul Tomcat, előbb vagy utóbb lesz PermGen memória problémák.)
  • (Linuxban vagy Mac OS-ban, ha létrehoztál egy speciális felhasználót a Tomcat futtatására, pl., tomcat, ne feledd megtenni a következő lépéseket, mint a felhasználó.)
  • Ha Tomcat már fut, állítsa le Tomcat (Linux vagy Mac OS) unit description in lists vagy (Windows) tomcat\\ bin\\ shutdown.bat

Linux, használat ps-ef | grep tomcat előtt és után Leállni. sh hogy megbizonyosodjon arról, hogy a macskafolyamat leállt. A folyamatot a leállítás előtt kell felsorolni, és végül a leállítás után nem. Eltarthat egy-két percig. ERDDAP™ hogy teljesen leálljanak. Légy türelmes. Vagy ha úgy tűnik, nem áll meg magától, használd: kill -9 <processID>

  • Kezdje Tomcat (Linux vagy Mac OS) unit description in lists vagy (Windows) tomcat\\ bin\\ startup.bat

Is ERDDAP™ Futni?​

A böngésző segítségével próbálja megtekinteni http://www.YourServer.org/erddap/status.html.

ERDDAP™ Az adatok betöltése nélkül indul. Az adatbázisok háttérszálba vannak betöltve, így elérhetőkké válnak.

Problémamegoldás​

  • Ha egy felhasználó kéri, az Apache-ba megy. (a Linux és Mac OS számítógépeken) aztán Tomcat, akkor ERDDAP™ .
  • Láthatod, mi jön Apache-ba. (és kapcsolódó hibák) az Apache naplófájlokban.
  • Te! Látod, mi jön Tomcat-ba? (és kapcsolódó hibák) a Tomcat naplófájlban ( tomcat / log / catalina.out és egyéb fájlok a könyvtárban) .
  • Te! látni, hogy mi jön ERDDAP , diagnosztikai üzenetek ERDDAP , és hibaüzenetek ERDDAP , a ERDDAP™ <bigParentDirectory> / naplók / log.txt akta.
  • Tomcat nem indul ERDDAP™ amíg Tomcat nem kap egy kérelmet ERDDAP™ . Tehát láthatja a Tomcat naplófájlokban, ha indítás ERDDAP™ vagy ha a kísérlethez hibaüzenet kapcsolódik.
  • Mikor? ERDDAP™ start up, it renales the old ERDDAP™ log.txt fájl ( logArchivedA <CurrentTime> .txt ) és létrehoz egy új log.txt fájlt. Tehát ha a log.txt A fájl régi, ez egy jel, hogy ERDDAP™ nem kezdte újra. ERDDAP™ naplóadatokat ír egy pufferbe és csak írja a pufferet a naplófájlba rendszeres időközönként, de lehet kényszeríteni ERDDAP™ hogy írja a pufferet a naplófájlba látogatással /erddap/status.html .

Probléma: régi verziója Java​

Ha a Java Ez túl öreg ahhoz, hogy ERDDAP , ERDDAP™ nem fut, és látni fogsz egy hibaüzenetet Tomcat naplófájljában, mint

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

A megoldás az, hogy frissítse a legújabb változata a Java És győződjön meg róla, hogy Tomcat használja.

Probléma: Lassú első alkalom​

Tomcat kell csinálni egy csomó munkát az első alkalommal egy alkalmazás, mint ERDDAP™ megkezdődött, nevezetesen ki kell csomagolnia a Erddap. War fájl (ami olyan, mint a .zip fájl) . Egyes szervereken, az első kísérlet a megtekintésre ERDDAP™ standok (30 másodperc?) amíg ez a munka be nem fejeződik. Más szervereken az első kísérlet azonnal megbukik. De ha vársz 30 másodpercet, és újra megpróbálod, sikerülni fog, ha ERDDAP™ helyesen szerelték fel.

Erre nincs megoldás. A Tomcat egyszerűen így működik. De ez csak akkor fordul elő az első alkalommal, miután telepít egy új változata ERDDAP™ .

Állítsa le és indítsa újra.​

A jövőben, hogy bezárják (és újraindul) ERDDAP™ Látod? Hogyan kell bezárni és visszaállítani Tomcat és ERDDAP .

Baj van?​

Problémák telepítése Tomcat vagy ERDDAP™ ? Lásd a mi szakasz a kiegészítő támogatás megszerzéséről .

Új verziók e-mail bejelentése ERDDAP​

Ha szeretne kapni egy e-mailt, amikor egy új változata ERDDAP™ rendelkezésre áll vagy más fontos ERDDAP™ bejelentések, csatlakozhat a ERDDAP™ A bejelentések listája Tessék. . Ez a lista háromhavonta átlagosan egy e-mailt tartalmaz.

Egyéni​

  • Testreszabása ERDDAP™ hogy kiemelje a szervezet (nem NOAA ERD ) .
  • Változtassa meg a zászlót, hogy megjelenik a tetején az összes ERDDAP™ html oldalak szerkesztésével a <startBodyHtml5> Címke a datasets.xml akta. (Ha nincs, másolja le az alapértelmezett ERDDAP™ s tomcat / webapps / erddap / WEB- INF / class / gov / noaa / pfel / erddap / util / messages.xml fájl be datasets.xml és szerkeszteni.) Például:
    • Más kép használata (azaz a szervezet logója) .
    • A háttérszín megváltoztatása.
    • Változás " ERDDAP™ "to" _ YourOrganization _ 's ERDDAP™ "
    • A tudományos adatokhoz való könnyebb hozzáférés módosítása a _ YourOrganization _ 's adatokhoz való könnyebb hozzáférés felé.
    • Változtassa meg a "által hozott" linkek, hogy linkek a szervezet és a finanszírozási források.
  • Az információ módosítása a bal oldalon a kezdőlap szerkesztésével <theShortDescriptionHtml> Címke a datasets.xml akta. (Ha nincs, másolja le az alapértelmezett ERDDAP™ s tomcat / webapps / erddap / WEB- INF / class / gov / noaa / pfel / erddap / util / messages.xml fájl be datasets.xml és szerkeszteni.) Például:
    • Írja le, mit csinál a szervezet és / vagy csoport.
    • Írja le, milyen adatok ezek ERDDAP™ Igen.
    • A böngésző fülein megjelenő ikon megváltoztatásához helyezze a szervezet kedvencét. o tomcat / content / erddap / images / . Lásd https://en.wikipedia.org/wiki/Favicon.