Hopp til hovedinnhold

Installer

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

ERDDAP™ kan kjøres på enhver server som støtter Java og Tomcat (og andre programmer servere 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 Kombinere vi gir enkle måter å konfigurere ssl og overvåking, lese mer ut 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 for offentlig ERDDAP™ Utdelinger. Running 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 Logg.txt fil som "Ukan ikke slette ..."), endre innstillingene til antivirusprogramvaren kan delvis lindre problemet. Eller vurdere å bruke Linux eller Mac-server i stedet.

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

  1. Pass på at alle avhengigheter er installert. På ikke-Windows maskiner (Linux og Mac) Du trenger csh.

Java​

  1. For ERDDAP™ v2.29.0+, sett opp Java 25. Av sikkerhetsgrunner er det nesten alltid best å bruke den nyeste versjonen av Java 25. Last ned og installer den nyeste versjonen av Adoptiums OpenJDK (Temurin) 25 (LTS) .. For å bekrefte installasjonen, kjør /javaJreBinDirectory/java -versjon For eksempel /usr/local/jdk-25.0.1+8/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 25 som tilbyr langsiktig støtte (gratis oppgraderinger i mange år tidligere den første utgivelsen) .. Av sikkerhetsgrunner, vennligst oppdater din ERDDAP versjon av Java periodisk som nye versjoner av Java 25 blir tilgjengelig fra Adoptium.

    ERDDAP™ er blitt testet og brukt mye med 25, 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 den 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 25 eller nyere. Nedenfor vil Tomcat-katalogen bli omtalt som tomcat ..

