Lumapit sa pangunahing nilalaman

Iluklok

Kung Paano Gagawin ang Unang Seksyon ERDDAP™ sa Iyong Server

ERDDAP™ ay maaaring tumakbo sa anumang server na sumusuporta Java at ang Tomcat (at iba pang aplikasyon na gaya ni Jetty, pero hindi namin sila sinusuportahan) . ERDDAP™ ay sinubok sa Linux (kasama ang AWS ng Amazon) , Mac, at Windows computers.

  • Docker -- Nagbibigay tayo ERDDAP™ sa isang Docker container at si IOOS ngayon ay nag - aalok ng isang Mabilis na Patnubay sa Pasimula ERDDAP™ sa Isang Docker Conter . Ito ang pamantayan ERDDAP™ pag-install, sa isang Docker container. Sa Pamamagitan ng Docker Compose ay naglalaan kami ng madaling mga paraan upang gumawa ng sstl at pagsubaybay, magbasa pa nang higit Docker dokumentasyon . Kung gumagamit ka na ng Docker, malamang na mas gugustuhin mo ang bersiyong Docker. Kung nais mong tumakbo sa mga serbisyo ng ulap malamang na mas gusto mo ang bersiyong Docker.
  • Amazon -- Kung naka-install ka ERDDAP™ sa isang Web Services EC2 halimbawa, tingnan ito Overviewed ang Web Services ng Amazon Una.
  • Linux at Macs -- ERDDAP™ ay napakahusay sa Linux at Mac na mga computer. Tingnan ang mga tagubilin sa ibaba.
  • Windows -- Mainam ang Windows para sa pagsubok ERDDAP™ at para sa personal na gamit (tingnan ang mga tagubilin sa ibaba) , ngunit hindi namin inirerekomenda ang paggamit nito para sa publiko ERDDAP™ Paglalagay. Pagtakbo ERDDAP™ sa Windows ay maaaring may mga problema: Kapansin - pansin, ERDDAP™ ay maaaring hindi matanggal ang mga talaksang delete at/o magkaroon ng maling pangalan nang mabilis. Ito marahil ay dahil sa antivirus software (e.g., mula sa McAfee at Norton) na sumusuri sa mga file para sa mga virus. Kung mapaharap ka sa problemang ito (na makikita sa maling mga mensahe sa log.txt talaksang tulad ng "Unang mag-delete ..."), ang pagbabago ng mga setting ng antivirus software ay maaaring bahagyang maibsan ang problema. O sa halip ay isaalang - alang ang paggamit ng isang Linux o Mac server.

Ang pamantayan ERDDAP™ Ang mga instruksiyon para sa mga computer ng Linux, Macs, at Windows ay:

  1. Tiyakin na ang anumang dependensiya ay naka-install. Sa mga makinang non-Windows (Linux at Mac) , kailangan mo ng csh.

Java

  1. Sapagkat ERDDAP™ v2.19+, itinayo Java 21. Para sa seguridad, halos laging pinakamabuting gamitin ang pinakabagong bersiyon ng Java 21. Paki-download at i-install ang pinakabagong bersyon ng Ang OpenJDK ng Pag - aampon (Temurin) 21 (MGA LTS) . Upang matiyak ang instalasyon, tumakbo /javaJreBin Direktory/java - Pagkumberte , halimbawa /usr/local/jdk-21.0.3+9/jre/bin/java - Pagkumberte .

    ERDDAP™ ay gumagawang kasama ng Java mula sa ibang pinagmulan, ngunit inirerekomenda namin ang Ampon dahil ito ang pangunahin, pampamayanang-suporta, malaya (gaya ng sa serbesa at pagsasalita) bersyon ng Java 21 na nagbibigay ng Pangmatagalang Suporta (libreng mga upgrade sa loob ng maraming taon pagkatapos ng panimulang paglabas) . Para sa mga kadahilanang panseguridad, pakisuyong i-update ang iyong ERDDAP 'Ang bersiyon ng Java Sa pana - panahon bilang mga bagong bersiyon ng Java 21 ang makukuha mula sa Repsium.

    ERDDAP™ ay sinubok at malawakang ginamit na may 21, hindi ang ibang bersiyon. Sa iba't ibang kadahilanan, hindi natin sinusubok ni sinusuportahan man ang ibang bersiyon ng Java .  

Tomcat

  1. Nagtayo Tomcat . Ang Tomcat ang pinakamalawak na ginagamit Java Tagapagsilbi, alin ang Java software na nakatayo sa pagitan ng mga serbisyong network ng operating system at Java software na server tulad ng ERDDAP™ . Ito ay Malaya at Open Software (MGA FOS) .

Maaari mong gamitin ang iba Java Tagapagsilbi (e.g., Jetty) , ngunit sinusubok lamang namin at sinusuportahan si Tomcat.

  • I-download Tomcat at i-track ito sa iyong server o PC. Para sa mga kadahilanang panseguridad, halos laging pinakamabuting gamitin ang pinakabagong bersiyon ng Tomcat 10 (bersyon 9 at sa ibaba ay hindi tanggap) na dinisenyo upang gumawang kasama ng Java 21 o mas bago. Sa ibaba, ang Tomcat directory ay tatawaging tomcat .

