Manual de Compilación Versão 3.0.1 Julio de 2013
Revisiones es Versão Autor Data Descrição 1.0 Anderson Araujo Lopes e Raphael Belo da Silva Abril de 2012 Meloni Primeira versão do documento 3.0.1 Viviana Aguilar Muñoz Julho 2013 Nueva Versión en español Powered by: Coordenação: Colaboradores: Projeto Temático Processo 04/09649-0 Desenvolvimento de Software:
Contenido 1 INTRODUÇÃO... 1 2 CÓDIGO FONTE... 2 2.1 CHECKOUT... 2 2.2 COMPILAÇÃO... 3 2.2.1 Windows... 3 2.2.2 Linux... 6 3 GERAÇÃO DOS INSTALADORES... 8 3.1 WINDOWS... 8 3.2 LINUX... 8
1 INTRODUÇÃO Este documento visa apresentar um passo a passo para a obtenção do código fonte, compilação, geração dos instaladores do TerraMA² e TerraOGC para as plataformas Windows e Linux. O TerraMA² é um sistema operacional para monitoramento de alertas de riscos ambientais de propriedade do Instituto Nacional de Pesquisas Espaciais que esta sobre a licença GNU GENERAL PUBLIC LICENSE (GPL) Version 3. A linguagem do código fonte do TerraMA² é C++ para todos os módulos, menos a interface de visualização que é utilizado Java. O TerraMA² possui algumas bibliotecas dependentes, algumas delas são: Qt, TerraLib, TerraOGC, Lua, GSOAP e TerraME. 1
2 CÓDIGO FONTE 2.1 Checkout Para realizar o checkout (download) do código fonte do TerraMA², é necessário instalar um software cliente de controle de versão SVN. Após a instalação do cliente SVN, faça os seguintes passos para obter o código fonte: svn checkout https://svn.dpi.inpe.br/sismaden/trunk Ao terminar o download de todo o código fonte do TerraMA², verifique se os seguintes diretórios foram baixados: admin (Módulo de Administração) alertas o terraweb alertasweb (Módulo de Visualização) analise (Serviço de Análise) animacao (Serviço de Animação) arquivador (Serviço de Arquivamento dos Dados) bin (Diretório dos executáveis) coleta (Serviço de Coleta) common (Arquivos comuns) configuracao (Módulo de Configuração) dependencies (Bibliotecas dependentes) o axis-1_4 o gsoap-2.7 o lua o qtservice o quazip o terralib o terrame o terraogc o terraphp 2
docs (Documentação) generatepdf (Serviço de Geração de PDF) idls (Arquivos do GSoap) distrib (Geração dos Instaladores) o tgz (Distribuição tar.gz) o deb (Distribuição deb) o rpm (Distribuição rmp) o win (Distribuição windows) notificacao (Serviço de Notificação) planos (Serviço de Planos) 2.2 Compilação 2.2.1 WINDOWS Para compilar o TerraMA² no ambiente Windows é necessária a instalação de alguns pré-requisitos: Microsoft Visual Studio 2008 (pode ser a versão Express) Qt 4.6.3 ou superior (para Microsoft Visual Studio) Para compilar as dependência do framework TerraMA² abra o prompt de comando do Qt (Qt 4.6.3 Command Prompt) e realize os seguintes passos: cd <diretório do TerraMA²> cd dependencies qmake recursive dependencies.pro nmake all Neste momento todas as dependências para o TerraMA² foram compiladas, para compilar o TerraMA² execute os seguintes comandos ainda no prompt de comando do Qt: qmake terrama2.pro nmake all 3
Caso queira gerar os arquivos de projeto do Microsoft Visual Studio, para utilizar o mesmo para desenvolver suas necessidades no TerraMA², execute o seguinte comando ainda no prompt de comando do Qt: updatevc.bat Para executar os serviços do TerraMA² é necessário copiar alguns arquivos, execute o comando abaixo ainda no prompt de comando do Qt, para copiar as dependências: copydlls.bat. Após compilar e copiar as dependências do TerraMA² para os diretórios correspondentes, o TerraMA² está preparado para ser executado. Utilize o Manual do Usuário como referência para executar os módulos e serviços do TerraMA². Para compilar o módulo de Visualização, é necessária a instalação de alguns pré-requisitos: Java SDK (recomendamos a versão 7.x) Ant 1.8.2 NetBeans 7.1.1 (faça o download pelo sitio www.netbeans.org) o Baixe a versão Java EE e Tomcat 7 No NetBeans, abra o projeto AlertasWeb do diretório <diretório do TerraMA²>/alertasweb Configure o servidor para o Tomcat 7 Após os requisitos instalados, execute os seguintes passos: Edite o arquivo <diretório do TerraMA²>/alertasweb/build.bat, modificando os diretórios do Java SDK e do Ant de acordo com sua instalação. Dê um duplo clique no arquivo <diretório do TerraMA²>/alertasweb/build.bat e aguarde finalizar a compilação. Após finalizar será criado o arquivo AlertasWeb.war no diretório <diretório do TerraMA²>/alertasweb/dist. Para compilar a versão 64 bits no ambiente Windows são necessárias algumas configurações. Microsoft Visual Studio 2008 (pode ser a versão Express) com compilador 64bits 4
Qt 4.6.3 ou superior (para Microsoft Visual Studio) compilado em 64bits, com suporte a OpenSSL Para compilar as dependência do framework TerraMA² abra o prompt de comando do Qt 64-bits (Qt 4.6.3_x64 Command Prompt) e realize os seguintes passos: (usando as versões 64-bits de qmake e de nmake) cd <diretório do TerraMA²> cd dependencies qmake recursive dependencies.pro nmake all Neste momento todas as dependências para o TerraMA² foram compiladas, para compilar o TerraMA² com Visual Studio, execute o seguinte comando ainda no prompt de comando do Qt: updatevc.bat Execute o Visual Studio com as variáveis de Qt corretamente definidas. Por causa de um problema conhecido de qmake, é preciso editar as propriedades da solução para compilar os executáveis 64-bits. Na caixa de diálogo Configuration Manager de Visual Studio, alterar a plataforma de destino para x64 (se não existir criar nova copiando os parâmetros da plataforma win32). Além disso, abra as propriedades de cada projeto e nas propriedades de configuração, definir as variáveis "Output Directory" e "Intermediate Directory" da seguinte forma: (Se for a versão Debug) Output Directory:. Intermediate Directory: debug\ (Se for a versão Release) Output Directory:. Intermediate Directory: release\ Para executar os serviços do TerraMA² é necessário copiar alguns arquivos, execute o comando abaixo ainda no prompt de comando do Qt, para copiar as dependências: copydlls_x64.bat 5
2.2.2 LINUX Para compilar o TerraMA² no ambiente Linux é necessária a instalação de algumas bibliotecas, para este manual, apresentaremos o passo a passo para o ambiente Mandriva 2011. As bibliotecas que precisam ser instaladas são: libqt4-devel-4.7.3 gcc-c++ libxerces-c-devel xerces-c libpq-devel libgd-devel libdread-devel libdvdread-devel libmysql-devel libzip-devel cmake atlas libatlas3-sse3 libboost-devel 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> Após a instalação de todas as dependências, podemos compilar o TerraMA². O processo de compilação começa através da compilação das dependências. cd <diretório do TerraMA²> cd dependencies./compiledeps.sh 6
A compilação das dependências é um passo demorado, pois compila as bibliotecas necessárias pelo TerraMA² que estão junto ao código fonte. Após a compilação das dependências podemos compilar o TerraMA², através dos seguintes comandos: cd <diretório do TerraMA²>./linuxmake.sh Aguarde a compilação do TerraMA², todos os executáveis são gerados no diretório <diretório do TerraMA²>/bin/debug ou <diretório do TerraMA²>/bin/release. Após compilar o TerraMA² está preparado para ser executado. Utilize o Manual do Usuário como referência para executar os módulos e serviços do TerraMA². Para compilar o módulo de Visualização, é necessária a instalação de alguns pré-requisitos: Ant 1.7.1 NetBeans 7.1.1 (faça o download pelo sitio www.netbeans.org) o Baixe a versão Java EE e Tomcat 7 No NetBeans, abra o projeto AlertasWeb do diretório <diretório do TerraMA²>/alertasweb o Configure o servidor para o Tomcat 7 Após os requisitos instalados, execute os seguintes passos: cd <diretório do TerraMA²>/alertasweb./build.sh Após executar o script acima será criado o arquivo AlertasWeb.war no diretório <diretório do TerraMA²>/alertasweb/dist. 7
3 GERAÇÃO DOS INSTALADORES 3.1 WINDOWS O processo de geração de um executável de instalação para Windows é realizada a través do software livre chamado NSIS (http://nsis.sourceforge.net/), realize o download e instale o software. Após a instalação do NSIS, execute-o e abra o script de geração do instalador do TerraMA² que deseja, atualmente existe os seguintes scripts de geração de instalação. <diretório TerraMa²>/distrib/win/terrama2.nsi <diretório TerraMa²>/distrib/win/terrama2_en.nsi <diretório TerraMa²>/distrib/win/terraogc.nsi A execução dos scripts no NSIS gera os arquivos executáveis para a instalação do TerraMA² ou do TerraOGC, os arquivos gerados para cada script são: <diretório TerraMa²>/distrib/TerraMA2_x86.exe <diretório TerraMa²>/distrib/TerraMA2_en_x86.exe <diretório TerraMa²>/distrib/TerraOGC_x86.exe 3.2 LINUX O processo de geração dos instaladores no ambiente Linux contém três formas, a primeira no formato TAR.GZ no qual os arquivos necessários a instalação do TerraMA² são apenas empacotados e compactados. Outra forma é o formato DEB, no qual é gerado um pacote de instalação para plataformas Linux que utilizam esse formato de instalação (exemplos: Ubuntu, Debian e outros). O último formato é o RPM, no qual é gerado um pacote de instalação para plataformas Linux que utilizam esse formato de instalação (exemplos: Mandriva, opensuse, Fedora e outros). Os formatos DEB e RPM precisam um pouco mais de cuidado devido ao diretório de instalação e suas permissões. O mais indicado é o formato TAR.GZ, no qual o controle sobre a instalação é maior. Após compilar o TerraMA² podemos criar os instaladores para cada formato: TAR.GZ Para criar o arquivo de instalação do TerraMA² no formato TAR.GZ, abra um terminal e siga os seguintes passos: cd <diretório do TerraMA²>/distrib/tgz 8
./build_targz.sh Caso queira criar os instaladores para a versão em inglês, execute os seguintes comandos: cd <diretório do TerraMA²>/distrib/tgz./build_targz.sh en Para criar o arquivo de instalação do TerraOGC no formato TAR.GZ, abra um terminal e siga os seguintes passos: cd <diretório do TerraMA²>/dependencies/terraogc/distrib/tgz./build_targz.sh DEB Para criar o arquivo de instalação do TerraMA² no formato DEB, abra um terminal e siga os seguintes passos (esse tipo de instalação funciona apenas em distribuições que utilizam esse formato para seus pacotes): cd <diretório do TerraMA²>/distrib/deb./build_deb.sh Caso queira criar os instaladores para a versão em inglês, execute os seguintes comandos: cd <diretório do TerraMA²>/distrib/deb./build_deb.sh en Para criar o arquivo de instalação do TerraOGC no formato DEB, abra um terminal e siga os seguintes passos: cd <diretório do TerraMA²>/dependencies/terraogc/distrib/deb./build_deb.sh RPM Para criar o arquivo de instalação do TerraMA² no formato RPM, abra um terminal e siga os seguintes passos (esse tipo de instalação funciona apenas em distribuições que utilizam esse formato para seus pacotes): cd <diretório do TerraMA²>/distrib/rpm 9
./rpm_build.sh Caso queira criar os instaladores para a versão em inglês, execute os seguintes comandos: cd <diretório do TerraMA²>/distrib/rpm./rpm_build.sh en Para criar o arquivo de instalação do TerraOGC no formato RPM, abra um terminal e siga os seguintes passos: cd <diretório do TerraMA²>/dependencies/terraogc/distrib/rpm./rpm_build.sh 10