Hopp til hovedinnhold

Installer

Hvordan å gjøre den første oppsett av ERDDAP™ på din server

ERDDAP™ kan kjøres på enhver server som støtter Java og Tomcat (og andre programservere som Jetty, men vi støtter dem ikke) .. ERDDAP™ Har blitt testet på Linux (Inkludert i Amazons AWS) Mac og Windows datamaskiner.

  • Docker -- Vi tilbyr ERDDAP™ i en Docker-beholder IOOS tilbyr nå Hurtigstartguide for ERDDAP™ i en Docker Container .. Det er standarden ERDDAP™ installasjon, i en Docker container. Gjennom Docker Kombiner vi gir enkle måter å sette opp ssl og overvåking, lese mer på utsiden Docker dokumentasjon .. Hvis du allerede bruker Docker, vil du sannsynligvis foretrekke Docker versjonen. Hvis du ønsker å kjøre på skytjenester vil du sannsynligvis foretrekke Docker-versjonen.
  • Amazon -- Hvis du installerer ERDDAP™ på en Amazon Web Services EC2-instans, se dette Amazon Web Services Oversikt Først.
  • Linux og Macs -- ERDDAP™ Fungerer bra på Linux og Mac datamaskiner. Se instruksjonene nedenfor.
  • Vinduer -- Windows er bra for testing ERDDAP™ og til personlig bruk (Se instruksjonene nedenfor) , Men vi anbefaler ikke å bruke det til offentlig ERDDAP™ Utdelinger. Kjøring ERDDAP™ På Windows kan det være problemer: særlig, ERDDAP™ kan være i stand til å slette og/eller omdøpe filer raskt. Dette skyldes sannsynligvis antivirusprogramvare. (For eksempel fra McAfee og Norton) som kontrollerer filene for virus. Hvis du løper inn i dette problemet (som kan ses av feilmeldinger i log.txt fil som "Ukan ikke slette ..."), endre innstillingene til antivirusprogramvaren kan delvis lindre problemet. Eller vurdere å bruke en Linux eller Mac-server i stedet.

Standarden ERDDAP™ installasjonsanvisninger for Linux, Macs og Windows-datamaskiner er:

  1. Sørg for at alle avhengigheter er installert. På ikke-Windows maskiner (Linux og Mac) Du trenger csh.

Java

  1. For ERDDAP™ v2.19+, sett opp Java 21. Av sikkerhetsgrunner er det nesten alltid best å bruke den nyeste versjonen av Java 21. Last ned og installer den nyeste versjonen av Adoptiums OpenJDK (Temurin) 21 (LTS) .. For å verifisere installasjonen, kjør /javaJreBinDirectory/java -versjon For eksempel /usr/lokal/jdk-21.0.3+9/jre/bin/java -versjon ..

    ERDDAP™ jobber med Java fra andre kilder, men vi anbefaler Adoptium fordi det er det viktigste, samfunnsstøttede, gratis (som i øl og tale) versjon av Java 21 som tilbyr langtidsstøtte (gratis oppgraderinger i mange år forbi den første utgivelsen) .. Av sikkerhetsgrunner, vennligst oppdater din ERDDAP versjon av Java periodisk som nye versjoner av Java 21 blir tilgjengelig fra Adoptium.

    ERDDAP™ har blitt testet og brukt mye med 21, ikke andre versjoner. Av ulike grunner tester vi ikke med eller støtter andre versjoner av Java ..  

Tomcat

  1. Sett opp Tomcat .. Tomcat er den mest brukte Java applikasjonsserver, som er Java programvare som står mellom operativsystemets nettverkstjenester og Java serverprogramvare som ERDDAP™ .. Det er gratis og åpen kilde programvare (FOSS) ..

Du kan bruke en annen Java Applikasjonsserver (f.eks. Jetty) Men vi tester bare med og støtter Tomcat.

  • Last ned Tomcat og pakke det ut på serveren eller PCen. Av sikkerhetsgrunner er det nesten alltid best å bruke den nyeste versjonen av Tomcat 10 (versjon 9 og nedenfor er ikke akseptable) som er designet for å jobbe med Java 21 eller nyere. Nedenfor vil Tomcat-katalogen bli omtalt som tomcat ..