Warning!___ Kung mayroon ka nang Tomcat na nagpapatakbo ng iba pang aplikasyon sa web (lalo nang MGA THEDD) , inirerekomenda namin na maglagay kayo ERDDAP™ sa loob ikalawang Tomcat , dahil ERDDAP™ kailangan ng iba't ibang Tomcat setting at hindi dapat na makipagtalo sa iba pang aplikasyon para sa memorya.

  • Sa Linux, I-download ang "Core" "tar" .gz " Pamamahagi ng Tomcat at binuksan ito. Iminumungkahi namin ang pagbuklat nito /usr/local .
  • Sa isang Mac, si Tomcat ay malamang na naluklok na /Libray/Tomcat , ngunit dapat itong i-update sa pinakabagong bersyon ng Tomcat 10. Kung kukunin mo ito, I-download ang "Core" "tar" .gz " Pamamahagi ng Tomcat at binuksan ito /Libray/Tomcat .
  • Sa Windows, maaari mong gawin I-download ang "Core" "zip" Tomcat distribution (Na hindi nakakaabala sa Windows register at na kontrolado mo sa isang DOS command line) at binuksan ito sa isang angkop na directory. (Para sa pag-unlad, ginagamit natin ang "Core" na "zip" na pamamahagi. Gumagawa kami ng isang / Mga program directory at buksan doon.) O maaari mong i-download ang "Core" na "64-bit Windows szill" distribution, na kinabibilangan ng higit pang mga katangian. Kung ang distribusyon ay isang Windows installer, malamang na ilagay nito si Tomcat, halimbawa, /Program Files/palache-tomcat-10.0.23. .  

server.xml

  • server.xml -Sa loob tomcat/conf/server.xml file, may dalawang pagbabago na dapat ninyong gawin sa bawat isa sa dalawa <Connector> mga tag (isa para sa &lt;Connektor port="8080" at isa pa &lt;Conector port="8443" ) .
    1. (Inirerekomenda) Dagdagan ang koneksyon Orasan Halaga ng parameter, marahil hanggang 3000 (Mga millisecond, na 5 minuto) .
    2. (Inirerekomenda) Magdagdag ng bagong parameter: Relaks="[] | " . Ito ay opsyonal at bahagyang hindi matatag, ngunit nag-aalis ng pangangailangan para sa mga gumagamit na maging porsyento-encode ang mga karakter na ito kapag nangyari ito sa parameter ng kahilingan ng gumagamit na URL.  

nilalaman.xml

  • konteksto.xml -- Pag - iimbak - ng - Yaman tomcat/conf/context.xml , sa mismong harap ng </Context> tag, palitan ang tag ng Yaman (o idagdag ito kung wala na ito) upang ayusin ang cache MaxSize parameter hanggang 80000:
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Iniiwasan nito ang maraming babala sa catalina. na ang lahat ay magsimula sa

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

 

Panahon ng Apache

  • Sa mga computer na Linux, baguhin ang mga timeout setting ng Apache upang ang time-consumting user requests ay huwag mag-oras (na kadalasang lumilitaw bilang isang "Proxy" o "Bad Gateway" error) . Bilang tagagamit ng ugat:
    • Pagpapain sa Apache http d.conf talaksan (karaniwang nasa /etc/ http d/conf/ ) :
      • Palitan ang umiiral <Timeout> tagpo (o magdagdag ng isa sa dulo ng talaksan) hanggang 3600 (mga segundo) , sa halip ng default 60 o 120 segundo.
      • Palitan ang umiiral <ProxyTimeout> tagpo (o magdagdag ng isa sa dulo ng talaksan) hanggang 3600 (mga segundo) , sa halip ng default 60 o 120 segundo.
    • Restart Apache: /usr/sbin/apachectl -k Maganda (ngunit kung minsan ito ay nasa ibang directory) .

