Ir para o conteúdo principal

Instalar

Como fazer a configuração inicial de ERDDAP™ no seu servidor

ERDDAP™ pode ser executado em qualquer servidor que suporte Java e Tomcat (e outros servidores de aplicativos como Jetty, mas nós não os suportamos) . ERDDAP™ foi testado no Linux (incluindo na AWS da Amazon) , Mac, e computadores Windows.

  • Acoplamento - O quê? Nós fornecemos ERDDAP™ num recipiente Docker e IOOS agora oferece um Guia de início rápido para ERDDAP™ em um recipiente Docker . É o padrão ERDDAP™ instalação, num contentor Docker. Através do Docker Compor nós fornecemos maneiras fáceis de configurar ssl e monitoramento, leia mais dentro Documentação da acoplagem . Se você já usar o Docker, provavelmente vai preferir a versão do Docker. Se você está olhando para executar em serviços de nuvem, você provavelmente vai preferir a versão Docker.
  • Amazonas - O quê? Se você estiver instalando ERDDAP™ em uma instância da Amazon Web Services EC2, veja isto Visão geral dos Serviços Web da Amazon Primeiro.
  • Linux e Macs - O quê? ERDDAP™ Funciona muito bem em computadores Linux e Mac. Veja as instruções abaixo.
  • Janelas - O quê? Windows é bom para testes ERDDAP™ e para uso pessoal (ver as instruções abaixo) , mas não recomendamos usá-lo para o público ERDDAP™ implantações. Em execução ERDDAP™ no Windows pode ter problemas: nomeadamente, ERDDAP™ pode ser incapaz de apagar e/ou renomear arquivos rapidamente. Isso é provavelmente devido ao software antivírus (Por exemplo, de McAfee e Norton) que está verificando os arquivos para vírus. Se encontrar este problema (que pode ser visto por mensagens de erro no log.txt arquivo como "Não é possível excluir ..."), alterar as configurações do software antivírus pode aliviar parcialmente o problema. Ou considere usar um servidor Linux ou Mac.

A norma ERDDAP™ instruções de instalação para computadores Linux, Macs e Windows são:

  1. Certifique-se de que quaisquer dependências estão instaladas. Em máquinas não-Windows (Linux e Mac) Você precisa de csh.

Java​

  1. Para ERDDAP™ v2.29.0+, configuração Java 25. Por razões de segurança, é quase sempre melhor usar a versão mais recente Java 25. Por favor, baixe e instale a versão mais recente de OpenJDK do Adoção (Temurina) 25 (LTS) . Para verificar a instalação, execute /javaJreBinDirectório/java -versão , por exemplo /usr/local/jdk-25.0.1+8/jre/bin/java -versão .

    ERDDAP™ funciona com Java de outras fontes, mas recomendamos o Adoptionium porque é o principal, apoiado pela comunidade, livre (como em cerveja e discurso) versão da Java 25 que oferece suporte a longo prazo (atualizações gratuitas para muitos anos após o lançamento inicial) . Por razões de segurança, atualize o seu ERDDAP a versão da Java periodicamente como novas versões de Java 25 ficam disponíveis no Adoptionium.

    ERDDAP™ foi testado e utilizado extensivamente com 25, não com outras versões. Por várias razões, não testamos com nem suportamos outras versões de Java .  

Tomcat​

  1. Configurar Tomcat . Tomcat é o mais amplamente utilizado Java Servidor de Aplicações, que é Java software que está entre os serviços de rede do sistema operacional e Java software de servidor como ERDDAP™ . É Software Livre e de Código Aberto (FOSS) .

Você pode usar outro Java Servidor de aplicativos (Por exemplo, Jetty) Mas só testamos e apoiamos o Tomcat.

  • Baixe Tomcat e desempacote-o em seu servidor ou PC. Por razões de segurança, é quase sempre melhor usar a última versão do Tomcat 10 (versão 9 e abaixo não são aceitáveis) que é concebido para trabalhar com Java 25 ou mais novo. Abaixo, o diretório Tomcat será referido como tomcat .