Varsel!__ Hvis du allerede har en Tomcat som kjører noe annet webprogram (Spesielt tredder) Vi anbefaler at du installerer ERDDAP™ i En andre Tomcat fordi ERDDAP™ trenger forskjellige Tomcat-innstillinger og bør ikke trenge å kjempe med andre programmer for minne.

  • på Linux Last ned "Kore" "tartar .gz " Tomcat distribusjon og pakke den ut. Vi anbefaler å pakke det i /usr/lokal ..
  • På en Mac er Tomcat sannsynligvis allerede installert i /Library/Tomcat , men bør oppdatere det til den nyeste versjonen av Tomcat 10. Hvis du laster det ned, Last ned "Kore" "tartar .gz " Tomcat distribusjon og pakke den i /Library/Tomcat ..
  • På Windows kan du Last ned "Kore" "zip" Tomcat-distribusjonen (som ikke roter med Windows-registeret og som du kontrollerer fra en DOS-kommandolinje) og pakke den i en passende katalog. (For utvikling bruker vi distribution Core " "zip"-distribusjonen. Vi lager en /programmer Katalog og pakke den der.) Eller du kan laste ned Windows Core" "64-bits Windows zip"-distribusjonen, som inkluderer flere funksjoner. Hvis distribusjonen er en Windows-installerer, vil den sannsynligvis sette Tomcat i, for eksempel, /Program Filer/apache-tomcat-10.0.23 ..  

server.xml

  • server.xml - I tomcat/conf/server.xml fil, det er to endringer du bør gjøre til hver av de to <Connector> tagger (En for &lt;Connector port="8080" En til &lt;Conector port="8443" ) ..
    1. (Anbefalt) Øke tilkobling Tidsavbrudd parameterverdi, kanskje til 300000 (millisekunder, som er 5 minutter) ..
    2. (Anbefalt) Legg til en ny parameter: AvslappetQueryChars="[] | " .. Dette er valgfritt og litt mindre sikkert, men fjerner behovet for brukerne til prosentkode disse tegnene når de oppstår i parametrene til en brukers forespørsel URL.  

content.xml

  • context.xml -- Resources Cache - I tomcat/conf/context.xml rett før </Context> Tagge, endre ressurstaggen (Legg til det hvis det ikke allerede er der) å sette bufferen MaxSize-parameter til 80000:
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Dette unngår mange advarsler i catalina. Alt starter med

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

 

Apache Tidsavbrudd

  • På Linux-datamaskiner endre innstillingene for tidsavbrudd for Apache slik at tidskrevende brukerforespørsler ikke vil bli forsinket (med det som ofte vises som en "Proxy" eller "Bad Gateway" feil) .. Som rotbrukere:
    • Endre Apache http d.conf fil (Vanligvis i /etc/ http d/conf/ ) :)
      • Endre eksisterende <Timeout> innstilling (eller legge til en på slutten av filen) til 3600 (sekunder) I stedet for standard 60 eller 120 sekunder.
      • Endre eksisterende <ProxyTimeout> innstilling (eller legge til en på slutten av filen) til 3600 (sekunder) I stedet for standard 60 eller 120 sekunder.
    • Start Apache på nytt: /usr/sbin/apachectl -K graciøs (Men noen ganger er det i en annen katalog) ..

