Pasar al contenido principal

Instala

Cómo hacer la configuración inicial ERDDAP™ en su servidor

ERDDAP™ puede ejecutarse en cualquier servidor que soporta Java y Tomcat (y otros servidores de aplicaciones como Jetty, pero no los apoyamos) . ERDDAP™ ha sido probado en Linux (incluido en el AWS de Amazon) , Mac y ordenadores Windows.

  • Docker -- Proporcionamos ERDDAP™ en un contenedor Docker IOOS ahora ofrece un Guía de inicio rápido ERDDAP™ en un contenedor Docker . Es el estándar. ERDDAP™ instalación, en un contenedor Docker. A través de Docker Compongamos que proporcionamos maneras fáciles de establecer ssl y monitoreo, leer más Documentación de Docker . Si ya usas Docker, probablemente preferirás la versión Docker. Si usted está buscando para ejecutar en los servicios de la nube usted probablemente prefiere la versión Docker.
  • Amazon -- Si usted está instalando ERDDAP™ en una instancia de Amazon Web Services EC2, ver esto Amazon Web Services Overview primero.
  • Linux y Macs -- ERDDAP™ funciona muy bien en computadoras Linux y Mac. Vea las instrucciones a continuación.
  • Windows -- Windows está bien para probar ERDDAP™ y para uso personal (ver las instrucciones siguientes) , pero no recomendamos utilizarlo para público ERDDAP™ despliegues. Corriendo ERDDAP™ en Windows puede tener problemas: en particular, ERDDAP™ puede ser incapaz de borrar y/o renombrar archivos rápidamente. Esto probablemente se debe al software antivirus (por ejemplo, de McAfee y Norton) que está revisando los archivos para virus. Si te enfrentas a este problema (que puede ser visto por mensajes de error en log.txt archivo "Incapaz de eliminar ..."), cambiar la configuración del software antivirus puede aliviar parcialmente el problema. O considere usar un servidor Linux o Mac en su lugar.

El estándar ERDDAP™ Instrucciones de instalación para computadoras Linux, Macs y Windows son:

  1. Asegúrese de que cualquier dependencia esté instalada. En máquinas no Windows (Linux y Mac) Necesitas csh.

Java

  1. Para ERDDAP™ v2.19+, establecido Java 21. Por razones de seguridad, es casi siempre mejor utilizar la última versión de Java 21. Por favor, descargar e instalar la última versión de OpenJDK de Adoptium (Temurin) 21 (LTS) . Para verificar la instalación, ejecutar /javaJreBinDirectory/java -versión Por ejemplo /usr/local/jdk-21.0.3+9/jre/bin/java -versión .

    ERDDAP™ obras con Java de otras fuentes, pero recomendamos Adoptium porque es el principal, apoyado por la comunidad, gratis (como en cerveza y discurso) versión de Java 21 que ofrece soporte a largo plazo (actualizaciones gratuitas durante muchos años pasado la liberación inicial) . Por razones de seguridad, por favor, actualice su ERDDAP 's versión de Java periódicamente como nuevas versiones Java 21 están disponibles desde Adoptium.

    ERDDAP™ ha sido probado y utilizado ampliamente con 21, no otras versiones. Por varias razones, no probamos ni apoyamos otras versiones de Java .  

Tomcat

  1. Configuración Tomcat . Tomcat es el más utilizado Java Servidor de aplicación, que es Java software que se encuentra entre los servicios de red del sistema operativo y Java software servidor como ERDDAP™ . Es software libre y de código abierto (FOSS) .

Puedes usar otro Java Application Server (por ejemplo, Jetty) , pero sólo probamos con y apoyamos a Tomcat.

  • Descargue Tomcat y desempaque en su servidor o PC. Por razones de seguridad, es casi siempre mejor utilizar la última versión de Tomcat 10 (no son aceptables) que está diseñado para trabajar con Java 21 o más nuevo. A continuación, el directorio Tomcat se denominará tomcat .