Aviso! Se você já tem um Tomcat executando algum outro aplicativo web (especialmente TRÊS) , recomendamos que você instale ERDDAP™ em um segundo Tomcat , porque ERDDAP™ precisa de configurações Tomcat diferentes e não deveria ter que lidar com outras aplicações para a memória.

  • No Linux, baixar o "tar Core" .gz " Distribuição Tomcat e desempacotar. Recomendamos desempacotá-lo em /usr/local .
  • Em um Mac, Tomcat provavelmente já está instalado em /Biblioteca/Tomcat , mas deve atualizá-lo para a versão mais recente do Tomcat 10. Se o transferires, baixar o "tar Core" .gz " Distribuição Tomcat e desfazê-lo /Biblioteca/Tomcat .
  • No Windows, você pode baixar a distribuição "Core" "zip" Tomcat (que não mexe com o registro do Windows e que você controla a partir de uma linha de comando DOS) e desempacotá-lo em um diretório apropriado. (Para o desenvolvimento, usamos a distribuição "Core" "zip". Nós fazemos um /programas diretório e desempacotá-lo lá.) Ou você pode baixar a distribuição "Core" "64 bits do Windows zip", que inclui mais recursos. Se a distribuição for um instalador do Windows, provavelmente irá colocar o Tomcat, por exemplo, /Program Files/apache-tomcat-10.0.23 .  

server.xml​

  • server.xml - No tomcat/conf/server.xml arquivo, existem duas alterações que você deve fazer para cada um dos dois <Connector> tags (um para &lt;Connector port="8080" e um para &lt;Conector port="8443" ) .
    1. (Recomendado) Aumentar a ligação Tempo- limite valor do parâmetro, talvez até 300000 (milissegundos, que são 5 minutos) .
    2. (Recomendado) Adicionar um novo parâmetro: relaxadoQueryChars="[] | " . Isto é opcional e um pouco menos seguro, mas remove a necessidade de os usuários codificarem esses caracteres quando ocorrem nos parâmetros da URL de solicitação de um usuário.  

content.xml​

  • context.xml - O quê? Cache de Recursos - In tomcat/conf/context.xml , mesmo antes da </Context> tag, alterar a tag Recursos (ou adicioná-lo se já não estiver lá) para configurar o cache Parâmetro MaxSize a 80000: 
    <Resources cachingAllowed="true" cacheMaxSize="80000" />

Isto evita numerosos avisos em catalina. que tudo começa com

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

 

Tempo- limite Apache​

  • Nos computadores Linux, altere as configurações de tempo limite Apache para que as solicitações de usuário que consomem tempo não diminua (com o que muitas vezes aparece como um erro "Proxy" ou "Bad Gateway") . Como usuário root:
    • Modificar o Apache http d.conf arquivo (geralmente em /etc/ http d/conf/ ) :
      • Mudar o existente <Timeout> configuração (ou adicionar um no fim do ficheiro) até 3600 (segundos) , em vez do padrão 60 ou 120 segundos.
      • Mudar o existente <ProxyTimeout> configuração (ou adicionar um no fim do ficheiro) até 3600 (segundos) , em vez do padrão 60 ou 120 segundos.
    • Reiniciar o Apache: /usr/sbin/apachectl -k gracioso (mas às vezes está em um diretório diferente) .

