TerraMA2: Plataforma de Monitoramento, Análise e Alerta de Extremos Ambientais

Apresentação teórica e prática do TerraMA2. CURSO - Universidade Federal de Pernambuco - UFPE.

O material pode ser utilizado desde que respeitada a licença:

Creative Commons License
TerraMA2: Plataforma de Monitoramento, Análise e Alerta de Extremos Ambientais by Laercio M. Namikawa is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.

Apresentação Geral do TerraMA2

Instalação e configuração do TerraMA2

A plataforma TerraMA² é composta por três aplicativos ou módulos:

  • Administração
  • Configuração
  • Apresentação WEB

E pelos serviços (executam tarefas definidas pelo módulo de configuração) de:

  • Análise
  • Animação
  • Coleta
  • Notificação

Esse conjunto de aplicativos e serviços formam o framework de execução da TerraMA², responsáveis por todo o trabalho de monitoramento, alerta e análise.
Para realizar a instalação do TerraMA² e das dependências no sistema operacional Windows, os arquivos estão disponíveis no endereço www.dpi.inpe.br/terrama2.

Dependências

Instalação do Servidor POSTGRESQL

Execute o postgresql-9.4.4-1-windows-x64.exe como administrador.

Setup
	- (Next >)       * na Janela Bem-Vindo (welcome)
Setup – Installation Directory
	- (Next >)     * manter o diretório para instalação do banco
Setup – Data Directory
	- (Next >)     * manter o diretório para criar os dados
Setup – Password
	- {Password ⌨ postgres} * sugerimos o mesmo nome da conta
	- {Retype Password ⌨ postgres}
	- (Next >)
Setup – Port
	- {Port ⌨ 5432}      * manter o valor
	- (Next >)
Setup – Advanced Options
	- (Locale ▼ <selecione seu país>)      ou deixe o valor padrão (default)
	- (Next >)
Setup – Ready to Install
	- (Next >)
Setup –Installing
	* aguarde instalação
Setup – Completing the PostgreSQL Setup Wizard
	- ( ⬜ Stack Builder …)     * desative  o  item
	- (Finish)

Testar a conexão com o banco de dados utilizando aplicativo “pgAdmin III”. Execute pgAdmin III instalado junto com o postgresql:

pgAdmin III
	- (Navegador de objetos – Servidores (1) | PostgresSQL 9.4 localhost:5432)
	- (PostgresSQL 9.4 (localhost:5432))   +  [Conectar]
Conexão ao Servidor
	- {Senha ⌨ postgres}
	- (Salvar Senha)       * para que não seja solicitada na próxima conexão.
	- (OK)
pgAdmin III
	* Verifique que o banco “postgres” está disponível.

Instalação do APACHE

Execute o httpd-2.2.22-win32-x86-openssl-0.9.8t.msi como administrador.

Apache HTTP Server 2.2 Installation Wizard
	- (Next  >)
Apache HTTP Server 2.2 Installation Wizard – License Agreement
	- (◉  I accept the terms in the license agreement)
	- (Next  >)
Apache HTTP Server 2.2 Installation Wizard – Read This First
	- (Next  >)
Apache HTTP Server 2.2 Installation Wizard – Server Information

Caso o instalador não preencha os campos automaticamente, preencha os três campos a seguir com qualquer valor, pois o acesso a aplicativo web será feito localmente.

Apache HTTP Server 2.2 Installation Wizard – Server Information
	- {Network Domain  ⌨ teste.com}
	- {Server Name  ⌨  www.teste.com}
	- {Administrator´s Email Address  ⌨ teste@teste.com}
	- (◉  for All Users, on Port 80, as a Service - Recommended)
	- (Next  >)
Apache HTTP Server 2.2 Installation Wizard – Setup Type
	- (◉  Typical)
	- (Next  >)
Apache HTTP Server 2.2 Installation Wizard – Destination Folder
	- Manter o caminho padrão
	- (Next  >)
Apache HTTP Server 2.2 Installation Wizard – Ready to Install the Program
	- (Install)
Apache HTTP Server 2.0 Installation Wizard – Installing
	- Aguarde instalação. Responda SIM  para permissão do windows
	- (Finish)

Para testar a instalação, primeiramente, certifique-se de que o Apache esteja em execução na barra de aplicativos do Windows. Abra o seu navegador favorito e digite o seguinte endereço: http://localhost. Este é o endereço do seu servidor web local. Deverá aparecer na página a seguinte mensagem: “It works!”.

Instalação do JAVA

Execute o jre-7u9-windows-x64.exe como administrador.

Instalação do Java – Bem-vindo
	- (Instalar  >)
Configuração do Java
	- (Próximo  >)
Instalação do Java - Andamento
Instalação do Java - Concluída

Instalação do APACHE-TOMCAT

Execute o apache-tomcat-7.0.28.exe como administrador.

Apache Tomcat Setup
	- (Next  >)
