Monitoramento, Análise e Alerta a extremos ambientais

Plataforma de Monitoramento, Análise e Alerta a extremos ambientais Manual de Instalação Versão 3.0.0 Julho de 2012

Revisões Versão Autor Data Descrição 1.0 Javier Baldan Maio de 2008 Primeira versão do documento 1.0 Laércio M. Namikawa Julho de 2008 Correções 1.0.3 Eymar Lopes Novembro 2008 Correções 2.0 Eymar Lopes Julho 2009 Nova Versão 2.0 Gustavo B. Sampaio e Ygor H. Speranza Julho 2009 Atualizações 2.0.1 Gustavo B. Sampaio e Ygor H. Speranza Agosto 2009 Correções 3.0.0 Raphael Belo da Silva Meloni Maio 2012 Nova Versão 3.0.0 Eymar Lopes Julho 2012 Ajustes Powered by: Coordenação: Colaboradores: Projeto Temático Processo 04/09649- Desenvolvimento de Software:

SUMÁRIO 1 INTRODUÇÃO... 1 2 PLATAFORMA TERRAMA²... 2 3 INSTALAÇÃO WINDOWS... 3 3.1 - DEPENDÊNCIAS... 3 3.1.1 - Servidor DE BANCO DE DADOS... 3 3.1.1.1- INSTALAÇÃO DO POSTGRES:...3 3.1.1.2- INSTALAÇÃO DO MySQL:...6 3.1.2- Instalação do APACHE:... 7 3.1.3- Instalação do JAVA:... 8 3.1.4- Instalação do APACHE-TOMCAT:... 9 3.1.5- Instalação do TerraView4.2.0:... 10 3.1.6- Instalação do TerraOGC:... 10 3.2- INSTALAÇÃO DO TERRAMA 2 :... 11 3.3- INSTALAÇÃO DO APLICATIVO WEB TERRAMA 2 :... 13 3.4 - CONFIGURAÇÃO DO TERRAMA 2 :... 14 3.4.1- Configuração do TerraOGC:... 14 3.4.2- Configuração do Apache:... 15 3.4.3- Configuração do ALERTAS WEB:... 16 3.4.4- Recarregar o APACHE-TOMCAT:... 16 3.4.5- Testar o Aplicativo WEB:... 17 4 INSTALAÇÂO LINUX... 18 4.1 INSTALAÇÃO DO TERRAMA 2... 18 4.1.1 Tar.gz... 18 4.1.2 Deb... 19 4.1.3 RPM... 19 4.2 TERRAOGC... 19 4.2.1 Tar.gz... 20 4.2.2 Deb... 20 4.2.3 RPM... 20 4.3 CONFIGURANDO... 21 4.3.1 Apache HTTP... 21 4.3.2 TerraOGC... 21

1 INTRODUÇÃO Este manual é um guia de instalação do programa TerraMA² para as plataformas Windows e Linux. Esse guia de instalação apresenta o passo a passo da instalação de cada componente do TerraMA². O TerraMA² é composto pelos seguintes componentes: Plataforma TerraMA² Aplicativo WEB TerraMA² Dependências: servidor de banco de dados, aplicativo TerraView, servidor HTTP Apache, servidor Web Java Tomcat e servidor Web TerraOGC Após a execução dos passos descritos neste documento, o processo de instalação do TerraMA² estará finalizado. Consulte o Manual do Usuário para saber como configurar e executar o sistema. 1

2 PLATAFORMA TERRAMA² A plataforma TerraMA² é composta por dois aplicativos, os módulos de Administração e Configuração e pelos serviços de Análise, Animação, Coleta, Notificação e Planos que ficam executando tarefas definidas pelo módulo de configuração. Esse conjunto de aplicativos e serviços formam o framework de execução do TerraMA², responsáveis por todo o trabalho de monitoramento, alerta e análise. Para realizar a instalação do TerraMA² é necessário realizar o download do instalador para a plataforma (Windows ou Linux) que deseja utilizar, assim como de algumas dependências. O download deve ser realizado no sitio de internet http://www.dpi.inpe.br/terrama2/, na página de download, onde é necessário realizar um cadastro, caso ainda não tenha feito. 2