Katiwasayan

 

  • Mungkahing panseguridad: Tingnan Ang mga tagubiling ito upang dagdagan ang seguridad ng ang iyong instalasyon ng Tomcat, lalo na para sa mga pampublikong server.  
  • Para sa publiko ERDDAP™ Mga instalasyon sa Linux at Macs, pinakamabuting itayo ang Tomcat (ang programa) bilang pag - aari ng gumagamit tomcat (isang hiwalay na gumagamit na may limitadong pahintulot at alin ang walang password ) . Sa gayon, tanging ang super user lamang ang maaaring bumaling sa pagkilos bilang gumagamit tomcat . Ginagawa nitong imposible para sa mga hacker na pumasok sa inyong server bilang gumagamit tomcat . At sa anumang kalagayan, dapat mong gawin ito upang ang tomcat Ang gumagamit ay may napakalimitadong mga pahintulot sa sistema ng talaksang server (basahin ang+write+execute na mga pribilehiyo para sa apache-tomcat punong directory at <bigParentDirectory> at bumasa-lamang mga pribilehiyo para sa mga direktoryo na may datos na ERDDAP™ kailangan i-access).
    • Maaari mong likhain ang tomcat account ng gumagamit (na walang password) sa pamamagitan ng paggamit sa utos:
      sudo useradd tomcat -s /bin/bash -p '*'
    • Maaari kang bumaling sa trabaho bilang gumagamit tomcat sa pamamagitan ng paggamit ng utos
      sudo su - tomcat
      (Hihingi ka nito ng superuser password para sa pahintulot na gawin ito.)
      • Maaari mong ihinto ang paggawa bilang gumagamit ng tomcat sa paggamit ng utos
      exit
      • Gawin ang karamihan ng natitirang bahagi ng Tomcat at ERDDAP™ Itakda ang mga instruksiyon bilang gumagamit tomcat . Pagkatapos, patakbuhin ang startup.sh at Pagkasiphayo. sh Mga iskrip bilang gumagamit tomcat kung kaya't may pahintulot si Tomcat na sumulat sa mga log files nito.
      • Pagkatapos buksan ang Tomcat, mula sa magulang ng apache-tomcat directory:
        • Palitan ang pagmamay-ari ng puno ng apache-tomcat directory sa tomacat user.
          chown -R tomcat apache-tomcat-10.0.23
          (kundi palitan ang aktuwal na pangalan ng iyong tomcat directory) .
        • Palitan ang "grupo" upang maging tomcat, ang inyong username, o ang pangalan ng isang maliit na grupo na kinabibilangan ng tomcat at lahat ng mga administrador ng Tomcat/ ERDDAP :
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Ang pagbabago ay nagpapahintulot upang ang tomcat at ang grupo ay bumasa, sumulat, maggawad ng mga pribilehiyo:
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Tanggalin ang "iba pang" pahintulot ng gumagamit na bumasa, sumulat, o magsulat:
          chmod -R o-rwx apache-tomcat-10.0.23

Mahalaga ito, sapagkat hinahadlangan nito ang ibang gumagamit na magbasa ng posibleng sensitibong impormasyon ERDDAP™ Mga setup file.

Alaala

Itakda ang Kaibahang Kapaligiran ni Tomcat

  • Sa Linux at Macs: Gumawa ng talaksan tomcat/bin/setenv.sh (o sa Red Hat Enterprise Linux \[ RHEL \] , edit ~tomcat/conf/tomcat10.conff ) na magpabago sa kapaligiran ni Tomcat. Ang talaksang ito ay gagamitin ng tomcat/bin/startup.sh at Pagkasiphayo. sh . Ang talaksan ay dapat na naglalaman ng gaya ng:

    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

    (ngunit ihalili ang mga pangalan ng directory mula sa iyong computer) . (Kung naunang set HRE_HOME , maaari mong alisin iyan.) Sa Macs, marahil ay hindi mo na kailangang magtakda JAVA_HOME .

  • Sa Windows: Gumawa ng talaksan tomcat\bin\\setenv.bat na magpabago sa kapaligiran ni Tomcat. Ang talaksang ito ay gagamitin ng tomcat\bin\\startup.bat at shutdown.bat . Ang talaksan ay dapat na naglalaman ng gaya ng:

    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"

    (ngunit ihalili ang mga pangalan ng directory mula sa iyong computer) . Kung ito ay para lamang sa lokal na pagsubok, tanggalin ang "-server". (Kung naunang set HRE_HOME , maaari mong alisin iyan.)

Ang -Xmx at -Xms Mahalaga ang mga setting ng memorya dahil ERDDAP™ ay mas mahusay sa pag - alaala. Laging Nakatakda -Xms katumbas ng halaga -Xmx .

  • Para sa 32 bit Operating Systems at 32 bit Java : 64 bit Java ay mas mabuti kaysa 32 bit Java , ngunit 32 bit Java ay magtatrabaho hangga't ang server ay hindi talagang abala. Mientras mas maganda ang pisikal na memorya sa server, mas mabuti: 4+ Ang GB ay talagang mabuti, 2 GB ay okay, mas kaunti ay hindi inirerekomenda. May 32 bit Java , kahit na may saganang pisikal na memorya, Tomcat at Java hindi tatakbo kung ikaw ay magtatakda -Xmx mahigit 1500M (1200M sa ilang computer) . Kung ang iyong server ay wala pang 2GB ng memorya, bawasan ang iyong server -Xmx halaga (sa 'M'ega Byte) sa 1/2 ng pisikal na memorya ng kompyuter.

  • Sa 64 bit Operating Systems at 64 bit Java : 64 bit Java ay magtatrabaho lamang sa 64 na bit operating system.

    • Kasama Java 8, kailangan mong idagdag -d64 sa Tomcat MGA KATOTOTOHANAN NG CATALINA ng parameter setenv.bat .
    • Kasama Java 21, pinili mo ang 64 bit Java kapag nag-download ka ng bersyon ng Java Minarkahan ng "64 bit".