Sikkerhet

 

  • Sikkerhetsanbefaling: Se disse instruksjonene å øke sikkerheten til din Tomcat installasjon, spesielt for offentlige servere.  
  • For offentlig ERDDAP™ installasjoner på Linux og Macs, det er best å sette opp Tomcat (programmet) som tilhører brukeren tomcat (en separat bruker med begrenset tillatelse og som har ikke passord ) .. Således kan bare superbrukeren bytte til å fungere som bruker tomcat .. Dette gjør det umulig for hackere å logge inn på serveren som bruker tomcat .. Og i alle fall bør du gjøre det slik at tomcat brukeren har svært begrensede tillatelser på serverens filsystem (lese+write+e executive privilegier For apache-tomcat katalogtre og <bigParentDirectory> og skrivebare privilegier for mapper med data som ERDDAP™ trenger tilgang til).
    • Du kan opprette tomcat brukerkonto (som ikke har passord) Ved å bruke kommandoen:
      sudo useradd tomcat -s /bin/bash -p '*'
    • Du kan bytte til å jobbe som bruker tomcat ved å bruke kommandoen
      sudo su - tomcat
      (Det vil be deg om superbrukarpassord for tillatelse til å gjøre dette.)
      • Du kan slutte å jobbe som brukertomcat ved å bruke kommandoen
      exit
      • Gjør det meste av resten av Tomcat og ERDDAP™ installasjonsanvisninger som bruker tomcat .. Senere kjører startup.sh og Nedleggelse. sh skript som bruker tomcat slik at Tomcat har tillatelse til å skrive til sine loggfiler.
      • Etter å ha pakket ut Tomcat, fra foreldre til apache-tomcat mappe:
        • Endre eierskap til Apache-tomcat katalogtre til tomcat bruker.
          chown -R tomcat apache-tomcat-10.0.23
          (men erstatte det faktiske navnet på tomcat-katalogen din) ..
        • Endregroupgruppen" for å være tomcat, brukernavn eller navnet på en liten gruppe som inkluderer tomcat og alle administratorer av Tomcat/ ERDDAP :)
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Endre tillatelser slik at tomcat og gruppen har lest, skrevet, utført privilegier:
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Fjern andres tillatelser til å lese, skrive eller utføre:
          chmod -R o-rwx apache-tomcat-10.0.23

Dette er viktig, fordi det hindrer andre brukere i å lese muligens sensitiv informasjon i ERDDAP™ installasjonsfiler.

Minne

Sett Tomcats miljøvariabler

  • På Linux og Macs: Opprett en fil tomcat/bin/setenv.sh (eller i Red Hat Enterprise Linux \[ RHEL \] , rediger ~tomcat/conf/tomcat10.conf ) For å sette Tomcats miljøvariabler. Denne filen vil bli brukt av tomcat/bin/startup.sh og Nedleggelse. sh .. Filen skal inneholde noe som:

    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

    (erstatte mappenavn fra datamaskinen) .. (Hvis du tidligere har satt JRE_HOME Du kan fjerne det.) På Macs trenger du sannsynligvis ikke å sette JAVA_HOME ..

  • På Windows: Opprett en fil nomcat\bin\\setenv.bat For å sette Tomcats miljøvariabler. Denne filen vil bli brukt av Tomcat\bin\\startup.bat og shutdown.bat .. Filen skal inneholde noe som:

    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"

    (erstatte mappenavn fra datamaskinen) .. Hvis dette er bare for lokal testing, fjerne "-server". (Hvis du tidligere har satt JRE_HOME Du kan fjerne det.)

Den -Xmx og -Xms minneinnstillinger er viktige fordi ERDDAP™ fungerer bedre med mer minne. Alltid satt -Xms til samme verdi som -Xmx ..

  • For 32 bit operativsystemer og 32 bit Java :) 64 bit Java Er mye bedre enn 32 bit Java men 32 bit Java Fungerer så lenge serveren ikke er opptatt. Jo mer fysisk minne på serveren jo bedre: 4+ GB er veldig bra, 2 GB er ok, mindre anbefales ikke. Med 32 bit Java , selv med rikelig fysisk minne, Tomcat og Java vil ikke løpe hvis du prøver å sette -Xmx Mer enn 1500 m (1200M på noen datamaskiner) .. Hvis serveren din har mindre enn 2GB minne, redusere -Xmx verdi (i 'M'egabytes) 1/2 av datamaskinens fysiske minne.

  • For 64 bit operativsystemer og 64 bit Java :) 64 bit Java Det vil bare fungere på et 64-biters operativsystem.

    • Med Java 8 du må legge til -d64 til Tomcat CATALINA_OPTS parameter i Setenv.bat ..
    • Med Java 21 du velger 64 bit Java Når du laster ned en versjon av Java merket "64 bit".

