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:
- Sørg for, at eventuelle afhængigheder er installeret. På ikke-Windows maskiner (Linux og Mac) , du behøver csh.
Java
-
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
- 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<Connector port Scope8080"
og en til<Conector port Hanging8443"
) .- (Anbefalet anbefalet) Forøgelse af
Tilslutningstilslutning Timeout
parameterværdi, måske til 300000 (millisekunder, som er 5 minutter) . - (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.
- (Anbefalet anbefalet) Forøgelse af
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.
- Ændre de eksisterende
- Genstart Apache:
/usr/sbin/apachectl -k yndefuld
(Men nogle gange er det i en anden mappe) .
- Rediger Apache
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 brugerTomcat
. Dette gør det umuligt for hackere at logge ind på din server som brugerTomcat
. 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 teapache-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(Det vil bede dig om superbruger adgangskode for tilladelse til at gøre dette.)sudo su - tomcat
- 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 denopstart.sh
og og ognedlukning. sh sh
scripts som brugerTomcat
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.
(men erstatte det faktiske navn på din tomcat mappe) .
chown -R tomcat apache-tomcat-10.0.23
- Æ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
- Ændre ejerskab af apache-tomcat-mappens træ til brugeren.
- Du kan oprette dig
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 aftomcat/bin/startup.sh
og og ognedlukning. 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 indstilleJAVA_HOME
. -
På Windows: Opret en fil
Tomcat\bin\\setenv.bat
at indstille Tomcats miljøvariabler. Denne fil vil blive brugt aftomcat\bin\\startup.bat
og og ogshutdown.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 TomcatCATALINA_OPTS
parameter iSetenv.bat
. - Med Java 21, du vælger 64 bit Java når du downloader en version af Java markeret "64 bit".
- Med Java 8, du skal tilføje
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->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
- På Linux og Macs skal du ændre tilladelser af alle
*.sh
filer i filer iTomcat/bin/
at være eksekverbar af ejeren:
chmod +x *.sh
Skrifttyper
- Skrifttyper til billeder: Vi foretrækker stærkt den gratis DejaVu skrifttyper til den anden Java skrifttyper. Brug af disse skrifttyper anbefales stærkt, men ikke påkrævet.
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:
- Som bruger "tomcat", kører
tomcat/bin/startup.sh
. - Se din URL + ":8080/" i din browser (fx, http://coastwatch.pfeg.noaa.gov:8080/ ) .
- Som bruger "tomcat", kører
- 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.
- Løb
- 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.
- Linux:
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
- Opsæt op af
tomcat / indhold /
konfigurationsfiler. På Linux, Mac og Windows, download ErddapContent .zip og riv den ind iTomcat
mappe, oprettelsetomcat / 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
- Læs kommentarerne i
tomcat/content/erddap/setup.xml
og foretage de ønskede ændringer. setup.xml er filen med alle de indstillinger, der angiver, hvordan din ERDDAP™ opfører sig.
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 afbigParentDirectory
: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 tiltomcat/content/erddap/images/erddap2.css
og derefter foretage ændringer til det. Ændringer tilErddap2.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
- 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
- Sørg for, at
Mod_proxy
og og ogMod_proxy_ http
er indlæst:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
- Æ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
- 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ældetlog.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 dindatasets.xml
fil. (Hvis der ikke er en, skal du kopiere standarden fra ERDDAP™ 'stomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml
filfil ind idatasets.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 dindatasets.xml
fil. (Hvis der ikke er en, skal du kopiere standarden fra ERDDAP™ 'stomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml
filfil ind idatasets.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.