Installazione

Come fare la configurazione iniziale diERDDAP™sul server

ERDDAP™può essere eseguito su qualsiasi server che supportaJavae Tomcat (e altri server di applicazione come Jetty, ma non li supportiamo) .ERDDAP™è stato testato su Linux (incluso su Amazon's AWS) , Mac e computer Windows.

• Amazzonia -- Se si installaERDDAP™su un'istanza Amazon Web Services EC2, vedere questoAmazon Web Services PanoramicaPrima.
• Docker -- Axiom ora offreERDDAP™in un contenitore Dockere IOOS ora offre unGuida rapida perERDDAP™in un contenitore Docker. È lo standardERDDAP™installazione, ma Axiom l'ha messa in un contenitore di armadietti. Se si utilizza già Docker, probabilmente si preferisce la versione Docker. Se non si utilizza già Docker, generalmente non lo consigliamo. Se hai scelto di installareERDDAP™via Docker, non offriamo alcun supporto per il processo di installazione. Non abbiamo ancora lavorato con Docker. Se lavori con questo, inviaci i tuoi commenti.
• Linux e Mac --ERDDAP™funziona benissimo su computer Linux e Mac. Vedi le istruzioni qui sotto.
• Windows -- Windows va bene per il testERDDAP™e per uso personale (vedi le istruzioni qui sotto) , ma non consigliamo di usarlo per il pubblicoERDDAPS. CorrereERDDAP™su Windows può avere problemi: in particolare,ERDDAP™può essere in grado di eliminare e/o rinominare rapidamente i file. Questo è probabilmente dovuto al software antivirus (ad esempio, da McAfee e Norton) che sta controllando i file per i virus. Se si verifica questo problema (che può essere visto da messaggi di errore nellog.txtfile come "Impossibile eliminare ...") , cambiare le impostazioni del software antivirus può parzialmente alleviare il problema. O considerare l'utilizzo di un server Linux o Mac.

Lo standardERDDAP™istruzioni di installazione per computer Linux, Mac e Windows sono:

0. Assicurarsi che vengano installate dipendenze. Su macchine non Windows (Linux e Mac) Hai bisogno di Csh.

Java

1. PerERDDAP™v2.19+, impostataJava21. Per motivi di sicurezza, è quasi sempre meglio usare l'ultima versione diJava21. Si prega di scaricare e installare l'ultima versione di OpenJDK di Adoptium (Temurin) 21 (LITTA) . Per verificare l'installazione, digitare "/javaJreBinDirectory/java -version", ad esempio /usr/local/jdk-21.0.3+9/jre/bin/java -versione

   ERDDAP™lavori conJavada altre fonti, ma consigliamo Adoptium perché è il principale, comunità sostenuto, libero (come nella birra e nel discorso) versione diJava21 che offre supporto a lungo termine (aggiornamenti gratuiti per molti anni dopo il rilascio iniziale) . Per motivi di sicurezza, si prega di aggiornare il vostroERDDAPLa versione diJavaperiodicamente come nuove versioni diJava21 diventano disponibili da Adoptium.

   ERDDAP™è stato testato e utilizzato ampiamente con 21, non altre versioni. Per vari motivi, non testiamo con né supportiamo altre versioni diJava.  

Tomcat

2. Impostazione Tomcat. Tomcat è il più utilizzatoJavaServer delle applicazioni, che èJavasoftware che si trova tra i servizi di rete del sistema operativo eJavasoftware server comeERDDAP™. È Software Libero e Open Source (FOSS) .

Puoi usare un altroJavaServer delle applicazioni (ad esempio, Jetty) , ma testiamo solo con e supportiamo Tomcat.  

• Scarica Tomcat e disfare il pacchetto sul tuo server o PC. Per motivi di sicurezza, è quasi sempre meglio usare l'ultima versione di Tomcat 10 (versione 9 e seguenti non sono accettabili) che è progettato per lavorare conJava21 o più recente. Qui di seguito, la directory Tomcat verrà chiamata tomcat.

Attenzione! Se hai già un Tomcat che esegue un'altra applicazione web (soprattutto THREDDS) , si consiglia di installareERDDAP™inun secondo TomcatperchéERDDAP™ha bisogno di diverse impostazioni Tomcat e non dovrebbe competere con altre applicazioni per la memoria.

• Su Linux,scaricare il "Core" "tar.gz" Distribuzione di Tomcate disfare le valigie. Si consiglia di disfare i bagagli in /usr/local.
• Su un Mac, Tomcat è probabilmente già installato in /Library/Tomcat, ma dovrebbe aggiornarlo all'ultima versione di Tomcat 10. Se lo scaricate,scaricare il "Core" "tar.gz" Distribuzione di Tomcate lo disfare in /Library/Tomcat.
• Su Windows, è possibilescaricare la distribuzione "Core" "zip" Tomcat (che non incasina con il registro di Windows e che si controlla da una linea di comando DOS) e lo disfare in una directory appropriata. (Per lo sviluppo, utilizziamo la distribuzione "Core" "zip". Facciamo una directory /programs e lo disfare lì.) Oppure è possibile scaricare la distribuzione "Core" "64-bit di Windows zip", che include più funzionalità. Se la distribuzione è un installatore di Windows, probabilmente metterà Tomcat in, per esempio, /Program Files/apache-tomcat-10.0.23 .  

server.xml

• server.xml- Nel file tomcat/conf/server.xml, ci sono due modifiche che si dovrebbero apportare a ciascuno dei due<Connector> tags- uno per

        <Connector port="8080" 

e uno per

        <Conector port="8443"

1. (Consigliato) Aumentare il valore dei parametri di connessioneTimeout, forse a 300000 (millisecondi) (che è 5 minuti) .
2. (Consigliato) Aggiungi un nuovo parametro: rilassataQueryChars="\[\]|" Questo è facoltativo e leggermente meno sicuro, ma rimuove la necessità per gli utenti di codificare per cento questi caratteri quando si verificano nei parametri di un URL di richiesta dell'utente.  

contenuto.xml

• contest.xml -- Risorse Cache - In tomcat/conf/context.xml, subito prima</Context> tag, modificare il tag Risorse (o aggiungerlo se non è già lì) per impostare la cache Parametro MaxSize a 80000: <Risorse cachingAllowed="true" cacheMaxSize="80000" /> Questo evita numerosi avvertimenti in catalina. fuori che tutto comincia con "ATTENZIONE\[principale\]org.apache.catalina.webresources.Cache.getResources Incapace di aggiungere la risorsa\[/WEB-INF/classi/...]"  

Tempo di Apache

• Su computer Linux, modificare le impostazioni di timeout di Apache in modo che le richieste degli utenti che richiedono tempo non timeout (con quello che spesso appare come un errore "Proxy" o "Bad Gateway") . Come utente root:
  1. Modificare il Apachehttpfile d.conf (di solito in /etc/httpd/conf/) : Cambiare l'esistente<Timeout> impostazione (o aggiungere uno alla fine del file) a 3600 (secondi) , invece dei 60 o 120 secondi di default. Cambiare l'esistente<ProxyTimeout> impostazione (o aggiungere uno alla fine del file) a 3600 (secondi) , invece dei 60 o 120 secondi di default.
  2. Riavviare Apache: /usr/sbin/apachectl -k graziosa (ma a volte è in una directory diversa) .  
  • Raccomandazione di sicurezza: Vediqueste istruzioniaumentare la sicurezza dell'installazione di Tomcat, soprattutto per i server pubblici.  
  • Per il pubblicoERDDAP™installazioni su Linux e Mac, è meglio configurare Tomcat (il programma) come appartenente all'utente "tomcat" (un utente separato con autorizzazioni limitate e chenon ha password) . Così, solo l'utente super può passare ad agire come tomcat utente. Questo rende impossibile per gli hacker di accedere al server come tomcat utente. E in ogni caso, si dovrebbe fare in modo che l'utente tomcat ha autorizzazioni molto limitate sul file system del server (leggi+write+execute privilegi per l'albero della directory apache-tomcat e<bigParentDirectory> e privilegi di sola lettura per le directory con dati cheERDDAP™ha bisogno di accesso a).

    • È possibile creare l'account utente tomcat (che non ha password) utilizzando il comando sudo useradd tomcat -s /bin/bash -p '\* '

    • È possibile passare a lavorare come tomcat utente utilizzando il comando Condividi su Twitter (Ti chiederà la password del superutente per il permesso di farlo.)

    • È possibile smettere di lavorare come tomcat utente utilizzando il comando uscita

    • Fai la maggior parte del resto del Tomcat eERDDAP™istruzioni di configurazione come utente "tomcat". Successivamente, eseguire gli script start.sh e shutdown.sh come utente "tomcat" in modo che Tomcat ha il permesso di scrivere ai suoi file di registro.

    • Dopo aver disacco Tomcat, dal genitore della directory apache-tomcat:

      • Modificare la proprietà dell'albero directory apache-tomcat all'utente tomcat. chown -R tomcat apache-tomcat-10.0.23 (ma sostituire il nome effettivo della directory tomcat) .

      • Modificare il "gruppo" per essere tomcat, il nome utente o il nome di un piccolo gruppo che include tomcat e tutti gli amministratori di Tomcat/ERDDAPPer esempio, chgrp -R UserName_ apache-tomcat-10.0.23

      • Cambiare le autorizzazioni in modo che tomcat e il gruppo hanno letto, scrivere, eseguire privilegi, ad esempio,. chmod -R ug+rwx apache-tomcat-10.0.23

      • Rimuovere i permessi dell'utente "altro" per leggere, scrivere o eseguire: chmod -R o-rwx apache-tomcat-10.0.23 Questo è importante, perché impedisce ad altri utenti di leggere informazioni eventualmente sensibili inERDDAP™File di configurazione.