Med 64 bit Java Tomcat og Java Kan bruke svært høy -Xmx og -Xms innstillinger. Jo mer fysisk minne på serveren jo bedre. Som et simplistisk forslag: vi anbefaler at du setter -Xmx og -Xms til (i 'M'egabytes) til 1/2 (eller mindre) av datamaskinens fysiske minne. Du kan se om Tomcat, Java , og ERDDAP™ kjører faktisk i 64-bits modus ved å lete etter - bit, - i ERDDAP Daglig rapport e-post eller i bigParentDirectory/logs/ [log.txt](/docs/server-admin/additional-information#log) fil ( bigParentDirectory er spesifisert i config.xml ) ..

Garbage Samling

  • I ERDDAP™ 's log.txt fil, vil du se mange "GC (Tildelingsfeil) " Meldinger. Dette er vanligvis ikke et problem. Det er et hyppig budskap fra en normalt drift Java å si at det nettopp fullførte et mindre søppel samling fordi det gikk tom for rom i Eden (delen av Java haug for svært unge objekter) .. Vanligvis viser meldingen deg minnebruk før-&gt;minnebruk .. Hvis disse to tallene er tett sammen, betyr det at søppelsamlingen ikke var produktiv. Budskapet er bare et tegn på problemer hvis det er svært hyppig (hvert sekund) ikke produktivt, og tallene er store og ikke voksende, som sammen indikerer at Java trenger mer minne, sliter med å frigjøre minne, og kan ikke frigjøre minne. Dette kan skje under en stressende tid, og deretter gå bort. Men hvis det fortsetter, er det et tegn på problemer.
  • Hvis du ser java.lang.OutOfMemoryError i ERDDAP™ 's log.txt fil, se OutOfMemory feil For tips om hvordan du diagnostiserer og løser problemene.  

Tillatelser

chmod +x *.sh

Skrifter

Hvis du velger å ikke bruke DejaVu-skriftene, må du endre fontFamily-innstillingen i config.xml til <fontFamily> SansSerif </fontFamily> , som er tilgjengelig med alle Java Distribusjoner. Hvis du setter <fontFamily> navn på en skrift som ikke er tilgjengelig, ERDDAP™ vil ikke laste og vil skrive ut en liste med tilgjengelige skrifter i log.txt fil. Du må bruke en av disse skriftene.

Hvis du velger å bruke DejaVu-fontene, må du sørge for at <fontFamily> innstilling i oppsett.xml er <fontFamily> DejaVu Sans </fontFamily> ..

Hvis du vil installere DejaVu-skrifter, vennligst last ned DejaVuFonts .zip (5 522 795 bytes, MD(95)33E1E61FAB06A547851ED308B4FFEF42) og fjern fontfilene til en midlertidig mappe.

  • På Linux:
    • For Linux Adoptium Java Fordelinger, se disse instruksjonene ..
    • Med andre Java Fordelinger: Som tomcat bruker, kopiere skriftfilene til $JAVA_HOME/lib/fonts så Java finner skriftene. Husk: Hvis/når du senere oppgraderer til en nyere versjon av Java , må du installere disse skriftene på nytt.
  • På Macs: for hver skrifttypefil, dobbeltklikk på den og klikk deretter Installer Font.
  • På Windows 7 og 10: i Windows Explorer, velg alle skriftfilene. Høyreklikk. Klikk på Installer.  

Test Tomcat

  • Test din Tomcat installasjon.
    • Linux:
    • Mac (kjøre tomcat som systemadministrator bruker) :)
      • Kjør tomcat/bin/startup.sh ..
      • Vis din URL + ":8080/" i nettleseren din (f.eks. http://coastwatch.pfeg.noaa.gov:8080/ ) .. Merk at Tomcat som standard er kun tilgjengelig for deg. Det er ikke offentlig tilgjengelig.
    • Windows localhost:
      • Høyreklikk på Tomcat-ikonet i systembrettet, og velg " Start service".
      • Vis http://127.0.0.1:8080/ Eller kanskje http://localhost:8080/ I nettleseren din. Merk at Tomcat som standard er kun tilgjengelig for deg. Det er ikke offentlig tilgjengelig.

Du bør se Tomcat-Congratulations - siden.

Hvis det er problemer, se Tomcat loggfil på tomcat/logs/catalina.out ..

Problemer med Tomcat installasjon?

  • På Linux og Mac, hvis du ikke kan nå Tomcat eller ERDDAP™ (Eller kanskje kan du bare ikke nå dem fra en datamaskin utenfor brannmuren) , du kan teste om Tomcat lytter til port 8080, ved å skrive (som rot) på en kommandolinje på serveren:

    netstat -tuplen | grep 8080

Dette bør returnere én linje med noe som:

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

(hvor # er noe digitalt) som indikerer at Java prosess (Sannsynligvis Tomcat) Lytter på havnen "8080" for "tcp" trafikk. Hvis ingen linjer ble returnert, hvis linjen returnerte er betydelig forskjellig, eller hvis to eller flere linjer ble returnert, kan det være et problem med portinnstillingene.

  • Se Tomcat-loggfilen tomcat/logs/catalina.out .. Tomcat problemer og noen ERDDAP™ oppstartsproblemer er nesten alltid angitt der. Dette er vanlig når du først setter opp ERDDAP™ ..

  • Se Tomcat nettside eller søk på nettet etter hjelp, men vennligst gi oss beskjed om problemene du hadde og løsningene du fant.

  • Se vår Seksjon om å få ekstra støtte ..  

ERDDAP™ Innhold

  1. Sett opp tomcat/innhold/erddap konfigurasjonsfiler. På Linux, Mac og Windows, last ned erddapContent .zip og zip det inn i tomcat mappe, opprette tomcat/innhold/erddap ..

Versjon 1.0.0, 20333 bytes, MD(2005)2B8D2A5E5ED73E3A42B529C168C60B5, datert 2024-10-14

Noen tidligere versjoner er også tilgjengelige:

  • 2.17 (19.792 bytes, MD(2005)8F892616BAEF2DF0F4B036DCB4AD7C, datert 2022-02-16)
  • 2.18 (19.792 bytes, MD(2005)8F892616BAEF2DF0F4B036DCB4AD7C, datert 2022-02-16)
  • 2.21 (19 810 bytes, MD(2005)1E26F62E7A06191EE6868C40B9A29362, datert 2022-10-09)
  • 2.22 (19.810 bytes, MD(2005)1E26F62E7A06191EE6868C40B9A29362, datert 2022-12-08)
  • 2.23 (19 810 bytes, MD(2005)1E26F62E7A06191EE6868C40B9A29362, datert 2023-02-27)

Andre mapper

For Red Hat Enterprise Linux (RHEL) eller for andre situasjoner der du ikke har lov til å endre Tomcat-katalogen eller hvor du vil / trenger å sette ERDDAP™ innholdskatalog på et annet sted av en annen grunn (Hvis du for eksempel bruker Jetty i stedet for Tomcat) , unzip erddapContent .zip i ønsket katalog (som bare tomcat brukeren har tilgang) og satt erddapContentDirectory system eiendom (f.eks. erddapContentDirectory =~tomcat/content/erddap ) så ERDDAP™ finner denne nye innholdskatalogen.

config.xml

For det første oppsettet må du i det minste endre disse innstillingene:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> innstillinger
  • <admin...> innstillinger
  • <baseHttpsUrl> (Når du setter opp https )

Når du oppretter bigParentDirectory, fra foreldrekatalogen til bigParentDirectory:

  • Gjøre tomcat bruker eieren av bigParentDirectory :)
    chown -R tomcat bigParentDirectory
  • Endregroupgruppen" for å være tomcat, brukernavn eller navnet på en liten gruppe som inkluderer tomcat og alle administratorer av Tomcat/ ERDDAP :)
    chgrp -R yourUserName bigParentDirectory
  • Endre tillatelser slik at tomcat og gruppen har lest, skrevet, utført privilegier:
    chmod -R ug+rwx bigParentDirectory
  • Fjern andres tillatelser til å lese, skrive eller utføre. Dette er viktig for å unngå å lese eventuelt sensitiv informasjon i ERDDAP™ Logge filer og filer med informasjon om private datasett.
    chmod -R o-rwx bigParentDirectory

Miljøvariabler

Begynner med ERDDAP™ v2.13, ERDDAP™ administratorer kan overstyre alle verdier i config.xml ved å angi en miljøvariabel navngitt ERDDAP _Verdinavn Før du kjører ERDDAP™ .. For eksempel bruk ERDDAP _BaseUrl Overstyrer <baseUrl> Værdi. Dette kan være praktisk ved utplassering ERDDAP™ med en beholder som Docker, som du kan sette standardinnstillinger i setup.xml og deretter gi spesielle innstillinger via miljøvariabler. Hvis du gir hemmelig informasjon til ERDDAP™ gjennom denne metoden, Pass på å sjekke at informasjonen vil forbli hemmelig. ERDDAP™ Leser bare miljøvariabler en gang per oppstart, i første sekund av oppstart, så en måte å bruke dette på er: sett miljøvariabler, start ERDDAP , Vent til ERDDAP™ er i gang, og deretter uroe miljøvariabler.

datasets.xml

  • Les kommentarene i Arbeide med datasets.xml Fil .. Senere, etter du får ERDDAP™ kjører For første gang (vanligvis med bare standard datasett) , vil du endre XML i tomcat/innhold/erddap/ datasets.xml for å angi alle datasettene du vil ha ERDDAP™ å tjene. Det er her du vil tilbringe mesteparten av din tid mens du konfigurerer ERDDAP™ og senere mens du opprettholder din ERDDAP™ ..

Du kan se et eksempel datasets.xml på GitHub ..  

  • (Ulikt) Nå eller (Litt mer sannsynlig) i fremtiden, hvis du vil endre Erddaps CSS-fil, kopier tomcat/innhold/erddap/bilder/erddapStart2.css til tomcat/innhold/erddap/bilder/erddap2.css og deretter gjøre endringer i det. Endringer til erddap2.css Bare tre i kraft når ERDDAP™ er omstartet og krever ofte også at brukeren fjerner nettleserens cachede filer.   ERDDAP™ vil ikke fungere riktig hvis config.xml eller datasets.xml filen er ikke en velformet XML-fil. Så etter at du har redigert disse filene, det er en god ide å bekrefte at resultatet er velformet XML ved å lime XML-teksten inn i en XML-sjekker som xmlvalidering ..  

Installer erddap. krigsfil

  1. På Linux, Mac og Windows _ Last ned Erddap.war _inn i tomcat/webapps :)