3 INSTALAÇÃO WINDOWS 3.1 - Dependências Para utilização do TerraMA 2 é necessário instalar algumas dependências que estão no endereço acima ou em sítios específicos. As dependências são: Servidor de Bando de Dados PostgreSQL : postgresql-8.2.zip Servidor de Bando de Dados MySQL : mysql-5.5.25a-win32.msi Servidor Http Apache: httpd-2.2.22-win32-x86-openssl-0.9.8t.msi Java 7: arquivo jxpiinstall.exe Apache Web Java Tomcat: apache-tomcat-7.0.28.exe Aplicativo TerraView : TerraView420.exe Servidor WEB TerraOGC : TerraOGC.exe 3.1.1 - SERVIDOR DE BANCO DE DADOS O TerraMA2 trabalha atualmente com os seguintes sistema gerenciadores de bando de dados: PostgreSQL, PostGIS ou MySQL. Para usuários avançados que forem utilizar análises baseadas em modelo TerraME (http://www.terrame.org/doku.php) deverão utilizar o servidor MySQL. Veja a seguir procedimento de instalação desses servidores. 3.1.1.1- INSTALAÇÃO DO POSTGRES: Descomprima o arquivo postgresql-8.2.zip e execute o programa postgresql-8.2.msi que esta na pasta postgresql-8.2. Durante a instalação será necessário criar uma conta de serviço, portanto, a instalação deve ser feita como Administrador do sistema operacional. O sistema gerenciador de banco de dados utilizado será o PostgreSQL versão 8.2. Eventualmente, no site http://www.postgresql.org/ encontram-se outras versões. A instalação do PostgreSQL é feita por um assistente como mostrado na figura. Siga os passos descritos no procedimento abaixo. 3

IMPORTANTE : Caso exista uma versão anterior em seu computador, remover a versão através do Painel de Controle Adicionar ou Remover Programas, depois remover qualquer chave de registro associada ao postgres que possa eventualmente persistir no Windows (use o programa regedit item HKEY_CURRENT_USER Software ), e também remover a conta de usuário de sistema criada por versões anteriores (use o programa control userpasswords2 aba Avançado item Gerenciamento avançado de usuários botão Avançado item Usuários na árvore excluir postgres ). Verifique ainda se algum diretório do postgres existir na pasta Arquivos de Programas do Windows remova o diretório caso exista. Instalando o PostgreSQL: - # Iniciar TodosProgramas Acessórios Windows Explorer Explorer <pasta corrente> - Selecionar o caminho onde foi descompactado o arquivo - postgresql-8.2 - clique duplamente sobre o arquivo postgresql-8.2.msi PostgreSQL - (Operação Brazilian Portuguese / Portugues - Brasil ) - (Start >) * na Janela Bem-Vindo (welcome) PostgreSQL Bem-vindo - (Próximo >) * na Janela Bem-Vindo (welcome) PostgreSQL Informações de Instalação - (Próximo >) * na Janela Informações da Instalação PostgreSQL Opções de Instalação - (PostgreSQL / Servidor de banco de dados) - (Diretório de dados Todo o recurso será instalado no disco rígido) - (Extensões espaciais PostGIS Todo o recurso será instalado no disco rígido) PostgreSQL Configurações do serviço - ( Instalar como serviço) * manter marcado - {Conta postgres} * sugerimos manter nome - {Senha postgres} * sugerimos o mesmo nome da conta - {Digite Novamente postgres} - (Próximo >) Conta incorreta - (Sim) * responda SIM para criar a conta. Senha - (Não) * responda NÃO para não modificar a senha. PostgreSQL Inicializar o agrupamento de banco de dados - {Porta 5432} * não altere a porta - (Locate Portuguese, Brazil) - (Codificação LANTIN1) - {Superusuário postgres} * manter o nome - {Senha postgres} * sugerimos o mesmo nome - {Senha (Novamente) postgres} - (Proximo >) Verificação do serviço - Caso o serviço Secundário de Logon não esteja iniciado, siga os passos na NOTA abaixo. Depois retorne a este ponto. PostgreSQL Habilitar linguagens procedurais 4

- ( PL/pgsql) * manter marcado - (Próximo >) PostgreSQL Habilitar Módulos Contrib - (Próximo >) PostgreSQL Pronto para instalar - (Próximo >) PostgreSQL Instalando - Aguarde instalação. Responda SIM para permissão do windows PostgreSQL Instalação concluída - (Concluir) NOTA: Caso apareça um erro dizendo "Secundary Logon não iniciado", siga a seguinte instrução do caminho para iniciar o Secondary Logon: 1. Iniciar; 2. Painel de Controle; 3. Ferramentas Administrativas; 4. Serviços; 5. Logon Secundário (Secondary Logon) 6. Iniciar serviço; 7. Depois prossiga com o final da instalação acima. Testar a conexão com o banco de dados utilizando aplicativo pgadmin III Verificando conexão com o PostgreSQL: - # Iniciar TodosProgramas PostgreSQL 8.2 pgadmin III pgadmin III - (Navegador de objetos Servidores (1) / PostgresSQL 8.2 (localhost:5432) ) - (PostgresSQL 8.2 (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 os bancos postgis, postgres e template_postgis estarão disponíveis. 5

3.1.1.2- INSTALAÇÃO DO MYSQL: Execute o programa mysql-5.5.25a-win32.msi que foi obtido do site. A instalação deve ser feita como Administrador do sistema operacional. O sistema gerenciador de banco de dados utilizado será o MySQL versão 5.5.25a, atualmente a versão estável mais recente. Eventualmente, no site http://www.mysql.com/ encontram-se outras versões. A instalação do MySQL é feita por um assistente como mostrado na figura. Siga os passos descritos no procedimento abaixo. Instalando o MySQL: - # Iniciar TodosProgramas Acessórios Windows Explorer Explorer <pasta corrente> - clique duplamente sobre o arquivo mysql-5.5.25a-win32.msi MySQL Server 5.5 Setup * na Janela Bem-Vindo (welcome) MySQL Server 5.5 Setup - I accept the terms in the License Agreement * na Janela Bem-Vindo (welcome) MySQL Server 5.5 Setup - (Typical) * para Choose Setup Type MySQL Server 5.5 Setup - (Install) * para Ready to install MySql Server 5.5 MySQL Server 5.5 Setup - Confirme caso o Windows solicite MySQL Enterprise MySQL Servar 5.5 Setup - Lauch the MySQL Instance Configuration Wizard * Manter selecionado 6

- (Finish) MySQL Server Instance Configuration Wizard MySQL Server Instance Configuration Wizard - Standard Configuration MySQL Server Instance Configuration Wizard - Install As Windows Service * Manter selecionado - Include BIN Directory in Windows PATH * Selecionar MySQL Server Instance Configuration Wizard - Modify Security Settings * Manter selecionado - {New root password: mysql} * sugerimos o mesmo nome da conta. No caso de um ambiente coorporativo, o super-usuário deverá definir esta senha e posteriormente criar contas de usuários para que tenham permissão de utilizar o banco. - {Confirm: mysql} - Enable root access from remote machines * Selecionar MySQL Server Instance Configuration Wizard - (Execute) * aguarde os 4 itens serem processados 3.1.2- INSTALAÇÃO DO APACHE: Execute o programa httpd-2.2.22-win32-x86-openssl-0.9.8t.msi. Eventualmente, no http://www.apache.org/ encontram-se outras versões. OBS: A instalação deve ser feita pelo Administrador do sistema operacional. Instalando o Apache: - # Iniciar TodosProgramas Acessórios Windows Explorer Explorer <pasta escolhida> - clique duplamente sobre httpd-2.2.22-win32-x86-openssl-0.9.8t.msi - Responda SIM para permissão do windows Apache HTTP Server 2.2 Installation Wizard Apache HTTP Server 2.2 Installation Wizard License Agreement - ( I accept the terms in the licence agreement) Apache HTTP Server 2.2 Installation Wizard Read This First 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. - {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) 7

Apache HTTP Server 2.2 Installation Wizard Setup Type - ( Typical) Apache HTTP Server 2.2 Installation Wizard Destination Folder - Manter o caminho padrão 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) NOTA: 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!. 3.1.3- INSTALAÇÃO DO JAVA: Execute o programa jxpiinstall.exe para instalar o Java 7. A instalação será feita por um assistente como mostrado na figura. Siga os passos descritos no procedimento. OBS: A instalação deve ser feita pelo Administrador do sistema operacional e o computador conectado a internet. Instalando o Java 7: - # Iniciar TodosProgramas Acessórios Windows Explorer Explorer <pasta escolhida> - clique duplamente sobre jxpiinstall.exe - Responda SIM para permissão do windows Instalação do Java Bem-vindo 8

