Taito pääsisältöön

Asentaminen

Miten tehdä ensimmäinen asennus ERDDAP™ Sinun palvelijasi

ERDDAP™ Voit käyttää mitä tahansa palvelinta, joka tukee Java Tomcat (muut sovelluspalvelimet, kuten Jetty, mutta emme tue niitä.) . ERDDAP™ on testattu Linuxilla (Lähde: Amazon's AWS) Mac ja Windows-tietokoneet.

  • Docker ----- Tarjoamme ERDDAP™ Docker-säiliö IOOS tarjoaa nyt Nopea aloitusopas ERDDAP™ Docker Container . Se on standardi ERDDAP™ Asentaminen Docker-säiliöön. Dockerin kautta Kompleksi tarjoaa helppoja tapoja luoda sl ja seuranta, lue lisää Dockerin dokumentointi . Jos käytät Dockeria, pidät todennäköisesti Docker-versiosta. Jos haluat käyttää pilvipalveluita, pidät todennäköisesti Docker-versiosta.
  • Amazon Amazon ----- Jos olet asennuksessa ERDDAP™ Amazon Web Services EC2:ssa, katso tämä Amazon Web Services yleiskatsaus Ensimmäinen.
  • Linux ja Macit ----- ERDDAP™ Toimii erinomaisesti Linux- ja Mac-tietokoneissa. Katso ohjeet alta.
  • Windows Windows ----- Windows on hyvä testata ERDDAP™ henkilökohtaiseen käyttöön (Katso ohjeet alta) , Emme suosittele käyttämään sitä julkisesti. ERDDAP™ käyttöönottoa. Juokseminen ERDDAP™ Windowsissa voi olla ongelmia: erityisesti, ERDDAP™ Et voi poistaa ja/tai nimetä tiedostoja nopeasti. Tämä johtuu todennäköisesti virustorjuntaohjelmistosta. (Lähde: McAfee and Norton) Tämä tarkistaa tiedostoja viruksia. Jos törmäät tähän ongelmaan (joka näkyy virheviestinä) log.txt tiedostot, kuten "Voi poistaa ..."), virustorjuntaohjelmiston asetusten muuttaminen voi osittain lievittää ongelmaa. Käyttää Linux- tai Mac-palvelinta.

Standardi ERDDAP™ Linux-, Mac- ja Windows-tietokoneiden asennusohjeet ovat:

  1. Varmista, että kaikki riippuvuudet on asennettu. Ei-Windows koneita (Linux ja Mac) Tarvitset csh:tä.

Java

  1. For For ERDDAP™ V2.19+, perustettu Java 21. Turvallisuussyistä on lähes aina parempi käyttää uusinta versiota. Java 21. Lataa ja asenna uusin versio Adoptiumin OpenJDK (Temurin) 21 21 (LTS) . Tarkista asennuksen, suorita /javaJreBinDirectory / Java käännökset Esimerkiksi Käyttäjä/paikallinen/jdk-21.0.3+9/jre/bin/java käännökset .

    ERDDAP™ Teosten kanssa Java muista lähteistä, mutta suosittelemme Adoptiumia, koska se on tärkein, yhteisöllistä tukea. Ilma ilmaiseksi ilmaiseksi (Olut ja puhe) versiosta Java 21, joka tarjoaa pitkäaikaista tukea (Ilmaiset päivitykset jo vuosia ennen alkuperäistä julkaisua) . Turvallisuussyistä päivitä ERDDAP versiosta Java säännöllisesti uusina versioina Java 21 on saatavana Adoptiumilta.

    ERDDAP™ Sitä on testattu ja käytetty laajasti 21:llä, ei muilla versioilla. Erilaisista syistä emme testaa tai tue muita versioita. Java .  

Tomca

  1. Aseta ylös Tomca . Tomcat on yleisimmin käytetty Java Palveluntarjoaja, joka on Java ohjelmisto, joka on käyttöjärjestelmän verkkopalveluiden ja Java palvelinohjelmisto, kuten ERDDAP™ . Vapaa ja avoin lähdekoodi (FOSS) .

Voit käyttää toista Java Sovelluspalvelin (Esimerkki: Jetty) Testaamme ja tuemme Tomcatia.

  • Lataa Tomcat ja pakkaa se palvelimellesi tai PC:lle. Turvallisuussyistä on lähes aina parempi käyttää Tomcat 10:n uusinta versiota. (9 ja alapuolella ei ole hyväksyttävää) joka on suunniteltu toimimaan Java 21 tai uudempi. Alla olevaa Tomcat-hakemistoa kutsutaan Tom .