_Versjon 2.28.1, 622.676.238 bytes, MD(2005)48b426045f950c8a8d69ef9521b9bc9, datert 2025-09-05

.war-filen er stor fordi den inneholder høy oppløsning kystlinje, grenser og høydedata som trengs for å opprette kart.

Noen tidligere versjoner er også tilgjengelige.

  • 2.17 (068,245 bytes, MD(2005)5FEA912B5D42E50EAB9591F773EA848D, datert 2022-02-16)
  • 2.18 (069,844 bytes, MD(35)461325E97E7577EC671DD50246CCFB8B, datert 2022-02-23)
  • 2.21 (568,644,411 bytes, MD(2005)F2CFF805893146E932E498FDDBD519B6, datet 2022-10-09)
  • 2.22 (567.742.765 bytes, MD(2005)2B33354F633294213AE2AFDDCF4DA6D0, datert 2022-12-08)
  • 2.23 (572,124,953 bytes, MD(2005)D843A043C506725EBD6F8EFDCCA8FD5F, dateret 2023-03-03)
  • 2.24 (568.748.187 bytes, MD(2005)970fbee172e28b0b8a07756eecbc898e, datert 2024-06-07)
  • 2.25 (592,292,039 bytes, MD(2005)652AFC9D1421F00B5F789DA2C4732D4C, datert 2024-11-07)
  • 2.26 (607.404.032 bytes, MD(2005)99a725108b37708e5420986c1616a119, datert 2025-03-31)
  • 2.27.0 (620,554,403 bytes, MD(2005)3b2086c659eee4145ca2dff447bf4ef7, datert 2025-06-11)