- (Instalar >) Fazendo Download do Instalador Java - Aguarde a transferência do arquivo Configuração do Java - (Próximo >) Instalação do Java - Andamento - Aguarde a transferência do arquivo Instalação do Java - Concluída 3.1.4- INSTALAÇÃO DO APACHE-TOMCAT: Execute o programa apache-tomcat-7.0.28.exe. OBS: A instalação deve ser feita pelo Administrador do sistema operacional. Instalando o Apache-Tomcat: - # Iniciar TodosProgramas Acessórios Windows Explorer Explorer <pasta escolhida> - clique duplamente sobre apache-tomcat-7.0.28.exe - Responda SIM para permissão do windows Apache Tomcat Setup Apache Tomcat Setup License Agreement - (I Agree) Apache Tomcat Setup Choose Components - (Select the type of install: Full) Apache Tomcat Setup Configuration - ( Create shortcuts for all users) * marcar - {User Name tomcat} - {Password tomcat} * sugerimos o mesmo nome Apache Tomcat Setup Java Virtual Machine * manter o diretório do Java Apache Tomcat Setup Choose Install Location - (Install) Apache Tomcat Setup Installing - Aguarde instalação Apache Tomcat Setup - (Finish) NOTA: Para testar a instalação, primeiramente, certifique-se de que o Apache Tomcat esteja 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 Autenticação solicitada 9