Memoria

• Impostare le variabili ambientali di Tomcat

Su Linux e Mac: Creare un file tomcat/bin/setenv.sh (o in Red Hat Enterprise Linux\[RHEL\], modifica ~tomcat/conf/tomcat10.conf) per impostare le variabili di ambiente di Tomcat. Questo file verrà utilizzato da tomcat/bin/startup.sh e shutdown.sh. Il file dovrebbe contenere qualcosa come:

    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_

(ma sostituire i nomi delle directory dal computer) . (Se hai impostato in precedenza JRE\_HOME, puoi rimuoverlo.)
Su Mac, probabilmente non è necessario impostare JAVA\_HOME.

Su Windows: Creare un file tomcat\bin\setenv.bat per impostare le variabili di ambiente di Tomcat. Questo file verrà utilizzato da tomcat\bin\startup.bat eshutdown.bat. Il file dovrebbe contenere qualcosa come:

    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_"

(ma sostituire i nomi delle directory dal computer) . Se questo è solo per i test locali, rimuovere "-server". (Se hai impostato in precedenza JRE\_HOME, puoi rimuoverlo.)

Le impostazioni di memoria -Xmx e -Xms sono importanti perchéERDDAP™funziona meglio con più memoria. Impostare sempre -Xms allo stesso valore di -Xmx.

