Taito pääsisältöön

Asenna

Miten tehdä ensimmäinen asetukset ERDDAP™ Palvelimen

ERDDAP™ voi suorittaa millä tahansa palvelimella, joka tukee Java ja Tomcat (ja muut sovelluspalvelimet kuten Jetty, mutta emme tue niitä) . ERDDAP™ on testattu Linuxilla (Amazonin AWS:ssä) , Mac, ja Windows tietokoneet.

  • Docker -- Me tarjoamme ERDDAP™ Docker-säiliössä ja IOOS tarjoaa nyt Pikakäynnistysopas ERDDAP™ Docker-kontissa . Se on standardi. ERDDAP™ Asennus Docker-kontissa. Dockerin kautta Komenna tarjoamme helppoja tapoja perustaa ssl ja seuranta, lue lisää ulos Docker-asiakirjat . Jos käytät jo Docker, luultavasti mieluummin Docker versio. Jos etsit ajaa pilvipalvelut luultavasti mieluummin Docker versio.
  • Amazon -- Jos asennat ERDDAP™ Amazon Web Services EC2:n instanssista, katso tämä Amazonin verkkosivujen yleiskatsaus Ensin.
  • Linux ja Mac -- ERDDAP™ toimii hyvin Linux ja Mac tietokoneet. Katso alla olevat ohjeet.
  • Ikkunat -- Windows sopii testattavaksi ERDDAP™ ja henkilökohtaiseen käyttöön (ks. alla olevat ohjeet) , mutta emme suosittele käyttää sitä julkisesti ERDDAP™ komennus. Suoritetaan ERDDAP™ Windows voi olla ongelmia: erityisesti ERDDAP™ tiedostoja ei voida poistaa ja/tai nimetä uudelleen nopeasti. Tämä johtuu todennäköisesti antivirus ohjelmisto (Esimerkiksi, McAfee ja Norton) Joka tutkii virusten tiedostoja. Jos törmäät tähän ongelmaan (joka näkyy virheilmoituksilla log.txt tiedosto kuten "Ei voitu poistaa ...," virustorjuntaohjelmiston asetusten muuttaminen voi osittain lievittää ongelmaa. Tai harkitse Linux- tai Mac-palvelimen käyttöä.

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

  1. Varmista, että kaikki riippuvuudet on asennettu. muut kuin Windows-koneet (Linux ja Mac) Tarvitset Csh:tä.

Java​

  1. -Ei. ERDDAP™ v2.29.0+, asennettu Java 25. Turvallisuussyistä on lähes aina parasta käyttää viimeisintä versiota Java 25. Lataa ja asenna uusin versio Adoptium's OpenJDK (Temuriini) 25 (LTS) . Asennuksen todentamiseksi suorita /javaJreBinHakemisto/jaava -versio , esimerkiksi /usr/local/jdk-25.0.1+8/jre/bin/java -versio .

    ERDDAP™ toimii Java muista lähteistä, mutta suosittelemme Adoptium koska se on tärkein, yhteisötuki, vapaa (kuten olut ja puhe) versio Java 25, joka tarjoaa pitkäaikaista tukea (ilmainen päivityksiä monta vuotta viimeisen alkuperäisen julkaisun) . Turvallisuussyistä voit päivittää ERDDAP ' s versio Java säännöllisesti uusina versioina Java 25 tulee saataville Adoptiumista.

    ERDDAP™ on testattu ja käytetty laajasti 25, ei muita versioita. Eri syistä emme testaa tai tue muita versioita Java .  

Tomcat​

  1. Perustettu Tomcat . Tomcat on yleisimmin käytetty Java Sovelluspalvelin joka on Java käyttöjärjestelmän verkkopalvelujen ja Java palvelinohjelmistot kuten ERDDAP™ . Se on vapaa ja avoin lähdekoodi ohjelmisto (FOSS) .

Voit käyttää toista Java Sovelluspalvelin (Esim.) Mutta testaamme vain Tomcatia.

  • Lataa Tomcat ja pura se palvelimelle tai tietokoneelle. Turvallisuussyistä on lähes aina parasta käyttää Tomcat 10:n viimeisintä versiota (versio 9 ja alla ei voida hyväksyä) joka on suunniteltu toimimaan Java 25 tai uudempi. Jäljempänä Tomcat-hakemistoon viitataan nimellä tomcat .

_Varoitus! Jos sinulla on jo Tomcat suorittaa jotain muuta web-sovellus (erityisesti THREDDIT) , suosittelemme, että asennat ERDDAP™ in toinen Tomcat , koska ERDDAP™ tarvitsee erilaisia Tomcat-asetuksia eikä tarvitse kamppailla muiden sovellusten kanssa.

  • Linuxissa lataa "Core" "tähti .gz " Tomcat distribution Ja pura se. Suosittelemme purkamaan sen. /usr/paikallinen .
  • On Mac, Tomcat on luultavasti jo asennettu Kirjasto/Tomcat , mutta pitäisi päivittää se uusimpaan versioon Tomcat 10. Jos lataat sen, lataa "Core" "tähti .gz " Tomcat distribution ja purkaa sen Kirjasto/Tomcat .
  • Windowsissa voit lataa "Core" "zip" Tomcat jakelu (joka ei sotke Windowsin rekisteriä ja jota ohjaat DOS- komentoriviltä) ja purkaa sen asianmukaiseen hakemistoon. (Kehitys, käytämme "Core" "zip" jakelu. Teemme /ohjelmat hakemisto ja purkaa sen siellä.) Tai voit ladata "Core" "64-bittinen Windows zip" jakelu, joka sisältää enemmän ominaisuuksia. Jos jakelu on Windows asentaja, se todennäköisesti laittaa Tomcat esimerkiksi, /Ohjelmatiedostot/apache-tomcat-10.0.23 .  

server.xml​

  • server.xml - tomcat/conf/server.xml tiedosto, on kaksi muutosta, jotka sinun pitäisi tehdä molempiin <Connector> tunnisteet (yksi &lt;Connector port="8080" ja yksi &lt;Conector port="8443" ) .
    1. (Suositeltava) Lisää yhteys Aikalisä parametriarvo, ehkä 300000 (millisekuntia, eli 5 minuuttia) .
    2. (Suositeltava) Lisää uusi parametri: rento QueryChars="[] | " . Tämä on vapaaehtoista ja hieman vähemmän turvallista. mutta poistaa käyttäjien tarpeen koodata nämä merkit, kun ne esiintyvät käyttäjän pyyntö URL.  

sisältö.xml​

  • konteksti.xml -- Resources Cache - sisään tomcat/conf/context.xml , juuri ennen </Context> tag, vaihda resurssitunnistetta (tai lisätä, jos se ei ole jo olemassa) asettaa välimuisti MaxSize parametri 80000: 
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Näin vältetään useita varoituksia Catalina. ulos, että kaikki alkaa

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

 

Apache aikakatkaisu​

  • Linux-tietokoneilla, vaihda Apache-aikakatkaisuasetukset niin, että aikaa vievät käyttäjäpyynnöt eivät aikakatkaisu (jossa usein näyttää "proxy" tai "Bad Gateway" virhe) . Juurikäyttäjänä:
    • Muokkaa apassia http d.conf tiedosto (yleensä / http d/conf/ ) :
      • Muuta nykyistä <Timeout> asetus (tai lisää yksi tiedoston loppuun) - 3600 (sekuntia) , sijasta oletus 60 tai 120 sekuntia.
      • Muuta nykyistä <ProxyTimeout> asetus (tai lisää yksi tiedoston loppuun) - 3600 (sekuntia) , sijasta oletus 60 tai 120 sekuntia.
    • Käynnistä apassi uudelleen: /usr/sbin/apachectl - k suloinen (mutta joskus se on eri hakemistossa) .

Turvallisuus​

 

  • Turvallisuussuositus: Katso nämä ohjeet parantaa Tomcat asennus, erityisesti julkisille palvelimille.  
  • Julkinen ERDDAP™ installaatiot Linux ja Macs, on parasta perustaa Tomcat (ohjelma) käyttäjälle kuuluvaksi tomcat (erillinen käyttäjä, jolla on rajoitetut oikeudet ja ei salasanaa ) . Näin ollen vain super käyttäjä voi siirtyä toimimaan käyttäjän tomcat . Näin hakkerit eivät voi kirjautua palvelimeen käyttäjänä tomcat . Ja joka tapauksessa, sinun pitäisi tehdä se niin, että tomcat käyttäjällä on erittäin rajalliset oikeudet palvelimen tiedostojärjestelmässä (luke+write+execute-oikeudet (DE-III) apache-tomcat kansiopuu ja <bigParentDirectory> ja lukea vain oikeudet hakemistot kanssa tietoja, ERDDAP™ on saatava käyttöönsä).
    • Voit luoda tomcat käyttäjätili (jossa ei ole salasanaa) käyttämällä komentoa: 
      sudo useradd tomcat -s /bin/bash -p '*'
    • Voit siirtyä käyttäjäksi töihin tomcat käyttämällä komentoa 
      sudo su - tomcat
      (Se pyytää sinulta superkäyttäjän salasanan luvan tehdä tämän.)
      • Voit lopettaa työskentelyn käyttäjän tomcat käyttämällä komentoa
      exit
      • Tehdä suurimman osan loput Tomcat ja ERDDAP™ asennusohjeet käyttäjänä tomcat . Myöhemmin startup.sh sekä Sammuta. pa skriptit käyttäjänä tomcat Tomcatilla on lupa kirjoittaa lokitiedostoihinsa.
      • Purettuaan Tomcatin, apache-tomcat kansio:
        • Vaihda apache-tomcat-hakemistopuun omistus tomcat-käyttäjäksi. 
          chown -R tomcat apache-tomcat-10.0.23
          (mutta korvata todellinen nimi Tomcat hakemiston) .
        • Muuta "ryhmäksi" tomcat, käyttäjätunnuksesi tai pienen ryhmän nimi, johon kuuluu tomcat ja kaikki Tomcat/ ERDDAP : 
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Muuta oikeuksia niin, että tomcat ja ryhmä ovat lukeneet, kirjoittaneet, suorittaneet oikeudet: 
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Poista "toisen" käyttäjän oikeudet lukea, kirjoittaa tai suorittaa: 
          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™ Aseta tiedostot.

Muisti​

Aseta Tomcatin ympäristömuuttujat

  • Linuxissa ja Macsissa: Luo tiedosto tomcat/bin/setenv.sh (tai Red Hat Enterprise Linuxissa \[ RHEL \] , muokkaa ~tomcat/conf/tomcat10.conf ) asettaa Tomcat ympäristömuuttujat. Tiedostoa käytetään tomcat/bin/startup.sh sekä Sammuta. pa . Tiedoston pitäisi sisältää jotain:

    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

    (mutta korvata hakemiston nimet tietokoneen) . (Jos olet aiemmin valinnut JRE_HOME Voit poistaa sen.) Macs, sinun ei varmaan tarvitse asettaa JAVA_HOME .

  • Windowsissa: Luo tiedosto tomcat\bin\\setenv.bat asettaa Tomcat ympäristömuuttujat. Tiedostoa käytetään tomcat\bin\\ startup.bat sekä shutdown.bat . Tiedoston pitäisi sisältää jotain:

    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"

    (mutta korvata hakemiston nimet tietokoneen) . Jos tämä on vain paikalliseen testaukseen, poista "-palvelin." (Jos olet aiemmin valinnut JRE_HOME Voit poistaa sen.)

• - Xmx sekä - Xms muistiasetukset ovat tärkeitä, koska ERDDAP™ Toimii paremmin enemmän muistia. Aseta aina - Xms samaan arvoon kuin - Xmx .

  • 32 bittistä käyttöjärjestelmää ja 32 bittiä Java : 64 bittiä Java on paljon parempi kuin 32 bittiä Java , mutta 32 bittiä Java toimii niin kauan kuin palvelimella ei ole kiire. Mitä fyysisempi muisti palvelimella, sitä parempi: 4+ GB on todella hyvä, 2 GB on kunnossa, vähemmän ei suositella. 32-bittisellä Java , vaikka runsaasti fyysistä muistia, Tomcat ja Java Ei juokse, jos yrität asettaa - Xmx paljon yli 1500 M (1200M joissakin tietokoneissa) . Jos palvelimellasi on alle 2GB muistia, vähennä - Xmx arvo (in 'M'egaBytes) 1/2 tietokoneen fyysisestä muistista.

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

    • Kun Java 8, sinun täytyy lisätä - d64 Tomcatille CATALINA_OPTS parametri setenv.bat .
    • Kun Java 21, valitkaa 64 bittiä Java kun lataat version Java merkintä "64 bittiä."

64-bittisellä Java , Tomcat ja Java voi käyttää hyvin korkea - Xmx sekä - Xms asetukset. Mitä fyysisempi muisti palvelimella, sen parempi. Yksinkertaisena ehdotuksena: suosittelemme, että asetat - Xmx sekä - Xms - (in 'M'egaBytes) 1/2 (tai vähemmän) tietokoneen fyysisen muistin. Katsotaan, onko Tomcat... Java ja ERDDAP™ ovat todellakin käynnissä 64 bitin tilassa etsimällä "bittiä," sisään ERDDAP 's Daily Report sähköposti tai bigPentDirectory/logs/ [log.txt](/docs/server-admin/additional-information#log) tiedosto ( bigPentDirectory on määritelty setup.xml ) .

Roskakokoelma​

  • Sisään ERDDAP™ S log.txt tiedosto, näet monia "GC (Kohdentaminen) Viestit. Tämä ei yleensä ole ongelma. Se on usein viesti normaalisti toimiva Java Sanoi, että se juuri lopetti pienen roskan. kokoelma koska se loppui tilaa Eeden (komission Java kasa hyvin nuoria esineitä) . Yleensä viesti näyttää sinulle MuistiKäyttöEnnen-&gt;muistin käyttöä jälkeen . Jos nuo numerot ovat lähellä toisiaan, roskakokoelma ei ollut tuottoisa. Viesti on vain merkki ongelmista, jos se on hyvin usein (muutaman sekunnin välein) , ei tuottava, ja määrä ovat suuria ja ei kasva, jotka yhdessä osoittavat, että Java tarvitsee enemmän muistia, kamppailee vapauttaakseen muistia, eikä pysty vapauttamaan muistia. Tämä voi tapahtua aikana stressaavaa aikaa, sitten mennä pois. Mutta jos se jatkuu, se on merkki ongelmista.
  • Jos näet Java.lang.OutMemoryError pa ERDDAP™ S log.txt tiedosto, Katso OutOfMemoryError vinkkejä siitä, miten diagnosoida ja ratkaista ongelmia.  

Lupa​

chmod +x *.sh

Kirjasimet​

  • Kuvien kirjasimet: Pidämme enemmän vapaista DejaVu-fontit toiselle Java Fontteja. Näiden fonttien käyttö on erittäin suositeltavaa, mutta sitä ei tarvita.

Jos et käytä DejaVu-fontteja, sinun täytyy vaihtaa fonttiFamily-asetukset setup.xml:iin <fontFamily> SansSerif </fontFamily> , joka on saatavilla kaikkien Java jakelu. Jos valitset <fontFamily> sellaisen kirjasimen nimeen, joka ei ole käytettävissä, ERDDAP™ ei lataa ja tulostaa listan saatavilla olevista kirjasimista log.txt Tiedosto. Sinun täytyy käyttää yhtä niistä fonteista.

Jos päätät käyttää DejaVu-fontteja, varmista <fontFamily> asetus setup.xml on <fontFamily> DejaVu Sans </fontFamily> .

Jos haluat asentaa DejaVu-fontit, lataa DejaVuFontit .zip (5,522,795 tavua, MD5=33E1E61FAB06A547851ED308B4FFEF42) ja avaa kirjasintiedostot väliaikaiseen hakemistoon.

  • Linuxissa:
    • Linux Adoptium Java jakelu, ks. nämä ohjeet .
    • Muut Java jakelut: Kuten tomcat käyttäjä, kopioi kirjasintiedostot $JAVA_HOME/lib/fontit Joten Java voi löytää fontit. Muista: jos/kun myöhemmin päivittää uudempaan versioon Java Sinun täytyy asentaa fontit uudelleen.
  • Macs: jokaisen kirjasintiedoston osalta kaksoisnapsauta sitä ja napsauta Asenna kirjasin.
  • Windows 7 ja 10: Windows Explorer, valitse kaikki kirjasintiedostot. Klikkaa oikealle. Klikkaa Asenna.  

Testi Tomcat​

  • Testaa Tomcatin asennusta.
    • Linux:
    • Mac (Suorita tomcat järjestelmän valvojana) :
      • Juokse tomcat/bin/startup.sh .
      • Näytä verkko- osoite + ":8080/" selaimessasi (esim. http://coastwatch.pfeg.noaa.gov:8080/ ) . Huomaa, että Tomcat on oletusarvoisesti vain sinun käytettävissäsi. Se ei ole julkisesti saatavilla.
    • Windows localhost:
      • Klikkaa Tomcat-kuvaketta oikealla painikkeella ja valitse "Käynnistä palvelu."
      • Näytä http://127.0.0.1:8080/ , tai ehkä http://localhost:8080/ Selaimessasi. Huomaa, että Tomcat on oletusarvoisesti vain sinun käytettävissäsi. Se ei ole julkisesti saatavilla.

Näkisitpä Tomcat-sivun.

Jos tulee ongelmia, katso Tomcat-lokitiedostoa osoitteessa tomcat/logs/catalina.out .

Ongelmia Tomcatin kanssa?​

  • Linuxissa ja Macissa, jos et tavoita Tomcatia tai ERDDAP™ (Tai ehkä et vain tavoita heitä tietokoneen ulkopuolella palomuurin) , Voit testata, kuunteleeko Tomcat porttia 8080 kirjoittamalla (juurina) palvelimen komentorivillä:

    netstat -tuplen | grep 8080

Sen pitäisi palauttaa yksi rivi jollain:

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

(jossa # on jokin numero) , mikä osoittaa, että Java prosessi (Oletettavasti Tomcat) Kuuntelee satamaa "8080" tcp-liikenteessä. Jos mitään linjoja ei palautettu, jos linja on merkittävästi erilainen tai jos kaksi tai useampia linjoja palautettiin, voi olla ongelma porttiasetuksissa.

  • Katso Tomcat-lokitiedosto tomcat/logs/catalina.out . Tomcat ongelmia ja joitakin ERDDAP™ Käynnistysongelmat ovat lähes aina siellä. Tämä on yleistä, kun aloitat ERDDAP™ .

  • Katso Tomcat sivusto tai etsiä web apua, mutta kerro meille ongelmista oli ja ratkaisuja löysit.

  • Katso kohta: .  

ERDDAP™ Sisältö​

  1. Perusta tomcat/sisältö/erddap asetustiedostot. Lataa Linuxista, Macista ja Windowsista erddapContent .zip ja avaa se sisään tomcat kansio, luonti tomcat/sisältö/erddap .

Versio 1.01, 20683 tavua, MD5=98a8099e7e674da59fe35e9c96efa7b5, päivätty 2025-06-02__

Joitakin aiempia versioita on myös saatavilla:

  • 2, 17 (19,792 tavua, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, päivätty 2022-02-16)
  • 2. 18 (19,792 tavua, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, päivätty 2022-02-16)
  • 2. 21 (19,810 tavua, MD5=1E26F62E7A06191EE6868C40B9A29362, päivätty 2022-10-09)
  • 2, 22 (15,810 tavua, MD5=1E26F62E7A06191EE6868C40B9A29362, päivätty 2022-12-08)
  • 2, 23 (19,810 tavua, MD5=1E26F62E7A06191EE6868C40B9A29362, päivätty 2023-02-27)

Muu kansio​

Red Hat Enterprise Linuxille (RHEL) tai muihin tilanteisiin, joissa et saa muokata Tomcat-hakemistoa tai missä haluat/tarpeesi ja ERDDAP™ sisältöhakemisto jostain muusta paikasta jostain muusta syystä (Esimerkiksi jos käytät Jetty sijasta Tomcat) , unzip erddapContent .zip haluttuun kansioon (joista ainoastaan tomcat käyttäjällä on pääsy) ja asettaa erddapContentDirectory järjestelmän omaisuus (esim. erddapContentDirectory =~tomcat/content/erddap ) Joten ERDDAP™ löytää tämän uuden sisältöhakemiston.

setup.xml​

Alun asetukset:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> asetukset
  • <admin...> asetukset
  • <baseHttpsUrl> (kun https )

Kun luot bigPentDirectory, bigPentDirectory:

  • Tee tomcat käyttäjä omistaja bigPentDirectory : 
    chown -R tomcat bigParentDirectory
  • Muuta "ryhmäksi" tomcat, käyttäjätunnuksesi tai pienen ryhmän nimi, johon kuuluu tomcat ja kaikki Tomcat/ ERDDAP : 
    chgrp -R yourUserName bigParentDirectory
  • Muuta oikeuksia niin, että tomcat ja ryhmä ovat lukeneet, kirjoittaneet, suorittaneet oikeudet: 
    chmod -R ug+rwx bigParentDirectory
  • Poista "toisen" käyttäjän oikeudet lukea, kirjoittaa tai suorittaa. Tämä on tärkeää, jotta voidaan estää lukeminen mahdollisesti arkaluonteisia tietoja in ERDDAP™ lokitiedostoja ja tiedostoja, joissa on tietoa yksityisistä tiedostoista. 
    chmod -R o-rwx bigParentDirectory

Ympäristömuuttujat​

alkaen ERDDAP™ v2.13 ERDDAP™ ylläpitäjät voivat ohittaa minkä tahansa arvon setup.xml määrittelemällä ympäristömuuttuja nimetty ERDDAP _Nimi ennen juoksemista ERDDAP™ . Käyttö ERDDAP _BaseUrl Ohittaa <baseUrl> arvo. Tämä voi olla kätevää käytettäessä ERDDAP™ Kanssa säiliö kuten Docker, koska voit laittaa vakioasetukset setup.xml ja toimittaa sitten erityisasetukset ympäristömuuttujien kautta. Jos annat salaisia tietoja ERDDAP™ tämän menetelmän avulla Varmista, että tiedot pysyvät salassa. ERDDAP™ lukee ympäristömuuttujia vain kerran käynnistettäessä, ensimmäisen sekunnin startup, joten yksi tapa käyttää tätä on: asettaa ympäristömuuttujat, aloittaa ERDDAP , Odota. ERDDAP™ Aloitetaan ja poistetaan ympäristömuuttujat.

datasets.xml​

  • Lue kommentit Yhteistyö datasets.xml Tiedosto . Myöhemmin, kun olet saanut ERDDAP™ käynnissä ensimmäistä kertaa (yleensä vain oletustiedostot) , voit muokata XML in tomcat/pitoisuus/erddap/ datasets.xml määrittää kaikki tiedostot haluat oman ERDDAP™ Palvella. Täällä vietät suurimman osan ajastasi. kun ERDDAP™ ja myöhemmin ERDDAP™ .

Näet esimerkin datasets.xml GitHubista .  

  • (Epätodennäköistä.) Nyt tai (hieman todennäköisempi) tulevaisuudessa, jos haluat muokata erddapin CSS-tiedosto, kopioida tomcat/content/erddap/images/erddapStart2.css - tomcat/content/erddap/images/erddap2.css ja sitten tehdä muutoksia siihen. Muutokset erddap2css tulee voimaan vain, kun ERDDAP™ on käynnistetty uudelleen ja vaatii usein myös käyttäjää tyhjentämään selaimen välimuistitiedostot.   ERDDAP™ ei toimi oikein, jos setup.xml tai datasets.xml tiedosto ei ole hyvin muotoiltu XML-tiedosto. Kun olet editoinut näitä tiedostoja, On hyvä ajatus tarkistaa, että tulos on hyvin muotoiltu XML liittämällä XML-teksti XML-tarkistus kuten xmlvalidointi .  

Asenna kierrosluku. Sotatiedosto​

  1. Linuxissa, Macissa ja Windowsissa __lataa erddap.war _ tomcat/webaps :

Versio 2.10.0, 706.939,130 tavua, MD5=CDC4B3D82A20B33A6623B85312F6DC21, päivätty 2026-04-2

.war tiedosto on suuri, koska se sisältää korkean resoluution rannikkoviiva, raja, ja korkeus merenpinnasta tietoja tarvitaan karttoja.

Myös joitakin 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=461325E97E7577EC671DD50246CCFB8B, päivätty 2022-02-23)
  • 2. 21 (568,644,411 tavua, MD5=F2CFF805893146E932E498FDDBD519B6, päivätty 2022-10-09)
  • 2, 22 (567,742,765 tavua, MD5=2B33354F633294213AE2AFDDCF4DA6D0, päivätty 2022-12-08)
  • 2, 23 (572,124,953 tavua, MD5=D843A043C506725EBD6F8EFDCCA8FD5FD5F, 2023-03-03)
  • 2, 14 (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=99a725108b37708e5420986c1616a119, päivätty 2025-03-31)
  • 2, 27, 0 (620,554,403 tavua, MD5=3b2086c659eee4145ca2dff447bf4ef7, päivätty 2025-6-11)
  • 2, 28.1 (622,676,238 tavua, MD5=48b4226045f950c8a8d69ef9521b9bc9, päivätty 2025-09-05)
  • 2, 29, 0 (706 788 135 tavua, MD5=A5ED0DCC8D46CA27640FFEB8CE4A8560, päivätty 2025-12-15)

Määrittele välityspalvelin (käyttöönottokohtainen)​

ERDDAP™ käytetään tyypillisesti webserver käänteisen välityspalvelimen takana, jotta sitä voidaan palvella HTTP:n vakioporteissa (80 ja 443) . SSL/TLS terminointi on usein handed webserver välityspalvelin kerros samoin. Yksityiskohdat riippuvat kunkin käyttöönoton vaatimuksista.

Apassi​

  1. Varmista, että mod_proxy sekä mod_proxy_ http on lastattu:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Muokkaa nykyistä <VirtualHost> tunniste (jos) , tai lisätä yksi lopussa tiedoston:
<VirtualHost *:80>
   ServerName YourDomain.org
   ProxyRequests Off
   ProxyPreserveHost On
   ProxyPass /erddap http://localhost:8080/erddap
   ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Jos ERDDAP™ palvelee muulla kuin /erddap , asettaa myös X-etuliite otsikko polkusegmentti ennen /erddap . Tämä asetus olisi sopiva ERDDAP™ Palveltiin /subpath/erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Käynnistä apassi uudelleen: /usr/sbin/apachectl - k suloinen (mutta joskus se on eri hakemistossa) .  

NGINX​

Aseta nginx config-tiedostossa 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™ palvelee muulla kuin /erddap , asettaa myös X-etuliite otsikko polkusegmentti ennen /erddap . Tämä asetus olisi sopiva ERDDAP™ Palveltiin /subpath/erddap :

proxy_set_header X-Forwarded-Prefix /subpath

Saada NGINX ja ERDDAP™ toimii oikein https , sinun täytyy laittaa seuraava snippet sisällä Tomcat palvelimen.xml <Host> lohko:

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

 

Käynnistä Tomcat​

  • (En suosittele Tomcat Web-sovelluspäällikköä. Jos et täysin sammuta ja käynnistä Tomcatia, sinulla on ennemmin tai myöhemmin PermGen-muistiongelmia.)
  • (Linuxissa tai Mac OS:ssä, jos olet luonut erityisen käyttäjän johtamaan Tomcatia, esim. Tomcatia, muista tehdä seuraavat vaiheet käyttäjänä.)
  • Jos Tomcat on jo käynnissä, sulje Tomcat (Linux tai Mac OS) tomcat/bin/shutdown.sh tai (Windowsissa) tomcat\\ bin\\ shutdown.bat

Linuxiin, käytä ps-ef | grep tomcat ennen ja jälkeen Sammuta. pa Varmistan, että Tomcat-prosessi on loppunut. Prosessi olisi lueteltava ennen sulkemista, eikä sitä lopulta luetella sulkemisen jälkeen. Se voi kestää hetken tai kaksi ERDDAP™ -Ei. Ole kärsivällinen. Tai jos näyttää siltä, että se ei lopeta yksin, käytä: tappaa -9 <processID>

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

On ERDDAP™ Juosta?​

Käytä selainta nähdäksesi http://www.YourServer.org/erddap/status.html.

ERDDAP™ aloittaa ilman mitään tiedostoja ladattu. Dataset on ladattu taustalankaan, joten se tulee saataville yksitellen.

Vianmääritys​

  • Kun käyttäjä pyytää, se menee Apache (Linux- ja Mac OS -tietokoneista) Sitten Tomcat. ERDDAP™ .
  • Näet, mitä Apassille tapahtuu. (ja siihen liittyvät virheet) Apache-lokitiedostoissa.
  • Sinä voi nähdä mitä tulee Tomcat (ja siihen liittyvät virheet) Tomcat-lokitiedostoissa ( tomcat/logs/catalina.out ja muita tiedostoja tässä hakemistossa) .
  • Sinä voi nähdä mitä tulee ERDDAP , diagnostisia viestejä osoitteesta ERDDAP , ja virheviestejä ERDDAP , ERDDAP™ <bigParentDirectory> /logs/log.txt Tiedosto.
  • Tomcat ei ala. ERDDAP™ kunnes Tomcat saa pyynnön ERDDAP™ . Joten voit nähdä Tomcat lokitiedostoja, jos se alkoi ERDDAP™ tai jos yritykseen liittyy virheilmoitus.
  • Milloin ERDDAP™ aloittaa, se nimeää vanhan ERDDAP™ log.txt-tiedosto ( logArchivedAt <CurrentTime> .txt ) ja luo uuden log.txt-tiedoston. Joten jos log.txt tiedosto on vanha, se on merkki, että ERDDAP™ Se ei ole käynnistynyt hiljattain. ERDDAP™ kirjoittaa lokitiedot puskurille ja vain kirjoittaa puskurin lokitiedostoon ajoittain, mutta voit pakottaa ERDDAP™ kirjoittaa puskuri lokitiedostoon vierailemalla /erddap/status.html .

Ongelma: Vanha versio Java​

Jos käytät versiota Java Se on liian vanha. ERDDAP , ERDDAP™ ei toimi ja näet virheviestin Tomcat's lokitiedostossa kuten

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

Ratkaisu on päivittää uusimman version Java Ja varmista, että Tomcat käyttää sitä.

Ongelma: Hidas käynnistys ensimmäisellä kerralla​

Tomcat tekee paljon töitä, kun ensimmäinen hakemus, kuten ERDDAP™ on aloitettu; erityisesti sen on purettava erddap.war tiedosto (joka on kuin .zip tiedosto) . Joillakin palvelimilla, ensimmäinen yritys tarkastella ERDDAP™ kojut (30 sekuntia?) Kunnes tämä työ on valmis. Muilla palvelimilla ensimmäinen yritys epäonnistuu välittömästi. Mutta jos odotat 30 sekuntia ja yrität uudelleen, se onnistuu, jos ERDDAP™ on asennettu oikein.

Tähän ei ole ratkaisua. Näin Tomcat toimii. Mutta se tapahtuu vasta ensimmäisen kerran, kun asennat uuden version ERDDAP™ .

Sammuta ja käynnistä uudelleen​

Tulevaisuudessa, lopettaa (ja käynnistä) ERDDAP™ , katso Miten sammuttaa ja käynnistää Tomcat ja ERDDAP .

Ongelmia?​

Ongelmia Tomcatin tai ERDDAP™ ? Katso kohta: .

Sähköposti-ilmoitus uusista versioista ERDDAP​

Jos haluat vastaanottaa sähköpostin aina uusi versio ERDDAP™ on saatavilla tai muu tärkeä ERDDAP™ ilmoitukset, Voit liittyä ERDDAP™ Ilmoitusluettelo Tässä. . Tämä luettelo on keskimäärin noin yksi sähköposti joka kolmas kuukausi.

Oma​

  • Mukauta ERDDAP™ korostaa organisaatiosi (ei NOAA ERD ) .
  • Muuta banner joka näkyy kaikkien alkuun ERDDAP™ .html sivut muokkaamalla <startBodyHtml5> tunniste datasets.xml Tiedosto. (Jos sellaista ei ole, kopioi oletus ERDDAP™ S tomcat/webaps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml tiedosto sisään datasets.xml ja muokata sitä.) Esimerkiksi:
    • Käytä toista kuvaa (eli organisaatiosi logo) .
    • Vaihda taustaväriä.
    • Muutos " ERDDAP™ " to "_YourOrganization_s ERDDAP™ "
    • Muuta "Helpompi pääsy tieteelliseen tietoon" muotoon " Helpompi pääsy _Organization_in tietoihin."
    • Muuta "Brought to you by"-linkkejä linkeiksi organisaatioosi ja rahoituslähteisiin.
  • Muuta tietoja kotisivun vasemmalla puolella muokkaamalla <theShortDescriptionHtml> tunniste datasets.xml Tiedosto. (Jos sellaista ei ole, kopioi oletus ERDDAP™ S tomcat/webaps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml tiedosto sisään datasets.xml ja muokata sitä.) Esimerkiksi:
    • Kuvaile mitä organisaatiosi ja/tai ryhmäsi tekee.
    • Kuvailkaa, millaiset tiedot tämä ERDDAP™ on.
    • Voit muuttaa kuvaketta, joka näkyy selaimen välilehtiä, laita organisaatiosi favicon. ilu tomcat/content/erddap/images/ . Katso https://en.wikipedia.org/wiki/Favicon.