- {Nome do Usuário tomcat} - {Senha tomcat} Navegador / manager - Tomcat Web Application Manager - Verifique as aplicações instaladas 3.1.5- INSTALAÇÃO DO TERRAVIEW4.2.0: Execute o programa terraview420.exe. Instalando o TerraView: - # Iniciar Todos Programas Acessórios Windows Explorer Explorer <pasta selecionada> - clique duplamente sobre o arquivo terraview420.exe - Responda SIM para permissão do windows Instalação do TerraView 4.2.0 - (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. 3.1.6- INSTALAÇÃO DO TERRAOGC: O pacote TerraOGC é composto por aplicativos que fornecem os dados presentes em 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. Para realizar a instalação do aplicativo TerraOGC é necessário realizar o download do pacote. O download deve ser realizado no sitio de internet http://www.dpi.inpe.br/terrama2/, na página de download, onde é necessário realizar um cadastro, caso ainda não tenha realizado. Esse módulo possui alguns pré-requisitos que precisam ser instalados. As dependências são: Apache HTTP (http://httpd.apache.org/) descrito acima. Execute a instalação através do arquivo TerraOGC.exe, realizando um duplo clique sobre o arquivo. Configure as opções apresentadas até a instalação do TerraOGC. A figura abaixo apresenta a janela inicial do instalador Windows. 10

Instalando o TerraOGC: - # Iniciar Todos Programas Acessórios Windows Explorer Explorer <pasta selecionada> - clique duplamente sobre o arquivo TerraOGC.exe - Responda SIM para permissão do windows Installer Language - (Please select a lamguage: 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) 3.2- Instalação do TerraMA 2 : Execute a instalação através do arquivo TerraMA2_v3.0.0_win32.exe, realizando um duplo clique sobre o arquivo. Configure as opções apresentadas. A figura abaixo apresenta a janela inicial do instalador Windows. 11

Instalando o TerraMA 2 : - # Iniciar Todos Programas Acessórios Windows Explorer Explorer <pasta selecionada> - clique duplamente sobre o arquivo TerraMA2_v3.0.0_win32.exe - Responda SIM para permissão do windows Installer Language - (Please select a lamguage: Português Brasileiro) - (OK) Instalação do TerraMA 2 3.0 - (Próximo >) Instalação do TerraMA 2 3.0 Escolher Usuários - ( Instalar para qualquer um usando este computador) - (Próximo >) * manter os plugins selecionados Instalação do TerraMA 2 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. 12

3.3- Instalação do Aplicativo WEB TerraMA 2 : O aplicativo Web TerraMA² é composto pelo módulo de Alertas. Esse aplicativo realiza a apresentação dos alertas, mapas de risco, planos adicionais, dados de entrada e possui diversas funcionalidades. Para realizar a instalação do aplicativo Web TerraMA² é necessário realizar o download do arquivo AlertasWeb.war. 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 TerraMA 2 : - # 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 )} Enviar arquivo - (Olhar em : <pasta selecionada>) - (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, conforme a figura abaixo. Figura 3.2 Aplicação AlertasWeb NOTA: Caso tenha mais de um aplicativo web a ser instalado, onde um segundo bando de dados deve ser configurado, altere o nome AlertasWeb.war para algo como 13