Segurança​

 

  • Recomendação de segurança: Ver estas instruções aumentar a segurança de sua instalação Tomcat, especialmente para servidores públicos.  
  • Para o público ERDDAP™ instalações em Linux e Macs, é melhor configurar Tomcat (o programa) como pertencente ao usuário tomcat (um usuário separado com permissões limitadas e que não tem senha ) . Assim, apenas o super usuário pode mudar para atuar como usuário tomcat . Isso torna impossível para hackers fazer login no seu servidor como usuário tomcat . E em qualquer caso, você deve fazê-lo para que o tomcat usuário tem permissões muito limitadas no sistema de arquivos do servidor (leia+gravar+executar privilégios para a apache-tomcat árvore de pastas e <bigParentDirectory> e privilégios somente de leitura para diretórios com dados que ERDDAP™ precisa de acesso).
    • Você pode criar o tomcat conta de usuário (que não tem senha) usando o comando: 
      sudo useradd tomcat -s /bin/bash -p '*'
    • Você pode mudar para trabalhar como usuário tomcat usando o comando 
      sudo su - tomcat
      (Ele lhe pedirá a senha do superusuário para permissão para fazer isso.)
      • Você pode parar de trabalhar como tomcat usando o comando
      exit
      • Fazer a maioria do resto do Tomcat e ERDDAP™ instruções de configuração como usuário tomcat . Mais tarde, correr o inicialização.sh e Desligar. sh scripts como usuário tomcat para que o Tomcat tenha permissão para escrever em seus arquivos de log.
      • Depois de desempacotar Tomcat, do pai do apache-tomcat pasta:
        • Mudar a propriedade da árvore de diretórios apache-tomcat para o usuário tomcat. 
          chown -R tomcat apache-tomcat-10.0.23
          (mas substitua o nome real do seu diretório tomcat) .
        • Altere o "grupo" para ser tomcat, seu nome de usuário ou o nome de um pequeno grupo que inclui tomcat e todos os administradores do Tomcat/ ERDDAP : 
          chgrp -R yourUserName apache-tomcat-10.0.23
        • Alterar permissões para que o tomcat e o grupo tenham lido, escrito e executado privilégios: 
          chmod -R ug+rwx apache-tomcat-10.0.23
        • Remover as permissões de "outro" usuário para ler, escrever ou executar: 
          chmod -R o-rwx apache-tomcat-10.0.23

Isto é importante, porque impede outros usuários de ler informações possivelmente sensíveis em ERDDAP™ configurar arquivos.

Memória​

Definir as Variáveis de Ambiente do Tomcat

  • No Linux e Macs: Criar um ficheiro tomcat/bin/setenv.sh (ou no Red Hat Enterprise Linux \[ RHEL \] , editar ~tomcat/conf/tomcat10.conf ) para definir as variáveis de ambiente do Tomcat. Este arquivo será usado por tomcat/bin/startup.sh e Desligar. sh . O arquivo deve conter algo como:

    export JAVA_HOME=/usr/local/jdk-25.0.1+8
    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

    (mas substitua os nomes das pastas do seu computador) . (Se você definir anteriormente JRE_HOME Pode tirar isso.) No Macs, você provavelmente não precisa definir JAVA_HOME .

  • No Windows: Criar um ficheiro tomcat\bin\\setenv.bat para definir as variáveis de ambiente do Tomcat. Este arquivo será usado por tomcat\bin\\ startup.bat e shutdown.bat . O arquivo deve conter algo como:

    SET "JAVA_HOME=\\someDirectory\\jdk-25.0.1+8"
    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"

    (mas substitua os nomes das pastas do seu computador) . Se isso for apenas para testes locais, remova "-servidor". (Se você definir anteriormente JRE_HOME Pode tirar isso.)

A -Xmx e - Xms configurações de memória são importantes porque ERDDAP™ funciona melhor com mais memória. Sempre definido - Xms ao mesmo valor que -Xmx .

  • Para sistemas operacionais de 32 bits e 32 bits Java : 64 bits Java é muito melhor do que 32 bits Java , mas 32 bits Java funcionará enquanto o servidor não estiver realmente ocupado. Quanto mais memória física no servidor melhor: 4+ GB é muito bom, 2 GB está bem, menos não é recomendado. Com 32 bits Java , mesmo com memória física abundante, Tomcat e Java não correrá se tentar definir -Xmx muito acima de 1500M (1200M em alguns computadores) . Se o seu servidor tem menos de 2GB de memória, reduzir o -Xmx valor (em 'M'egaBytes) para 1/2 da memória física do computador.

  • Para sistemas operacionais de 64 bits e 64 bits Java : 64 bits Java só funcionará em um sistema operacional de 64 bits.

    • Com Java 8, você precisa adicionar -d64 ao Tomcat CATALINA_ OPTES parâmetro em setenv.bat .
    • Com Java 21, você escolhe 64 bits Java quando você baixar uma versão de Java marcado "64 bits".