Konfigurer proxy (bruksspesifikk)

ERDDAP™ er vanligvis plassert bak en webserver omvendt proxy for å tillate det å betjenes på standard HTTP-porter (80 og 443) .. SSL/TLS-avslutting er ofte hevet på webserverens proxylag. Spesifikasjonene avhenger av kravene til hver utplassering.

Apache

  1. Sørg for at mod_proxy og mod_proxy_ http er lastet:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Endre eksisterende <VirtualHost> Merke (Hvis det finnes en) , eller legg til en på slutten av filen:
<VirtualHost *:80>
ServerName YourDomain.org
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /erddap http://localhost:8080/erddap
ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Hvis ERDDAP™ er på andre veier enn /erddap , også satt X-Forwarded-prefix overskrift til banesegment før /erddap .. Denne innstillingen vil være egnet for en ERDDAP™ servert på /subpath/erddap :)

RequestHeader set X-Forwarded-Prefix /subpath
  1. Start Apache på nytt: /usr/sbin/apachectl -K graciøs (Men noen ganger er det i en annen katalog) ..  

NGINX

I konfigurasjonsfilen for nginx angir du disse overskriftene:

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;

Hvis ERDDAP™ er på andre veier enn /erddap , også satt X-Forwarded-prefix overskrift til banesegment før /erddap .. Denne innstillingen vil være egnet for en ERDDAP™ servert på /subpath/erddap :)