AlertasWeb2.war.antes de adicioná-lo conforme procedimento acima. Posteriormente, lembre-se de alterar o parâmetro OpenLayers.ProxyHost no item 3.4.3. Neste ponto o módulo de alertas está instalado, mas ainda não está configurado. Como configurar e customizar o módulo de alertas veja no Manual do Usuário. Normalmente os diretórios das aplicações adicionadas ao Tomcat 7 ficam nos diretórios "C:/Program Files/Apache Software Foundation/Tomcat 7.0/webapps" para Windows ou /var/lib/tomcat7/webapps para Linux. Normalmente o endereço do módulo de visualização é http://localhost:8080/alertasweb/, é necessário que configure o Tomcat 7 para que usuários externos possam ter acesso ao módulo de alertas. Lembre-se sempre de dar permissão de acesso externo e configurar o firewall para o Tomcat 7. 3.4 - Configuração do TerraMA 2 : Para completar a instalação é necessário que o usuário tenha criado um banco de dados, tenha cadastrado fontes de coleta de dados, tenha definido planos de risco e adicionais que foram importadas no aplicativo TerraView, tenha criado análises e adicionado usuários para receber tais análises. Estes procedimentos dependem do uso que o usuário fará ao TerraMA 2. As configurações a seguir são necessárias para utilizar o aplicativo WEB. O procedimento a seguir é definido supondo algumas definições como exemplo. Gerenciador utilizado : PostgreSQL Usuário do gerenciador do banco de dados : postgres Senha do gerenciador : postgres Porta do gerenciador : 5432 Nome do Banco de Dados : meubanco Nome da vista do banco de dados : vista1 Nome da vista do banco de dados : vista2 3.4.1- CONFIGURAÇÃO DO TERRAOGC: O TerraOGC está apto a disponibilizar os dados nos formatos WFS, WMS e WCS do padrão OGC, mas para isso é necessário configurar cada um dos serviços. O diretório de instalação do TerraOGC contém os seguintes arquivos que precisam ser configurados: wcsconfiguration.xml, wmsconfiguration.xml e wfsconfiguration.xml. Os três arquivos possuem basicamente a mesma estrutura, onde a principal configuração é a inclusão de banco de dados para que seja disponibilizado. Na área <TeDataSource> adicione os bancos de dados TerraLib que deseja disponibilizar. Abaixo um exemplo de um banco de dados PostgreSQL conforme definições acima. <TeDatabase id="1"> 14

<DBType>PostgreSQL</DBType> <Host>localhost</Host> <User>postgres</User> <Password>postgres</Password> <DBName>meubanco</DBName> <TeViews> <TeView name="vista1"/> </TeViews> </TeDatabase> <TeView name="vista2"/> *nome do banco de dados *nome da vista criado no TerraView *nome da vista criado no TerraView TerraMA² - Manual de Instalação Na propriedade TeView, adicione todas as Vistas que deseja disponibilizar. Além do banco de dados pode-se configurar as outras propriedades dos arquivos de configuração. NOTA: Caso tenha mais de um aplicativo web instalado, duplique todo o trecho com os parâmetros acima e edite-os de acordo com o tipo de banco utilizado (PostgreSQL, PostGIS ou MySQL), local onde está sendo executado o servidor de banco de dados (localhost ou outro), usuário e senha de acesso ao banco, nome do banco e vistas criadas no TerraView. No parâmetro TeDatabase id altere para 2 ou mais dependendo de quantos aplicativos web serão utilizados. 3.4.2- CONFIGURAÇÃO DO APACHE: Inserir as seguintes linhas do arquivo httpd.conf que está no diretório C:\Arquivos de Programas (x86)\apache Group\Apache2\conf. OBS: Esta configuração deve ser feita pelo Administrador do sistema operacional. ScriptAlias /teogc/ "C:/Arquivos de Programas (x86)/terraogc/" <Directory "C:/Arquivos de Programas (x86)/terraogc/"> Options +ExecCGI Order allow,deny Allow from all </Directory> NOTA: Reiniciar o Apache após a inclusão das linhas acima 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 15