__Warning! Si ya tienes un Tomcat ejecutando alguna otra aplicación web (especialmente THREDDS) , te recomendamos que instales ERDDAP™ dentro un segundo Tomcat , porque ERDDAP™ necesita diferentes configuraciones de Tomcat y no debería tener que lidiar con otras aplicaciones para la memoria.

  • En Linux, descargar el "Core" "tar .gz " Distribución Tomcat y desempacarlo. Recomendamos desempacarlo en /usr/local .
  • En un Mac, Tomcat probablemente ya está instalado en /Library/Tomcat , pero debe actualizarlo a la última versión de Tomcat 10. Si lo descargas, descargar el "Core" "tar .gz " Distribución Tomcat y desempacarlo /Library/Tomcat .
  • En Windows, usted puede descargar la distribución "Core" "zip" Tomcat (que no se mete con el registro de Windows y que controla desde una línea de comando DOS) y deshacerlo en un directorio apropiado. (Para el desarrollo, utilizamos la distribución "Core" "zip". Hacemos un /programas directorio y deshacerlo allí.) O puede descargar la distribución "Core" "64-bit Windows zip", que incluye más características. Si la distribución es un instalador de Windows, probablemente pondrá a Tomcat, por ejemplo, / Archivos de programa /apache-tomcat-10.0.23 .  

server.xml

  • server.xml - En el tomcat/conf/server.xml archivo, hay dos cambios que usted debe hacer a cada uno de los dos <Connector> tags (uno para "Puente Connector" y uno para "Puente Conector" ) .
    1. (Recomendado) Aumentar el conexión Timeout valor del parámetro, quizás a 300000 (milisegundos, que es 5 minutos) .
    2. (Recomendado) Añadir un nuevo parámetro: relaxedQueryChars="[] | " . Esto es opcional y ligeramente menos seguro, pero elimina la necesidad de que los usuarios codifican por ciento estos caracteres cuando se presentan en los parámetros de la URL de solicitud del usuario.  

content.xml

  • context.xml -- Caché de recursos - In tomcat/conf/context.xml , justo antes del </Context> etiqueta, cambiar la etiqueta Recursos (o añadirlo si no está allí) para establecer el caché Parámetro MaxSize a 80000:
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Esto evita numerosas advertencias en catalina. que todo comienza con

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

 

Apache Timeout

  • En las computadoras Linux, cambia la configuración de tiempo de Apache para que las solicitudes de usuario que consumen tiempo no tengan tiempo (con lo que a menudo aparece como un error "Proxy" o "Bad Gateway") . Como usuario raíz:
    • Modificar el Apache http d.conf archivo (generalmente en /etc/ http d/conf/ ) :
      • Cambio de las existentes <Timeout> configuración (o añadir uno al final del archivo) a 3600 (segundos) , en lugar de los 60 o 120 segundos predeterminados.
      • Cambio de las existentes <ProxyTimeout> configuración (o añadir uno al final del archivo) a 3600 (segundos) , en lugar de los 60 o 120 segundos predeterminados.
    • reiniciar Apache: /usr/sbin/apachectl -k Graceful (pero a veces está en un directorio diferente) .

Seguridad

 

  • Recomendación de seguridad: See estas instrucciones para aumentar la seguridad su instalación de Tomcat, especialmente para servidores públicos.  
  • Para público ERDDAP™ instalaciones en Linux y Macs, es mejor configurar Tomcat (el programa) como perteneciente al usuario tomcat (un usuario separado con permisos limitados y que no tiene contraseña ) . Así, sólo el super usuario puede cambiar a actuar como usuario tomcat . Esto hace imposible que los hackers inicien sesión en su servidor como usuario tomcat . Y en cualquier caso, deberías hacerlo para que el tomcat usuario tiene permisos muy limitados en el sistema de archivos del servidor (read+write+ejecute privilegios para el apache-tomcat árbol del directorio y <bigParentDirectory> y privilegios sólo lectura para directorios con datos que ERDDAP™ necesita acceso a).
    • Puedes crear el tomcat cuenta de usuario (que no tiene contraseña) utilizando el comando:
      sudo useradd tomcat -s /bin/bash -p '*'
    • Puede cambiar a trabajar como usuario tomcat utilizando el comando
      sudo su - tomcat
      (Le pedirá la contraseña de superusuario para obtener permiso para hacer esto.)
      • Puede dejar de trabajar como usuario tomcat utilizando el comando
      exit
      • Hacer la mayor parte del resto del Tomcat y ERDDAP™ Instrucciones de configuración como usuario tomcat . Más tarde, corre. startup.sh y Cállate. # scripts como usuario tomcat para que Tomcat tenga permiso para escribir a sus archivos de registro.
      • Después de desempacar a Tomcat, del padre del apache-tomcat directorio:
        • Cambiar la propiedad del árbol del directorio apache-tomcat al usuario tomcat.
          chown -R tomcat apache-tomcat-10.0.23
          (pero sustituya el nombre real de su directorio tomcat) .
        • Cambiar el "grupo" para ser tomcat, tu nombre de usuario, o el nombre de un pequeño grupo que incluye tomcat y todos los administradores de Tomcat/ ERDDAP :
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Cambiar permisos para que tomcat y el grupo hayan leído, escriban, ejecuten privilegios:
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Eliminar los permisos del usuario "otro" para leer, escribir o ejecutar:
          chmod -R o-rwx apache-tomcat-10.0.23