proxy_set_header X-Forwarded-Prefix /subpath

For å få NGINX og ERDDAP™ fungerer riktig med https , må du sette følgende snutt inne i Tomcat server.xml <Host> blokk:

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

 

Start Tomcat

  • (Jeg anbefaler ikke å bruke Tomcat Web Application Manager. Hvis du ikke helt stenger og starter Tomcat, vil du tidligere eller senere ha problemer med minneproblemene i PermGen.)
  • (I Linux eller Mac OS, hvis du har opprettet en spesiell bruker å kjøre Tomcat, for eksempel tomcat, huske å gjøre følgende trinn som den brukeren.)
  • Hvis Tomcat allerede kjører, steng Tomcat med (i Linux eller Mac OS) tomcat/bin/shutdown.sh eller (i Windows) tomcat-bin shutdown.bat

På Linux, bruk ps-ef | grep tomcat Før og etter Nedleggelse. sh For å sikre at tomcat prosessen har stoppet. Prosessen bør listes opp før avslutningen og til slutt ikke oppført etter avslutningen. Det kan ta et minutt eller to for ERDDAP™ Fullstendig lukket ned. Vær tålmodig. Eller hvis det ser ut som det ikke vil stoppe på egen hånd, bruk: kill -9 <processID>

  • Start Tomcat med (i Linux eller Mac OS) tomcat/bin/startup.sh eller (i Windows) Tomcat\bin\\startup.bat

Er ERDDAP™ Løper?

Bruk en nettleser til å prøve å visehttp://www.YourServer.org/erddap/status.html. ERDDAP™ starter uten datasett. Datasett er lastet i en bakgrunnstråd og så bli tilgjengelig en for én.