Com 64 bits Java , Tomcat e Java pode usar muito alto -Xmx e - Xms configurações. Quanto mais memória física no servidor, melhor. Como uma sugestão simplista: recomendamos que você set -Xmx e - Xms para (em 'M'egaBytes) a 1/2 (ou menos) da memória física do computador. Você pode ver se Tomcat, Java , e ERDDAP™ estão realmente rodando em modo 64 bits, procurando por "bit," em ERDDAP 's Daily Report email quer na bigParentDirectory/logs/ [log.txt](/docs/server-admin/additional-information#log) arquivo ( bigPaitDirectório é especificado em setup.xml ) .

Colecção de Lixo​

  • In ERDDAP™ 's log.txt arquivo, você verá muitos "GC (Falha na atribuição) "mensagens. Isto normalmente não é um problema. É uma mensagem frequente de uma operação normal Java dizendo que acabou um lixo menor coleção porque ficou sem espaço no Éden (a secção da Java pilha para objetos muito jovens) . Normalmente a mensagem mostra- lhe memóriaUseBefore-&gt;memoryUseAfter . Se esses dois números estão próximos, significa que a recolha de lixo não foi produtiva. A mensagem é apenas um sinal de problemas se for muito frequente (a cada poucos segundos) , não produtivo, e os números são grandes e não crescentes, que em conjunto indicam que Java precisa de mais memória, está a lutar para libertar a memória, e é incapaz de libertar a memória. Isto pode acontecer durante um tempo estressante, e depois desaparecer. Mas se persistir, isso é sinal de problemas.
  • Se você ver java.lang.OutOfMemoryError s in ERDDAP™ 's log.txt ficheiro, ver Erro da Memória para dicas sobre como diagnosticar e resolver os problemas.  

Permissões​

chmod +x *.sh

Fontes​

Se você optar por não usar as fontes DejaVu, você precisa alterar a configuração de fonteFamília no setup.xml para <fontFamily> SansSerif </fontFamily> , que está disponível com todos Java distribuições. Se você definir <fontFamily> para o nome de uma fonte que não está disponível, ERDDAP™ não carregar e irá imprimir uma lista de fontes disponíveis no log.txt Arquivo. Você deve usar uma dessas fontes.

Se optar por usar as fontes DejaVu, certifique-se de que <fontFamily> configuração no setup.xml é <fontFamily> DejaVu Sans </fontFamily> .

Para instalar as fontes DejaVu, por favor baixe DejaVuFonts .zip (5522.795 bytes, MD5=33E1E61FAB06A547851ED308B4FFEF42) e descompacte os arquivos de fonte para uma pasta temporária.

  • No Linux:
    • Para o Linux Adoptium Java distribuições, ver estas instruções .
    • Com outras Java distribuições: Como tomcat usuário, copie os arquivos de fonte em $JAVA_HOME/lib/fonts assim Java pode encontrar as fontes. Lembre-se: se/quando você mais tarde atualizar para uma versão mais nova de Java , você precisa reinstalar essas fontes.
  • No Macs: para cada arquivo de fonte, clique duas vezes nele e clique em Instalar fonte.
  • No Windows 7 e 10: no Windows Explorer, selecione todos os arquivos de fonte. Botão direito. Clique em Instalar.  