3.4.3- CONFIGURAÇÃO DO ALERTAS WEB: Alterar o arquivo config.js que está em C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\AlertasWeb\script. OBS: Esta substituição deve ser feita pelo Administrador do sistema operacional. Configurar a localização do aplicativo Web. Certifique que o nome do aplicativo é o mesmo considerando a diferença entre maiúsculas e minúsculas, conforme instalação realizada no item 1.4 acima e a variável: OpenLayers.ProxyHost = "/AlertasWeb/proxy.jsp?"; NOTA: Caso tenha mais de um aplicativo web instalado, altere o nome AlertasWeb conforme instalação realizada no item 1.4. Alterar o arquivo hibernate.cfg.xml que está em C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\AlertasWeb\WB-INF\classes. Configurar a conexão com a base de dados: <property name="hibernate.connection.driver_class">org.postgresql.driver</property> <property name="hibernate.connection.url">jdbc:postgresql://localhost:5432/meubanco</property> * nome do banco <property name="hibernate.connection.username">postgres</property> <property name="hibernate.connection.password">postgres</property> 3.4.4- RECARREGAR O APACHE-TOMCAT: Abrir o Tomcat Manager. Verifique a porta do Tomcat: http://localhost:8080/manager Clique no Reload ao lado do aplicativo AlertasWeb 16

3.4.5- TESTAR O APLICATIVO WEB: Abrir o navegador e digitar o endereço: http://localhost:8080/alertasweb No navegador deverá aparecer o login do usuário. 17

4 INSTALAÇÂO LINUX A plataforma Linux possui três tipos de distribuição: Tar.gz, Deb e RPM. As distribuições Deb e RPM servem apenas para os Linux's que sigam esse tipo de instalação. Para todas as formas de instalação alguns pacotes precisam ser instalados, para que o TerraMA² possa executar. As dependências são: libqtcore4 libqtgui4 libqtxml4 libqtnetwork4 libxerces-c3.1 libpq9.0_5 libmysqlclient Para instalar os pacotes listados acima (é necessário que seja o usuário root), utilize os seguintes comandos para cada uma das bibliotecas: su urpmi <nome do pacote> 4.1 Instalação do TerraMA 2 4.1.1 TAR.GZ Neste tipo de distribuição o pacote de aplicativos do TerraMA² está apenas reunido e compactado. Para descompactar o pacote terrama2_3.0.tar.gz utilize o seguinte comando: tar -zxf terrama2_3.0.tar.gz Após a execução do comando, é criado um diretório chamado "terrama2_3.0" no diretório corrente. Neste tipo de instalação é necessário que os pacotes dependentes sejam instalados para que o TerraMA² seja executado. Para executar os módulos do TerraMA², entre no diretório de instalação e execute os comandos abaixo para abrir o módulo de Administração e Configuração, respectivamente:./admin./config 18

4.1.2 DEB Neste tipo de distribuição o pacote de aplicativos do TerraMA² está no formato das distribuições baseadas no ambiente Debian. Para instalar o pacote terrama2_3.0.1.deb utilize o seguinte comando: dpkg i terrama2_3.0.1.deb Para realizar a instalação é necessário que seja o usuário root, logo se deve tomar cuidado com as permissões o diretório de instalação, principalmente a permissão de escrita. Após a execução do comando, no diretório /usr/local é criado um diretório chamado "terrama2". Para executar os módulos do TerraMA² execute os comandos abaixo para abrir o módulo de Administração e Configuração, respectivamente: 4.1.3 RPM./usr/local/terrama2/admin./usr/local/terrama2/config Neste tipo de distribuição o pacote de aplicativos do TerraMA² está no formato das distribuições baseadas em instalações RPM(RedHat Package Manager). Para instalar o pacote terrama2_3.0.1.rpm utilize o seguinte comando: rpm ivh terrama2_3.0.1.rpm Para realizar a instalação é necessário que seja o usuário root, logo se deve tomar cuidado com as permissões o diretório de instalação, principalmente a permissão de escrita. Após a execução do comando, no diretório /usr/local é criado um diretório chamado "terrama2". Para executar os módulos do TerraMA² execute os comandos abaixo para abrir o módulo de Administração e Configuração, respectivamente:./usr/local/terrama2/admin./usr/local/terrama2/config 4.2 TerraOGC O pacote TerraOGC é composto por aplicativos que fornecem os dados presentes em 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. Para realizar a instalação do aplicativo TerraOGC é necessário realizar o download do pacote. O download deve ser realizado no sitio de internet http://www.dpi.inpe.br/terrama2/, na página de download, onde é necessário realizar um cadastro, caso ainda não tenha realizado. 19

