Gå til hovedindholdet

Installer installation

Sådan gør du den første opsætning af ERDDAP™ på din server

ERDDAP™ kan køre på enhver server, der understøtter Java og Tomcat (og andre applikationsservere som Jetty, men vi understøtter ikke dem) . ERDDAP™ er blevet testet på Linux (herunder på Amazon's AWS) , Mac og Windows-computere.

  • Docker -- Vi leverer ERDDAP™ i en Docker-container og IOOS tilbyder nu et tilbud Hurtig startguide til ERDDAP™ i en Docker Container . Det er standarden ERDDAP™ installation, i en Docker beholder. Gennem Docker Vi tilbyder nemme måder at opsætte ssl og overvåge, læse mere på Docker dokumentation . Hvis du allerede bruger Docker, vil du sandsynligvis foretrække Docker-versionen. Hvis du leder efter at køre på cloud-tjenester, vil du sandsynligvis foretrække Docker-versionen.
  • Amazon Amazon -- Hvis du installerer ERDDAP™ på en Amazon Web Services EC2-instans, se dette Oversigt over Amazon Web Services først.
  • Linux og Macs -- ERDDAP™ virker fantastisk på Linux og Mac-computere. Se vejledningen nedenfor.
  • Windows Windows Windows -- Windows er fint til test ERDDAP™ og til personlig brug (Se vejledningen nedenfor) , men vi anbefaler ikke at bruge det til offentligheden ERDDAP™ implementeringer. Løb ERDDAP™ på Windows kan have problemer: særligt, ERDDAP™ kan ikke slette og/eller omdøbe filer hurtigt. Dette skyldes sandsynligvis antivirus software (f.eks. fra McAfee og Norton) som kontrollerer filerne til virus. Hvis du kører ind i dette problem (som kan ses af fejlmeddelelser i log.txt fil lignende "Tilgængelig for at slette ..."), ændring af antivirussoftwarens indstillinger kan delvist lindre problemet. Eller overveje at bruge en Linux- eller Mac-server i stedet.

Standard ERDDAP™ installationsinstruktioner for Linux, Macs og Windows-computere er:

  1. Sørg for, at eventuelle afhængigheder er installeret. På ikke-Windows maskiner (Linux og Mac) , du behøver csh.

Java

  1. For For For For For ERDDAP™ v2.19+, sæt op Java 21. marts Af sikkerhedsmæssige årsager er det næsten altid bedst at bruge den nyeste version af Java 21. marts Download og installer den nyeste version af Adoptiums OpenJDK (Temurin) 21:21 (LTS) . For at kontrollere installationen, køre /javaJreBinDirectory/java -version f.eks. /usr/local/jdk-21.0.3+9/jre/bin/java -version .

    ERDDAP™ arbejder med Java fra andre kilder, men vi anbefaler Adoptium, fordi det er den vigtigste, fællesskabsstøttet, Gratis gratis (som i øl og tale) version af Java 21 der tilbyder Long Term Support (gratis opgraderinger i mange år tidligere den første udgivelse) . Af sikkerhedsmæssige årsager, bedes du opdatere din ERDDAP 's version af Java periodisk som nye versioner af Java 21 bliver tilgængelig fra Adoptium.

    ERDDAP™ er blevet testet og brugt i vid udstrækning med 21, ikke andre versioner. Af forskellige grunde tester vi ikke med eller understøtter andre versioner af Java .  

Tomcat

  1. Opsæt op Tomcat . Tomcat er den mest udbredte Java Ansøgningsserver, som er Java software, der står mellem operativsystemets netværkstjenester og Java serversoftware som ERDDAP™ . Det er gratis og Open Source software (FOSS) .

Du kan bruge en anden Java Ansøgning Server (f.eks. Jetty) , men vi tester kun med og støtte Tomcat.

  • Hent Tomcat og udpakning det på din server eller pc. Af sikkerhedsmæssige årsager er det næsten altid bedst at bruge den nyeste version af Tomcat 10 (version 9 og nedenfor er ikke acceptabel) som er designet til at arbejde med Java 21 eller nyere. Nedenfor vil Tomcat-mappen blive henvist til som Tomcat .

Warning! Hvis du allerede har en Tomcat, der kører nogle andre webapplikationer (særligt særligt) , vi anbefaler, at du installerer ERDDAP™ i in in in in Et andet Tomcat , fordi ERDDAP™ behov for forskellige Tomcat indstillinger og bør ikke konkurrere med andre programmer til hukommelse.

  • På Linux, Download "Core" "tar .gz " Tomcat distribution og udpakning det. Vi anbefaler at pakke det i /usr/lokal .
  • På en Mac, Tomcat er sandsynligvis allerede installeret i /Library/Tomcat , men skal opdatere det til den nyeste version af Tomcat 10. Hvis du downloader det, Download "Core" "tar .gz " Tomcat distribution og udpakning det i /Library/Tomcat .
  • På Windows, kan du Download "Core" "zip" Tomcat distribution (som ikke roder med Windows-registreringsdatabasen, og som du styrer fra en DOS-kommandolinje) og udpakning det i en passende mappe. (Til udvikling bruger vi "Core" "zip" distribution. Vi laver en / programmer mappe og pakke det der.) Eller du kan downloade "Core" "64-bit Windows zip" distribution, som indeholder flere funktioner. Hvis distributionen er en Windows-installation, vil den sandsynligvis sætte Tomcat i, for eksempel, /Program Files/apache-tomcat-10.0.23 .  

server.xml

  • server.xml - I te tomcat/conf/server.xml fil, der er to ændringer, du skal foretage for hver af de to <Connector> tags (en til en &lt;Connector port Scope8080" og en til &lt;Conector port Hanging8443" ) .
    1. (Anbefalet anbefalet) Forøgelse af Tilslutningstilslutning Timeout parameterværdi, måske til 300000 (millisekunder, som er 5 minutter) .
    2. (Anbefalet anbefalet) Tilføj en ny parameter: Tilbage til kortet[] | " " " " . Dette er valgfrit og lidt mindre sikker, Men fjerner behovet for brugere til procentkode disse tegn, når de forekommer i parametrene for en brugerkonto.  

indhold.xml

  • kontekst.xml -- Ressourcer cache - I tomcat/conf/context.xml , lige før det </Context> Mærke, ændre Ressourcer tag (eller tilføje det, hvis det ikke allerede er der) for at indstille cachen MaxSize parameter til 80000:
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Dette undgår mange advarsler i katalina. ud af, at alle starter med

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

 

Apache Timeout

  • På Linux-computere skal du ændre indstillingerne for Apache timeout, så tidskrævende brugeranmodninger ikke timeout (med hvad der ofte vises som en "Proxy" eller "Bad Gateway" fejl) . Som root-brugeren:
    • Rediger Apache http d.conf filfil (normalt i /etc / http d/konference/ ) :
      • Ændre de eksisterende <Timeout> indstilling af indstilling (eller tilføje en i slutningen af filen) til 3600 (sekunder sekunder) , i stedet for standard 60 eller 120 sekunder.
      • Ændre de eksisterende <ProxyTimeout> indstilling af indstilling (eller tilføje en i slutningen af filen) til 3600 (sekunder sekunder) , i stedet for standard 60 eller 120 sekunder.
    • Genstart Apache: /usr/sbin/apachectl -k yndefuld (Men nogle gange er det i en anden mappe) .

Sikkerhed for sikkerhed

 

  • Sikkerheds anbefaling: Se endnu disse instruktioner for at øge sikkerheden af Din Tomcat installation, især for offentlige servere.  
  • Til offentligheden ERDDAP™ installationer på Linux og Macs, det er bedst at opsætte Tomcat (programmet) som tilhører brugeren Tomcat (en separat bruger med begrænsede tilladelser og hvilke Ingen adgangskode ) . Således kan kun superbrugeren skifte til at handle som bruger Tomcat . Dette gør det umuligt for hackere at logge ind på din server som bruger Tomcat . Og i alle tilfælde skal du gøre det så Tomcat Brugeren har meget begrænsede tilladelser på serverens filsystem (læs+writing + eksekverbare privilegier for te apache-tomcat mappetræ og <bigParentDirectory> og læs kun rettigheder til mapper med data, der ERDDAP™ behov for adgang til).
    • Du kan oprette dig Tomcat brugerkonto (som ikke har nogen adgangskode) ved at bruge kommandoen:
      sudo useradd tomcat -s /bin/bash -p '*'
    • Du kan skifte til at arbejde som bruger Tomcat ved at bruge kommandoen
      sudo su - tomcat
      (Det vil bede dig om superbruger adgangskode for tilladelse til at gøre dette.)
      • Du kan stoppe med at arbejde som bruger tomcat ved at bruge kommandoen
      exit
      • De fleste af resten af Tomcat og ERDDAP™ setup instruktioner som bruger Tomcat . Senere, køre den opstart.sh og og og nedlukning. sh sh scripts som bruger Tomcat så Tomcat har tilladelse til at skrive til sine log filer.
      • Efter at have pakket Tomcat, fra forælderen af apache-tomcat Katalog:
        • Ændre ejerskab af apache-tomcat-mappens træ til brugeren.
          chown -R tomcat apache-tomcat-10.0.23
          (men erstatte det faktiske navn på din tomcat mappe) .
        • Ændre "gruppen" for at være tomcat, dit brugernavn eller navnet på en lille gruppe, der indeholder tomcat og alle administratorer af Tomcat/ ERDDAP :
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Ændre tilladelser, så tomcat og gruppen har læst, skrive, udføre privilegier:
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Fjern "andre" brugerens tilladelser til at læse, skrive eller udføre:
          chmod -R o-rwx apache-tomcat-10.0.23

Dette er vigtigt, fordi det forhindrer andre brugere i at læse muligvis følsomme oplysninger i ERDDAP™ Opsætning af filer.

Hukommelseshukommelse

Sæt Tomcats miljøvariabler

  • På Linux og Macs: Opret en fil tomcat/bin/setenv.sh (eller i Red Hat Enterprise Linux \[ RHEL \] , redigere ~tomcat/conf/tomcat10.conf ) at indstille Tomcats miljøvariabler. Denne fil vil blive brugt af tomcat/bin/startup.sh og og og nedlukning. sh sh . Filen skal indeholde noget 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

    (men erstatning af mappenavne fra din computer) . (Hvis du tidligere har indstillet JRE_HOME , du kan fjerne det.) På Macs, behøver du sandsynligvis ikke at indstille JAVA_HOME .

  • På Windows: Opret en fil Tomcat\bin\\setenv.bat at indstille Tomcats miljøvariabler. Denne fil vil blive brugt af tomcat\bin\\startup.bat og og og shutdown.bat . Filen skal indeholde noget 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"

    (men erstatning af mappenavne fra din computer) . Hvis dette kun er for lokal test, skal du fjerne "-server". (Hvis du tidligere har indstillet JRE_HOME , du kan fjerne det.)

The The The The The The The -Xmx og og og -Xms hukommelsesindstillinger er vigtige, fordi ERDDAP™ virker bedre med mere hukommelse. Altid indstillet -Xms til samme værdi som -Xmx .

  • Til 32 bit operativsystemer og 32 bit Java : 64 bit Java er meget bedre end 32 bit Java , men 32 bit Java vil arbejde så længe serveren ikke er virkelig optaget. Jo mere fysisk hukommelse i serveren jo bedre: 4+ GB er virkelig god, 2 GB er okay, mindre anbefales ikke. Med 32 bit Java , selv med rigelig fysisk hukommelse, Tomcat og Java Kør ikke, hvis du forsøger at indstille -Xmx langt over 1500M (1200M på nogle computere) . Hvis din server har mindre end 2 GB hukommelse, skal du reducere hukommelsen -Xmx værdiværdiværdiværdi (i 'M'egaBytes) til 1/2 af computerens fysiske hukommelse.

  • Til 64 bit Betjeningssystemer og 64 bit Java : 64 bit Java vil kun arbejde på et 64 bit operativsystem.

    • Med Java 8, du skal tilføje -d64 til Tomcat CATALINA_OPTS parameter i Setenv.bat .
    • Med Java 21, du vælger 64 bit Java når du downloader en version af Java markeret "64 bit".

Med 64 bit Java , Tomcat og Java kan bruge meget høj -Xmx og og og -Xms Indstillinger. Jo mere fysisk hukommelse i serveren jo bedre. Som et forenklet forslag: Vi anbefaler, at du indstiller -Xmx og og og -Xms til at til (i 'M'egaBytes) til 1/2 (eller mindre) af computerens fysiske hukommelse. Du kan se, om Tomcat, Java , og ERDDAP™ kører faktisk i 64 bit mode ved at søge efter " bit", i ERDDAP 's Daily Report e-mail eller i området bigParentDirectory/logs/logs [log.txt](/docs/server-admin/additional-information#log) filfil ( bigParentDirectory er angivet i opsætning.xml ) .

Billeder af Garbage Collection

  • I nærheden af In In In In In In In In In In In In In In ERDDAP™ 's log.txt fil, vil du se mange "GC (Ombygning Failure) " beskeder. Dette er normalt ikke et problem. Det er en hyppig meddelelse fra en normalt drift Java at sige, at det bare er afsluttet et mindre affald samling, fordi det løb ud af rummet i Eden (Afsnittet i Java hanap for meget unge genstande) . Normalt vises beskeden hukommelseBrug før-&gt;memoryBrug efter . Hvis disse to tal er tæt sammen, betyder det, at affaldsopsamlingen ikke var produktiv. Meddelelsen er kun et tegn på problemer, hvis det er meget hyppig (hvert par sekunder) , ikke produktive, og tallene er store og ikke voksende, som tilsammen angiver, at Java kræver mere hukommelse, kæmper for at frigøre hukommelse, og er ikke i stand til at frigøre hukommelse. Det kan ske under en stressende tid, så gå væk. Men hvis det fortsætter, det er et tegn på problemer.
  • Hvis du ser Klik her for at få flere oplysninger. s i s ERDDAP™ 's log.txt fil, Se se FjerneMemoryFejl for tips om, hvordan du diagnosticerer og løser problemerne.  

Tilladelser

chmod +x *.sh

Skrifttyper

Hvis du vælger ikke at bruge DejaVu-skrifttyper, skal du ændre skriftfamilieindstillingen i opsætning.xml til <fontFamily> I nærheden af SansSerif </fontFamily> , som er tilgængelig med alle Java distributioner. Hvis du indstiller <fontFamily> til navnet på en skrifttype, der ikke er tilgængelig, ERDDAP™ Må ikke indlæse og vil udskrive en liste over tilgængelige skrifttyper på listen log.txt fil. Du skal bruge en af disse skrifttyper.

Hvis du vælger at bruge DejaVu-skrifttyperne, skal du sørge for, at <fontFamily> konfiguration.xml er <fontFamily> Flyrejser til Sans </fontFamily> .

For at installere DejaVu-skrifttyper, skal du downloade DejaVuFonts .zip (5,522,795 bytes, MD5=33E1E61FAB06A547851ED308B4FFEF42) og indpakke skriftfilerne til en midlertidig mappe.

  • På Linux:
    • Til Linux Adoptium Java distributioner, se disse instruktioner .
    • Med andre Java Fordelinger: Som det Tomcat Bruger, kopiere skriftfilerne til $JAVA_HOME/lib/fonts så så sådan Java kan finde skrifttyperne. Husk: hvis/ når du senere opgraderer til en nyere version af Java , du skal geninstallere disse skrifttyper.
  • På Macs: for hver skriftfil, dobbelt klik på det, og klik derefter på Installer Font.
  • På Windows 7 og 10: I Windows Explorer skal du vælge alle skriftfiler. Højreklik. Klik på Installer.  

Test Tomcat

  • Test din Tomcat installation.
    • Linux:
    • Mac Mac Mac Mac (Kør tomcat som systemadministratorens bruger) :
      • Løb tomcat/bin/startup.sh .
      • Se din URL + ":8080/" i din browser (fx, http://coastwatch.pfeg.noaa.gov:8080/ ) . Bemærk, at din Tomcat som standard kun er tilgængelig af dig. Det er ikke offentligt tilgængeligt.
    • Windows lokalhost:
      • Højreklik på Tomcat-ikonet i systembakken, og vælg "Start service".
      • Udsigt til udsigt http://127.0.0.1:8080/ eller måske http://localhost:8080/ , i din browser. Bemærk, at din Tomcat som standard kun er tilgængelig af dig. Det er ikke offentligt tilgængeligt.

Du skal se Tomcat "Congratulations" side.

Hvis der er problemer, se Tomcat-filen på tomcat/logs/catalina.out .

Problemer med Tomcat installation?

  • På Linux og Mac, hvis du ikke kan nå Tomcat eller ERDDAP™ (eller måske kan du bare ikke nå dem fra en computer uden for din firewall) , Du kan teste, om Tomcat lytter til port 8080 ved at skrive (som rod) på en kommandolinje af serveren:

    netstat -tuplen | grep 8080

Det skal returnere en linje med noget som:

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

(hvor # # # # er nogle digitalisering) , der angiver, at en java procesproces (formodentlig Tomcat) lytter på port "8080" til "tcp" trafik. Hvis der ikke blev returneret linjer, hvis linjen returneres markant anderledes, eller hvis to eller flere linjer blev returneret, kan der være et problem med portindstillingerne.

  • Se filen Tomcat tomcat/logs/catalina.out . Tomcat problemer og nogle ERDDAP™ opstartsproblemer er næsten altid angivet der. Dette er almindeligt, når du først opretter op ERDDAP™ .

  • Se billederne Tomcat hjemmeside eller søg på nettet for at hjælpe, men lad os vide de problemer, du havde, og de løsninger, du fandt.

  • Se vores udvalg sektion om at få ekstra støtte .  

ERDDAP™ Indhold Indhold indhold

  1. Opsæt op af tomcat / indhold / konfigurationsfiler. På Linux, Mac og Windows, download ErddapContent .zip og riv den ind i Tomcat mappe, oprettelse tomcat / indhold / .

Version 1.0.0, 20333 bytes, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, dateret 2024-10-14-14

Nogle tidligere versioner er også tilgængelige:

  • 2.17 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, af 2022-02-16)
  • 2.18 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, af 2022-02-16)
  • 2.21 (19,810 bytes, MD5 =E26F62E7A06191EE6868C40B9A29362, af 2022-10-09)
  • 2.22 (19,810 bytes, MD5 =E26F62E7A06191EE6868C40B9A29362, af 2022-12-08)
  • 2.23 (19,810 bytes, MD5 =E26F62E7A06191EE6868C40B9A29362, dateret 2023-02-27)

Andre mappe

Til Red Hat Enterprise Linux (RHEL) eller for andre situationer, hvor du ikke har tilladelse til at ændre Tomcat-mappen, eller hvor du vil/need at sætte den ERDDAP™ indholdskatalog på en anden grund (for eksempel, hvis du bruger Jetty i stedet for Tomcat) , Uzip ErddapContent .zip i den ønskede mappe (til hvilket kun den Tomcat Brugeren har adgang) og sæt den erddapContentDirectory Systemejendom (f.eks. erddapContentDirectory =~tomcat/content/erddap ) så så sådan ERDDAP™ kan finde denne nye indholdskatalog.

opsætning.xml

For den første opsætning, skal du mindst ændre disse indstillinger:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> Indstillinger for indstillinger
  • <admin...> Indstillinger for indstillinger
  • <baseHttpsUrl> (når du opsætter https )

Når du opretter bigParentDirectory, fra forældremappen af bigParentDirectory:

  • Gør det Tomcat Bruger ejeren af ejeren af bigParentDirectory :
    chown -R tomcat bigParentDirectory
  • Ændre "gruppen" for at være tomcat, dit brugernavn eller navnet på en lille gruppe, der indeholder tomcat og alle administratorer af Tomcat/ ERDDAP :
    chgrp -R yourUserName bigParentDirectory
  • Ændre tilladelser, så tomcat og gruppen har læst, skrive, udføre privilegier:
    chmod -R ug+rwx bigParentDirectory
  • Fjern "andre" brugerens tilladelser til at læse, skrive eller udføre. Dette er vigtigt at forhindre læsning muligvis følsomme oplysninger i in in in in ERDDAP™ log filer og filer med oplysninger om private datasæt.
    chmod -R o-rwx bigParentDirectory

Miljøvariabler

Begyndende med ERDDAP™ v2.13, ERDDAP™ Administratorer kan tilsidesætte enhver værdi i opsætning.xml ved at angive en miljøvariable navngivet navn ERDDAP _værdinavn før løb ERDDAP™ . Brug f.eks. ERDDAP _baseUrl tilsidesætter tilsidesættelsen <baseUrl> værdi. Dette kan være praktisk, når du installerer ERDDAP™ med en beholder som Docker, da du kan sætte standardindstillinger i opsætning.xml og derefter levere særlige indstillinger via miljøvariabler. Hvis du leverer hemmelige oplysninger til ERDDAP™ via denne metode, Sørg for at kontrollere, at oplysningerne forbliver hemmelige. ERDDAP™ kun læser miljøvariabler én gang pr. opstart, i første sekund af opstart, så en måde at bruge dette er: sæt miljøvariabler, start ERDDAP , Vent frem til ERDDAP™ Startes, og sæt derefter miljøvariablerne.

datasets.xml

  • Læs kommentarerne i Arbejde med arbejdet datasets.xml Filen fil . Senere, efter du får ERDDAP™ løbeløb for første gang (Normalt med kun standarddatasæt) , vil du ændre XML i tomcat / indhold / datasets.xml for at angive alle de data, du ønsker, ERDDAP™ at tjene. Dette er, hvor du vil bruge mængden af din tid samtidig med at du indstiller ERDDAP™ og senere samtidig opretholde din ERDDAP™ .

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

  • (I modsætning til) Nu eller nu (lidt mere sandsynligt) i fremtiden, hvis du ønsker at ændre erddap's CSS-fil, kopiere tomcat/content/erddap/images/erddapStart2.css til at til tomcat/content/erddap/images/erddap2.css og derefter foretage ændringer til det. Ændringer til Erddap2.css kun tage virkning, når ERDDAP™ genstartes og kræver ofte også brugeren at rydde browserens cachede filer.   ERDDAP™ virker ikke korrekt, hvis opsætningen.xml eller datasets.xml filen er ikke en veldannet XML-fil. Så efter du har redigeret disse filer, Det er en god ide at bekræfte, at resultatet er veldannet XML ved at indsætte XML-teksten i en XML-tjeker som xmlvalidation .  

Installer æraen. krig fil

  1. På Linux, Mac og Windows, __download Erddap.war __ ind i Tomcat/webapps :

Version 2.28.1, 622,676,238 bytes, MD5=48b4226045f950c8a8d69ef9521b9bc9, dateret 2025-09-05

.war-filen er stor, fordi den indeholder høj opløsning kystlinje, grænse og højdedata, der er nødvendige for at oprette kort.

Nogle tidligere versioner er også tilgængelige.

  • 2.17 (551,068,245 bytes, MD5=5FEA912B5D42E50EAB9591F773EA848D, af 2022-02-16)
  • 2.18 (551,069,844 bytes, MD5=461325E97E7577EC671DD50246CCFB8B, af 2022-02-23)
  • 2.21 (568,644,411 bytes, MD5=F2CFF893146E932E498FDDBD519B6, af 2022-10-09)
  • 2.22 (567,742,765 bytes, MD5=2B33354F633294213AE2AFDDCF4DA6D0, af 2022-12-08)
  • 2.23 (572,124,953 bytes, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, af 2023-03-03-03)
  • 2.24 (568,748,187 bytes, MD5=970fbee172e28b0b8a07756eecbc898e, dateret 2024-06-07)
  • 2.25 (592,292,039 bytes, MD5=652AFC9D1421F00B5F789DA2C4732D4C, af 2024-11-07)
  • 2.26 (607,404,032 bytes, MD5=99a725108b37708e5420986c16a119, dateret 202187-31)
  • 2.27.0 (620,554,403 bytes, MD5=3b2086c659eee4145ca2dff447bf4ef7, dateret 2025-06-11)

Konfigurer proxy (implementering af specifikke)

ERDDAP™ er typisk indsat bag en webserver reverse proxy for at tillade, at den bliver serveret på standard HTTP-porte (80 og 443) . SSL/TLS opsigelse er ofte afdøbt på webserver proxy lag samt. Specifikke afhænger af kravene i hver implementering.

Apache Apache

  1. Sørg for, at Mod_proxy og og og Mod_proxy_ http er indlæst:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Ændre den eksisterende <VirtualHost> tag tag (hvis der er en) , eller tilføj en ved udgangen af 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™ betjenes på en anden vej end /erddap , også sæt den X-Forwarded-Prefix Overskrift til sidehovedet stisegment beDerfor /erddap . Denne indstilling ville være passende for en ERDDAP™ Der serveres morgenmad på cafeen. /subpath/erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Genstart derefter Apache: /usr/sbin/apachectl -k yndefuld (Men nogle gange er det i en anden mappe) .  

NGINX

I nginx config-filen skal du indstille disse 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™ betjenes på en anden vej end /erddap , også sæt den X-Forwarded-Prefix Overskrift til sidehovedet stisegment beDerfor /erddap . Denne indstilling ville være passende for en ERDDAP™ Der serveres morgenmad på cafeen. /subpath/erddap :

proxy_set_header X-Forwarded-Prefix /subpath

For at få NGINX og ERDDAP™ arbejde korrekt med https , du skal sætte følgende uddrag inde i Tomcat-serveren.xml <Host> blok:

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

 

Start Tomcat

  • (Jeg anbefaler ikke at bruge Tomcat Web Application Manager. Hvis du ikke er helt lukket og starter Tomcat, før eller senere vil du have PermGen hukommelse problemer.)
  • (I Linux eller Mac OS, hvis du har oprettet en speciel bruger til at køre Tomcat, f.eks. tomcat, huske at gøre følgende trin som den bruger.)
  • Hvis Tomcat allerede kører, lukkes Tomcat med (i Linux eller Mac OS) tomcat/bin/shutdown.sh eller eller eller (I Windows) I nærheden af tomcat\bin\\ shutdown.bat

På Linux, brug ps -ef | Færk tomcat før og efter nedlukning. sh sh for at sikre, at tomcat-processen er stoppet. Processen skal være opført før nedlukningen og i sidste ende ikke opført efter nedlukningen. Det kan tage et minut eller to til ERDDAP™ til fuldstændig lukket ned. Vær tålmodig. Eller hvis det ser ud, at det ikke stopper på sin egen, brug: drab -9 <processID>

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

Is ERDDAP™ løb?

Brug en browser til at forsøge at sehttp://www.YourServer.org/erddap/status.html. ERDDAP™ starter op uden datasæt indlæst. Datasets er indlæst i en baggrundstråd og bliver tilgængelige en-by-one.

Fejlfinding

  • Når en anmodning fra en bruger kommer i, går det til Apache (på Linux og Mac OS-computere) , så Tomcat, så ERDDAP™ .
  • Du kan se, hvad der kommer til Apache (og relaterede fejl) i Apache log filer.
  • Dig kan se, hvad der kommer til Tomcat (og relaterede fejl) i Tomcat log filer ( tomcat/logs/catalina.out og andre filer i denne mappe) .
  • Dig kan se, hvad der kommer til ERDDAP , diagnostiske meddelelser fra ERDDAP , og fejlmeddelelser fra ERDDAP , i den ERDDAP™ <bigParentDirectory> /logs/log.txt fil.
  • Tomcat starter ikke ERDDAP™ indtil Tomcat får en anmodning om ERDDAP™ . Så du kan se i Tomcat log filer, hvis det er startede ERDDAP™ eller hvis der er en fejlmeddelelse relateret til dette forsøg.
  • Hvornår Hvornår skal man Hvornår ERDDAP™ starter op, det omdøber den gamle ERDDAP™ log.txt-fil ( Log ind <CurrentTime> .txt ) og oprette en ny log.txt-fil. Så hvis det er tilfældet log.txt fil er gammel, det er et tegn på, at ERDDAP™ har ikke for nylig genstartet. ERDDAP™ Skriv logoplysninger til en buffer og skriver kun bufferen til logfilen periodisk, men du kan tvinge ERDDAP™ at skrive bufferen til logfilen ved at besøge /erddap/status.html .

Trouble: Gamle version af Java

Hvis du bruger en version af Java det er for gammel til ERDDAP , ERDDAP™ Kør ikke, og du vil se en fejlmeddelelse i Tomcat's logfil som

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

Løsningen er at opdatere til den seneste version af Java og sørg for, at Tomcat bruger den.

Trouble: Slow Startup første gang

Tomcat skal gøre en masse arbejde første gang en ansøgning som ERDDAP™ er startet; især, det skal pakke pakken Erddap.war filfil (som er som en .zip filfil) . På nogle servere, det første forsøg på at se ERDDAP™ boder (30 sekunder?) indtil dette arbejde er færdigt. På andre servere vil det første forsøg mislykkes med det samme. Men hvis du venter 30 sekunder og prøve igen, vil det lykkes, hvis ERDDAP™ blev installeret korrekt.

Der er ingen fix for dette. Dette er simpelthen, hvordan Tomcat virker. Men det sker kun første gang, efter at du installerer en ny version af ERDDAP™ .

Luk og genstart

I fremtiden, for at lukke (og genstart) ERDDAP™ , se Sådan lukkes du ned og genstart Tomcat og ERDDAP .

Har du lyst?

Troubles installation Tomcat eller ERDDAP™ ? Se vores udvalg sektion om at få ekstra støtte .

Email Meddelelse om nye versioner af ERDDAP

Hvis du vil modtage en e-mail, når en ny version af ERDDAP™ er tilgængelig eller andre vigtige ERDDAP™ meddelelser, Du kan tilmelde dig ERDDAP™ bekendtgørelser liste her her . Denne liste svarer til omtrent én e-mail hver tredje måned.

Tilpas tilpasning

  • Tilpas din søgning ERDDAP™ at fremhæve din organisation (Ikke ikke NOAA ERD ) .
  • Ændre det banner, der vises øverst på alle ERDDAP™ .html sider ved at redigere <startBodyHtml5> tag i din datasets.xml fil. (Hvis der ikke er en, skal du kopiere standarden fra ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml filfil ind i datasets.xml og redigere det.) Du kan f.eks.:
    • Brug et andet billede (f.eks. din organisations logo) .
    • Ændre baggrundsfarven.
    • Ændre " ERDDAP™ " til "DinOrganization's ERDDAP™ " " " "
    • Ændre "Easier adgang til videnskabelige data" til "Easier adgang til DinOrganization's data".
    • Du kan ændre links til din organisation og finansieringskilder.
  • Ændre oplysningerne på venstre side af startsiden ved at redigere oplysningerne <theShortDescriptionHtml> tag i din datasets.xml fil. (Hvis der ikke er en, skal du kopiere standarden fra ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml filfil ind i datasets.xml og redigere det.) Du kan f.eks.:
    • Beskriv hvad din organisation og/eller gruppe gør.
    • Beskrive, hvilken slags data dette ERDDAP™ har.
    • Hvis du vil ændre ikonet, der vises på browser faner, skal du sætte din organisations favicon. ico in tomcat/content/erddap/billeder/ . Se endnuhttps://en.wikipedia.org/wiki/Favicon.