May 64 bit Java , Tomcat at Java ay maaaring gumamit ng napakataas -Xmx at -Xms Mga tagpo. Mientras mas mahusay ang pisikal na memorya sa server. Bilang simpleng mungkahi: Iminungkahi namin sa inyo ang -Xmx at -Xms hanggang sa (sa 'M'ega Byte) sa 1/2 (o mas mababa) ng pisikal na memorya ng computer. Makikita mo kung Tomcat, Java , at ERDDAP™ ay tunay na tumatakbo sa 64 bit mode sa pamamagitan ng paghahanap ng "bakit," sa ERDDAP ' Araw - Araw na Report email o nasa Malaking Direktoryo/logs/ [log.txt](/docs/server-admin/additional-information#log) talaksan ( Malaking Direktoryo ay nakatakda setup.xml ) .

Koleksiyon ng Basura

  • Sa loob ERDDAP™ ' log.txt talaksan, makikita mo ang maraming "GC (Pagkabigo ng Pananakop) " mga mensahe. Karaniwan nang hindi ito problema. Ito ang madalas na mensahe mula sa isang normal na operasyon Java na katatapos lamang nito ng isang maliit na basura dahil wala itong silid sa Eden (bahagi ng Java magbunton para sa napakabatang mga bagay) . Karaniwan nang ipinakikita sa iyo ng mensahe memoryUse Bago-&gt;memoryUse Pagkatapos . Kung ang dalawang numerong iyon ay magkalapit, nangangahulugan ito na ang koleksiyon ng basura ay hindi mabunga. Ang mensahe ay tanda lamang ng problema kung ito ay napakadalas (bawat ilang segundo) , hindi mabunga, at ang bilang ay malaki at hindi lumalaki, na magkasamang nagpapakita na Java Kailangan ang higit pang memorya, ang pagsisikap na alisin ang memorya, at hindi kayang alisin ang memorya. Ito ay maaaring mangyari sa isang maigting na panahon, pagkatapos ay umalis. Subalit kung ito ay magpapatuloy, iyan ay isang tanda ng problema.
  • Kung makita mo java.lang.OOOutOMemoryEror sa loob ng ERDDAP™ ' log.txt talaksan, tingnan Labas ng MemoryError kung paano susuriin at lulutasin ang mga problema.  

Mga Pagpapahintulot

chmod +x *.sh

Mga Patak

  • Mga larawan: Mas gusto namin ang libre Mga font ng DejaVu sa isa pa Java Mga font. Ang paggamit ng mga font na ito ay mahigpit na inirerekomenda ngunit hindi kinakailangan.

Kung hindi mo gagamitin ang mga font ng DejaVu, kailangan mong palitan ang font familyfamily setting sa setup.xml <fontFamily> Sassirif </fontFamily> , na makukuha ng lahat Java distribusyon. Kung ikaw ang nagtatakda <fontFamily> Sa pangalan ng isang font na hindi magagamit, ERDDAP™ ay hindi magkakarga at mag - iimprenta ng listahan ng magagamit na mga font sa log.txt talaksan. Dapat mong gamitin ang isa sa mga font na iyon.

Kung pipiliin mong gamitin ang mga font ng DejaVu, pakisuyong tiyakin ang mga ito <fontFamily> Pagtatakda sa setup.xml ay <fontFamily> Mga San ng DejaVu </fontFamily> .

Upang mailuklok ang mga font ng DejaVu, pakisuyong download Mga DejaVuFont .zip (5,522,795 bytes, MD5=33E61FAB6A547851ED308B4FFFF42) at itapon ang font files sa isang temporary directory.

  • Sa Linux:
    • Para sa Linux Pag - aampon Java mga distribusyon, tingnan Ang mga tagubiling ito .
    • Kasama ng iba Java mga distribusyon: Bilang ang tomcat gumagamit, kopyahin ang font files $JAVA_HOME/lib/fonts gayo'y Java ay mahahanap ang fonts. Tandaan: kung/kapag nag-upgrade ka mamaya sa mas bagong bersyon ng Java , kailangan mong ilagay muli ang mga font na ito.
  • Sa Macs: sa bawat font file, dobleng klik dito at pagkatapos ay i-install ang Font.
  • Sa Windows 7 at 10: sa Windows Explorer, piliin ang lahat ng font files. Klik. Click na naka-install.  