• Per sistemi operativi a 32 bit e 32 bitJava: 64 bitJavaè molto meglio di 32 bitJava, ma 32 bitJavafunzionerà finché il server non è molto occupato. Più la memoria fisica nel server è migliore: 4+ GB è davvero buono, 2 GB è ok, meno non è raccomandato. Con 32 bitJava, anche con abbondante memoria fisica, Tomcat eJavanon correre se si tenta di impostare -Xmx molto sopra 1500M (1200M su alcuni computer) . Se il server ha meno di 2GB di memoria, ridurre il valore -Xmx (in 'M'egaBytes) a 1/2 della memoria fisica del computer.

• Per sistemi operativi a 64 bit e 64 bitJava: 64 bitJavafunzionerà solo su un sistema operativo a 64 bit.

  • ConJava8, è necessario aggiungere \-d64 al parametro Tomcat CATALINA\_OPTS in setenv.bat
  • ConJava21, si sceglie 64 bitJavaquando si scarica una versione diJavamarcato "64 bit".

Con 64 bitJava, Tomcat eJavapuò utilizzare impostazioni -Xmx e -Xms molto elevate. Più la memoria fisica nel server è migliore. Come suggerimento semplicistico: si consiglia di impostare -Xmx e -Xms a (in 'M'egaBytes) a 1/2 (o meno) della memoria fisica del computer. Puoi vedere se Tomcat,JavaeERDDAP™sono effettivamente in esecuzione in modalità a 64 bit cercando " bit", inERDDAP's Daily Report email o nel bigParentDirectory/logs/log.txtfile (bigParentDirectory è specificato insetup.xml) .