Varokaa! Jos sinulla on jo Tomcat, jolla on jokin muu verkkosovellus (Erityisesti kolme) Suosittelemme, että asennat ERDDAP™ Sisällä Toinen Tomcat koska ERDDAP™ Tarvitset erilaisia Tomcat-asetuksia Ei tarvitse olla mukana muissa muistisovelluksissa.

  • Linuxissa, Download "Tähti" .gz Tomcatin jakelu Pakkaa se pois. Suosittelemme pakkaamaan sen sisään Käyttäjä/Paikallinen .
  • Macissa Tomcat on jo asennettu Kirjasto / Tomcat Tomcat 10:n uusimpaan versioon. Jos lataat sen, Download "Tähti" .gz Tomcatin jakelu Pakkaa se sisään Kirjasto / Tomcat .
  • Windowsissa voit Download "Core" "Zip" Tomcat (joka ei sotke Windows-rekisteriä ja jota hallitset DOS-komentorivillä) Pakkaa se sopivaan hakemistoon. (Kehittämistä varten käytämme "Core" "zip" -jakelua. Me teemme Ohjelmat Pakkaa ja pakkaa se sinne.) Voit ladata "Core" "64-bittinen Windows zip" -jakelun, joka sisältää enemmän ominaisuuksia. Jos jakelu on Windows-asennus, se saattaa esimerkiksi Tomcatin. Ohjelmatiedostot / apache-tomcat-10.0.23 .  

palvelin.xml

  • palvelin.xml - Sisällä Tomcat/conf/server.xml On olemassa kaksi muutosta, jotka sinun tulisi tehdä kullekin <Connector> Tagit (Yksi &lt;Connector Port = 8080 Yksi &lt;Conector Port="8443" ) .
    1. (Suositellaan) Lisäämällä yhteysyhteys Timeout Parametriarvo ehkä 300 000 (Millisekuntia, joka on 5 minuuttia) .
    2. (Suositellaan) Lisää uusi parametri: Rentoutuneisuus =" | """ . Se on valinnainen ja hieman epävarma, mutta poistaa käyttäjien tarvetta prosenttikoodiin, kun ne esiintyvät käyttäjän pyynnön URL-osoitteen parametreissa.  

Sisältö.xml

  • Konteksti.xml ----- Resurssit - In Tomcat/conf/context.xml Juuri ennen </Context> Muuta Resursseja Tag (tai lisätä, jos se ei ole jo siellä) Aseta kätkön MaxSize-parametri 80000:
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Näin vältetään lukuisia varoituksia katalinassa. Kaikki alkaa

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

 

Apace Timeout

  • Linux-tietokoneissa Apache-aikatauluasetukset muutetaan niin, että aikaa vievät käyttäjäpyynnöt eivät aikatauluta. (Se, mitä usein kutsutaan "Proxy" tai "Bad Gateway" -virheeksi.) . Käyttäjänä:
    • Muokkaa apassia http d.conf tiedostotiedosto (Yleensä /etc/ http d/conf/ ) :
      • Muuta olemassa olevaa <Timeout> asetukset (tai lisätä tiedoston lopussa) 3600 (Sekunnit) Oletusarvon sijaan 60 tai 120 sekuntia.
      • Muuta olemassa olevaa <ProxyTimeout> asetukset (tai lisätä tiedoston lopussa) 3600 (Sekunnit) Oletusarvon sijaan 60 tai 120 sekuntia.
    • Käynnistä Apache uudelleen: Käyttäjä/sbin/apachectl K Graceful (Joskus se on toisessa hakemistossa.) .