Esto es importante, porque evita que otros usuarios lean información posiblemente sensible en ERDDAP™ Configuración de archivos.

Memoria

Establecer variables ambientales de Tomcat

  • En Linux y Macs: Crear un archivo tomcat/bin/setenv.sh (o Red Hat Enterprise Linux \[ RHEL \] , edición ~tomcat/conf/tomcat10.conf ) para establecer las variables ambientales de Tomcat. Este archivo será utilizado por tomcat/bin/startup.sh y Cállate. # . El archivo debe contener algo como:

    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

    (pero sustituya los nombres de directorio de su computadora) . (Si usted ha establecido previamente JRE_HOME Puedes quitar eso.) En Macs, probablemente no necesites establecer JAVA_HOME .

  • En Windows: Crear un archivo tomcat\bin\\setenv.bat para establecer las variables ambientales de Tomcat. Este archivo será utilizado por tomcat\bin\\startup.bat y shutdown.bat . El archivo debe contener algo como:

    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"

    (pero sustituya los nombres de directorio de su computadora) . Si esto es sólo para las pruebas locales, eliminar "-servidor". (Si usted ha establecido previamente JRE_HOME Puedes quitar eso.)

El -Xmx y -Xms la configuración de memoria es importante porque ERDDAP™ funciona mejor con más memoria. Siempre listo -Xms al mismo valor que -Xmx .

  • Para 32 bits Sistemas operativos y 32 bits Java : 64 bits Java es mucho mejor que 32 bits Java , pero 32 bits Java funcionará mientras el servidor no esté ocupado. Cuanto más memoria física en el servidor mejor: 4+ GB es realmente bueno, 2 GB está bien, menos no se recomienda. Con 32 bits Java , incluso con abundante memoria física, Tomcat y Java no funcionará si intentas establecer -Xmx mucho por encima de 1500M (1200M en algunas computadoras) . Si su servidor tiene menos de 2 GB de memoria, reduzca el -Xmx valor (en 'M'egaBytes) a 1/2 de la memoria física del ordenador.

  • Para 64 bits Sistemas operativos y 64 bits Java : 64 bits Java sólo funcionará en un sistema operativo de 64 bits.

    • Con Java 8, tienes que añadir -d64 al Tomcat CATALINA_OPTS parámetro in setenv.bat .
    • Con Java 21, eliges 64 bits Java cuando descargar una versión de Java marcado "64 bit".

Con 64 bits Java , Tomcat Java puede utilizar muy alto -Xmx y -Xms Ajustes. Cuanto más memoria física en el servidor mejor. Como una sugerencia simplista: te recomendamos establecer -Xmx y -Xms a (en 'M'egaBytes) 1/2 (o menos) de la memoria física del ordenador. Puedes ver si Tomcat, Java , y ERDDAP™ se ejecutan en modo 64 bits buscando " bit", en ERDDAP 's Daily Report email o en el bigParentDirectory/logs/ [log.txt](/docs/server-admin/additional-information#log) archivo ( bigParentDirectory se especifica en setup.xml ) .