Apache Tomcat Setup – License Agreement
	- (I Agree)
Apache Tomcat Setup – Choose Components
	- (Select the type of install:  ▼   Full)
	- (Next  >)
Apache Tomcat Setup – Configuration
	- (☑ Create shortcuts for all users)     * marcar
	- {User Name ⌨ tomcat}
	- {Password ⌨ tomcat}                 * sugerimos o mesmo nome
	- (Next  >)
Apache Tomcat Setup – Java Virtual Machine
	- (Next  >)                  * manter o diretório do Java
Apache Tomcat Setup – Choose Install Location
	- (Install)
Apache Tomcat Setup – Installing
	- Aguarde instalação
Apache Tomcat Setup
	- (Finish)

O serviço será inicializado no final. Para que o gerenciador do Tomcat seja inicializado na próxima vez que o computador for reinicializada, deve-se alterar a propriedade do programa executável “tomcat7w.exe” para sempre ser executado como Administrador do sistema operacional.

Alterando a propriedade do executável do Tomcat
  • Localize o arquivo “tomcat7w.exe” na pasta “bin” criada no caminho de instalação do Apache-Tomcat, normalmente em C:\Program Files\Apache Software Foundation\Tomcat 7.0\bin .
  • Escolha o item Propriedades com botão da direita sobre o nome do arquivo tomcat7w.exe
Propriedades de Tomcat7w.exe ABA Compatibilidade
	- Nível de Privilégio  ☑  Executar este programa como administrador
	- (Aplicar)
	- (OK)

Para testar a instalação, primeiramente, certifique-se de que o Apache Tomcat está em execução na barra de aplicativos do Windows. Abra o administrador do Tomcat com o procedimento a seguir.

Testando o Apache-Tomcat
# Iniciar – TodosProgramas – Apache Tomcat 7.0 Tomcat7 – Tomcat Manager
	Ou digite 127.0.0.1:8080/manager no seu navegador
Autenticação solicitada
	- {Nome do Usuário ⌨ tomcat}
	- {Senha ⌨ tomcat}
Navegador / manager  - Tomcat Web Application Manager
	- Verifique as aplicações instaladas

Instalação do TerraView-4.2.2

Execute o TerraView-4.2.2-x86.exe.

Instalação do TerraView 4.2.2 
	- (Próximo >)    
	- (Próximo >)     * manter os plugins selecionados
	- (Próximo >)     * local de instalação pode manter o padrão
	- (Instalar)      * Aguarde a instalação.
	- (Terminar)      * Aplicativo é aberto.

Instalação do TerraOGC

O pacote TerraOGC é composto por programas que servem os dados (PI´s) presentes em uma vista de um banco de dados TerraLib no formato do padrão OGC. Especificamente para o TerraMA² o TerraOGC disponibiliza os dados apenas nos formatos WFS, WMS e WCS.

Execute o TerraOGC_x86.exe.

Responda SIM para permissão do windows

Installer Language 
	- (Please select a language:  ▼   Português Brasileiro)
	- (OK)    
Instalação do TerraOGC
	- (Próximo >)    
Instalação do TerraOGC – Escolher Usuários
	- (◉  Instalar para qualquer um usando este computador)
	- (Próximo >)     * manter os plugins selecionados
Instalação do TerraOGC – Escolher o Local da Instalação
	* Manter a pasta indicada.
	- (Instalar)    * Aguarde a instalação.
	- (Fechar)

Para que o Apache reconheça que o servidor de mapas TerraOGC foi instalado, será necessário incluir as linhas abaixo no arquivo “httpd.conf” que está no diretório C:\Arquivos de Programas (x86)\Apache Software Foundation\Apache2.2\conf .

ScriptAlias /teogc/ "C:/Arquivos de Programas (x86)/TerraOGC/"
<Directory "C:/Arquivos de Programas (x86)/TerraOGC/">
            Options +ExecCGI
            Order allow,deny
            Allow from all
</Directory>

OBS: Esta configuração deve ser feita pelo Administrador do sistema operacional, para isto execute o Bloco de Notas como Administrador e abra o arquivo “httpd.conf” para edita conforme mostrado acima.

CUIDADO: O caminho do “Arquivo de Programas” acima pode ser diferente dependendo da versão do sistema operacional Windows instalado, se 32 ou 64 bits, ou ainda se português ou inglês. Veja neste caso (figura abaixo), que o caminho está em português na janela do Windows Explorer, mas quando se clica no campo o caminho real é mostrado.

NOTA: Reiniciar o Apache após a inclusão das linhas acima. Utilize o botão Iniciar do Windows em:

Iniciar – Todos Programas – Apache HTTP Server 2.2 – Control Apache Server – Restart

ou o atalho na barra de aplicativos abertos

Testar o TerraOGC, o link abaixo deve retornar um xml, com as características do Banco de Dados. Verifique a porta do Apache.

http://localhost/teogc/terraogcwmscgi.exe?REQUEST=GetCapabilities