Turvallisuusturvallisuus

 

  • Turvallisuussuositus: Näytä Nämä ohjeet lisätä turvallisuuden Tomcat-asennus, erityisesti julkisille palvelimille.  
  • Yleisölle ERDDAP™ Linux- ja Mac-laitteissa on parasta perustaa Tomcat. (Ohjelman) Käyttäjän kuuluminen Tom (erillinen käyttäjä, jolla on rajalliset luvat ja Ei salasanaa ) . Vain käyttäjä voi siirtyä toimimaan käyttäjänä Tom . Näin hakkerit voivat kirjautua sisään palvelimeesi käyttäjänä Tom . Joka tapauksessa sinun pitäisi tehdä se niin, että Tom Käyttäjällä on hyvin rajalliset käyttöoikeudet palvelimen tiedostojärjestelmään (lue + kirjoita + suorita etuoikeudet) Sillä Apache-tomcat Hakemistopuu ja <bigParentDirectory> Vain luku-oikeudet hakemistoihin, joissa on tietoja, jotka ERDDAP™ tarvitaan pääsyä).
    • Voit luoda Tom Käyttäjätili (jolla ei ole salasanaa) Käyttämällä käskyä:
      sudo useradd tomcat -s /bin/bash -p '*'
    • Voit siirtyä toimimaan käyttäjänä Tom Käyttämällä käskyä
      sudo su - tomcat
      (Se pyytää sinulta superkäyttäjän salasanan, jotta voit tehdä tämän.)
      • Voit lopettaa käyttäjien tomcatin käytön komennolla
      exit
      • Suurin osa Tomcatista ja ERDDAP™ Käyttäjän ohjeet Tom . Myöhemmin juoksemaan Startup. ja sulku. Säv. Käsikirjoitukset käyttäjänä Tom Tomcatilla on oikeus kirjoittaa lokitiedostoihinsa.
      • Tomcatin pakkaamisen jälkeen, vanhempien Apache-tomcat Hakemisto:
        • Muuta apache-tomcat-hakemistopuun omistajuutta tomcatin käyttäjäksi.
          chown -R tomcat apache-tomcat-10.0.23
          (Korvaa Tomcat-hakemiston todellinen nimi) .
        • Muuta "ryhmä" tomcatiksi, käyttäjänimeksi tai pienen ryhmän nimeksi, joka sisältää tomcatin ja kaikki Tomcatin ylläpitäjät ERDDAP :
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Muuta lupia, jotta Tomcat ja ryhmä ovat lukeneet, kirjoittaneet ja toteuttaneet etuoikeuksia:
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Poista "muut" käyttäjän lukemis-, kirjoitus- tai suoritusoikeudet:
          chmod -R o-rwx apache-tomcat-10.0.23

Tämä on tärkeää, koska se estää muita käyttäjiä lukemasta mahdollisesti arkaluonteisia tietoja. ERDDAP™ asennustiedostoja.

Muisti

Tomcatin ympäristömuuttujat

  • Linux ja Mac: Luo tiedosto Tomcat/bin/setenv.sh (Pääosat Red Hat Enterprise Linux \[ Ryhmä \] edit Tomcat/conf/tomcat10.conf ) Tomcatin ympäristömuuttujat. Tätä tiedostoa käytetään Tomcat/bin/startup.sh ja sulku. Säv. . Tiedosto sisältää jotain:

    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

    (Korvaa hakemiston nimet tietokoneeltasi) . (Jos olet aiemmin määrittänyt Jre_home Voit poistaa sen.) Macsissa sinun ei välttämättä tarvitse asettaa JAVA - Koti .

  • Windowsissa: Luo tiedosto Tomcat: Setenv.bat Tomcatin ympäristömuuttujat. Tätä tiedostoa käytetään Tomcat\bin\\startup.bat ja shutdown.bat . Tiedosto sisältää jotain:

    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"

    (Korvaa hakemiston nimet tietokoneeltasi) . Jos tämä koskee vain paikallista testiä, poista "palvelin". (Jos olet aiemmin määrittänyt Jre_home Voit poistaa sen.)