Colección de basura

  • In ERDDAP™ 's log.txt archivo, verá muchos "GC (Asignación) " mensajes. Esto generalmente no es un problema. Es un mensaje frecuente de un funcionamiento normal Java diciendo que acaba de terminar una basura menor colección porque se quedó sin espacio en Eden (la sección del Java salto para objetos muy jóvenes) . Normalmente el mensaje te muestra la memoriaUseAntes de usar . Si esos dos números están unidos, significa que la colección de basura no fue productiva. El mensaje es sólo un signo de problemas si es muy frecuente (cada segundo) , no productivo, y los números son grandes y no crecen, que en conjunto indican que Java necesita más memoria, está luchando para liberar la memoria, y es incapaz de liberar la memoria. Esto puede suceder durante un tiempo estresante, y luego desaparecer. Pero si persiste, eso es un signo de problemas.
  • Si lo ves java.lang.OutOfMemoryError S in ERDDAP™ 's log.txt archivo, ver OutOfMemoryError para consejos sobre cómo diagnosticar y resolver los problemas.  

Permisos

chmod +x *.sh

Fuentes

Si opta por no utilizar las fuentes DejaVu, necesita cambiar la fuenteConfiguración familiar en setup.xml a <fontFamily> SansSerif </fontFamily> , que está disponible con todo Java distribuciones. Si te fijas <fontFamily> al nombre de una fuente que no está disponible, ERDDAP™ no cargará e imprimirá una lista de fuentes disponibles en el log.txt archivo. Debe utilizar una de esas fuentes.

Si elige utilizar las fuentes DejaVu, asegúrese de que <fontFamily> configuración en setup.xml es <fontFamily> DejaVu Sans </fontFamily> .

Para instalar las fuentes DejaVu, por favor descarga DejaVuFonts .zip (5,522,795 bytes, MD5=33E1E61FAB06A547851ED308B4FFEF42) y descifrar los archivos de fuentes a un directorio temporal.

  • En Linux:
    • Para Linux Adoptium Java distribuciones, ver estas instrucciones .
    • Con otros Java distribuciones: Como tomcat usuario, copiar los archivos de fuente en $JAVA_HOME/lib/fonts Así que... Java puede encontrar las fuentes. Recuerde: si/cuando más tarde se actualiza a una versión más nueva de Java , necesita reinstalar estas fuentes.
  • En Macs: para cada archivo de fuentes, haga doble clic en él y luego haga clic en Instalar Fuente.
  • En Windows 7 y 10: en Windows Explorer, seleccione todos los archivos de fuente. Clic derecho. Haga clic en Instalar.  

Prueba Tomcat

  • Prueba tu instalación de Tomcat.
    • Linux:
    • Mac (ejecutar tomcat como el usuario administrador del sistema) :
      • Corre tomcat/bin/startup.sh .
      • Ver su URL + ":8080/" en su navegador (por ejemplo, http://coastwatch.pfeg.noaa.gov:8080/ ) . Tenga en cuenta que por defecto, su Tomcat sólo es accesible por usted. No es accesible públicamente.
    • Windows localhost:
      • Haga clic derecho en el icono Tomcat en la bandeja del sistema, y seleccione "Iniciar servicio".
      • Ver http://127.0.0.1:8080/ , o quizás http://localhost:8080/ , en su navegador. Tenga en cuenta que por defecto, su Tomcat sólo es accesible por usted. No es accesible públicamente.

Deberías ver la página "Felicitaciones" de Tomcat.

Si hay problemas, vea el archivo de registro de Tomcat tomcat/logs/catalina.out .

¿Problemas con la instalación de Tomcat?

  • En Linux y Mac, si no puedes llegar a Tomcat o ERDDAP™ (o tal vez no puedes contactarlos desde un ordenador fuera de tu cortafuegos) , puede probar si Tomcat está escuchando el puerto 8080, escribiendo (como raíz) en una línea de comandos del servidor:

    netstat -tuplen | grep 8080

Eso debería devolver una línea con algo como:

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

(Donde # es un dígito) , indicando que java proceso (Supongo que Tomcat) está escuchando en el puerto "8080" para el tráfico "tcp". Si no se devolvieron líneas, si la línea devuelta es significativamente diferente, o si se devolvieron dos o más líneas, entonces puede haber un problema con la configuración del puerto.

  • Ver el archivo de registro de Tomcat tomcat/logs/catalina.out . Problemas de Tomcat y algunos ERDDAP™ Los problemas de arranque son casi siempre indicados allí. Esto es común cuando se está estableciendo ERDDAP™ .

  • Ver el Tomcat sitio web o buscar la web para obtener ayuda, pero por favor háganos saber los problemas que tenía y las soluciones que encontró.

  • Vea nuestro sección sobre la obtención de apoyo adicional .  

ERDDAP™ Índice

  1. Configurar el tomcat/content/erddap archivos de configuración. En Linux, Mac y Windows, descargar erddapContent .zip y deshacerlo en tomcat directorio, creación tomcat/content/erddap .

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

Algunas versiones anteriores también están disponibles:

  • 2.17 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, fechada 2022-02-16)
  • 2.18 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, fechada 2022-02-16)
  • 2.21 (19,810 bytes, MD5=1E26F62E7A06191EE68C40B9A29362, de fecha 2022-10-09)
  • 2.22 (19,810 bytes, MD5=1E26F62E7A06191EE68C40B9A29362, de fecha 2022-12-08)
  • 2.23 (19,810 bytes, MD5=1E26F62E7A06191EE68C40B9A29362, de fecha 2023-02-27)