Teste Tomcat​

  • Teste a instalação do Tomcat.
    • Linux:
    • Mac (execute tomcat como o usuário administrador do sistema) :
      • Executar tomcat/bin/startup.sh .
      • Ver o seu URL + ":8080/" no seu navegador (Por exemplo, http://coastwatch.pfeg.noaa.gov:8080/ ) . Observe que, por padrão, seu Tomcat só é acessível por você. Não é acessível ao público.
    • Máquina local das janelas:
      • Clique com o botão direito no ícone Tomcat na bandeja do sistema e escolha "Iniciar serviço".
      • Ver http://127.0.0.1:8080/ , ou talvez http://localhost:8080/ , no seu navegador. Observe que, por padrão, seu Tomcat só é acessível por você. Não é acessível ao público.

Devias ver a página do Tomcat "Parabéns".

Se houver problemas, consulte o arquivo de registro Tomcat em tomcat/logs/catalina.out .

Problemas com a instalação do Tomcat?​

  • No Linux e Mac, se não conseguires contactar o Tomcat ou ERDDAP™ (Ou talvez não consiga contactá-los de um computador fora do seu firewall.) , você pode testar se Tomcat está ouvindo a porta 8080, digitando (como raiz) numa linha de comando do servidor:

    netstat -tuplen | grep 8080

Isso deve devolver uma linha com algo como:

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

(em que # # é algum dígito) , indicando que java processo (Provavelmente Tomcat.) está ouvindo na porta "8080" para "tcp" tráfego. Se nenhuma linha foi devolvida, se a linha devolvida é significativamente diferente, ou se duas ou mais linhas foram devolvidas, então pode haver um problema com as configurações do porto.

  • Veja o arquivo de registro Tomcat tomcat/logs/catalina.out . Tomcat problemas e alguns ERDDAP™ problemas de inicialização são quase sempre indicados lá. Isto é comum quando está a configurar pela primeira vez ERDDAP™ .

  • Ver o Tomcat site ou procurar na web por ajuda, mas por favor, informe-nos os problemas que você teve e as soluções que você encontrou.

  • Veja o nosso seção sobre obter suporte adicional .  

ERDDAP™ Conteúdo​

  1. Configurar o tomcat/content/erddap ficheiros de configuração. No Linux, Mac e Windows, baixe erddapContent .zip e descompactá-lo para o tomcat diretório, criando tomcat/content/erddap .

_Versão 1.0.1, 20683 bytes, MD5=98a8099e7e674da59fe35e9c96efa7b5, datado de 2025-06-02

Algumas versões anteriores também estão disponíveis:

  • 2. 17 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, datado de 2022-02-16)
  • 2. 18 (19,792 bytes, MD5=8F892616BAEEF2DF0F4BB036DCB4AD7C, datado de 2022-02-16)
  • 2.21 (19,810 bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, de 2022-10-09)
  • 2.22 (19,810 bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, de 2022-12-08)
  • 2.23 (19,810 bytes, MD5=1E26F62E7A06191EE6868C40B9A29362, datado de 2023-02-27)

Outra pasta​

Para o Red Hat Enterprise Linux (RHEL) ou para outras situações em que você não tem permissão para modificar o diretório Tomcat ou onde você deseja/necessita para colocar o ERDDAP™ diretório de conteúdo em algum outro local por alguma outra razão (por exemplo, se você usar Jetty em vez de Tomcat) , unzip erddapContent .zip no diretório desejado (para o qual apenas o tomcat usuário tem acesso) e definir o erddapContentDirectory propriedade do sistema (Por exemplo: erddapContentDirectory =~tomcat/content/erddap ) assim ERDDAP™ pode encontrar este novo diretório de conteúdo.

setup.xml​

Para a configuração inicial, você deve pelo menos alterar estas configurações:

  • <bigParentDirectory>
  • <emailEverythingTo>
  • <baseUrl>
  • <email...> configurações
  • <admin...> configurações
  • <baseHttpsUrl> (quando você configurar https )

Quando você cria o BigPaintDirectory, a partir do diretório pai do BigPaintDirectório:

  • Faça o tomcat usuário o proprietário do bigPaitDirectório : 
    chown -R tomcat bigParentDirectory
  • Altere o "grupo" para ser tomcat, seu nome de usuário ou o nome de um pequeno grupo que inclui tomcat e todos os administradores do Tomcat/ ERDDAP : 
    chgrp -R yourUserName bigParentDirectory
  • Alterar permissões para que o tomcat e o grupo tenham lido, escrito e executado privilégios: 
    chmod -R ug+rwx bigParentDirectory
  • Remova as permissões de "outro" usuário para ler, escrever ou executar. Isto é importante para evitar a leitura de informações possivelmente sensíveis em ERDDAP™ registrar arquivos e arquivos com informações sobre conjuntos de dados privados. 
    chmod -R o-rwx bigParentDirectory

Variáveis de Ambiente​

A começar por ERDDAP™ v2.13, ERDDAP™ administradores podem substituir qualquer valor no setup.xml especificando uma variável de ambiente nomeado ERDDAP _ValorName antes de correr ERDDAP™ . Por exemplo, use ERDDAP _baseUrl substitui a <baseUrl> valor. Isso pode ser útil ao implantar ERDDAP™ com um recipiente como Docker, como você pode colocar configurações padrão em setup.xml e então fornecer configurações especiais via variáveis de ambiente. Se você fornecer informações secretas para ERDDAP™ através deste método, Certifique-se de verificar que a informação permanecerá secreta. ERDDAP™ somente lê variáveis de ambiente uma vez por inicialização, no primeiro segundo da inicialização, então uma maneira de usar isso é: definir as variáveis de ambiente, iniciar ERDDAP , esperar até ERDDAP™ é iniciado, então desativa as variáveis de ambiente.

datasets.xml​

  • Leia os comentários em Trabalhar com datasets.xml Ficheiro . Mais tarde, depois de ERDDAP™ em execução pela primeira vez (geralmente com apenas os conjuntos de dados padrão) , você irá modificar o XML em tomcat/content/erddap/ datasets.xml para especificar todos os conjuntos de dados que deseja ERDDAP™ para servir. Aqui é onde você vai passar a maior parte do seu tempo durante a configuração ERDDAP™ e mais tarde, mantendo ERDDAP™ .

Você pode ver um exemplo datasets.xml no GitHub .  

  • (Improvável) Agora ou... (ligeiramente mais provável) no futuro, se você quiser modificar o arquivo CSS do erddap, copie tomcat/content/erddap/images/erddapStart2.css para tomcat/content/erddap/images/erddap2.css e depois fazer-lhe alterações. Alterações a erddap2.css só produzir efeitos quando ERDDAP™ é reiniciado e muitas vezes também exigem que o usuário limpe os arquivos cache do navegador.   ERDDAP™ não funcionará corretamente se o setup.xml ou datasets.xml O ficheiro não é um ficheiro XML bem formado. Então, depois de editar estes arquivos, é uma boa ideia verificar que o resultado é XML bem formado colando o texto XML em um verificador XML como xmlvalidação .  

Instale o erddap. arquivo de guerra​

  1. No Linux, Mac e Windows, __download erddap.war __ em tomcat/webapps :

Versão 2.30.0, 706.939,130 bytes, MD5=CDC4B3D82A20B33A6623B85312F6DC21, datado de 2026-04-06

O arquivo .war é grande porque contém dados de alta resolução de costa, fronteira e elevação necessários para criar mapas.

Algumas versões anteriores também estão disponíveis.

  • 2. 17 (551,068,245 bytes, MD5=5FEA912B5D42E50EAB9591F773EA848D, datado de 2022-02-16)
  • 2. 18 (551,069,844 bytes, MD5=461325E97E7577EC671DD50246CCFB8B, datado de 2022-02-23)
  • 2.21 (568.644.411 bytes, MD5=F2CFF805893146E932E498FDDBD519B6, datado de 2022-10-09)
  • 2.22 (567.742.765 bytes, MD5=2B33354F633294213AE2AFDDCF4DA6D0, datado de 2022-12-08)
  • 2.23 (572.124.953 bytes, MD5=D843A043C506725EBD6F8EFDCCA8FD5F, datado de 2023-03-03)
  • 2.24 (568.748.187 bytes, MD5=970fbee172e28b0b8a07756eecbc898e, datado de 2024-06-07)
  • 2. 25 (592,292,039 bytes, MD5=652AFC9D1421F00B5F789DA2C4732D4C, datado de 2024-11-07)
  • 2. 26 (607,404,032 bytes, MD5=99a725108b37708e5420986c1616a119, datado de 2025-03-31)
  • 2.27.0 (620.554.403 bytes, MD5=3b2086c659eee4145ca2dff447bf4ef7, datado de 2025-06-11)
  • 2.28.1 (622.676.238 bytes, MD5=48b422605f950c8a8d69ef9521b9bc9, datado de 2025-09-05)
  • 2.29.0 (706.788,135 bytes, MD5=A5ED0DCC8D46CA27640FFEB8CE4A8560, datado de 2025-12-15)

Configurar o 'proxy' (Implementação específica)​

ERDDAP™ é tipicamente implantado atrás de um servidor web proxy reverso para permitir que ele seja servido em portas HTTP padrão (80 e 443) . A terminação do SSL/TLS é frequentemente hanlded na camada proxy do servidor web também. As especificidades dependem dos requisitos de cada implantação.

Apache​

  1. Garantir que mod_ proxy e mod_proxy_ http são carregados:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
  1. Modificar o existente <VirtualHost> tag (se existe um) , ou adicionar um no final do arquivo:
<VirtualHost *:80>
   ServerName YourDomain.org
   ProxyRequests Off
   ProxyPreserveHost On
   ProxyPass /erddap http://localhost:8080/erddap
   ProxyPassReverse /erddap http://localhost:8080/erddap
</VirtualHost>

Se ERDDAP™ é servido em um caminho que não /erddap , também definir o Prefixo X- Forwarded cabeçalho para o segmento do caminho antes /erddap . Este quadro seria adequado para ERDDAP™ servido em /subpath/erddap :

RequestHeader set X-Forwarded-Prefix /subpath
  1. Em seguida, reinicie o Apache: /usr/sbin/apachectl -k gracioso (mas às vezes está em um diretório diferente) .  

NGINX​

No arquivo de configuração nginx, defina estes cabeçalhos:

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;

Se ERDDAP™ é servido em um caminho que não /erddap , também definir o Prefixo X- Forwarded cabeçalho para o segmento do caminho antes /erddap . Este quadro seria adequado para ERDDAP™ servido em /subpath/erddap :

proxy_set_header X-Forwarded-Prefix /subpath

Para obter NGINX e ERDDAP™ trabalhar correctamente com https , você precisa colocar o seguinte trecho dentro do servidor Tomcat.xml <Host> bloco:

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

 

Iniciar Tomcat​

  • (Não recomendo usar o Tomcat Web Application Manager. Se você não desligar completamente e iniciar o Tomcat, mais cedo ou mais tarde você terá problemas de memória PermGen.)
  • (No Linux ou Mac OS, se você criou um usuário especial para executar Tomcat, por exemplo, tomcat, lembre-se de fazer as seguintes etapas como esse usuário.)
  • Se o Tomcat já estiver a correr, desliga o Tomcat com (em Linux ou Mac OS) tomcat/bin/shutdown.sh ou (em Windows) tomcat\bin\\ shutdown.bat

No Linux, use ps-ef | grep tomcat antes e depois Desligar. sh para ter a certeza que o processo Tomcat parou. O processo deve ser listado antes do desligamento e, eventualmente, não listado após o desligamento. Pode levar um minuto ou dois para ERDDAP™ para desligar completamente. Seja paciente. Ou se parecer que não vai parar sozinho, use: matar - 9 <processID>

  • Iniciar Tomcat com (em Linux ou Mac OS) tomcat/bin/startup.sh ou (em Windows) tomcat\bin\\ startup.bat

É ERDDAP™ Correr?​

Usar um navegador para tentar visualizar http://www.YourServer.org/erddap/status.html.

ERDDAP™ inicia sem nenhum conjunto de dados carregado. Os conjuntos de dados são carregados em um thread de fundo e assim se tornam disponíveis um-por-um.

Resolução de Problemas​

  • Quando um pedido de um usuário entra, ele vai para o Apache (em computadores Linux e Mac OS) Depois Tomcat, então ERDDAP™ .
  • Você pode ver o que vem para Apache (e erros relacionados) nos arquivos de log Apache.
  • Você pode ver o que vem para Tomcat (e erros relacionados) nos arquivos de log do Tomcat ( tomcat/logs/catalina.out e outros arquivos nesse diretório) .
  • Você pode ver o que vem a ERDDAP , mensagens de diagnóstico de ERDDAP , e mensagens de erro de ERDDAP , na ERDDAP™ <bigParentDirectory> /logs/log.txt Arquivo.
  • Tomcat não começa. ERDDAP™ até Tomcat receber um pedido de ERDDAP™ . Então você pode ver nos arquivos de registro Tomcat se iniciado ERDDAP™ ou se houver uma mensagem de erro relacionada com essa tentativa.
  • Quando ERDDAP™ inicia, renomeia o antigo ERDDAP™ arquivo log.txt ( logArchivedAt <CurrentTime> .txt ) e cria um novo arquivo log.txt. Então, se o log.txt arquivo é antigo, é um sinal de que ERDDAP™ não foi reiniciado recentemente. ERDDAP™ escreve informações de log em um buffer e só escreve o buffer no arquivo de log periodicamente, mas você pode forçar ERDDAP™ para gravar o buffer no arquivo de log visitando /erddap/status.html .

Problemas: Versão antiga de Java​

Se você estiver usando uma versão de Java Isso é muito velho para ERDDAP , ERDDAP™ não será executado e você verá uma mensagem de erro no arquivo de registro do Tomcat como

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

A solução é atualizar para a versão mais recente do Java E certifica-te que o Tomcat está a usá-lo.

Problemas: Iniciação lenta primeira vez​

Tomcat tem que fazer muito trabalho na primeira vez que um aplicativo como ERDDAP™ é iniciado; nomeadamente, tem de descompactar o erddap.war arquivo (que é como uma .zip arquivo) . Em alguns servidores, a primeira tentativa de ver ERDDAP™ baias (30 segundos?) Até que este trabalho termine. Em outros servidores, a primeira tentativa falhará imediatamente. Mas se você esperar 30 segundos e tentar novamente, ele vai ter sucesso se ERDDAP™ foi instalado corretamente.

Não há solução para isto. É assim que o Tomcat funciona. Mas só ocorre a primeira vez depois de instalar uma nova versão de ERDDAP™ .

Desligar e reiniciar​

No futuro, para fechar (e reiniciar) ERDDAP™ , ver Como fechar e reiniciar Tomcat e ERDDAP .

Problemas?​

Problemas na instalação do Tomcat ou ERDDAP™ ? Veja o nosso seção sobre obter suporte adicional .

E-mail Notificação de novas versões de ERDDAP​

Se você quiser receber um email sempre que uma nova versão de ERDDAP™ está disponível ou outro importante ERDDAP™ anúncios, você pode se juntar ao ERDDAP™ lista de anúncios Aqui . Esta lista é média de aproximadamente um e-mail a cada três meses.

Personalizar​

  • Personalizar o seu ERDDAP™ para destacar sua organização (não NOAA ERD ) .
  • Mudar o banner que aparece no topo de tudo ERDDAP™ .html páginas editando o <startBodyHtml5> tag na sua datasets.xml Arquivo. (Se não houver, copie o padrão de ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/mensages.xml arquivo em datasets.xml e editá-lo.) Por exemplo, você poderia:
    • Usar uma imagem diferente (ou seja, o logotipo da sua organização) .
    • Mudar a cor de fundo.
    • Mudança " ERDDAP™ "A sua organização ERDDAP™ "
    • Alterar "Acesso mais fácil aos dados científicos" para "Acesso mais fácil aos dados YourOrganização".
    • Mude os links "Browd to you by" para ser links para sua organização e fontes de financiamento.
  • Alterar as informações do lado esquerdo da página inicial, editando o <theShortDescriptionHtml> tag na sua datasets.xml Arquivo. (Se não houver, copie o padrão de ERDDAP™ 's tomcat/webapps/erddap/WEB-INF/classes/gov/noaa/pfel/erddap/util/mensages.xml arquivo em datasets.xml e editá-lo.) Por exemplo, você poderia:
    • Descreva o que sua organização e/ou grupo fazem.
    • Descreva que tipo de dados ERDDAP™ Tem.
    • Para alterar o ícone que aparece nas páginas do navegador, coloque o favicon da sua organização. ico in tomcat/content/erddap/imagens/ . Ver https://en.wikipedia.org/wiki/Favicon.