The XMX ja xms Muisti on tärkeä, koska ERDDAP™ toimii paremmin enemmän muistin kanssa. Aina asetettu xms sama arvo kuin XMX .

  • 32 bittiä ja 32 bittiä Java : 64 bittiä Java Paljon parempi kuin 32 Java 32 bit Java Toimii niin kauan kuin palvelin ei ole kiireinen. Mitä enemmän fyysistä muistia palvelimessa on, sitä parempi: 4+ GB on hyvä, 2 GB on kunnossa, vähemmän ei suositella. 32 bittiä Java fyysinen muisti, Tomcat ja Java Älä juokse, jos yrität XMX Yli 1500 M (1200 m joissakin tietokoneissa) . Jos palvelimellasi on alle 2 Gt muistia, vähennä XMX Arvon arvo (Sisältää M'egaBytes) 1/2 tietokoneen fyysisestä muistista.

  • 64 bittiä ja 64 bittiä Java : 64 bittiä Java Toimii vain 64-bittisessä käyttöjärjestelmässä.

    • kanssa Java 8. Sinun on lisättävä d64 Tomcatille CATALINA_OPTS parametriä Televisio.bat .
    • kanssa Java Valitse 64 bittiä Java Kun lataat version Java "64 bittiä"

64 bittiä Java Tomcat ja Java voi käyttää erittäin korkea XMX ja xms asetuksia. Mitä enemmän fyysistä muistia palvelimessa on, sitä parempi. Yksinkertainen ehdotus: suosittelemme, että asetat XMX ja xms että (Sisältää M'egaBytes) 1/2 (tai vähemmän) tietokoneen fyysinen muisti. Saa nähdä, onko Tomcat Java ja ERDDAP™ 64-bittisessä tilassa etsitään "vähän" ERDDAP Päivittäinen sähköposti tai sisällä BigParentDirectory/logs Näytä tarkat tiedot [log.txt](/docs/server-admin/additional-information#log) tiedostotiedosto ( isovanhemmat on määritelty Asennus.xml ) .

Garbage kokoelma

  • Sisällä ERDDAP™ > log.txt Näet monia "GC" (Jakamisen epäonnistuminen) "Viestit. Tämä ei yleensä ole ongelma. Se on usein viesti normaalista toiminnasta. Java Sanotaan, että se on juuri päättynyt pieneen roskaan. Kokoelma, koska se loppui huoneesta Eedenissä (osion Java Hyvin nuoret esineet) . Yleensä viesti näyttää MemoryUseAfter . Jos nämä kaksi numeroa ovat lähellä toisiaan, se tarkoittaa, että roskat eivät ole tuottavia. Viesti on vain merkki ongelmasta, jos se on hyvin usein (joka sekunti) eivät ole tuottavia, ja määrät ovat suuria eivätkä kasva, jotka yhdessä osoittavat, että Java Tarvitset enemmän muistia, kamppailee vapauttaa muistia, ja ei voi vapauttaa muistia. Tämä voi tapahtua stressaavana aikana ja sitten mennä pois. Jos se jatkuu, se on merkki ongelmasta.
  • Jos näet Java.lang.OutOfMemory Virhe s sisään ERDDAP™ > log.txt tiedosto, Katso nähkää OutMemory-virhe vinkkejä siitä, miten diagnosoida ja ratkaista ongelmat.  

Luvat

chmod +x *.sh

Fonts

  • Kuvat: Pidämme enemmän vapaista DejaVu-fontit toiseen Java fontteja. Näiden fonttien käyttö on suositeltavaa, mutta sitä ei tarvita.

Jos päätät olla käyttämättä DejaVu-fontteja, sinun on muutettava fontFamily-asetus asennuksessa.xml. <fontFamily> Sansserif </fontFamily> , joka on kaikkien saatavilla Java jakelua. Jos asetat <fontFamily> sellaisen fontin nimi, jota ei ole saatavilla, ERDDAP™ ei kuormita ja tulostaa luettelon käytettävissä olevista fonteista log.txt tiedosto. Sinun on käytettävä yhtä näistä fonteista.

Jos haluat käyttää DejaVu-fontteja, varmista, että <fontFamily> asennus.xml on <fontFamily> DejaVu Sans </fontFamily> .

DejaVu-fonttien asentaminen, lataa DejaVuFonts .zip (5 522 795 tavua, MD5=33E1E61FAB06A547851ED308B4FFF42) ja poista fonttitiedostot väliaikaiseen hakemistoon.

  • Linuxissa:
    • Linux Adoptium Java jakelua, katso Nämä ohjeet .
    • toisen kanssa Java Jakelu: Kuten Tom Käyttäjä, kopioi fonttitiedostot $JAVA_HOME/Lib/Fonts niin Java Löydä fontit. Muista: jos/kun päivität uudempaan versioon Java Sinun on asennettava nämä fontit uudelleen.
  • Kunkin fonttitiedoston kohdalla, kaksinkertaista napsauttamalla sitä ja valitse sitten Asenna Font.
  • Windows 7 ja 10: Windows Explorerissa valitse kaikki fonttitiedostot. Klikkaa oikein. Klikkaa asennusta.  

Testaa Tomcat

  • Testaa Tomcat-asennus.
    • Linux:
    • Mac Mac Mac (Tomcat toimii järjestelmänvalvojana) :
      • Juokseminen Tomcat/bin/startup.sh .
      • Katso URL + ":80/" selaimessasi (esim. http://coastwatch.pfeg.noaa.gov:8080/ ) . Huomaa, että oletusarvoisesti Tomcat on vain käytettävissäsi. Se ei ole julkisesti saatavilla.
    • Windows paikalliset:
      • Napsauta Tomcat-kuvaketta järjestelmän lokerossa ja valitse "Aloita palvelu".
      • Näkymä http://127.0.0.1:8080/ Tai ehkä http://localhost:8080/ Selaimessasi. Huomaa, että oletusarvoisesti Tomcat on vain käytettävissäsi. Se ei ole julkisesti saatavilla.

Tomcat "Onnittelut" -sivulla.

Jos on ongelmia, katso Tomcat-lokitiedosto Tomcat/logs/catalina.out .

Ongelmia Tomcatin asennuksen kanssa?

  • Linux ja Mac, jos et pääse Tomcatiin ERDDAP™ (Tai ehkä et pääse tietokoneelta palomuurin ulkopuolella.) , Voit testata, jos Tomcat kuuntelee porttia 8080 kirjoittamalla (kuin juuret) palvelimen komentorivillä:

    netstat -tuplen | grep 8080

Tämän pitäisi palauttaa yksi rivi jollakin tavalla:

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

(missä missä # Jokin digi) osoittaa, että a Jaava Prosessiprosessi (Epäilemättä Tomcat) Satama 8080 tarkoittaa "Tcp"-liikennettä. Jos riviä ei palautettu, jos linja on merkittävästi erilainen tai jos kaksi tai useampia rivejä on palautettu, satamaasetukset voivat olla ongelma.

  • Katso Tomcat-lokitiedosto Tomcat/logs/catalina.out . Tomcan ongelmat ja jotkut ERDDAP™ Käynnistysongelmat ovat lähes aina esillä. Tämä on yleistä, kun aloitat ERDDAP™ .

  • Nähdään Tomca Verkkosivut tai hae apua, mutta kerro meille ongelmat, joita sinulla on ja löytämäsi ratkaisut.

  • Katso meidän Lisätuen saaminen .  

ERDDAP™ Sisältö

  1. Aseta ylös Tomcat/Sisältö/erdap tiedostojen määrittely. Linux, Mac ja Windows, lataa erdapContent .zip ja purkaa sitä Tom Hakemisto, luominen Tomcat/Sisältö/erdap .

__Version 1.0.0, 20333 tavua, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, päivätty 2024-10-14

Myös aiemmat versiot ovat saatavilla:

  • 2.17 (19 792 tavua, MD5=8F892616BAEEF2DF0F4B036DCB4AD7C, päivätty 2022-02-16)
  • 2.18 (19 792 tavua, MD5=8F892616BAEEF2DF0F4B036DCB4AD7C, päivätty 2022-02-16)
  • 2.2. (19 810 tavua, MD5=1E26F62E7A06191EE68C40B9A29362, päivätty 2022-10-09)
  • 2.22 (19 810 tavua, MD5=1E26F62E7A06191EE68C40B9A29362, päivätty 2022-12-08)
  • 2.23 (19 810 tavua, MD5=1E26F62E7A06191EE68C40B9A29362, päivätty 2023-02-27)

Muu ohjaus

Edeltäjä Red Hat Enterprise Linux (Ryhmä) muissa tilanteissa, joissa et saa muuttaa Tomcat-hakemistoa tai missä haluat/tarvitset Laittaa ERDDAP™ Sisältöhakemisto jostain muusta syystä (Jos käytät Jettyä Tomcatin sijaan) , Unzip erdapContent .zip haluttuun hakemistoon (johon vain Tom Käyttäjällä on pääsy) ja asettaa erddapContentDirectory Järjestelmän omaisuus (esim. erddapContentDirectory =~tomcat/content/erddap ) niin ERDDAP™ Löydä tämä uusi sisältöhakemisto.

Asennus.xml

Alkuvaiheessa sinun on ainakin muutettava näitä asetuksia:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> asetukset
  • <admin...> asetukset
  • <baseHttpsUrl> (Kun olet asentanut https )

Kun luot BigParentDirectoryn, BigParentDirectoryn emohakemistosta:

  • Tee siitä Tom Käyttäjän omistaja isovanhemmat :
    chown -R tomcat bigParentDirectory
  • Muuta "ryhmä" tomcatiksi, käyttäjänimeksi tai pienen ryhmän nimeksi, joka sisältää tomcatin ja kaikki Tomcatin ylläpitäjät ERDDAP :
    chgrp -R yourUserName bigParentDirectory
  • Muuta lupia, jotta Tomcat ja ryhmä ovat lukeneet, kirjoittaneet ja toteuttaneet etuoikeuksia:
    chmod -R ug+rwx bigParentDirectory
  • Poista "muut" käyttäjän lukemis-, kirjoitus- tai toteutusoikeudet. Tämä on tärkeää ehkäistä mahdollisesti arkaluonteisten tietojen lukemista. Sisällä ERDDAP™ kirjaa tiedostoja ja tiedostoja yksityisistä tietoaineistoista.
    chmod -R o-rwx bigParentDirectory

Ympäristömuuttujat

Aloitetaan ERDDAP™ v2.13, ERDDAP™ Järjestäjät voivat ylittää minkä tahansa arvon asennus.xml määrittämällä ympäristömuuttujan. Nimeä ERDDAP _arvonimi ennen juoksemista ERDDAP™ . Esimerkiksi käyttö ERDDAP _baseUrl Ylittää <baseUrl> arvoa. Tämä voi olla kätevää, kun käytät ERDDAP™ Dockerin kaltaisella säiliöllä, koska voit asettaa asennusasetukset.xml Toimita erityisasetuksia ympäristömuuttujan kautta. Jos toimitat salaisia tietoja ERDDAP™ tämän menetelmän kautta, Tarkista, että tiedot pysyvät salaisina. ERDDAP™ Lue ympäristömuuttujat vain kerran käynnistysvaiheessa. käynnistyksen ensimmäisessä sekunnissa, joten yksi tapa käyttää tätä on: aseta ympäristömuuttujat, aloita ERDDAP , Odota kunnes ERDDAP™ Se on aloitettu ja sitten ympäristömuuttujia.

datasets.xml

  • Lue kommentit sisään Työskentelyä yhdessä datasets.xml Tiedosto . Myöhemmin, kun olet saanut ERDDAP™ Juoksen juoksemassa ensimmäistä kertaa (yleensä vain oletustietojen kanssa) Muutat XML:ää Tomcat/content/erddap datasets.xml määrittää kaikki haluamasi tietoaineistot ERDDAP™ palvelemaan. Näin vietät suurimman osan ajastasi Kun perustat ERDDAP™ ja myöhemmin säilyttäen ERDDAP™ .

Voit nähdä esimerkin datasets.xml Kirjoittanut GitHub .  

  • (epätodennäköistä) Nyt tai (hieman todennäköisemmin) tulevaisuudessa, jos haluat muuttaa erddapin CSS-tiedostoa, kopioi Tomcat/content/erddap/images/erdapStart2.css että Tomcat/content/erddap/images/erddap2.css Sitten tehdään muutoksia siihen. Muutoksia Erddap2.css Vain silloin, kun ERDDAP™ Käynnistetään uudelleen ja usein myös käyttäjän on puhdistettava selaimen välimuistitiedostot.   ERDDAP™ ei toimi oikein, jos asennus.xml tai datasets.xml tiedosto ei ole hyvin muotoiltu XML-tiedosto. Kun olet muokannut näitä tiedostoja, On hyvä tarkistaa, että tulos on hyvin muotoiltu XML liittämällä XML-teksti XML-testiin, kuten xmlvalidaatio .  

Asenna erddap. War tiedostot

  1. Linux, Mac ja Windows, _download Erddap.sota Sisään Tomcat/webapps :

_Version 2.28.1, 622,676,238 tavua, MD5=48b4226045f950c8d69ef9521b9bc9, päivätty 2025-09-05

.war-tiedosto on suuri, koska se sisältää korkean resoluution rantaviivaa, rajoja ja korkeustietoja, joita tarvitaan karttojen luomiseen.

Myös aiempia versioita on saatavilla.

  • 2.17 (551 068 245 tavua, MD5=5FEA912B5D42E50EAB9591F773EA848D, päivätty 2022-02-16)
  • 2.18 (551 069 844 tavua, MD5=461325E97E7577EC671D50246CCFB8B, päivätty 2022-02-23)
  • 2.2. (568 6644 411 tavua, MD5=F2CFF805893146E932E498FDDBD519B6, päivätty 2022-10-09)
  • 2.22 (567,742,765 tavua, MD5=2B33354F633294213AE2AFDCF4DA6D0, päivätty 2022-12-08)
  • 2.23 (572 124,953 tavua, MD5=D843A043C506725EBD6F8FDCCA8FD5F, päivätty 2023-03-03)
  • 2.24 (568 748 187 tavua, MD5=970fbee172e28b0b8a07756eecbc898e, päivätty 2024-06-07)
  • 2.25 (592 292 039 tavua, MD5=652AFC9D1421F00B5F789DA2C4732D4C, päivätty 2024-11-07)
  • 2.26 (607 404 032 tavua, MD5=99a725108b37708e5420986c16a119, päivätty 2025-03-31)
  • 2.2.0 (620 554 403 tavua, MD5=3b2086c659ee4145ca2dff447bf4ef7, päivätty 2025-06-11)

Konfiguroi proxy (Erityinen käyttöönotto)

ERDDAP™ on tyypillisesti sijoitettu webserverin käänteisen välityspalvelimen taakse, jotta sitä voidaan palvella tavallisilla HTTP-porteilla. (80 ja 443) . SSL/TLS-terminaatio on usein hajallaan myös webserver-proxy-kerroksessa. Riippuu kunkin käyttöönoton vaatimuksista.

Apasseja

  1. Varmista, että Mod_proxy ja Mod_proxy http on ladattu:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Muokkaa olemassa olevaa <VirtualHost> Tag (Jos on yksi) tai lisätä tiedoston lopussa:
<VirtualHost *:80>
ServerName YourDomain.org
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /erddap http://localhost:8080/erddap
ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Jos ERDDAP™ tarjoillaan muulla tiellä kuin Eddap myös asettaa X-Forwarded-Prefix Otsikko kohti Lähde: Before_ Eddap . Tämä asetus olisi sopiva ERDDAP™ Palvellen Lähde/erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Aloita Apache uudelleen: Käyttäjä/sbin/apachectl K Graceful (Joskus se on toisessa hakemistossa.) .  

Yhdessä

nginx config -tiedostossa aseta nämä otsikot:

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;

Jos ERDDAP™ tarjoillaan muulla tiellä kuin Eddap myös asettaa X-Forwarded-Prefix Otsikko kohti Lähde: Before_ Eddap . Tämä asetus olisi sopiva ERDDAP™ Palvellen Lähde/erddap :

proxy_set_header X-Forwarded-Prefix /subpath

Jotta NGINX ja ERDDAP™ toimimaan oikein https Sinun täytyy laittaa seuraava snippet sisään Tomcat-palvelin.xml <Host> Blokki:

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

 

Aloita Tomcat

  • (En suosittele Tomcat Web Application Managerin käyttöä. Jos et ole täysin suljettu ja käynnistys Tomcat, ennemmin tai myöhemmin sinulla on PermGen muistiongelmia.)
  • (Linuxissa tai Mac OS:ssä, jos olet luonut Tomcat-käyttäjän, esimerkiksi tomcat, muista tehdä seuraavat vaiheet käyttäjänä.)
  • Jos Tomcat jo juoksee, sulje Tomcat (Linux tai Mac OS) Tomcat/bin/shutdown tai tai (Windowsissa) Tomcat \bin shutdown.bat

Linux, Käytä ps -ef | Tomcat ennen ja jälkeen sulku. Säv. Varmista, että tomcat-prosessi on pysähtynyt. Prosessi on lueteltava ennen sulkeutumista, eikä sitä lopulta ole listattu sulkeutumisen jälkeen. Se voi kestää minuutin tai kaksi. ERDDAP™ Täysin suljettu. Ole kärsivällinen. Jos se ei näytä pysähtyvän itsestään, käytä: tappaa -9 <processID>

  • Aloita Tomcat (Linux tai Mac OS) Tomcat/bin/startup.sh tai tai (Windowsissa) Tomcat\bin\\startup.bat

on ERDDAP™ juoksemaan?

Käytä selainta nähdäksesihttp://www.YourServer.org/erddap/status.html. ERDDAP™ Käynnistetään ilman tiedostoja. Datasetit ladataan taustasäikeeseen, joten ne ovat saatavilla yksi kerrallaan.

Troubleshoot

  • Kun käyttäjän pyyntö tulee sisään, se menee Apacheen. (Linux- ja Mac OS -tietokoneissa) Sitten Tomcat, ERDDAP™ .
  • Näet, mitä tulee Apache (liittyviä virheitä) Apache-lokitiedostoissa.
  • Sinä Katso, mitä Tomcat (liittyviä virheitä) Tomcat-lokitiedostot ( Tomcat/logs/catalina.out Muut tiedostot tässä hakemistossa) .
  • Sinä Saa nähdä, mitä tulee ERDDAP diagnostisia viestejä ERDDAP , Viestien virheet ERDDAP Sisällä ERDDAP™ <bigParentDirectory> Tekijät/log.txt tiedosto.
  • Tomcat ei aloita ERDDAP™ Kun Tomcat saa pyynnön ERDDAP™ . Voit katsoa Tomcat-lokitiedostoja, jos Alku alkoi ERDDAP™ tai jos tähän yritykseen liittyy virheilmoitus.
  • Milloin ERDDAP™ Aloita, se nimeää vanhan ERDDAP™ log.txt-tiedosto ( logiikka <CurrentTime> .txt ) Luo uusi log.txt-tiedosto. Jos siis log.txt tiedosto on vanha, se on merkki siitä, että ERDDAP™ Ei ole hiljattain aloitettu uudelleen. ERDDAP™ Kirjoita lokitiedot puskuriin ja kirjoittaa puskurin lokitiedostoon säännöllisesti, mutta voit pakottaa ERDDAP™ Kirjoita puskuri lokitiedostoon vierailemalla /erddap/status.html .

Vaikeus: Vanha versio Java

Jos käytät versiota Java Se on liian vanha ERDDAP , ERDDAP™ Et juokse ja näet virheilmoituksen Tomcatin lokitiedostossa

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

Ratkaisu on päivittää uusin versio Java Varmista, että Tomcat käyttää sitä.

Slow startup ensimmäistä kertaa

Tomcatin on tehtävä paljon työtä ensimmäisen kerran, kun sovellus on ERDDAP™ on aloitettu; varsinkin sen on purettava Erddap.sota tiedostotiedosto (joka on kuin .zip tiedostotiedosto) . Joillakin palvelimilla ensimmäinen yritys nähdä ERDDAP™ Tanssit (30 sekuntia?) kunnes tämä työ on valmis. Muilla palvelimilla ensimmäinen yritys epäonnistuu välittömästi. Jos odotat 30 sekuntia ja yritä uudelleen, se onnistuu, jos ERDDAP™ asennettiin oikein.

Tähän ei ole korjausta. Näin Tomcat toimii. Tämä tapahtuu vasta ensimmäisen kerran, kun olet asentanut uuden version. ERDDAP™ .

Sulje ja käynnistä uudelleen

Tulevaisuudessa suljetaan (uudelleenkäynnistys) ERDDAP™ nähtävä Miten lopettaa ja käynnistää Tomcat ERDDAP .

Ongelmia?

Tomcatin tai ERDDAP™ ?? Katso meidän Lisätuen saaminen .

Sähköpostiilmoitus uusista versioista ERDDAP

Jos haluat saada sähköpostiviestin aina, kun uusi versio ERDDAP™ Saatavilla tai muu tärkeä ERDDAP™ ilmoitukset, Voit liittyä ERDDAP™ Ilmoituslistat täällä täällä täällä . Luettelossa on noin yksi sähköposti kolmen kuukauden välein.

Mukautettu

  • Mukauta itseäsi ERDDAP™ korostaa organisaatiotasi (Ei ei ei NOAA ERD ) .
  • Vaihda lippu, joka näkyy kaikkien huipulla ERDDAP™ .html-sivut muokkaamalla <startBodyHtml5> Tag in your datasets.xml tiedosto. (Jos ei ole yhtä, kopioi oletus ERDDAP™ > Tomcat/webapps/erddap/WEB-INF/Classes/Gov/noaa/pfel/erddap/util/viestejä.xml tiedostotiedosto sisään datasets.xml ja editoida sitä.) Voit esimerkiksi:
    • Käytä erilaista kuvaa (• organisaation logo) .
    • Muuta taustaväriä.
    • Muutos" ERDDAP™ "Organisaatiosi" ERDDAP™ """
    • Vaihda "Tieteellisten tietojen helpompi saatavuus" "Sinun organisaatiosi tietojen helpompi saatavuus".
    • Vaihda "Brought to You by" -linkkejä ollaksesi linkkejä organisaatioosi ja rahoituslähteisiin.
  • Muuta kotisivun vasemmalla puolella olevaa tietoa muokkaamalla <theShortDescriptionHtml> Tag in your datasets.xml tiedosto. (Jos ei ole yhtä, kopioi oletus ERDDAP™ > Tomcat/webapps/erddap/WEB-INF/Classes/Gov/noaa/pfel/erddap/util/viestejä.xml tiedostotiedosto sisään datasets.xml ja editoida sitä.) Voit esimerkiksi:
    • Kerro, mitä organisaatiosi ja/tai ryhmäsi tekee.
    • Selvitä, millaisia tietoja tämä ERDDAP™ on.
    • Muuttaa ikoni, joka näkyy selaimen välilehtiä, laittaa organisaation favicon. Ico sisään Tomcat/content/erddap/images/ . Näytähttps://en.wikipedia.org/wiki/Favicon.