IMPORTANTE: Caso não apareça um código XML, tente executar o arquivo terraogcwmscgi.exe que está na pasta C:\Arquivos de Programas\TerraOGC (ou o seu diretório de instalação do TerraOGC). Caso o problema seja falta de DLLs, execute vcredist_x64.exe (Pacote de redistribuição do Microsoft Visual C++) ou o vcredist_x86.exe, disponível aqui.

Instalação do TerraMA2

Execute o TerraMA2_x64.exe.

Responda SIM para permissão do windows.

Installer Language 
	- (Please select a language:  ▼   Português Brasileiro)
	- (OK)    
Instalação do TerraMA2  3.0
	- (Próximo >)    
Instalação do TerraMA2  3.0 – Escolher Usuários
	- (◉  Instalar para qualquer um usando este computador)
	- (Próximo >)     * manter os plugins selecionados
Instalação do TerraMA2  3.0 – Escolher o Local da Instalação * Manter a pasta indicada.
	- (Instalar)  * Aguarde a instalação.
	- (Fechar)

Após a instalação, serão criados na Área de Trabalho e no Menu Iniciar ícones correspondentes aos módulos de Administração e Configuração, Manual do Usuário e Manual de Instalação.

Instalação do Aplicativo WEB TerraMA2

O módulo de alerta TerraMA² é composto de um aplicativo com interface WEB para se aberto em qualquer navegador. Esse aplicativo realiza a apresentação das análises que representam os alertas, mapas de risco, planos adicionais, dados de entrada e possui diversas funcionalidades como animação, visualização gráfica e acesso a boletins.

Para realizar a instalação do aplicativo Web TerraMA² é necessário o arquivo “AlertasWeb.war”. Descomprimir o arquivo em C:\Curso_TerraMA2_UFPE\Aplicativos. Esse módulo possui alguns pré-requisitos que precisam ser instalados. As dependências são: Java 7 e Apache Tomcat 7 descritos acima.

OBS: A instalação deve ser feita pelo Administrador do sistema operacional. Instalando aplicativo WEB do TerraMA2:

	# Iniciar – TodosProgramas – Apache Tomcat 7.0 Tomcat7 – Tomcat Manager

ou digite no navegador http://localhost:8080/manager/html.

Autenticação solicitada
	- {Nome do Usuário ⌨ tomcat}
	- {Senha ⌨ tomcat}
Navegador / manager  - Tomcat Web Application Manager - Deploy
	- {Select WAR file to upload  ⌨ (Selecionar arquivo…)}
Abrir
	- (Olhar em : ▼ <pasta selecionada>)
	Selecionar o caminho ??\Curso_TerraMA2_UFPE\Aplicativos\Instalacao_Win-x86/AlertasWeb_port
	- (Tipo de arquivo : ▼ Todos os arquivos)
	- (Nome ↕ AlertasWeb.war)
	- (Deploy)
Navegador / manager  - Tomcat Web Application Manager - Applications

Verifique na lista de aplicações o item instalado.

Estudo de Caso do Tutorial

Este tutorial mostra a utilização do TerraMA2 como um módulo de estudo sobre o evento que ocorreu na região de Angra dos Reis – RJ na noite do Ano Novo de 2009/2010. Neste evento de chuvas extremas, deslizamentos de terra foram deflagrados no morro da Carioca na parte continental de Angra dos Reis e na região da Pousada Sankay na enseada do Bananal, Ilha Grande.

Base de Dados do Tutorial

Download dos Dados do Curso
Para instalar estes dados, descomprima o arquivo baixado no diretório raiz do seu computador para garantir que o tutorial se refira aos diretórios corretos. Caso não possa utilizar o diretório raiz, coloque em outro qualquer, lembrando de buscar os dados no diretório selecionado ao invés do diretório sugerido no tutorial.

Passos para Estudo de Caso

  1. Criar o Banco de Dados
  2. Importar Dados Estáticos com o TerraView
  3. Definir o banco de estudo e Configurar Serviços
  4. Executar os Serviços
  5. Criar Configuração de Dados Ambientais
    1. Precipitação por Satélite GOES
    2. Estimativa de Precipitação Eta
    3. Plataforma de Coleta de Dados PCD
  6. Habilitar Objeto Monitorado e Dados Adicionais
  7. Criar análises para executar
    1. Análise 1 – Precipitação Máxima por satélite GOES
    2. Análise 2 – Precipitação total por satélite e modelo de previsão
    3. Análise 4 – Precipitação acumulada no pluviômetro
    4. Análise 5 – Precipitação total por pluviômetro e previsão numérica
  8. Habilitar análises para usuários
  9. Executar Estudo
  10. Configurar o Aplicativo WEB para o banco “angra”
  11. Acessando o Aplicativo WEB

O tutorial pode ser obtido em PDF.

Os slides com os passos do tutorial podem ser obtidos em PDF.