Otros directorios

Para Red Hat Enterprise Linux (RHEL) o para otras situaciones en las que no se le permite modificar el directorio Tomcat o donde desea/necesita para poner el ERDDAP™ directorio de contenidos en alguna otra ubicación por alguna otra razón (por ejemplo, si usas Jetty en lugar de Tomcat) , unzip erddapContent .zip en el directorio deseado (a la que sólo tomcat usuario tiene acceso) y establecer el erddapContentDirectory propiedad del sistema (Por ejemplo. erddapContentDirectory =~tomcat/content/erddap ) Así que... ERDDAP™ puede encontrar este nuevo directorio de contenidos.

setup.xml

Para la configuración inicial, debe cambiar al menos estos ajustes:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> Ajustes
  • <admin...> Ajustes
  • <baseHttpsUrl> (cuando se estableció https )

Cuando creas el directorio de BigParent, desde el directorio principal de BigParentDirectory:

  • Hacer el tomcat usuario el propietario del bigParentDirectory :
    chown -R tomcat bigParentDirectory
  • Cambiar el "grupo" para ser tomcat, tu nombre de usuario, o el nombre de un pequeño grupo que incluye tomcat y todos los administradores de Tomcat/ ERDDAP :
    chgrp -R yourUserName bigParentDirectory
  • Cambiar permisos para que tomcat y el grupo hayan leído, escriban, ejecuten privilegios:
    chmod -R ug+rwx bigParentDirectory
  • Eliminar los permisos del usuario "otro" para leer, escribir o ejecutar. Esto es importante para prevenir la lectura de información posiblemente sensible dentro ERDDAP™ archivos de registro y archivos con información sobre conjuntos de datos privados.
    chmod -R o-rwx bigParentDirectory

Medio ambiente

Empezando con ERDDAP™ v2.13, ERDDAP™ los administradores pueden anular cualquier valor en setup.xml especificando una variable entorno llamado ERDDAP _valueName antes de correr ERDDAP™ . Por ejemplo, uso ERDDAP _baseUrl anula el <baseUrl> valor. Esto puede ser útil cuando se implementa ERDDAP™ con un contenedor como Docker, como puede poner la configuración estándar en setup.xml y luego suministrar ajustes especiales a través de variables ambientales. Si usted suministra información secreta a ERDDAP™ a través de este método, Asegúrese de comprobar que la información permanecerá secreta. ERDDAP™ sólo lee variables ambientales una vez por startup, en el primer segundo de inicio, por lo que una manera de utilizar esto es: establecer las variables del entorno, comenzar ERDDAP , Espera. ERDDAP™ se inicia, luego desactiva las variables ambientales.

datasets.xml

  • Lea los comentarios en Trabajando con el datasets.xml Archivo . Luego, después de que llegues ERDDAP™ corriendo por primera vez (generalmente con sólo los conjuntos de datos predeterminados) , modificará el XML en tomcat/content/erddap/ datasets.xml para especificar todos los conjuntos de datos que desea ERDDAP™ para servir. Aquí es donde pasarás la mayor parte de tu tiempo mientras se establece ERDDAP™ y más tarde manteniendo su ERDDAP™ .