Varsler!__ Hvis du allerede har en Tomcat som kjører noe annet webprogram (Spesielt tredder) , anbefaler vi 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 "Core" "tar .gz " Tomcat-distribusjon og pakke den ut. Vi anbefaler å pakke det ut i /usr/lokal ..
  • På en Mac er Tomcat sannsynligvis allerede installert i /Library/Tomcat , men bør oppdatere det til den siste versjonen av Tomcat 10. Hvis du laster det ned, Last ned "Core" "tar .gz " Tomcat-distribusjon og pakke den i /Library/Tomcat ..
  • På Windows kan du Last ned "Core" "zip" Tomcat-distribusjonen (som ikke forstyrrer 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-bit Windows zip"-distribusjonen, som inkluderer flere funksjoner. Hvis distribusjonen er en Windows installatør, vil den sannsynligvis legge Tomcat i for eksempel, /Programfiler/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 til &lt;Connector port="8080" En for &lt;Kontorport=-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 brukere til prosent-kode disse tegnene når de forekommer i parametrene til en brukers forespørsel URL.  

content.xml​

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

Dette unngår mange advarsler i catalina. Det hele starter med

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

 

Apache Tidsgrense​

  • På Linux-datamaskiner endre innstillingene for tidsavbrudd for Apache slik at tidskrævende brukerforespørsler ikke vil bli avgrenset (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 Tomcat installasjon, spesielt for offentlige servere.  
  • For offentlig ERDDAP™ installasjoner på Linux og Macs, er det 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 på serveren din 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 superbrukerpassordet om 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™ installasjonsinstruksjoner som bruker tomcat .. Senere, løp startup.sh og Nedlegg. sh skript som bruker tomcat slik at Tomcat har tillatelse til å skrive til sine loggfiler.
      • Etter å ha pakket ut Tomcat, fra foreldrene til apache-tomcat mappe:
        • Endre eierskapet til apache-tomcat katalogtre til tomcat brukeren. 
          chown -R tomcat apache-tomcat-10.0.23
          (men erstatte det faktiske navnet på din tomcat-katalog) ..
        • Endregroupgruppen" til å være tomcat, ditt brukernavn eller navnet på en liten gruppe som inkluderer tomcat og alle administratorene til 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 brukerens 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 eventuelt 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 Nedlegg. sh .. Filen skal inneholde noe som:

    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

    (men 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 Tomcat\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-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"

    (men erstatte mappenavn fra datamaskinen) .. Hvis dette bare er 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 hukommelse. 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 vil fungere så lenge serveren ikke er opptatt. Jo mer fysisk minne i 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 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 Fungerer bare på et 64-biters operativsystem.

    • Med Java 8 du må legge til -d64 til Tomcat CATALINA_OPTS parameter i setenv.bat ..
    • Med Java 21 velger du 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 å søke etter - bit, - i ERDDAP Daglig rapport e-post eller i bigParentDirectory/logs/ [Logg.txt](/docs/server-admin/additional-information#log) fil ( bigParentDirectory er angitt i setup.xml ) ..

Garbage samling​

  • I ERDDAP™ 's Logg.txt fil, vil du se mange "GC (Tildelingsfeil) " meldinger. Dette er vanligvis ikke et problem. Det er en hyppig melding 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 nært 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 hukommelse, sliter med å frigjøre minnet, og er ikke i stand til å frigjøre minnet. Dette kan skje under en stressende tid, deretter gå bort. Men hvis det fortsetter, er det et tegn på problemer.
  • Hvis du ser java.lang.OutOfMemoryError i ERDDAP™ 's Logg.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-fontene, må du endre fontFamily-innstillingen i config.xml til <fontFamily> SansSerif </fontFamily> , som er tilgjengelig med alle Java Fordelinger. Hvis du setter <fontFamily> til navnet på en skrift som ikke er tilgjengelig, ERDDAP™ vil ikke laste og vil skrive ut en liste over tilgjengelige fonter i Logg.txt fil. Du må bruke en av disse skriftene.

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

Hvis du vil installere DejaVu skrifttyper, vennligst last ned DejaVuFonts .zip (5.522.795 bytes, MD(2005)33E1E61FAB06A547851ED308B4FFEF42) og fjerne 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 Du må 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 velger du alle skriftfilene. Høyreklikk. Klikk på Installer.  

Test Tomcat​

  • Test Tomcat-installasjonen.
    • Linux:
    • Mac (kjører 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 tjeneste".
      • 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 du bare ikke kan nå dem fra en datamaskin utenfor brannmuren din) , du kan teste hvis Tomcat lytter til port 8080, ved å skrive (som rot) på en kommandolinje på serveren:

    netstat -tuplen | grep 8080

Dette må returnere én linje med noe som:

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

(hvor # er noe siffer) som indikerer at Java prosess (Sannsynligvis Tomcat) Lytter på havnen "8080" for "tcp" trafikk. Hvis ingen linjer ble returnert, hvis linjen returnert er betydelig annerledes, 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 konfigurerer 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 slupp det ut i tomcat mappe, opprette tomcat/innhold/erddap ..

Versjon 1.0.1, 20683 bytes, MD(2005)98a8099e7e674da59fe35e9c96efa7b5, datert 2025-06-02

Noen tidligere versjoner er også tilgjengelige:

  • 2.17 (19.792 bytes, MD(2005)8F892616BAEF2DF0F4B036DCB4AD7C, dateret 2022-02-16)
  • 2.18 (19.792 bytes, MD(2005)8F892616BAEF2DF0F4B036DCB4AD7C, dateret 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 sette erddapContentDirectory system eiendom (f.eks. erddapContentDirectory =~tomcat/content/erddap ) så ERDDAP™ finner denne nye innholdskatalogen.

setup.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 brukeren eier av bigParentDirectory :) 
    chown -R tomcat bigParentDirectory
  • Endregroupgruppen" til å være tomcat, ditt brukernavn eller navnet på en liten gruppe som inkluderer tomcat og alle administratorene til 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 brukerens tillatelser til å lese, skrive eller kjøre. Dette er viktig for å unngå å lese mulig 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 å spesifisere en miljøvariabel navngitt ERDDAP _verdinavn Før du kjører ERDDAP™ .. For eksempel bruk ERDDAP _BaseUrl Overskrider <baseUrl> Værdi. Dette kan være praktisk når du distribuerer 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™ via denne metoden, Pass på at informasjonen forblir hemmelig. ERDDAP™ Leser bare miljøvariabler en gang per oppstart, i første sekund av oppstart, så en måte å bruke dette på er: angi miljøvariabler, start ERDDAP , Vent til ERDDAP™ er i gang, og så er det ikke noe 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 å 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 holder 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 i erddap2.css Bare tre i kraft når ERDDAP™ er omstartet og krever ofte også at brukeren å rydde 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 å verifisere 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 _I tomcat/webapps :)

Versjon 2.30.0, 706.939,130 bytes, MD(2005)CDC4B3D82A20B33A6623B85312F6DC21, datert 2026-04-06

.war-filen er stor fordi den inneholder høy oppløsning kystlinje, grense 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(2005)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, datert 2023-03-03)
  • 2.24 (568.748.187 bytes, MD(2005)970fbee172e28b0b8a07756eecbc898e, datert 2024-06-07)
  • 2.25 (592,292,039 bytes, MD(95)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)
  • 2.28.1 (622 676 238 bytes, MD(2005)48b4226045f950c8a8d69ef9521b9bc9, datert 2025-09-05)
  • 2.29.0 (706.788.135 bytes, MD(2005)A5ED0DCC8D46CA26640F [30]8CE4A8560, datert 2025-12-15)

Set opp proxy (bruksspesifikk)​

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

Apache​

  1. Pass på 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 er 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å en annen vei enn /erddap , også satt X-videresendt-prefix overskrift til banesegment før /erddap .. Denne innstillingen vil være egnet for en ERDDAP™ serveres 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 følgende overskrifter:

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å en annen vei enn /erddap , også satt X-videresendt-prefix overskrift til banesegment før /erddap .. Denne innstillingen vil være egnet for en ERDDAP™ serveres 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 i Tomcat serveren.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 for å 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 Nedlegg. sh For å sikre at tomcat prosessen har stoppet. Prosessen bør være oppført før avslutningen og til slutt ikke oppført etter avslutningen. Det kan ta et minutt eller to ERDDAP™ å stenge helt. 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 å vise http://www.YourServer.org/erddap/status.html.

ERDDAP™ starter uten datasett. Datasett lastes i en bakgrunnstråd og blir dermed tilgjengelige én 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 (og relaterte feil) i Apache loggfiler.
  • Du Se hva som kommer til Tomcat (og relaterte feil) i Tomcat loggfiler ( tomcat/logs/catalina.out og andre filer i den katalogen) ..
  • Du Kan se hva som kommer til ERDDAP diagnostiske meldinger fra ERDDAP , og feilmeldinger fra ERDDAP I ERDDAP™ <bigParentDirectory> /logs/log.txt fil.
  • Tomcat starter ikke ERDDAP™ til Tomcat får forespørsel om ERDDAP™ .. Så du kan se i Tomcat loggfiler hvis det Startet ERDDAP™ eller hvis det er en feilmelding relatert til dette forsøket.
  • Når ERDDAP™ starter opp, den omdøper den gamle ERDDAP™ log.txt-fil ( loggArchivedAt <CurrentTime> .txt ) og oppretter en ny log.txt-fil. Hvis Logg.txt Filen er gammel, det er et tegn på at ERDDAP™ Har ikke nylig startet på nytt. ERDDAP™ Skriv logginformasjon til en buffer og bare skriver bufferen til loggfilen regelmessig, 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 Og sørg for 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 startet; spesielt det må pakke ut Erddap.war fil (som er som en .zip fil) .. På noen servere, det første forsøket på å vise ERDDAP™ stall (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å​

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> Tagg 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" lenker til å være koblinger til organisasjonen din og finansieringskildene.
  • Endre informasjonen på venstre side av forsiden ved å redigere <theShortDescriptionHtml> Tagg 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 hvilken type data dette ERDDAP™ Det har jeg.
    • Hvis du vil endre ikonet som vises på nettleserfanene, legger du organisasjonens favicon. ico i tomcat/innhold/erddap/bilder/ .. Se https://en.wikipedia.org/wiki/Favicon.