Pagsubok sa Tomcat

  • Subukin ang iyong instalasyon ng Tomcat.
    • Linux:
    • Mac (ay tumatakbo upang maging ang tagapangasiwa ng sistema) :
      • Takbo tomcat/bin/startup.sh .
      • Tingnan ang iyong URL + ":8080/" sa iyong browser (e.g., http://coastwatch.pfeg.noaa.gov:8080/ ) . Pansinin na sa hindi pagtupad, ang iyong Tomcat ay mararating mo lamang. Hindi ito maaaring puntahan ng publiko.
    • Windows localhost:
      • Hango sa Tomcat icon sa system tray, at pumili ng "Start service".
      • Pangmalas http://127.0.0.1:8080/ , o marahil http://localhost:8080/ , sa iyong browser. Pansinin na sa hindi pagtupad, ang iyong Tomcat ay mararating mo lamang. Hindi ito maaaring puntahan ng publiko.

Dapat mong tingnan ang Tomcat "Criise" page.

Kung may problema, tingnan ang log file ng Tomcat tomcat/logs/catalina.out .

Mga problema sa instalasyon ng Tomcat?

  • Sa Linux at Mac, kung hindi mo maabot ang Tomcat o ang Mac ERDDAP™ (o marahil ay hindi mo sila maaabot mula sa isang computer sa labas ng iyong firewall) , masusubok mo kung nakikinig si Tomcat sa daungan 8080, sa pamamagitan ng pagmamakinilya (bilang ugat) sa isang command line ng server:

    netstat -tuplen | grep 8080

Iyan ay dapat na bumalik sa isang linya na may katulad na:

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

(kung saan # ay numero) , nagpapahiwatig na isang juva proseso (Malamang na Tomcat) ay nakikinig sa port "8080" para sa "tcp" traffic. Kung walang ibinalik na mga linya, kung ang linya ay bumalik ay lubhang magkaiba, o kung ang dalawa o higit pang mga linya ay ibabalik, kung gayon maaaring magkaroon ng problema sa mga setting ng daungan.

  • Tingnan ang log file ng Tomcat tomcat/logs/catalina.out . Mga problema sa paggamot at ilan ERDDAP™ Ang mga problema sa simula ay halos laging ipinakikita roon. Karaniwan na ito kapag una kang nagtayo ERDDAP™ .

  • Tingnan ang Tomcat website o maghanap ng tulong sa web, pero pakisuyong ipaalam sa amin ang mga problema ninyo at ang mga solusyong nakita ninyo.

  • Tingnan ang sa pagkuha ng karagdagang suporta .  

ERDDAP™ Nasisiyahan

  1. Itakda ang tomcat/content/erddap Iayos ang mga file. Sa Linux, Mac, at Windows, download ErddapContent .zip at ibabad sa loob tomcat directory, paglikha tomcat/content/erddap .

Version 1.0.0, 20333 bytes, MD5=2B8D2A5ED73E42B529C168C60B5, na may petsang 429 2024-10-14

May ilang naunang bersyon din:

  • 2.17 (19,792 bytes, MD5=8F892616BAEF2DF0F4BB34B34AD7C, na may petsang 2022-02-16)
  • 2.18 (19,792 bytes, MD5=8F892616BAEF2DF0F4BB34B34AD7C, na may petsang 2022-02-16)
  • 2.21 (19,810 byte, MD5=1E26F62E7A06191EE68C40B9A29362, na may petsang 2022-10-09)
  • 2.22 (19,810 byte, MD5=1E26F62E7A06191EE68C40B9A29362, na may petsang 2022-12-08)
  • 2.23 (19,810 byte, MD5=1E26F62E7A06191EE68C40B9A29362, na may petsang 2023-02-27)

Iba Pang Direktoryo

Para sa Red Hat Enterprise Linux (RHEL) o para sa ibang sitwasyon kung saan hindi ka pinapayagang baguhin ang Tomcat directory o kung saan mo nais/kailangan upang ilagay ang ERDDAP™ directory sa ibang lugar sa ibang kadahilanan (Halimbawa, kung gumagamit ka ng Jetty sa halip na Tomcat) , dizip ErddapContent .zip sa nais na directory (na yaon lamang tomcat may access ang gumagamit) at itinakda ang erddapContentDirectory pag - aari ng sistema (e.g. erddapContentDirectory =~tomcat/content/erddap ) gayo'y ERDDAP™ ay makasusumpong ng bagong talaang ito ng nilalaman.

setup.xml

Para sa panimulang setup, baguhin mo sa paano man ang mga tagpong ito:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> Mga kalagayan
  • <admin...> Mga kalagayan
  • <baseHttpsUrl> (kapag ikaw ay nagtayo https )

Kapag nililikha mo ang malaking Direktoryo ng Party, mula sa magulang na directory ng BigParent Direktory:

  • Gawin ang tomcat gamitin ang may - ari ng Malaking Direktoryo :
    chown -R tomcat bigParentDirectory
  • Palitan ang "grupo" upang maging tomcat, ang inyong username, o ang pangalan ng isang maliit na grupo na kinabibilangan ng tomcat at lahat ng mga administrador ng Tomcat/ ERDDAP :
    chgrp -R yourUserName bigParentDirectory
  • Ang pagbabago ay nagpapahintulot upang ang tomcat at ang grupo ay bumasa, sumulat, maggawad ng mga pribilehiyo:
    chmod -R ug+rwx bigParentDirectory
  • Tanggalin ang "iba pang" pahintulot ng gumagamit na bumasa, sumulat, o pumatay. Mahalaga ito upang maiwasan ang posibleng sensitibong impormasyon sa loob ERDDAP™ Mga log file at file na may impormasyon tungkol sa mga pribadong dataset.
    chmod -R o-rwx bigParentDirectory

Kakaibang Kapaligiran

Pasimula sa ERDDAP™ v2.13, ERDDAP™ Maaaring pawalang-bisa ng mga administrador ang anumang halaga sa setup.xml sa pamamagitan ng pagtatakda ng isang kapaligirang variable Pangalan ERDDAP _Kahalagahan bago tumakbo ERDDAP™ . Halimbawa, gamitin ERDDAP _baseUrl ang nangingibabaw sa <baseUrl> halaga. Ito'y kapaki - pakinabang kapag naglalagay ERDDAP™ na may lalagyan na gaya ng Docker, yamang maaari mong ilagay ang karaniwang setting sa setup.xml at pagkatapos ay maglaan ng pantanging mga tanawin sa pamamagitan ng iba't ibang kapaligiran. Kung magbibigay ka ng lihim na impormasyon ERDDAP™ sa pamamagitan ng pamamaraang ito, tiyakin na ang impormasyon ay mananatiling lihim. ERDDAP™ basahin lamang ang kapaligiran na pabagu - bago minsan sa bawat simula, sa unang segundo ng startup, kaya ang isang paraan upang gamitin ito ay: itakda ang iba't ibang kapaligiran, magsimula ERDDAP , maghintay hanggang sa ERDDAP™ ay sinisimulan, pagkatapos ay hindi pa naitatakda ang iba't ibang kapaligiran.

datasets.xml

  • Basahin ang mga komento sa Paggawang kasama ng mga kapatid datasets.xml Larawan . Sa kalaunan, pagdating mo ERDDAP™ tumatakbo sa unang pagkakataon (karaniwang kasama lamang ang default datasets) , babaguhin mo ang XML sa tomcat/content/erddap/ datasets.xml upang tiyakin ang lahat ng datos na gusto mo ERDDAP™ upang maglingkod. Dito mo gugugulin ang malaking bahagi ng iyong panahon habang nagtatayo ERDDAP™ at mamaya habang pinananatili ang iyong ERDDAP™ .

Makikita mo ang isang halimbawa datasets.xml tungkol sa GitHub .  

  • (Di - inaasahan) Ngayon o (bahagyang malamang) sa hinaharap, kung nais mong baguhin ang talaksang CSS ng erddap, kopya tomcat/content/erddap/images/erddapStart2.cs hanggang sa tomcat/content/erddap/images/erddap2.cs at pagkatapos ay gumawa ng mga pagbabago rito. Mga Pagbabago erddap2.cs saka lamang makaaapekto kapag ERDDAP™ ay muling naka-arte at kadalasan ay nangangailangan din ang gumagamit na alisin ang mga screw na file ng browser.   ERDDAP™ hindi gagana nang wasto kung ang setup.xml o datasets.xml Ang talaksan ay hindi isang mahusay-pormal na talaksang XML. Kaya, pagkatapos mong ayusin ang mga file na ito, Ito ay isang mabuting ideya upang kumpirmahin na ang resulta ay maayos na XML sa pamamagitan ng paglalagay ng teksto ng XML sa isang XML checker tulad ng XML Paglaganap ng xmlvalid .  

Iluklok ang erddap. talaksang digmaan

  1. Sa Linux, Mac, at Windows, _download erddap.war _ ilagay tomcat/webapps :

Version 2.28.1, 622,676,238 bytes, MD5=48b42260450c8d69ef9521bbc9, na may petsang 2025-09-05

Ang talaksang .war ay malaki dahil ito ay naglalaman ng mataas na resolution baybayin, hangganan, at taas na mga datos na kinakailangan upang lumikha ng mga mapa.

May ilang naunang bersyon din na makukuha.

  • 2.17 (551,068,245 bytes, MD5=5FEA912B5D42EB9591F773EA848D, na may petsang 2022-02-16)
  • 2.18 (551,069,844 bytes, MD5=461325E97E7577EC671DD50246CB8B, na may petsang 2022-02-23)
  • 2.21 (568,644,411 bytes, MD5=F2CFF805893146E932E498FDBD19B6, na may petsang 2022-10-09)
  • 2.22 (567,742,765 bytes, MD5=2B33354F633294213AE2AF4DCF4DA6D0, na may petsang 2022-12-08)
  • 2.23 (572,124,953 bytes, MD5=D843A043C506725EBD6F8EFDCA8FD5F, na may petsang 2023-03-03)
  • 2.24 (568,748,187 bytes, MD5=970fbee172e28b0b807756eecbc898e, na may petsang 2024-06-07)
  • 2.25 (592,292,039 bytes, MD5=652AFC9D1421F00B5F789DA2C4732D4C, na may petsang 2024-11-07)
  • 2.26 (607,404,032 bytes, MD5=99a725108b37708e5420986c16a119, na may petsang 2025-03-31)
  • 2.27.0 (620,554,403 bytes, MD5=3b2086c659°N 2025-06-11)

Configure proxy (Espesipikong paglalagay)

ERDDAP™ ay karaniwang ginagamit sa likod ng isang webserver reverse proxy upang pahintulutan itong ihain sa karaniwang mga daungan ng HTTP (80 at 443) . Ang paghinto ng SSL/TLS ay kadalasang binabaklas din sa webserver proxy layer. Ang espesipikong mga detalye ay depende sa mga kahilingan ng bawat paglalagay.

Apache

  1. Tiyakin na mod_proxy at mod_proxy_ http ay may karga:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Bigyang - diin ang umiiral <VirtualHost> tag (kung may isa) , o magdagdag ng isa sa dulo ng talaksan:
<VirtualHost *:80>
ServerName YourDomain.org
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /erddap http://localhost:8080/erddap
ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Kung ERDDAP™ ay inihahain sa ibang landas /erddap , itinakda rin ang X-Forwarded-Prefix ulo patungo sa Bahagi ng landas Bago ang /erddap . Ang tagpong ito ay angkop para sa isang ERDDAP™ hain /subpath/erdap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Pagkatapos ay ulitin ang Apache: /usr/sbin/apachectl -k Maganda (ngunit kung minsan ito ay nasa ibang directory) .  

GAINX

Sa talaksang pag-aayos ng nginx, ilagay ang mga header na ito:

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;

Kung ERDDAP™ ay inihahain sa ibang landas /erddap , itinakda rin ang X-Forwarded-Prefix ulo patungo sa Bahagi ng landas Bago ang /erddap . Ang tagpong ito ay angkop para sa isang ERDDAP™ hain /subpath/erdap :

proxy_set_header X-Forwarded-Prefix /subpath

Upang makakuha ng NGINX at ERDDAP™ gumagawa nang tama https , kailangan mong ilagay ang sumusunod na snippet sa loob ng Tomcat server.xml <Host> bloke:

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

 

Magsimulang Tomcat

  • (Hindi ko inirerekomenda ang paggamit ng Tomcat Web Application Manler. Kung hindi mo lubusang aalisin at sisimulan ang Tomcat, sa malao't madali ay magkakaroon ka ng mga isyu sa memorya ng PermGen.)
  • (Sa Linux o Mac OS, kung nakalikha ka na ng isang pantanging tagagamit upang patakbuhin ang Tomcat, e.g., tomcat, tandaan na gawin ang sumusunod na mga hakbang gaya ng gumagamit na iyon.)
  • Kung tumatakbo na si Tomcat, isara ang Tomcat kasama si Tomcat (sa Linux o Mac OS) tomcat/bin/shutdown.sh o (sa Windows) tomcat\bin= shutdown.bat

Sa Linux, gamitin ps -ef | Tusong tomcat bago at pagkatapos Pagkasiphayo. sh upang matiyak na ang proseso ng tomcat ay huminto na. Ang proseso ay dapat na itala bago ang paghinto at sa wakas ay hindi itala pagkatapos ng paghinto. Maaaring kumuha ng isa o dalawang minuto para rito ERDDAP™ upang lubusang magsara. Maging matiyaga. O kung parang hindi ito hihinto sa ganang sarili, gamitin ito: -9 <processID>

  • Magsimula Ka sa Tomcat (sa Linux o Mac OS) tomcat/bin/startup.sh o (sa Windows) tomcat\bin\\startup.bat

Ay ERDDAP™ tumatakbo?

Gumamit ng browser para makitahttp://www.YourServer.org/erddap/status.html. ERDDAP™ ay nagsisimula nang walang anumang datasets na nakakarga. Nakakarga ang mga Data sa isang sinulid sa likuran kaya't nagiging makukuhang one-by-one.

Pagputok ng Problema

  • Kapag may dumating na kahilingan mula sa gumagamit, nagtutungo ito sa Apache (sa mga computer ng Linux at Mac OS) , pagkatapos Tomcat, pagkatapos ERDDAP™ .
  • Makikita mo kung ano ang nangyayari sa Apache (at kaugnay na mga pagkakamali) sa mga log file ng Apache.
  • Ikaw kung ano ang nangyayari kay Tomcat (at kaugnay na mga pagkakamali) sa mga log file ng Tomcat ( tomcat/logs/catalina.out at iba pang files sa directory) .
  • Ikaw kung ano ang nangyayari ERDDAP , suriin ang mga mensahe mula sa ERDDAP , at mga maling mensahe mula sa ERDDAP , sa loob ERDDAP™ <bigParentDirectory> /log/log.txt talaksan.
  • Hindi nagsisimula si Tomcat ERDDAP™ hanggang sa makuha ni Tomcat ang kahilingan ERDDAP™ . Kaya makikita mo sa Tomcat log files kung ito ay nagsimula ERDDAP™ o kung may maling mensahe na nauugnay sa pagtatangkang iyon.
  • Kailan ERDDAP™ Nagsisimula, binabago nito ang pangalan ng matanda ERDDAP™ log.txt file ( Nilagyan ng logArchive <CurrentTime> .txt ) at lumilikha ng bagong log.txt file. Kaya kung gayon log.txt Ang talaksan ay luma na, ito ay tanda na ERDDAP™ ay hindi na muling nag - aral kamakailan. ERDDAP™ Sumulat ng log info sa isang neutralidad at isulat mo lamang paminsan - minsan ang buffer sa log file, ngunit maaari kang pilitin ERDDAP™ upang isulat ang pananggalang sa log file sa pamamagitan ng pagdalaw /erddap/status.html .

Suliranin: Lumang Aklat ng Java

Kung gumagamit ka ng bersiyon ng Java na napakatanda na para sa ERDDAP , ERDDAP™ hindi tatakbo at makikita mo ang maling mensahe sa log file ni Tomcat na gaya ng

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

Ang solusyon ay i - update ang pinakabagong bersiyon ng Java at tiyakin na ginagamit ito ni Tomcat.

Suliranin: Mabagal na Unang Pagsisimula

Kailangang magtrabaho nang husto si Tomcat sa unang pagkakataon ng aplikasyon na gaya ng ERDDAP™ ay sinisimulan; lalo na, kailangang buksan nito ang mga pakete erddap.war talaksan (na parang .zip talaksan) . Sa ilang server, ang unang pagtatangkang magmasid ERDDAP™ mga puwesto (30 segundo?) hanggang sa matapos ang gawaing ito. Sa ibang server, ang unang pagtatangka ay mabibigo agad. Subalit kung maghihintay ka ng 30 segundo at sisikaping muli, magtatagumpay ito kung ERDDAP™ ay tamang ikinabit.

Walang solusyon dito. Ganito lamang gumagana ang Tomcat. Subalit ito'y nangyayari lamang sa unang pagkakataon pagkatapos mong maglagay ng isang bagong bersiyon ng ERDDAP™ .

Ibagsak at ulitin

Sa hinaharap, upang magsara (at muling pag - uusap) ERDDAP™ , tingnan Kung Paano Patatahimikin at Ipahinga ang Tomcat at ERDDAP .

Suliranin?

Mga Suliranin sa pagkabit ng Tomcat o ERDDAP™ ? Tingnan ang sa pagkuha ng karagdagang suporta .

Email Notification of New Versions of ERDDAP

Kung nais mong tumanggap ng email kailanma't may bagong bersiyon ng ERDDAP™ o iba pang mahalaga ERDDAP™ mga patalastas, maaari kang sumali ERDDAP™ listahan ng mga patalastas dito . Ang talaang ito ay may katamtamang bilang na humigit - kumulang isang email tuwing ikatlong buwan.

Kaugalian

  • Gawing kaugalian ang iyong ERDDAP™ upang itampok ang inyong organisasyon (hindi NOAA ERD ) .
  • Palitan ang baner na nasa itaas ng lahat ERDDAP™ .html pahina sa pamamagitan ng pag - aayos ng mga pahina <startBodyHtml5> tag sa iyong tag datasets.xml talaksan. ( Kung walang isa man, kopyahin ang default mula sa ERDDAP™ ' tomcat/webapps/erddap/WEB-INF/classes/gov/noa/pfel/erddap/util/messages.xml talaksan sa loob datasets.xml at ayusin ito.) Halimbawa, maaari mong sabihin:
    • Gumamit ng ibang larawan (I.e., logo ng inyong organisasyon) .
    • Palitan ang kulay sa likuran.
    • Pagbabago " ERDDAP™ " to "Youganization's ERDDAP™ "
    • Palitan ang "Easier access sa datos ng agham" sa "Easier access of Organization's data".
    • Palitan ang "Brought to you sa pamamagitan ng" links upang maging links sa iyong organisasyon at mga mapagkukunan ng pondo.
  • Palitan ang impormasyon sa kaliwang bahagi ng home page sa pamamagitan ng pagsasaayos ng <theShortDescriptionHtml> tag sa iyong tag datasets.xml talaksan. ( Kung walang isa man, kopyahin ang default mula sa ERDDAP™ ' tomcat/webapps/erddap/WEB-INF/classes/gov/noa/pfel/erddap/util/messages.xml talaksan sa loob datasets.xml at ayusin ito.) Halimbawa, maaari mong sabihin:
    • Ilarawan kung ano ang ginagawa ng iyong organisasyon at/o grupo.
    • Ilarawan kung anong uri ng datos ito ERDDAP™ na ngayon.
    • Upang baguhin ang larawan na lumilitaw sa mga buslo, ilagay ang favicon ng inyong organisasyon. Ico sa tomcat/content/erddap/images/images/ . Tingnanhttps://en.wikipedia.org/wiki/Favicon.