Puedes ver un ejemplo. datasets.xml en GitHub .  

  • (Diferentemente) Ahora o (ligeramente más probable) en el futuro, si desea modificar el archivo CSS de Erddap, copiar tomcat/content/erddap/images/erddapStart2.css a tomcat/content/erddap/images/erddap2.css y luego hacer cambios en él. Cambios en erddap2.css sólo tomar efecto cuando ERDDAP™ se reinicia y a menudo también requieren que el usuario despeje los archivos en caché del navegador.   ERDDAP™ no funcionará correctamente si la configuración.xml o datasets.xml El archivo no es un archivo XML bien formado. Entonces, después de editar estos archivos, es una buena idea verificar que el resultado es XML bien formado al pegar el texto XML en un chequeador XML como xmlvalidación .  

Instala el erddap. archivo de guerra

  1. En Linux, Mac y Windows, __download Erddap.war Adentro. tomcat/webapps :

Versión 2.28.1, 622,676,238 bytes, MD5=48b4226045f950c8d69ef9521b9bc9, de fecha 2025-09-05

El archivo .war es grande porque contiene datos de alta resolución de costa, frontera y elevación necesarios para crear mapas.

Algunas versiones anteriores también están disponibles.

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

Configure proxy (despliegue específico)

ERDDAP™ normalmente se implementa detrás de un servidor web inverso proxy para permitir que se sirva en puertos HTTP estándar (80 y 443) . La terminación SSL/TLS a menudo se mantiene en la capa proxy del servidor web también. Las características específicas dependen de las necesidades de cada despliegue.

Apache

  1. Garantizar que mod_proxy y mod_proxy_ http están cargados:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Modificar el existente <VirtualHost> etiqueta (si hay uno) , o añadir uno al final del archivo:
<VirtualHost *:80>
ServerName YourDomain.org
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /erddap http://localhost:8080/erddap
ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Si ERDDAP™ se sirve en un camino distinto a /erddap , también establecer el X-Forwarded-Prefix cabeza a la segmento de ruta before /erddap . Esta configuración sería apropiada para un ERDDAP™ atendidos /subpath/erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Entonces reinicia Apache: /usr/sbin/apachectl -k Graceful (pero a veces está en un directorio diferente) .  

NGINX

En el archivo de configuración nginx, establece estos encabezados:

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;

Si ERDDAP™ se sirve en un camino distinto a /erddap , también establecer el X-Forwarded-Prefix cabeza a la segmento de ruta before /erddap . Esta configuración sería apropiada para un ERDDAP™ atendidos /subpath/erddap :

proxy_set_header X-Forwarded-Prefix /subpath

Para conseguir NGINX y ERDDAP™ trabajar correctamente https , usted necesita poner el siguiente snippet dentro del servidor Tomcat.xml <Host> bloque:

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

 

Empieza Tomcat

  • (No recomiendo usar el Administrador de aplicaciones web de Tomcat. Si no cierras completamente y empiezas Tomcat, tarde o temprano tendrás problemas de memoria PermGen.)
  • (En Linux o Mac OS, si usted ha creado un usuario especial para ejecutar Tomcat, por ejemplo, tomcat, recuerde hacer los siguientes pasos como ese usuario.)
  • Si Tomcat ya está corriendo, cierra Tomcat con (en Linux o Mac OS) tomcat/bin/shutdown.sh o (en Windows) tomcat\bin\\ shutdown.bat

En Linux, uso ps -ef | Griep tomcat antes y después Cállate. # para asegurarse de que el proceso de tomcat se ha detenido. El proceso debe ser enumerado antes de la apagación y eventualmente no aparece después de la apagada. Puede tomar un minuto o dos para ERDDAP™ para cerrar completamente. Sé paciente. O si parece que no se detendrá por sí solo, use: matar a 9 <processID>

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

I ERDDAP™ ¿Corriendo?

Utilice un navegador para tratar de verhttp://www.YourServer.org/erddap/status.html. ERDDAP™ comienza sin ningún conjunto de datos cargados. Los conjuntos de datos se cargan en un hilo de fondo y así se ponen a disposición uno por uno.