Esse módulo possui alguns pré-requisitos que precisam ser instalados. As dependências são: Apache HTTP (http://httpd.apache.org/). Para prosseguir realize a instalação das dependências. 4.2.1 TAR.GZ Neste tipo de distribuição o pacote de aplicativos do TerraOGC está apenas reunido e compactado. Para descompactar o pacote terraogc_1.1.0.tar.gz utilize o seguinte comando: tar -zxf terraogc_1.1.0.tar.gz Após a execução do comando, é criado um diretório chamado "terraogc_1.1.0" no diretório corrente. Neste tipo de instalação é necessário que os pacotes dependentes sejam instalados para que o TerraMA² seja executado. Para executar os módulos do TerraOGC, é necessário realizar a configuração apresentada no item 4.3 4.2.2 DEB Neste tipo de distribuição o pacote de aplicativos do TerraOGC está no formato das distribuições baseadas no ambiente Debian. Para instalar o pacote terraogc_1.1.0.deb utilize o seguinte comando: dpkg i terraogc_1.1.0.deb Para realizar a instalação é necessário que seja o usuário root, logo se deve tomar cuidado com as permissões o diretório de instalação, principalmente a permissão de escrita. Após a execução do comando, no diretório /usr/local é criado um diretório chamado "terraogc". Para executar os módulos do TerraOGC, é necessário realizar a configuração apresentada no item 4.3 4.2.3 RPM Neste tipo de distribuição o pacote de aplicativos do TerraMA² está no formato das distribuições baseadas em instalações RPM(RedHat Package Manager). Para instalar o pacote terraogc_1.1.0.rpm utilize o seguinte comando: rpm ivh terraogc_1.1.0.rpm Para realizar a instalação é necessário que seja o usuário root, logo se deve tomar cuidado com as permissões o diretório de instalação, principalmente a permissão de escrita. Após a execução do comando, no diretório /usr/local é criado um diretório chamado "terraogc". Para executar os módulos do TerraOGC, é necessário realizar a configuração apresentada no item 4.3 20

4.3 Configurando Após realizar a instalação das dependências e do TerraOGC é necessário configurar o Apache HTTP e o TerraOGC 4.3.1 APACHE HTTP Configurando o Apache HTTP para adicionar o TerraOGC como uma aplicação. Para isso é necessário alterar o arquivo httpd.conf adicionando as seguintes propriedades. O arquivo httpd.conf fica armazenado no diretório /etc/httpd/conf no ambiente Linux (é necessário permissão de superusuário). As propriedades abaixo podem ser incluídas ao final do arquivo httpd.conf: ScriptAlias /teogc/ "C:/Program Files/TerraOGC/" <Directory "C:/Program Files/TerraOGC/"> Options +ExecCGI Order allow,deny Allow from all </Directory> Essas propriedades não possuem nenhuma restrição, este é apenas um exemplo simples de configuração. De acordo com sua necessidade configure a sua maneira o Apache HTTP. 4.3.2 TERRAOGC O TerraOGC está apto a disponibilizar os dados nos formatos WFS, WMS e WCS do padrão OGC, mas para isso é necessário configurar cada um dos serviços. O diretório de instalação do TerraOGC contém os seguintes arquivos que precisam ser configurados: wcsconfiguration.xml, wmsconfiguration.xml e wfsconfiguration.xml. Os três arquivos possuem basicamente a mesma estrutura, onde a principal configuração é a inclusão de banco de dados para que seja disponibilizado. Na área <TeDataSource> adicione os bancos de dados TerraLib que deseja disponibilizar. Abaixo um exemplo de um banco de dados PostgreSQL. <TeDatabase id="2"> <DBType>PostgreSQL</DBType> <Host>localhost</Host> <User>postgres</User> 21

<Password>password</Password> <DBName>databasetwo</DBName> <TeViews> </TeViews> </TeDatabase> <TeView name="view1"/> <TeView name="view2"/> Na propriedade TeView, adicione todas as Vistas que deseja disponibilizar. Além do banco de dados pode-se configurar as outras propriedades dos arquivos de configuração. 22