Feilsøking

  • Når en forespørsel fra en bruker kommer inn, går det til Apache (på Linux og Mac OS datamaskiner) Så Tomcat, så ERDDAP™ ..
  • Du kan se hva som kommer til Apache (relaterte feil) i Apache loggfiler.
  • Du Se hva som kommer til Tomcat (relaterte feil) i Tomcat loggfiler ( tomcat/logs/catalina.out og andre filer i denne katalogen) ..
  • Du kan se hva som kommer til ERDDAP , diagnostiske meldinger fra ERDDAP , og feilmeldinger fra ERDDAP i ERDDAP™ <bigParentDirectory> /logg/log.txt fil.
  • Tomcat starter ikke ERDDAP™ til Tomcat får en forespørsel ERDDAP™ .. Så du kan se i Tomcat-loggfiler hvis det Startet ERDDAP™ eller hvis det er en feilmelding knyttet til dette forsøket.
  • Når ERDDAP™ Begynner å omdøpe det gamle ERDDAP™ log.txt-fil ( loggArchivedAt <CurrentTime> .txt ) og oppretter en ny log.txt-fil. Hvis log.txt fil er gammel, det er et tegn på at ERDDAP™ Har ikke nylig startet på nytt. ERDDAP™ skriver logginformasjon til en buffer og bare skriver bufferen til loggfilen periodisk, men du kan tvinge ERDDAP™ å skrive bufferen til loggfilen ved å besøke /erddap/status.html ..

Problem: Gamle versjon av Java

Hvis du bruker en versjon av Java Det er for gammelt til ERDDAP , ERDDAP™ vil ikke kjøre, og du vil se en feilmelding i Tomcats loggfil som

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

Løsningen er å oppdatere den siste versjonen av Java Pass på at Tomcat bruker det.

Problem: Treg oppstart første gang

Tomcat må gjøre mye arbeid første gang en søknad som ERDDAP™ er i gang; spesielt må den pakke ut Erddap.war fil (som er som en .zip fil) .. På noen servere, det første forsøket på å vise ERDDAP™ boder (30 sekunder?) til dette arbeidet er ferdig. På andre servere vil det første forsøket mislykkes umiddelbart. Men hvis du venter 30 sekunder og prøver igjen, vil det lykkes hvis ERDDAP™ ble installert riktig.

Det er ingen løsning på dette. Slik fungerer Tomcat. Men det skjer bare første gang etter at du installerer en ny versjon av ERDDAP™ ..

Slå av og på nytt

I fremtiden, å stenge ned (og omstart) ERDDAP™ Se Hvordan slå ned og starte Tomcat på nytt og ERDDAP ..

Problemer?

Problemer med å installere Tomcat eller ERDDAP™ ? Se vår Seksjon om å få ekstra støtte ..

E-postvarsel om nye versjoner av ERDDAP

Hvis du vil motta en e-post når en ny versjon av ERDDAP™ er tilgjengelig eller annen viktig ERDDAP™ kunngjøringer, Du kan bli med i ERDDAP™ annonseringsliste her .. Denne listen gjennomsnitt omtrent én e-post hver tredje måned.

Tilpass

  • Tilpass din ERDDAP™ å markere organisasjonen din (ikke NOAA ERD ) ..
  • Endre banneren som vises øverst på alle ERDDAP™ .html sider ved å redigere <startBodyHtml5> Tagge i din datasets.xml fil. (Hvis det ikke er én, kopier standard fra ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml fil i datasets.xml og rediger det.) For eksempel kan du:
    • Bruk et annet bilde (Det vil si organisasjonens logo) ..
    • Endre bakgrunnsfarge.
    • Endre " ERDDAP™ " til "YourOrganization ERDDAP™ "
    • Endre " lettere tilgang til vitenskapelige data" til " lettere tilgang til _YourOrganization_s data".
    • Endre "Brought til deg ved" koblinger for å være koblinger til organisasjonen og finansieringskildene.
  • Endre informasjonen på venstre side av hjemmesiden ved å redigere <theShortDescriptionHtml> Tagge i din datasets.xml fil. (Hvis det ikke er én, kopier standard fra ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml fil i datasets.xml og rediger det.) For eksempel kan du:
    • Beskriv hva din organisasjon og/eller gruppe gjør.
    • Beskriv hva slags data dette ERDDAP™ Det har det.
    • Hvis du vil endre ikonet som vises på nettleserfanene, setter du organisasjonens favicon. ico i tomcat/innhold/erddap/bilder/ .. Sehttps://en.wikipedia.org/wiki/Favicon.