Collezione Garbage

• InERDDAP™'log.txtfile, vedrete molti "GC (Ricorso di annullamento) " messaggi. Di solito non è un problema. È un messaggio frequente da un normale funzionamentoJavadicendo che ha appena finito una piccola raccolta di rifiuti perché è finito di stanza in Eden (la sezione dellaJavamucchio per oggetti molto giovani) . Di solito il messaggio ti mostra memoryUseBefore\->memoryUseAfter. Se questi due numeri sono vicini insieme, significa che la raccolta di rifiuti non era produttiva. Il messaggio è solo un segno di problemi se è molto frequente (ogni pochi secondi) , non produttivo, e i numeri sono grandi e non in crescita, che insieme indicano cheJavaha bisogno di più memoria, sta lottando per liberare la memoria, ed è in grado di liberare la memoria. Questo può accadere durante un tempo stressante, poi andare via. Ma se persiste, questo è un segno di guai.
• Se vedi java.lang.OutOfMemoryError è inERDDAP™'log.txtfile, vediInformazioni generaliper consigli su come diagnosticare e risolvere i problemi.  

Permissioni

• Su Linux e Mac, modificare le autorizzazionidi tutti\*.shfile in tomcat/bin/ da eseguibile dal proprietario, ad esempio, con

    chmod +x \\*.sh  

Fonti

• Fonti per immagini:Preferiamo fortemente il liberofont DejaVuall'altroJavafont. Utilizzando questi font è fortemente raccomandato ma non richiesto.

Se si sceglie di non utilizzare i font DejaVu, è necessario modificare l'impostazione fontFamily in setup.xml a<fontFamily>SansSerif</fontFamily>, che è disponibile con tuttiJavadistribuzioni. Se si imposta fontFamily al nome di un carattere che non è disponibile,ERDDAP™non caricare e stamperà un elenco di caratteri disponibili nel file log.txt. Devi usare uno di quei caratteri.

Se si sceglie di utilizzare i font DejaVu, si prega di assicurarsi che l'impostazione fontFamily in setup.xml è<carattere Famiglia > DejaVu Sans</fontFamily>

Per installare i font DejaVu, scaricareDejaVuFonte.zip (5,522,795 byte, MD5=33E1E61FAB06A547851ED308B4FFEF42) e deselezionare i file del carattere in una directory temporanea.

• Su Linux:
  • Per Linux AdoptiumJavadistribuzioni, vediqueste istruzioni.
  • Con altriJavadistribuzioni: Come utente Tomcat, copiare i file del carattere in _JAVA\HOME/lib/fonts soJavapuò trovare i caratteri. Ricorda: se/quando in seguito si aggiorna a una nuova versione diJava, è necessario reinstallare questi font.
• Su Mac: per ogni file di carattere, fare doppio clic su di esso e quindi fare clic su Install Font.
• Su Windows 7 e 10: in Windows Explorer, selezionare tutti i file del carattere. Fare clic destro. Clicca su Install.  

Prova Tomcat