Solución de problemas

  • Cuando una solicitud de un usuario entra, va a Apache (en computadoras Linux y Mac OS) Entonces Tomcat ERDDAP™ .
  • Puedes ver lo que viene a Apache (y errores conexos) en los archivos de registro de Apache.
  • Tú. puede ver lo que viene a Tomcat (y errores conexos) en los archivos de registro de Tomcat ( tomcat/logs/catalina.out y otros archivos en ese directorio) .
  • Tú. puede ver lo que viene ERDDAP , mensajes de diagnóstico de ERDDAP , y mensajes de error ERDDAP , en el ERDDAP™ <bigParentDirectory> /logs/log.txt archivo.
  • Tomcat no empieza ERDDAP™ hasta que Tomcat reciba una solicitud ERDDAP™ . Así que puedes ver en los archivos de registro de Tomcat si comenzado ERDDAP™ o si hay un mensaje de error relacionado con ese intento.
  • Cuando ERDDAP™ comienza, renombra el viejo ERDDAP™ log.txt file ( logArchivedAt <CurrentTime> .txt ) y crea un nuevo archivo log.txt. Así que si log.txt archivo es viejo, es una señal que ERDDAP™ no ha vuelto a empezar. ERDDAP™ escribe información de registro a un buffer y sólo escribe el búfer al archivo de registro periódicamente, pero puede forzar ERDDAP™ para escribir el búfer al archivo de registro visitando /erddap/status.html .

Problemas: Versión antigua Java

Si está usando una versión de Java que es demasiado viejo para ERDDAP , ERDDAP™ no funcionará y verá un mensaje de error en el archivo de registro de Tomcat como

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

La solución es actualizar a la versión más reciente de Java y asegúrate de que Tomcat lo use.

Problemas: Slow Startup First Time

Tomcat tiene que hacer mucho trabajo la primera vez una aplicación como ERDDAP™ se inicia; en particular, tiene que desempacar Erddap.war archivo (que es como un .zip archivo) . En algunos servidores, el primer intento de ver ERDDAP™ puestos (¿30 segundos?) hasta que termine este trabajo. En otros servidores, el primer intento fallará inmediatamente. Pero si esperas 30 segundos e intentas de nuevo, tendrá éxito si ERDDAP™ fue instalado correctamente.

No hay solución para esto. Así es como funciona Tomcat. Pero sólo ocurre la primera vez después de instalar una nueva versión de ERDDAP™ .

Apaga y reinicia

En el futuro, para cerrar (y reiniciar) ERDDAP™ , ver Cómo cerrar y reiniciar Tomcat y ERDDAP .

¿Problemas?

Problemas para instalar Tomcat o ERDDAP™ ? Vea nuestro sección sobre la obtención de apoyo adicional .

Notificación de Nuevas Versiones ERDDAP

Si desea recibir un correo electrónico cuando una nueva versión de ERDDAP™ está disponible u otro importante ERDDAP™ anuncios, puedes unirte a ERDDAP™ lista de anuncios Aquí. . Esta lista promedio aproximadamente un email cada tres meses.

Personalizar

  • Personalice su ERDDAP™ para destacar su organización (no NOAA ERD ) .
  • Cambiar el banner que aparece en la parte superior de todos ERDDAP™ .html pages by editing <startBodyHtml5> etiqueta en tu datasets.xml archivo. (Si no hay uno, copiar el predeterminado de ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml archivo en datasets.xml y editarlo.) Por ejemplo, podría:
    • Usar una imagen diferente (i.e., el logotipo de su organización) .
    • Cambiar el color de fondo.
    • Cambio ERDDAP™ "a tu organización" ERDDAP™ "
    • Cambiar "Acceso más fácil a los datos científicos" a "Acceso más fácil a los datos de YourOrganization".
    • Cambiar los enlaces "Brought to you by" para ser enlaces a su organización y fuentes de financiación.
  • Cambiar la información en el lado izquierdo de la página de inicio editando <theShortDescriptionHtml> etiqueta en tu datasets.xml archivo. (Si no hay uno, copiar el predeterminado de ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/messages.xml archivo en datasets.xml y editarlo.) Por ejemplo, podría:
    • Describa lo que hace su organización y/o grupo.
    • Describir qué tipo de datos este ERDDAP™ Sí.
    • Para cambiar el icono que aparece en las pestañas del navegador, ponga el favicon de su organización. ico en tomcat/content/erddap/images/ . Seehttps://en.wikipedia.org/wiki/Favicon.