Asentaminen
Miten tehdä ensimmäinen asennus ERDDAP™ Sinun palvelijasi
ERDDAP™ Voit käyttää mitä tahansa palvelinta, joka tukee Java Tomcat (muut sovelluspalvelimet, kuten Jetty, mutta emme tue niitä.) . ERDDAP™ on testattu Linuxilla (Lähde: Amazon's AWS) Mac ja Windows-tietokoneet.
- Docker ----- Tarjoamme ERDDAP™ Docker-säiliö IOOS tarjoaa nyt Nopea aloitusopas ERDDAP™ Docker Container . Se on standardi ERDDAP™ Asentaminen Docker-säiliöön. Dockerin kautta Kompleksi tarjoaa helppoja tapoja luoda sl ja seuranta, lue lisää Dockerin dokumentointi . Jos käytät Dockeria, pidät todennäköisesti Docker-versiosta. Jos haluat käyttää pilvipalveluita, pidät todennäköisesti Docker-versiosta.
- Amazon Amazon ----- Jos olet asennuksessa ERDDAP™ Amazon Web Services EC2:ssa, katso tämä Amazon Web Services yleiskatsaus Ensimmäinen.
- Linux ja Macit ----- ERDDAP™ Toimii erinomaisesti Linux- ja Mac-tietokoneissa. Katso ohjeet alta.
- Windows Windows ----- Windows on hyvä testata ERDDAP™ henkilökohtaiseen käyttöön (Katso ohjeet alta) , Emme suosittele käyttämään sitä julkisesti. ERDDAP™ käyttöönottoa. Juokseminen ERDDAP™ Windowsissa voi olla ongelmia: erityisesti, ERDDAP™ Et voi poistaa ja/tai nimetä tiedostoja nopeasti. Tämä johtuu todennäköisesti virustorjuntaohjelmistosta. (Lähde: McAfee and Norton) Tämä tarkistaa tiedostoja viruksia. Jos törmäät tähän ongelmaan (joka näkyy virheviestinä) log.txt tiedostot, kuten "Voi poistaa ..."), virustorjuntaohjelmiston asetusten muuttaminen voi osittain lievittää ongelmaa. Käyttää Linux- tai Mac-palvelinta.
Standardi ERDDAP™ Linux-, Mac- ja Windows-tietokoneiden asennusohjeet ovat:
- Varmista, että kaikki riippuvuudet on asennettu. Ei-Windows koneita (Linux ja Mac) Tarvitset csh:tä.
Java
-
For For ERDDAP™ V2.19+, perustettu Java 21. Turvallisuussyistä on lähes aina parempi käyttää uusinta versiota. Java 21. Lataa ja asenna uusin versio Adoptiumin OpenJDK (Temurin) 21 21 (LTS) . Tarkista asennuksen, suorita
/javaJreBinDirectory / Java käännökset
EsimerkiksiKäyttäjä/paikallinen/jdk-21.0.3+9/jre/bin/java käännökset
.ERDDAP™ Teosten kanssa Java muista lähteistä, mutta suosittelemme Adoptiumia, koska se on tärkein, yhteisöllistä tukea. Ilma ilmaiseksi ilmaiseksi (Olut ja puhe) versiosta Java 21, joka tarjoaa pitkäaikaista tukea (Ilmaiset päivitykset jo vuosia ennen alkuperäistä julkaisua) . Turvallisuussyistä päivitä ERDDAP versiosta Java säännöllisesti uusina versioina Java 21 on saatavana Adoptiumilta.
ERDDAP™ Sitä on testattu ja käytetty laajasti 21:llä, ei muilla versioilla. Erilaisista syistä emme testaa tai tue muita versioita. Java .
Tomca
- Aseta ylös Tomca . Tomcat on yleisimmin käytetty Java Palveluntarjoaja, joka on Java ohjelmisto, joka on käyttöjärjestelmän verkkopalveluiden ja Java palvelinohjelmisto, kuten ERDDAP™ . Vapaa ja avoin lähdekoodi (FOSS) .
Voit käyttää toista Java Sovelluspalvelin (Esimerkki: Jetty) Testaamme ja tuemme Tomcatia.
- Lataa Tomcat ja pakkaa se palvelimellesi tai PC:lle.
Turvallisuussyistä on lähes aina parempi käyttää Tomcat 10:n uusinta versiota. (9 ja alapuolella ei ole hyväksyttävää)
joka on suunniteltu toimimaan Java 21 tai uudempi. Alla olevaa Tomcat-hakemistoa kutsutaan
Tom
.
Varokaa! Jos sinulla on jo Tomcat, jolla on jokin muu verkkosovellus (Erityisesti kolme) Suosittelemme, että asennat ERDDAP™ Sisällä Toinen Tomcat koska ERDDAP™ Tarvitset erilaisia Tomcat-asetuksia Ei tarvitse olla mukana muissa muistisovelluksissa.
- Linuxissa, Download "Tähti" .gz Tomcatin jakelu Pakkaa se pois.
Suosittelemme pakkaamaan sen sisään
Käyttäjä/Paikallinen
. - Macissa Tomcat on jo asennettu
Kirjasto / Tomcat
Tomcat 10:n uusimpaan versioon. Jos lataat sen, Download "Tähti" .gz Tomcatin jakelu Pakkaa se sisäänKirjasto / Tomcat
. - Windowsissa voit Download "Core" "Zip" Tomcat
(joka ei sotke Windows-rekisteriä ja jota hallitset DOS-komentorivillä) Pakkaa se sopivaan hakemistoon.
(Kehittämistä varten käytämme "Core" "zip" -jakelua. Me teemme
Ohjelmat
Pakkaa ja pakkaa se sinne.) Voit ladata "Core" "64-bittinen Windows zip" -jakelun, joka sisältää enemmän ominaisuuksia. Jos jakelu on Windows-asennus, se saattaa esimerkiksi Tomcatin.Ohjelmatiedostot / apache-tomcat-10.0.23
.
palvelin.xml
- palvelin.xml - Sisällä
Tomcat/conf/server.xml
On olemassa kaksi muutosta, jotka sinun tulisi tehdä kullekin<Connector>
Tagit (Yksi<Connector Port = 8080
Yksi<Conector Port="8443"
) .- (Suositellaan) Lisäämällä
yhteysyhteys Timeout
Parametriarvo ehkä 300 000 (Millisekuntia, joka on 5 minuuttia) . - (Suositellaan) Lisää uusi parametri:
Rentoutuneisuus =" | """
. Se on valinnainen ja hieman epävarma, mutta poistaa käyttäjien tarvetta prosenttikoodiin, kun ne esiintyvät käyttäjän pyynnön URL-osoitteen parametreissa.
- (Suositellaan) Lisäämällä
Sisältö.xml
- Konteksti.xml ----- Resurssit - In
Tomcat/conf/context.xml
Juuri ennen</Context>
Muuta Resursseja Tag (tai lisätä, jos se ei ole jo siellä) Aseta kätkön MaxSize-parametri 80000:<Resources cachingAllowed="true" cacheMaxSize="80000" />
Näin vältetään lukuisia varoituksia katalinassa. Kaikki alkaa
WARNING [main] org.apache.catalina.webresources.Cache.getResource Unable to add the resource at [/WEB-INF/classes/...]
Apace Timeout
- Linux-tietokoneissa Apache-aikatauluasetukset muutetaan niin, että aikaa vievät käyttäjäpyynnöt eivät aikatauluta.
(Se, mitä usein kutsutaan "Proxy" tai "Bad Gateway" -virheeksi.) . Käyttäjänä:
- Muokkaa apassia
http d.conf
tiedostotiedosto (Yleensä/etc/ http d/conf/
) :- Muuta olemassa olevaa
<Timeout>
asetukset (tai lisätä tiedoston lopussa) 3600 (Sekunnit) Oletusarvon sijaan 60 tai 120 sekuntia. - Muuta olemassa olevaa
<ProxyTimeout>
asetukset (tai lisätä tiedoston lopussa) 3600 (Sekunnit) Oletusarvon sijaan 60 tai 120 sekuntia.
- Muuta olemassa olevaa
- Käynnistä Apache uudelleen:
Käyttäjä/sbin/apachectl K Graceful
(Joskus se on toisessa hakemistossa.) .
- Muokkaa apassia
Turvallisuusturvallisuus
- Turvallisuussuositus: Näytä Nämä ohjeet lisätä turvallisuuden Tomcat-asennus, erityisesti julkisille palvelimille.
- Yleisölle ERDDAP™ Linux- ja Mac-laitteissa on parasta perustaa Tomcat. (Ohjelman) Käyttäjän kuuluminen
Tom
(erillinen käyttäjä, jolla on rajalliset luvat ja Ei salasanaa ) . Vain käyttäjä voi siirtyä toimimaan käyttäjänäTom
. Näin hakkerit voivat kirjautua sisään palvelimeesi käyttäjänäTom
. Joka tapauksessa sinun pitäisi tehdä se niin, ettäTom
Käyttäjällä on hyvin rajalliset käyttöoikeudet palvelimen tiedostojärjestelmään (lue + kirjoita + suorita etuoikeudet) SilläApache-tomcat
Hakemistopuu ja<bigParentDirectory>
Vain luku-oikeudet hakemistoihin, joissa on tietoja, jotka ERDDAP™ tarvitaan pääsyä).- Voit luoda
Tom
Käyttäjätili (jolla ei ole salasanaa) Käyttämällä käskyä:sudo useradd tomcat -s /bin/bash -p '*'
- Voit siirtyä toimimaan käyttäjänä
Tom
Käyttämällä käskyä(Se pyytää sinulta superkäyttäjän salasanan, jotta voit tehdä tämän.)sudo su - tomcat
- Voit lopettaa käyttäjien tomcatin käytön komennolla
exit
- Suurin osa Tomcatista ja ERDDAP™ Käyttäjän ohjeet
Tom
. Myöhemmin juoksemaanStartup.
jasulku. Säv.
Käsikirjoitukset käyttäjänäTom
Tomcatilla on oikeus kirjoittaa lokitiedostoihinsa. - Tomcatin pakkaamisen jälkeen, vanhempien
Apache-tomcat
Hakemisto:- Muuta apache-tomcat-hakemistopuun omistajuutta tomcatin käyttäjäksi.
(Korvaa Tomcat-hakemiston todellinen nimi) .
chown -R tomcat apache-tomcat-10.0.23
- Muuta "ryhmä" tomcatiksi, käyttäjänimeksi tai pienen ryhmän nimeksi, joka sisältää tomcatin ja kaikki Tomcatin ylläpitäjät ERDDAP :
chgrp -R yourUserName apache-tomcat-10.0.23
- Muuta lupia, jotta Tomcat ja ryhmä ovat lukeneet, kirjoittaneet ja toteuttaneet etuoikeuksia:
chmod -R ug+rwx apache-tomcat-10.0.23
- Poista "muut" käyttäjän lukemis-, kirjoitus- tai suoritusoikeudet:
chmod -R o-rwx apache-tomcat-10.0.23
- Muuta apache-tomcat-hakemistopuun omistajuutta tomcatin käyttäjäksi.
- Voit luoda
Tämä on tärkeää, koska se estää muita käyttäjiä lukemasta mahdollisesti arkaluonteisia tietoja. ERDDAP™ asennustiedostoja.
Muisti
Tomcatin ympäristömuuttujat
-
Linux ja Mac: Luo tiedosto
Tomcat/bin/setenv.sh
(Pääosat Red Hat Enterprise Linux \[ Ryhmä \] editTomcat/conf/tomcat10.conf
) Tomcatin ympäristömuuttujat. Tätä tiedostoa käytetäänTomcat/bin/startup.sh
jasulku. Säv.
. Tiedosto sisältää jotain: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(Korvaa hakemiston nimet tietokoneeltasi) . (Jos olet aiemmin määrittänyt
Jre_home
Voit poistaa sen.) Macsissa sinun ei välttämättä tarvitse asettaaJAVA - Koti
. -
Windowsissa: Luo tiedosto
Tomcat: Setenv.bat
Tomcatin ympäristömuuttujat. Tätä tiedostoa käytetäänTomcat\bin\\startup.bat
jashutdown.bat
. Tiedosto sisältää jotain: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"(Korvaa hakemiston nimet tietokoneeltasi) . Jos tämä koskee vain paikallista testiä, poista "palvelin". (Jos olet aiemmin määrittänyt
Jre_home
Voit poistaa sen.)
The XMX
ja xms
Muisti on tärkeä, koska ERDDAP™ toimii paremmin enemmän muistin kanssa.
Aina asetettu xms
sama arvo kuin XMX
.
-
32 bittiä ja 32 bittiä Java : 64 bittiä Java Paljon parempi kuin 32 Java 32 bit Java Toimii niin kauan kuin palvelin ei ole kiireinen. Mitä enemmän fyysistä muistia palvelimessa on, sitä parempi: 4+ GB on hyvä, 2 GB on kunnossa, vähemmän ei suositella. 32 bittiä Java fyysinen muisti, Tomcat ja Java Älä juokse, jos yrität
XMX
Yli 1500 M (1200 m joissakin tietokoneissa) . Jos palvelimellasi on alle 2 Gt muistia, vähennäXMX
Arvon arvo (Sisältää M'egaBytes) 1/2 tietokoneen fyysisestä muistista. -
64 bittiä ja 64 bittiä Java : 64 bittiä Java Toimii vain 64-bittisessä käyttöjärjestelmässä.
- kanssa Java 8. Sinun on lisättävä
d64
TomcatilleCATALINA_OPTS
parametriäTelevisio.bat
. - kanssa Java Valitse 64 bittiä Java Kun lataat version Java "64 bittiä"
- kanssa Java 8. Sinun on lisättävä
64 bittiä Java Tomcat ja Java voi käyttää erittäin korkea XMX
ja xms
asetuksia. Mitä enemmän fyysistä muistia palvelimessa on, sitä parempi.
Yksinkertainen ehdotus: suosittelemme, että asetat XMX
ja xms
että (Sisältää M'egaBytes) 1/2 (tai vähemmän) tietokoneen fyysinen muisti.
Saa nähdä, onko Tomcat Java ja ERDDAP™ 64-bittisessä tilassa etsitään "vähän" ERDDAP Päivittäinen sähköposti
tai sisällä BigParentDirectory/logs Näytä tarkat tiedot [log.txt](/docs/server-admin/additional-information#log)
tiedostotiedosto ( isovanhemmat
on määritelty Asennus.xml ) .
Garbage kokoelma
- Sisällä ERDDAP™ > log.txt Näet monia "GC" (Jakamisen epäonnistuminen) "Viestit.
Tämä ei yleensä ole ongelma. Se on usein viesti normaalista toiminnasta. Java Sanotaan, että se on juuri päättynyt pieneen roskaan.
Kokoelma, koska se loppui huoneesta Eedenissä (osion Java Hyvin nuoret esineet) . Yleensä viesti näyttää
MemoryUseAfter
. Jos nämä kaksi numeroa ovat lähellä toisiaan, se tarkoittaa, että roskat eivät ole tuottavia. Viesti on vain merkki ongelmasta, jos se on hyvin usein (joka sekunti) eivät ole tuottavia, ja määrät ovat suuria eivätkä kasva, jotka yhdessä osoittavat, että Java Tarvitset enemmän muistia, kamppailee vapauttaa muistia, ja ei voi vapauttaa muistia. Tämä voi tapahtua stressaavana aikana ja sitten mennä pois. Jos se jatkuu, se on merkki ongelmasta. - Jos näet
Java.lang.OutOfMemory Virhe
s sisään ERDDAP™ > log.txt tiedosto, Katso nähkää OutMemory-virhe vinkkejä siitä, miten diagnosoida ja ratkaista ongelmat.
Luvat
- Linux ja Macs muuttavat käyttöoikeuksia kaikista
*Shh.
tiedostot sisäänTomcat/bin/
Omistajan suoritettavaksi:
chmod +x *.sh
Fonts
- Kuvat: Pidämme enemmän vapaista DejaVu-fontit toiseen Java fontteja. Näiden fonttien käyttö on suositeltavaa, mutta sitä ei tarvita.
Jos päätät olla käyttämättä DejaVu-fontteja, sinun on muutettava fontFamily-asetus asennuksessa.xml. <fontFamily> Sansserif </fontFamily>
,
joka on kaikkien saatavilla Java jakelua. Jos asetat <fontFamily>
sellaisen fontin nimi, jota ei ole saatavilla, ERDDAP™ ei kuormita
ja tulostaa luettelon käytettävissä olevista fonteista log.txt
tiedosto. Sinun on käytettävä yhtä näistä fonteista.
Jos haluat käyttää DejaVu-fontteja, varmista, että <fontFamily>
asennus.xml on <fontFamily> DejaVu Sans </fontFamily>
.
DejaVu-fonttien asentaminen, lataa DejaVuFonts .zip (5 522 795 tavua, MD5=33E1E61FAB06A547851ED308B4FFF42) ja poista fonttitiedostot väliaikaiseen hakemistoon.
- Linuxissa:
- Linux Adoptium Java jakelua, katso Nämä ohjeet .
- toisen kanssa Java Jakelu: Kuten
Tom
Käyttäjä, kopioi fonttitiedostot$JAVA_HOME/Lib/Fonts
niin Java Löydä fontit. Muista: jos/kun päivität uudempaan versioon Java Sinun on asennettava nämä fontit uudelleen.
- Kunkin fonttitiedoston kohdalla, kaksinkertaista napsauttamalla sitä ja valitse sitten Asenna Font.
- Windows 7 ja 10: Windows Explorerissa valitse kaikki fonttitiedostot. Klikkaa oikein. Klikkaa asennusta.
Testaa Tomcat
- Testaa Tomcat-asennus.
- Linux:
- Käyttäjä "tomcat"
Tomcat/bin/startup.sh
. - Katso URL + ":80/" selaimessasi (esim. http://coastwatch.pfeg.noaa.gov:8080/ ) .
- Käyttäjä "tomcat"
- Mac Mac Mac (Tomcat toimii järjestelmänvalvojana) :
- Juokseminen
Tomcat/bin/startup.sh
. - Katso URL + ":80/" selaimessasi (esim. http://coastwatch.pfeg.noaa.gov:8080/ ) . Huomaa, että oletusarvoisesti Tomcat on vain käytettävissäsi. Se ei ole julkisesti saatavilla.
- Juokseminen
- Windows paikalliset:
- Napsauta Tomcat-kuvaketta järjestelmän lokerossa ja valitse "Aloita palvelu".
- Näkymä http://127.0.0.1:8080/ Tai ehkä http://localhost:8080/ Selaimessasi. Huomaa, että oletusarvoisesti Tomcat on vain käytettävissäsi. Se ei ole julkisesti saatavilla.
- Linux:
Tomcat "Onnittelut" -sivulla.
Jos on ongelmia, katso Tomcat-lokitiedosto Tomcat/logs/catalina.out
.
Ongelmia Tomcatin asennuksen kanssa?
-
Linux ja Mac, jos et pääse Tomcatiin ERDDAP™ (Tai ehkä et pääse tietokoneelta palomuurin ulkopuolella.) , Voit testata, jos Tomcat kuuntelee porttia 8080 kirjoittamalla (kuin juuret) palvelimen komentorivillä:
netstat -tuplen | grep 8080
Tämän pitäisi palauttaa yksi rivi jollakin tavalla:
tcp 0 0 :::8080 :::* LISTEN ## ##### ####/java
(missä missä #
Jokin digi) osoittaa, että a Jaava
Prosessiprosessi (Epäilemättä Tomcat) Satama 8080 tarkoittaa "Tcp"-liikennettä.
Jos riviä ei palautettu, jos linja on merkittävästi erilainen tai jos kaksi tai useampia rivejä on palautettu, satamaasetukset voivat olla ongelma.
-
Katso Tomcat-lokitiedosto
Tomcat/logs/catalina.out
. Tomcan ongelmat ja jotkut ERDDAP™ Käynnistysongelmat ovat lähes aina esillä. Tämä on yleistä, kun aloitat ERDDAP™ . -
Nähdään Tomca Verkkosivut tai hae apua, mutta kerro meille ongelmat, joita sinulla on ja löytämäsi ratkaisut.
-
Katso meidän Lisätuen saaminen .
ERDDAP™ Sisältö
- Aseta ylös
Tomcat/Sisältö/erdap
tiedostojen määrittely. Linux, Mac ja Windows, lataa erdapContent .zip ja purkaa sitäTom
Hakemisto, luominenTomcat/Sis ältö/erdap
.
__Version 1.0.0, 20333 tavua, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, päivätty 2024-10-14
Myös aiemmat versiot ovat saatavilla:
- 2.17 (19 792 tavua, MD5=8F892616BAEEF2DF0F4B036DCB4AD7C, päivätty 2022-02-16)
- 2.18 (19 792 tavua, MD5=8F892616BAEEF2DF0F4B036DCB4AD7C, päivätty 2022-02-16)
- 2.2. (19 810 tavua, MD5=1E26F62E7A06191EE68C40B9A29362, päivätty 2022-10-09)
- 2.22 (19 810 tavua, MD5=1E26F62E7A06191EE68C40B9A29362, päivätty 2022-12-08)
- 2.23 (19 810 tavua, MD5=1E26F62E7A06191EE68C40B9A29362, päivätty 2023-02-27)
Muu ohjaus
Edeltäjä Red Hat Enterprise Linux (Ryhmä) muissa tilanteissa, joissa et saa muuttaa Tomcat-hakemistoa tai missä haluat/tarvitset
Laittaa ERDDAP™ Sisältöhakemisto jostain muusta syystä (Jos käytät Jettyä Tomcatin sijaan) ,
Unzip erdapContent .zip
haluttuun hakemistoon (johon vain Tom
Käyttäjällä on pääsy) ja asettaa erddapContentDirectory
Järjestelmän omaisuus
(esim. erddapContentDirectory =~tomcat/content/erddap
) niin ERDDAP™ Löydä tämä uusi sisältöhakemisto.
Asennus.xml
- Lue kommentit sisään
Tomcat/content/erddap/setup.xml
Tee pyydetyt muutokset. setup.xml on tiedosto, jossa on kaikki asetukset, jotka määrittävät, miten ERDDAP™ käyttäytyä.
Alkuvaiheessa sinun on ainakin muutettava näitä asetuksia:
<bigParentDirectory>
<emailEverythingTo>
<baseUrl>
<email...>
asetukset<admin...>
asetukset<baseHttpsUrl>
(Kun olet asentanut https )
Kun luot BigParentDirectoryn, BigParentDirectoryn emohakemistosta:
- Tee siitä
Tom
Käyttäjän omistajaisovanhemmat
:chown -R tomcat bigParentDirectory
- Muuta "ryhmä" tomcatiksi, käyttäjänimeksi tai pienen ryhmän nimeksi, joka sisältää tomcatin ja kaikki Tomcatin ylläpitäjät ERDDAP :
chgrp -R yourUserName bigParentDirectory
- Muuta lupia, jotta Tomcat ja ryhmä ovat lukeneet, kirjoittaneet ja toteuttaneet etuoikeuksia:
chmod -R ug+rwx bigParentDirectory
- Poista "muut" käyttäjän lukemis-, kirjoitus- tai toteutusoikeudet. Tämä on tärkeää ehkäistä mahdollisesti arkaluonteisten tietojen lukemista.
Sisällä ERDDAP™ kirjaa tiedostoja ja tiedostoja yksityisistä tietoaineistoista.
chmod -R o-rwx bigParentDirectory
Ympäristömuuttujat
Aloitetaan ERDDAP™ v2.13, ERDDAP™ Järjestäjät voivat ylittää minkä tahansa arvon asennus.xml määrittämällä ympäristömuuttujan.
Nimeä ERDDAP _arvonimi
ennen juoksemista ERDDAP™ . Esimerkiksi käyttö ERDDAP _baseUrl
Ylittää <baseUrl>
arvoa.
Tämä voi olla kätevää, kun käytät ERDDAP™ Dockerin kaltaisella säiliöllä, koska voit asettaa asennusasetukset.xml
Toimita erityisasetuksia ympäristömuuttujan kautta. Jos toimitat salaisia tietoja ERDDAP™ tämän menetelmän kautta,
Tarkista, että tiedot pysyvät salaisina. ERDDAP™ Lue ympäristömuuttujat vain kerran käynnistysvaiheessa.
käynnistyksen ensimmäisessä sekunnissa, joten yksi tapa käyttää tätä on: aseta ympäristömuuttujat, aloita ERDDAP ,
Odota kunnes ERDDAP™ Se on aloitettu ja sitten ympäristömuuttujia.
datasets.xml
- Lue kommentit sisään Työskentelyä yhdessä datasets.xml Tiedosto . Myöhemmin, kun olet saanut ERDDAP™ Juoksen juoksemassa
ensimmäistä kertaa (yleensä vain oletustietojen kanssa) Muutat XML:ää
Tomcat/content/erddap datasets.xml
määrittää kaikki haluamasi tietoaineistot ERDDAP™ palvelemaan. Näin vietät suurimman osan ajastasi Kun perustat ERDDAP™ ja myöhemmin säilyttäen ERDDAP™ .
Voit nähdä esimerkin datasets.xml Kirjoittanut GitHub .
- (epätodennäköistä) Nyt tai (hieman todennäköisemmin) tulevaisuudessa, jos haluat muuttaa erddapin CSS-tiedostoa, kopioi
Tomcat/content/erddap/images/erdapStart2.css
ettäTomcat/content/erddap/images/erddap2.css
Sitten tehdään muutoksia siihen. MuutoksiaErddap2.css
Vain silloin, kun ERDDAP™ Käynnistetään uudelleen ja usein myös käyttäjän on puhdistettava selaimen välimuistitiedostot. ERDDAP™ ei toimi oikein, jos asennus.xml tai datasets.xml tiedosto ei ole hyvin muotoiltu XML-tiedosto. Kun olet muokannut näitä tiedostoja, On hyvä tarkistaa, että tulos on hyvin muotoiltu XML liittämällä XML-teksti XML-testiin, kuten xmlvalidaatio .
Asenna erddap. War tiedostot
- Linux, Mac ja Windows, _download Erddap.sota Sisään
Tomcat/webapps
:
_Version 2.28.1, 622,676,238 tavua, MD5=48b4226045f950c8d69ef9521b9bc9, päivätty 2025-09-05
.war-tiedosto on suuri, koska se sisältää korkean resoluution rantaviivaa, rajoja ja korkeustietoja, joita tarvitaan karttojen luomiseen.
Myös aiempia versioita on saatavilla.
- 2.17 (551 068 245 tavua, MD5=5FEA912B5D42E50EAB9591F773EA848D, päivätty 2022-02-16)
- 2.18 (551 069 844 tavua, MD5=461325E97E7577EC671D50246CCFB8B, päivätty 2022-02-23)
- 2.2. (568 6644 411 tavua, MD5=F2CFF805893146E932E498FDDBD519B6, päivätty 2022-10-09)
- 2.22 (567,742,765 tavua, MD5=2B33354F633294213AE2AFDCF4DA6D0, päivätty 2022-12-08)
- 2.23 (572 124,953 tavua, MD5=D843A043C506725EBD6F8FDCCA8FD5F, päivätty 2023-03-03)
- 2.24 (568 748 187 tavua, MD5=970fbee172e28b0b8a07756eecbc898e, päivätty 2024-06-07)
- 2.25 (592 292 039 tavua, MD5=652AFC9D1421F00B5F789DA2C4732D4C, päivätty 2024-11-07)
- 2.26 (607 404 032 tavua, MD5=99a725108b37708e5420986c16a119, päivätty 2025-03-31)
- 2.2.0 (620 554 403 tavua, MD5=3b2086c659ee4145ca2dff447bf4ef7, päivätty 2025-06-11)
Konfiguroi proxy (Erityinen käyttöönotto)
ERDDAP™ on tyypillisesti sijoitettu webserverin käänteisen välityspalvelimen taakse, jotta sitä voidaan palvella tavallisilla HTTP-porteilla. (80 ja 443) . SSL/TLS-terminaatio on usein hajallaan myös webserver-proxy-kerroksessa. Riippuu kunkin käyttöönoton vaatimuksista.
Apasseja
- Varmista, että
Mod_proxy
jaMod_proxy http
on ladattu:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
- Muokkaa olemassa olevaa
<VirtualHost>
Tag (Jos on yksi) tai lisätä tiedoston lopussa:
<VirtualHost *:80>
ServerName YourDomain.org
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /erddap http://localhost:8080/erddap
ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>
Jos ERDDAP™ tarjoillaan muulla tiellä kuin Eddap
myös asettaa X-Forwarded-Prefix
Otsikko kohti
Lähde: Before_ Eddap
. Tämä asetus olisi sopiva ERDDAP™ Palvellen
Lähde/erddap
:
RequestHeader set X-Forwarded-Prefix /subpath
- Aloita Apache uudelleen:
Käyttäjä/sbin/apachectl K Graceful
(Joskus se on toisessa hakemistossa.) .
Yhdessä
nginx config -tiedostossa aseta nämä otsikot:
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header REMOTE_ADDR $remote_addr;
proxy_set_header HTTP_CLIENT_IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
Jos ERDDAP™ tarjoillaan muulla tiellä kuin Eddap
myös asettaa X-Forwarded-Prefix
Otsikko kohti
Lähde: Before_ Eddap
. Tämä asetus olisi sopiva ERDDAP™ Palvellen
Lähde/erddap
:
proxy_set_header X-Forwarded-Prefix /subpath
Jotta NGINX ja ERDDAP™ toimimaan oikein https Sinun täytyy laittaa seuraava snippet sisään Tomcat-palvelin.xml <Host>
Blokki:
<Valve className="org.apache.catalina.valves.RemoteIpValve"
remoteIpHeader="X-Forwarded-For"
protocolHeader="X-Forwarded-Proto"
protocolHeaderHttpsValue="https" />
Aloita Tomcat
- (En suosittele Tomcat Web Application Managerin käyttöä. Jos et ole täysin suljettu ja käynnistys Tomcat, ennemmin tai myöhemmin sinulla on PermGen muistiongelmia.)
- (Linuxissa tai Mac OS:ssä, jos olet luonut Tomcat-käyttäjän, esimerkiksi tomcat, muista tehdä seuraavat vaiheet käyttäjänä.)
- Jos Tomcat jo juoksee, sulje Tomcat (Linux tai Mac OS)
Tomcat/bin/shutdown
tai tai (Windowsissa)Tomcat \bin shutdown.bat
Linux, Käytä ps -ef | Tomcat
ennen ja jälkeen sulku. Säv.
Varmista, että tomcat-prosessi on pysähtynyt.
Prosessi on lueteltava ennen sulkeutumista, eikä sitä lopulta ole listattu sulkeutumisen jälkeen.
Se voi kestää minuutin tai kaksi. ERDDAP™ Täysin suljettu. Ole kärsivällinen. Jos se ei näytä pysähtyvän itsestään, käytä:
tappaa -9 <processID>
- Aloita Tomcat (Linux tai Mac OS)
Tomcat/bin/startup.sh
tai tai (Windowsissa)Tomcat\bin\\startup.bat
on ERDDAP™ juoksemaan?
Käytä selainta nähdäksesihttp://www.YourServer.org/erddap/status.html. ERDDAP™ Käynnistetään ilman tiedostoja. Datasetit ladataan taustasäikeeseen, joten ne ovat saatavilla yksi kerrallaan.
Troubleshoot
- Kun käyttäjän pyyntö tulee sisään, se menee Apacheen. (Linux- ja Mac OS -tietokoneissa) Sitten Tomcat, ERDDAP™ .
- Näet, mitä tulee Apache (liittyviä virheitä) Apache-lokitiedostoissa.
- Sinä Katso, mitä Tomcat (liittyviä virheitä)
Tomcat-lokitiedostot (
Tomcat/logs/catalina.out
Muut tiedostot tässä hakemistossa) . - Sinä Saa nähdä, mitä tulee ERDDAP diagnostisia viestejä ERDDAP ,
Viestien virheet ERDDAP Sisällä ERDDAP™
<bigParentDirectory> Tekijät/log.txt
tiedosto. - Tomcat ei aloita ERDDAP™ Kun Tomcat saa pyynnön ERDDAP™ . Voit katsoa Tomcat-lokitiedostoja, jos Alku alkoi ERDDAP™ tai jos tähän yritykseen liittyy virheilmoitus.
- Milloin ERDDAP™ Aloita, se nimeää vanhan ERDDAP™ log.txt-tiedosto (
logiikka <CurrentTime> .txt
) Luo uusi log.txt-tiedosto. Jos siislog.txt
tiedosto on vanha, se on merkki siitä, että ERDDAP™ Ei ole hiljattain aloitettu uudelleen. ERDDAP™ Kirjoita lokitiedot puskuriin ja kirjoittaa puskurin lokitiedostoon säännöllisesti, mutta voit pakottaa ERDDAP™ Kirjoita puskuri lokitiedostoon vierailemalla/erddap/status.html
.
Vaikeus: Vanha versio Java
Jos käytät versiota Java Se on liian vanha ERDDAP , ERDDAP™ Et juokse ja näet virheilmoituksen Tomcatin lokitiedostossa
Exception in thread "main" java.lang.UnsupportedClassVersionError:
_some/class/name_: Unsupported major.minor version _someNumber_
Ratkaisu on päivittää uusin versio Java Varmista, että Tomcat käyttää sitä.
Slow startup ensimmäistä kertaa
Tomcatin on tehtävä paljon työtä ensimmäisen kerran, kun sovellus on ERDDAP™ on aloitettu; varsinkin sen on purettava Erddap.sota
tiedostotiedosto
(joka on kuin .zip tiedostotiedosto) . Joillakin palvelimilla ensimmäinen yritys nähdä ERDDAP™ Tanssit (30 sekuntia?) kunnes tämä työ on valmis.
Muilla palvelimilla ensimmäinen yritys epäonnistuu välittömästi. Jos odotat 30 sekuntia ja yritä uudelleen, se onnistuu, jos ERDDAP™ asennettiin oikein.
Tähän ei ole korjausta. Näin Tomcat toimii. Tämä tapahtuu vasta ensimmäisen kerran, kun olet asentanut uuden version. ERDDAP™ .
Sulje ja käynnistä uudelleen
Tulevaisuudessa suljetaan (uudelleenkäynnistys) ERDDAP™ nähtävä Miten lopettaa ja käynnistää Tomcat ERDDAP .
Ongelmia?
Tomcatin tai ERDDAP™ ?? Katso meidän Lisätuen saaminen .
Sähköpostiilmoitus uusista versioista ERDDAP
Jos haluat saada sähköpostiviestin aina, kun uusi versio ERDDAP™ Saatavilla tai muu tärkeä ERDDAP™ ilmoitukset, Voit liittyä ERDDAP™ Ilmoituslistat täällä täällä täällä . Luettelossa on noin yksi sähköposti kolmen kuukauden välein.
Mukautettu
- Mukauta itseäsi ERDDAP™ korostaa organisaatiotasi (Ei ei ei NOAA ERD ) .
- Vaihda lippu, joka näkyy kaikkien huipulla ERDDAP™ .html-sivut muokkaamalla
<startBodyHtml5>
Tag in yourdatasets.xml
tiedosto. (Jos ei ole yhtä, kopioi oletus ERDDAP™ >Tomcat/webapps/erddap/WEB-INF/Classes/Gov/noaa/pfel/erddap/util/viestejä.xml
tiedostotiedosto sisäändatasets.xml
ja editoida sitä.) Voit esimerkiksi:- Käytä erilaista kuvaa (• organisaation logo) .
- Muuta taustaväriä.
- Muutos" ERDDAP™ "Organisaatiosi" ERDDAP™ """
- Vaihda "Tieteellisten tietojen helpompi saatavuus" "Sinun organisaatiosi tietojen helpompi saatavuus".
- Vaihda "Brought to You by" -linkkejä ollaksesi linkkejä organisaatioosi ja rahoituslähteisiin.
- Muuta kotisivun vasemmalla puolella olevaa tietoa muokkaamalla
<theShortDescriptionHtml>
Tag in yourdatasets.xml
tiedosto. (Jos ei ole yhtä, kopioi oletus ERDDAP™ >Tomcat/webapps/erddap/WEB-INF/Classes/Gov/noaa/pfel/erddap/util/viestejä.xml
tiedostotiedosto sisäändatasets.xml
ja editoida sitä.) Voit esimerkiksi:- Kerro, mitä organisaatiosi ja/tai ryhmäsi tekee.
- Selvitä, millaisia tietoja tämä ERDDAP™ on.
- Muuttaa ikoni, joka näkyy selaimen välilehtiä, laittaa organisaation favicon. Ico sisään
Tomcat/content/erddap/images/
. Näytähttps://en.wikipedia.org/wiki/Favicon.