• Prova la tua installazione Tomcat.

  • Linux:

    • Come utente "tomcat", eseguire tomcat/bin/startup.sh
    • Visualizza il tuo URL + ":8080/" nel tuo browser (ad esempio, http://coastwatch.pfeg.noaa.gov:8080/ ) .
    • Si dovrebbe vedere la pagina Tomcat "Congratulations". Se ci sono problemi, vedere il file di registro Tomcat tomcat/logs/catalina.out.

  • Mac (eseguire tomcat come utente dell'amministratore di sistema) :

    • Correre tomcat/bin/startup.sh
    • Visualizza il tuo URL + ":8080/" nel tuo browser (ad esempio, http://coastwatch.pfeg.noaa.gov:8080/ ) . Nota che per impostazione predefinita, il tuo Tomcat è accessibile solo da te. Non è pubblicamente accessibile.
    • Si dovrebbe vedere la pagina Tomcat "Congratulations". Se ci sono problemi, vedere il file di registro Tomcat tomcat/logs/catalina.out.

  • Windows localhost:

    • Fare clic con il tasto destro sull'icona Tomcat nel vassoio di sistema e scegliere "Avvia servizio".
    • Vista http://127.0.0.1:8080/ o forse http://localhost:8080/ , nel tuo browser. Nota che per impostazione predefinita, il tuo Tomcat è accessibile solo da te. Non è pubblicamente accessibile.
    • Si dovrebbe vedere la pagina Tomcat "Congratulations". Se ci sono problemi, vedere il file di registro Tomcat tomcat/logs/catalina.out.

Problemi con l'installazione di Tomcat?

• Su Linux e Mac, se non riesci a raggiungere Tomcat oERDDAP™ (o forse non si può raggiungere da un computer al di fuori del firewall) , si può verificare se Tomcat sta ascoltando la porta 8080, digitando (come radice) su una riga di comando del server:

    netstat -tuplen | grep 8080  

Questo dovrebbe restituire una riga con qualcosa come:

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

(dove '#' è qualche cifra) , indicando che un processo "java" (presumibilmente Tomcat) sta ascoltando sul porto "8080" per il traffico "tcp". Se nessuna riga è stata restituita, se la linea restituita è significativamente diversa, o se sono state restituite due o più linee, allora potrebbe esserci un problema con le impostazioni della porta.

• Vedere il file di registro Tomcat tomcat/logs/catalina.out. Problemi Tomcat e alcuniERDDAP™problemi di avvio sono quasi sempre indicati lì. Questo è comune quando si è in primo pianoERDDAP™.
• Vedere laTomcatsito web o cercare il web per aiuto, ma per favore fateci sapere i problemi che avete avuto e le soluzioni che avete trovato.
• Guarda la nostrasezione per ottenere supporto aggiuntivo.  

ERDDAP™Contenuto

3. Impostare il_tomcat_/content/erddapfile di configurazione.
   Su Linux, Mac e Windows, scaricareerddapContent.zip (versione 1.0.0, 20333 byte, MD5=2B8D2A5AE5ED73E3A42B529C168C60B5, datata 2024-10-14) e szip in tomcat, creando_tomcat_/content/erddap.

   \[Sono disponibili anche alcune versioni precedenti: 2.1. (19,792 byte, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, datata 2022-02-16)
   2.18 (19,792 byte, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, datata 2022-02-16)
   2.21 (19,810 byte, MD5=1E26F62E7A06191EE68C40B9A29362, datata 2022-10-09)
   2.22 (19,810 byte, MD5=1E26F62E7A06191EE68C40B9A29362, datata 2022-12-08) 2.23 (19,810 byte, MD5=1E26F62E7A06191EE68C40B9A29362, datata 2023-02-27) e szip in tomcat, creando_tomcat_/content/erddap.\]

Altri cataloghi

Per Red Hat Enterprise Linux (RHEL) o per altre situazioni in cui non è consentito modificare la directory Tomcat o dove si desidera/necessario mettereERDDAP™directory dei contenuti in un'altra posizione per qualche altro motivo (per esempio, se si utilizza Jetty invece di Tomcat) , unzip erddapContent.zipnella directory desiderata (a cui solo utente=tomcat ha accesso) e impostare ilerddapContentDirectoryproprietà del sistema (ad esempio,erddapContentDirectory=~tomcat/content/erddap) CosìERDDAP™può trovare questa nuova directory di contenuti.

setup.xml

• Leggi i commenti in_tomcat_/content/erddap/ setup.xml e apportare le modifiche richieste. setup.xml è il file con tutte le impostazioni che specificano come il vostroERDDAP™Si comporta. Per la configurazione iniziale, devi almeno modificare queste impostazioni:

    <bigParentDirectory>, <emailEverythingTo>, <baseUrl>, <email.\\*>, <admin.\\*> (and <baseHttpsUrl> when you set up https).

Quando crei la bigParentDirectory, dalla directory madre di bigParentDirectory:

• Fare utente=tomcat il proprietario del grandeParentDirectory, ad esempio,

        chown -R tomcat _bigParentDirectory_

• Modificare il "gruppo" per essere tomcat, il nome utente o il nome di un piccolo gruppo che include tomcat e tutti gli amministratori di Tomcat/ERDDAPPer esempio,

        chgrp -R _yourUserName_ _bigParentDirectory_

• Cambiare le autorizzazioni in modo che tomcat e il gruppo hanno letto, scrivere, eseguire privilegi, ad esempio,.

        chmod -R ug+rwx _bigParentDirectory_

• Rimuovere i permessi dell'utente "altro" per leggere, scrivere o eseguire. Questo è importante per evitare la lettura di informazioni eventualmente sensibili inERDDAP™file di registro e file con informazioni su dataset privati.:

        chmod -R o-rwx _bigParentDirectory_

Variabili dell'ambiente

A partire daERDDAP™2, del regolamento (CEE) n.ERDDAP™gli amministratori possono sovrascrivere qualsiasi valore in setup.xml specificando una variabile di ambiente denominataERDDAP\_valueName prima di eseguireERDDAP™. Per esempio, utilizzareERDDAP\_baseUrl sovrascrive il<baseUrl> valore. Questo può essere utile quando si distribuisceERDDAP™con un contenitore come Docker, come è possibile mettere le impostazioni standard in setup.xml e quindi fornire impostazioni speciali tramite variabili di ambiente. Se fornisce informazioni segrete aERDDAP™tramite questo metodo, assicurarsi di controllare che le informazioni rimangano segrete.ERDDAP™solo legge variabili di ambiente una volta all'avvio, nel primo secondo di avvio, quindi un modo per usare questo è: impostare le variabili di ambiente, avviareERDDAP♪, aspetta fino a quando ♪ERDDAP™è iniziato, quindi unset le variabili di ambiente.

datasets.xml

• Leggi i commenti in Lavorare con ildatasets.xmlFile . Dopo teERDDAP™correre per la prima volta (di solito con solo i dati predefiniti) , modificherai l'XML in_tomcat_/content/erddap/ datasets.xml per specificare tutti i set di dati che desideriERDDAP™per servire. Questo è dove trascorrerete la maggior parte del vostro tempo durante la configurazioneERDDAP™e più tardi mantenendo il vostroERDDAP™.

Si può vedere un esempiodatasets.xmlsu GitHub.  

• (Diversamente) Ora o (leggermente più probabile) in futuro, se si desidera modificare il file CSS di erddap, fare una copia di_tomcat_/content/erddap/images/erddapStart2.css chiamato erddap2.css e poi fare modifiche ad esso. Le modifiche a erddap2.css hanno effetto solo quandoERDDAP™è riavviato e spesso anche richiedono all'utente di cancellare i file memorizzati nella cache del browser.   ERDDAP™non funzionerà correttamente se il setup.xml odatasets.xmlil file non è un file XML ben formato. Quindi, dopo aver modificato questi file, è una buona idea verificare che il risultato sia ben formato XML incollando il testo XML in un checker XML comexmlvalidazione.  

Installare il file erddap.war

4. Su Linux, Mac e Windows, scaricareerddap.warin tomcat/webapps . (versione 2.25_1, 592,292,039 byte, MD5=652AFC9D1421F00B5F789DA2C4732D4C, datata 2024-11-07)

Il file .war è grande perché contiene costi di alta risoluzione, confine e dati di elevazione necessari per creare mappe.

\[Sono disponibili anche alcune versioni precedenti. 2.1. (551,068,245 byte, MD5=5FEA912B5D42E50EAB9591F773EA848D, datata 2022-02-16)
2.18 (551,069,844 byte, MD5=461325E97E7577EC671DD50246CCFB8B, datata 2022-02-23)
2.21 (568,644,411 byte, MD5=F2CFF805893146E932E498FDDBD519B6, datata 2022-10-09)
2.22 (567,742,765 byte, MD5=2B33354F633294213AE2AFDDCF4DA6D0, datata 2022-12-08) 2.23 (572,124,953 byte, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, datata 2023-03-03) 2.24 (568,748,187 byte, MD5=970fbee172e28b0b8a07756eecbc898e, datata 2024-06-07) \]

ProxyPass

5. Utilizzare il proxy Passare in modo che gli utenti non devono mettere il numero di porta, ad esempio, : 8080, nell'URL. Su computer Linux, se Tomcat è in esecuzione in Apache, si prega di modificare il Apachehttpfile d.conf (di solito in /etc/httpd/conf/) per consentire il traffico HTTP da/perERDDAP™senza richiedere il numero della porta, ad esempio : 8080, nell'URL. Come utente root:
   1. Modificare l'esistente<VirtualHost> tag (se c'è uno) , o aggiungere uno alla fine del file:

        <VirtualHost \\*:80>
           ServerName _YourDomain.org_
           ProxyRequests Off
           ProxyPreserveHost On
           ProxyPass /erddap http://localhost:8080/erddap
           ProxyPassReverse /erddap http://localhost:8080/erddap
        </VirtualHost>

2. Poi riavvia Apache: /usr/sbin/apachectl -k graziosa (ma a volte è in una directory diversa) .  

NGINX

(UNCOMMON) Se stai usandoNGINX (un server web e un bilanciatore di carico) : per ottenere NGINX eERDDAP™lavorare correttamente conhttps, è necessario mettere il seguente snippet all'interno del server Tomcat.xml<Host> blocco:

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

E nel file di configurazione nginx, è necessario impostare queste intestazioni:

      proxy\\_set\\_header Host              $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;

(Grazie a Kyle Wilcox.)
 

Iniziare Tomcat

• (Non consiglio di usare Tomcat Web Application Manager. Se non si completamente shutdown e avvio Tomcat, prima o poi si avrà PermGen problemi di memoria.)
   
• (In Linux o Mac OS, se hai creato un utente speciale per eseguire Tomcat, ad esempio, tomcat, ricorda di fare i seguenti passaggi come quell'utente.)
   
• Se Tomcat è già in esecuzione, spegnere Tomcat con (in Linux o Mac OS) tomcat/bin/shutdown.sh o (in Windows) Non è vero.shutdown.bat

Su Linux, usare ps -ef|grep tomcat prima e dopo shutdown.sh per assicurarsi che il processo di tomcat si sia fermato. Il processo dovrebbe essere elencato prima dell'arresto e alla fine non elencato dopo l'arresto. Potrebbe volerci un minuto o due perERDDAP™per chiudere completamente. Sii paziente. O se sembra che non si fermerà da solo, usare: uccidere -9 processID

• Inizia Tomcat con (in Linux o Mac OS) tomcat/bin/startup.sh o (in Windows) tomcat\bin\\startup.bat

ÈERDDAP™Correre?

Utilizzare un browser per cercare di visualizzare http://www.YourServer.org/erddap/status.html
ERDDAP™si avvia senza alcun dataset caricato. I set di dati sono caricati in un thread di sfondo e quindi diventano disponibili uno per uno.

Risoluzione dei problemi

• Quando una richiesta da parte di un utente entra, va a Apache (su computer Linux e Mac OS) Poi Tomcat,ERDDAP™.
• Puoi vedere cosa succede a Apache (e relativi errori) nei file di registro Apache.
• #può vedere cosa arriva a Tomcat (e relativi errori) nei file di registro Tomcat (tomcat/logs/catalina.out e altri file in quella directory) .
• #può vedere cosa succedeERDDAP, messaggi diagnostici daERDDAP, e messaggi di errore daERDDAP, nelERDDAP™ <bigParentDirectory>logs/log.txt file.
• Tomcat non iniziaERDDAP™fino a quando Tomcat ottiene una richiestaERDDAP™. Così si può vedere nei file di registro Tomcat se è iniziatoERDDAP™o se c'è un messaggio di errore relativo a quel tentativo.
• QuandoERDDAP™inizia, rinomina il vecchioERDDAP™file log.txt (logArchivedAt_CurrentTime_.txt) e crea un nuovo file log.txt. Quindi, se il registro. il file txt è vecchio, è un segno cheERDDAP™di recente non ha ricominciato.ERDDAP™scrive informazioni di registro a un buffer e scrive solo il buffer al file di registro periodicamente, ma è possibile forzareERDDAP™per scrivere il buffer al file di registro visitando .../erddap/status.html.

Problemi: Vecchia versione diJava

Se si utilizza una versione diJavache è troppo vecchio perERDDAP♪ERDDAP™non verrà eseguito e vedrai un messaggio di errore nel file di registro di Tomcat come Eccezione nel thread "main" java.lang.UnsupportedClassVersionError: some/class/name: Non supportato versione major.minor someNumber La soluzione è quella di aggiornare alla versione più recente diJavae assicurarsi che Tomcat lo stia usando.

Problemi: avvio lento prima volta

Tomcat deve fare un sacco di lavoro la prima volta un'applicazione comeERDDAP™è iniziato; in particolare, deve disfare il erddap. file di guerra (che è come.zipfile) . Su alcuni server, il primo tentativo di visualizzareERDDAP™stalle (30 secondi?) fino a che questo lavoro non è finito. Su altri server, il primo tentativo fallirà immediatamente. Ma se si aspetta 30 secondi e riprovare, avrà successo seERDDAP™è stato installato correttamente. Non c'è rimedio per questo. Questo è semplicemente il modo in cui Tomcat funziona. Ma si verifica solo la prima volta dopo che si installa una nuova versione diERDDAP™.

Chiudi e riavvia

In futuro, per chiudere (e riavviare) ERDDAP, vediCome chiudere e riavviare Tomcat eERDDAP.

Problemi?

Problemi di installazione di Tomcat oERDDAP? Guarda la nostrasezione per ottenere supporto aggiuntivo.

Notifica e-mail di nuove versioni diERDDAP

Se si desidera ricevere un'email ogni volta che una nuova versione diERDDAP™è disponibile o altro importanteERDDAP™annunci, si può aderire alERDDAP™elenco annunciQui. Questa lista media approssimativamente una e-mail ogni tre mesi.

Personalizzare

Personalizza il tuoERDDAP™per evidenziare la vostra organizzazione (nonNOAA ERD) .

• Cambiare il banner che appare in cima a tuttiERDDAP™.html pagine modificando<startBodyHtml5> tag nel tuodatasets.xmlfile. (Se non ce n'è uno, copia il default daERDDAP' \[tomcat\]/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml file indatasets.xmle modificarlo.) Per esempio, si potrebbe:
  • Utilizzare un'immagine diversa (il logo della vostra organizzazione) .
  • Cambia il colore di sfondo.
  • Cambiare "ERDDAP" a "YourOrganization'sERDDAP"
  • Modifica "Accesso più semplice ai dati scientifici" per "Accesso più semplice ai dati di YourOrganization".
  • Modificare i link "Brought to you by" per essere link alla vostra organizzazione e fonti di finanziamento.
• Modificare le informazioni sul lato sinistro della home page modificando le<theShortDescriptionHtml> tag nel tuodatasets.xmlfile. (Se non ce n'è uno, copia il default daERDDAP' \[tomcat\]/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml file indatasets.xmle modificarlo.) Per esempio, si potrebbe:
  • Descrivi cosa fa la tua organizzazione e/o il tuo gruppo.
  • Descrivere che tipo di dati questoERDDAP™ha.
• Per cambiare l'icona che appare sulle schede del browser, mettere il favicon della vostra organizzazione. Ico in_tomcat_/content/erddap. Vedi https://en.wikipedia.org/wiki/Favicon .