Divisão de Observação da Terra e Geoinformática

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== 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:

<html>
<a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/deed.en_US"><img alt="Creative Commons License" style="border-width:0" src="http://i.creativecommons.org/l/by-sa/3.0/88x31.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" href="http://purl.org/dc/dcmitype/Text" property="dct:title" rel="dct:type">TerraMA2: Plataforma de Monitoramento, Análise e Alerta de Extremos Ambientais</span> by <a xmlns:cc="http://creativecommons.org/ns#" href="http://wiki.dpi.inpe.br/doku.php?id=elevacao&rev=1375816021" property="cc:attributionName" rel="cc:attributionURL">Laercio M. Namikawa</a> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/deed.en_US">Creative Commons Attribution-ShareAlike 3.0 Unported License</a>.
</html>


===== Apresentação Geral do TerraMA2 =====

[[http://www.dpi.inpe.br/terrama2/doku.php|A descrição do TerraMA2 se encontra neste link.]]
===== 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 ====
  * [[http://www.dpi.inpe.br/terrama2/lib/exe/fetch.php?media=download:win:dep:postgresql-9.0.17-3-windows-x64.exe.zip| Servidor de Bando de Dados PostgreSQL]]
  * [[http://www.dpi.inpe.br/terrama2/lib/exe/fetch.php?media=download:win:dep:httpd-2.2.22-win32-x86-openssl-0.9.8t.msi.zip|Servidor Http Apache]]
  * [[http://www.dpi.inpe.br/terrama2/lib/exe/fetch.php?media=download:win:dep:jre-7u9-windows-x64.zip|Java 7]]
  * [[http://www.dpi.inpe.br/terrama2/lib/exe/fetch.php?media=download:win:dep:apache-tomcat-7.0.28.exe.zip|Apache Web Java Tomcat]]
  * [[http://www.dpi.inpe.br/terrama2/lib/exe/fetch.php?media=download:win:dep:terraview-4.2.2-x86.exe.zip|Aplicativo TerraView]]
  * [[http://www.dpi.inpe.br/terrama2/lib/exe/fetch.php?media=download:win:dep:terraogc_x86.zip|Servidor WEB TerraOGC]]”
  * {{:trein:vcredist_x64_e_x86.zip|Pacotes (32 e 64 bits) de redistribuição do Microsoft Visual C++}}
==== 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 
[[http://wiki.dpi.inpe.br/lib/exe/fetch.php?media=trein:vcredist_x64_e_x86.zip|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 {{:trein:alertasweb_port.zip|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 utilização do TerraMA2 como um módulo de estudo sobre o evento que ocorreu na regiã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 região da Pousada Sankay na enseada do Bananal, Ilha Grande.

==== Base de Dados do Tutorial ====
{{:trein:curso_terrama2_ufpe.zip|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 ====
  - Criar o Banco de Dados
  - Importar Dados Estáticos com o TerraView 
  - Definir o banco de estudo e Configurar Serviços
  - Executar os Serviços 
  - Criar Configuração de Dados Ambientais
     - Precipitação por Satélite GOES
     - Estimativa de Precipitação Eta
     - Plataforma de Coleta de Dados PCD
  - Habilitar Objeto Monitorado e Dados Adicionais
  - Criar análises para executar
     - Análise 1 – Precipitação Máxima por satélite GOES
     - Análise 2 – Precipitação total por satélite e modelo de previsão
     - Análise 4 – Precipitação acumulada no pluviômetro
     - Análise 5 – Precipitação total por pluviômetro e previsão numérica 
  - Habilitar análises para usuários
  - Executar Estudo
  - Configurar o Aplicativo WEB para o banco “angra”
  - Acessando o Aplicativo WEB

O tutorial pode ser obtido em {{:trein:pratica_terrama2_ufpe.pdf|PDF}}.

Os slides com os passos do tutorial podem ser obtidos em {{:trein:cursoufpeslides.zip| PDF}}.