GEPLANES GESTÃO DE PLANEJAMENTO ESTRATÉGICO MANUAL DE INSTALAÇÃO DO GEPLANES EM UM AMBIENTE WINDOWS

Transcrição

1 GEPLANES GESTÃO DE PLANEJAMENTO ESTRATÉGICO MANUAL DE INSTALAÇÃO DO GEPLANES EM UM AMBIENTE WINDOWS MAIO

2 Sumário 1. Introdução Pré-Requisitos Instalação do Java Development Kit 6 (JDK6) Download do JDK Instalação do JDK Configuração da variável de ambiente JAVA_HOME Instalação o Banco de Dados PostgreSQL Download do PostgreSQL Instalação do PostgreSQL Instalação do Servidor de Aplicação JBoss GA Download do JBoss Instalação do JBoss Instalação do Geplanes Criação e configuração do Banco de Dados Configuração do Servidor de Aplicação (JBoss) Deploy da aplicação Geplanes Confiugrando Jboss como serviço no Windows Atualização do Geplanes Atualização das versões 3.03/3.0.4 para Atualização da aplicação Atualização do banco de dados Execução do Geplanes

3 1. Introdução Esse manual contemm instruçoses passo-a-passo para instalaçaso do Geplanes com as seguintes configuraçoses: Sistema Operacional: Windows Java Development Kit: JDK1.6.0_45 Banco de Dados: PostgreSQL Servidor de Aplicaçaso: JBoss GA 3

4 2. Pré-Requisitos 2.1. Instalação do Java Development Kit 6 (JDK6) Caso jam possua o JDK configurado na mamquina onde seram instalado o Geplanes, siga para o passo Download do JDK Para fazer o download do JDK1.6.0_45, clique no link abaixo: 4

5 Seram apresentada a tela acima. Verifique o sistema operacional, caso seja a versaso de 32 bits do Windows, faça o download do produto Windows x86, caso seja a versaso 64 bits, faça download do produto Windows x Instalação do JDK Vam atem o local onde o arquivo jdk-6u45-windows-i586.exe (ou jdk-6u45-windowsx64.exe) foi salvo e execute-o. Concluímda a instalaçaso, caso tenha seguido a configuraçaso padraso, o JDK estaram instalado no caminho: C:\Program Files\Java\jdk1.6.0_ Configuração da variável de ambiente JAVA_HOME Para acessar as variamveis de ambiente, vam atem o Painel de Controle, clique em Sistema e, em seguida, clique no botaso Variamveis de Ambiente, conforme figura abaixo: 5

6 Em seguida, verifique se existe a variamvel de sistema JAVA_HOME. Se existir, clique no botaso EEditar..., senaso clique no botaso ENovo.... Veja figura abaixo: 6

7 Em seguida, digite o caminho onde foi instalado o JDK, conforme figura abaixo: Apoms criar/editar a variamvel JAVA_HOME, em necessamrio alterar a variamvel de sistema Path. Para isso, seleciona a variamvel com o nome Path e clique no botaso EEditar..., conforme figura abaixo: 7

8 Em seguida, adicione no final do valor da variamvel o seguinte texto: ;%JAVA_HOME%\bin conforme figura abaixo: Finalmente, clique no botaso EOK de todas as telas e reinicie o computador para que as alteraçoses surtam efeito. 8

9 Verifique se a variamvel foi setada corretamente atravems do seguinte comando no prompt: c:\> echo %JAVA_HOME% A saímda deveram ser conforme a figura abaixo: 2.2. Instalação o Banco de Dados PostgreSQL Caso jam possua o PostgreSQL instalado na mamquina, siga para o passo Download do PostgreSQL Para fazer o download da versaso do PostgreSQL, clique no link abaixo: 9

10 Instalação do PostgreSQL Efetuado o download, vam atem o local onde o arquivo postgresql zip foi salvo e descompacte-o. Em seguida, clique no arquivo postgresql-8.3.msi O processo de instalaçaso seram iniciado. Primeiramente, seram pedido para escolher a linguagem utilizada durante a instalaçaso. Selecione Portugues B Brasil e clique no botaso EStart, conforme figura abaixo: A promxima tela faz uma recomendaçaso para que todos os programas sejam fechados antes de prosseguir com a instalaçaso. Clique no botaso EPromximo, conforme figura abaixo: 10

11 A promxima tela fornece informaçoses sobre a instalaçaso. Clique no botaso EPromximo, conforme figura abaixo: 11

12 A promxima tela lista os componentes que seraso instalados, bem como o local onde seram instalado o PostgreSQL. Naso em necessamrio mudar nenhuma configuraçaso nessa tela. Clique no botaso EPromximo, conforme figura abaixo: Na promxima tela deveraso ser configurados alguns parametros do PostgreSQL. - Marque a opçaso EInstalar como serviço - Crie uma senha para o usuamrio postgres - Digite novamente a senha criada Em seguida, clique no botaso EPromximo, conforme figura abaixo: 12

13 Na promxima tela deveraso ser configurados mais alguns parametros do PostgreSQL. As configuraçoses deveraso estar conforme a figura abaixo. Em seguida, clique no botaso EPromximo. 13

14 Na promxima tela seraso listadas as opçoses de linguagens procedurais que poderaso ser instaladas no PostgreSQL. Habilite somente a opçaso EPL/pgsql. Em seguida, clique no botaso EPromximo, conforme figura abaixo: Na promxima tela seraso listados momdulos adicionais que poderaso ser instalados. Marque somente a opçaso EAdminpack., conforme figura abaixo. Em seguida, clique no botaso EPromximo. 14

15 A promxima tela em som para indicar que o PostgreSQL estam pronto para ser instalado. Clique no botaso EPromximo, conforme figura abaixo: 15

16 A promxima tela informaram o temrmino do processo de instalaçaso. Desmarque a opçaso ELaunch Stack Builder at exit, conforme figura abaixo. Em seguida, clique no botaso EConcluir. Pronto. O PostgreSQL jam estam instalado ser am iniciado automaticamente todas as vezes que o Windows for iniciado. Para verificar se o PostgreSQL estam em execuçaso no momento, vam atem o prompt e digite: c:\> psql U postgres Caso o comando naso seja reconhecido, ham duas opçoses possímveis: colocar o caminho completo da instalaçaso do PostgreSQL na variamvel de ambiente PATH (conforme feito para a configuraçaso do JDK) ou acessar diretamente o diretomrio de instalaçaso do PostrgreSQL antes de executar o comando acima (para a instalaçaso padraso, o PostgreSQL estam localizado em "c:\program Files\PostgreSQL\8.3\bin". 16

17 Em seguida, digite a senha criada para o usuamrio postgres durante o processo de instalaçaso. A saímda deveram ser conforme a figura abaixo: Caso ocorra algum erro na conexaso com o servidor de banco de dados, conforme figura abaixo, verifique na tela de serviços do Windows se o serviço PostgreSQL Database Server 8.3 estam em execuçaso. 17

18 2.3. Instalação do Servidor de Aplicação JBoss GA Caso jam possua o Jboss instalado na mamquina, siga para o passo Download do JBoss Clique no link abaixo para efetuar o download da versaso GA do JBoss jam configurado: Instalação do JBoss A instalaçaso do JBoss em bem simples. Basta ir atem o local onde o arquivo jboss_configurado.zip foi salvo e descompactam-lo. 18

19 3. Instalação do Geplanes 3.1. Criação e configuração do Banco de Dados Inicialmente, deveram ser criado um banco de dados com o nome geplanes_bsc Para isso, proceda da seguinte forma: Faça o download do arquivo contendo o script SQL do banco de dados no endereço abaixo: Apoms baixar e extrair o arquivo acima, abra o prompt de comando (cmd.exe) e vam atem a pasta bin do diretomrio onde foi instalado o PostgreSQL. c:\> cd "c:\program Files\PostgreSQL\8.3\bin" Em seguida, digite o seguinte comando para criar o banco de dados: c:\program Files\PostgreSQL\8.3\bin>createdb U postgres geplanes_bsc Entre com a senha do usuamrio postgres e pronto. Estam criado o banco de dados. Veja figura abaixo: 19

20 O promximo passo em executar o script para criaçaso das tabelas do geplanes. Para isso, basta executar o seguinte comando: c:\program Files\PostgreSQL\8.3\bin>psql.exe -U postgres Bf c:\temp\geplanes3.0.5_new.sql -d geplanes_bsc * Aqui, assume-se que o arquivo geplanes-3.0.5_new.sql esteja no diretório Temp da Unidade C. Caso esteja em outro local, basta alterar o caminho acima Configuração do Servidor de Aplicação (JBoss) Em seguida, abra o arquivo geplanes_bsc_postgresql-ds.xml na pasta /jboss/server/default/deploy do diretomrio de instalaçaso do JBoss e configure os parametros de acesso ao banco de dados. Segue abaixo exemplo das informaçoses contidas no arquivo com os dados que podem ser alterados destacados em amarelo: <local-tx-datasource> <jndi-name>nome_ou_ip_do_servidor_geplanes_bsc_postgresqlds</jndi-name> <connection-url>jdbc:postgresql://localhost/nome_do_banco_de_dados</connection-url> <driver-class>org.postgresql.driver</driver-class> <user-name>postgres (Usuário do banco de dados)</user-name> 20

21 <password> postgres (Senha do banco de dados)</</password> <metadata> <type-mapping>postgresql 7.2</type-mapping> </metadata> </local-tx-datasource> Podem ser criados quantos datasources forem necessamrios, uma para cada URL que seram utilizada para acessar o Geplanes. Por exemplo, se o Geplanes for acessado das seguintes formas: E necessamrio acrescentar no arquivo toda a tag <local-tx-datasource> para cada nome de servidor substituindo o item nome_ou_ip_do_servidor, pelo nome ou endereço da mamquina que seram o servidor. Exemplo de conteumdo do arquivo: 21

22 Caso o Jboss foi baixado pelo site do Geplanes no link contido neste manual, naso em necessamrio executar o passo abaixo: Para que seja possímvel o Geplanes acessar as informaçoses do banco de dados PostgreSQL, deve existir o driver JDBC correspondente na pasta server/default/lib do JBoss. Sendo assim, copie o arquivo postgresql jdbc4.jar (baixado do Portal do Software Pumblico) para a pasta server/default/lib do diretomrio de instalaçaso do JBoss. 22

23 3.3. Deploy da aplicação Geplanes Caso tenha feito o download do Jboss configurado, o Geplanes jam se encontra na pasta deploy, naso em necessamrio executar este passo. Baixe o arquivo atravems do endereço abaixo: Extrair e copiar o Geplanes para dentro do servidor de aplicaçaso, para isso, descompacte o arquivo geplanes_bsc zip e copie a pasta geplanes_bsc.war para dentro do diretomrio /jboss/server/default/deploy do JBoss. * Apoms a descompactaçaso, verifique se o arquivo geplanes_bsc zip estam na pasta /jboss/server/default/deploy do diretomrio de instalaçaso do Jboss ou se existe uma subpasta com o mesmo nome dentro de geplanes_bsc.war. Se estiver o arquivo zip remova-o ou caso tenha uma pasta geplanes_bsc.war dentro da mesma pasta, mova para que fique somente um diretomrio com este nome geplanes_bsc.war Confiugrando Jboss como serviço no Windows Faça o download do JBoss Web Native Connectors versaso correspondente ao seu sistema operacional (Windows 32 ou 64 bits). 23

24 Windows 32 bits Windows 64 bits Descompacte o arquivo jboss-native windows-x64-ssl.zip (no caso de um Windows 64 bits) e copie apenas os arquivos do diretomrio bin ( READMEservice.txt, jbosssvc.exe, jbossweb.x64.exe, jbosswebw.x64.exe e service.bat ) para JBOSS_HOME\bin. Edite o arquivo service.bat alterando as linhas 75 e 104, Linha antiga: call run.bat <.r.lock >> run.log 2>&1 Linha editada: call run.bat -b c default <.r.lock >> run.log 2>&1. Explicando a linha de comando: -b => em para indicar que o servidor pode ser acessado de qualquer mamquina na rede. -c default => indica que a configuraçaso de servidor a ser iniciada em a default (as configuraçoses de servidor do JBoss disponímveis ficam em JBOSS_HOME\server ). No prompt de comando acesse o diretomrio JBOSS_HOME\bin e execute o comando service.bat install. Com os passos mostrados anteriormente voce vai ter um serviço instalado no Windows para o JBoss com o nome JBAS50SVC. Para alterar o nome do serviço que seram instalado voce deve, antes de executar os passos descritos, alterar as linhas 20, 21 e 22 do arquivo service.bat com o nome e descriçaso mais adequados para o serviço. Caso ocorra algum erro ao iniciar o serviço do Jboss no Windows, verificar o arquivo run.log disponímvel no mesmo diretomrio do arquivo service.bat. 24

25 4. Atualização do Geplanes Este passo som em necessamrio para quem jam possui o Geplanes instalado na versaso ou 3.04, caso esteja realizando a primeira instalaçaso, prosseguir para o tompico 5 para execuçaso do Geplanes Atualização das versões 3.03/3.0.4 para Faça o download do Geplanes versaso no endereço abaixo: Faça do download do script para atualizaçaso do banco de dados no endereço abaixo: Apoms o download, extrair os arquivos geplanes_bsc_305.zip e geplanes3.0.3_3.0.4_to_3.0.5.zip gerando os respectivos arquivos geplanes_bsc.war e geplanes-3.0.5_upgrade.sql * Entre as versões e não houve mudanças no banco de dados, portanto o script de atualização para a é somente um Atualização da aplicação Interrompa a execuçaso do servidor de aplicaçaso Jboss e acesse o seu diretomrio de instalaçaso abaixo: \jboss\server\default\deploy Neste diretomrio, mova a pasta geplanes_bsc.war para uma outra pasta fora do diretomrio do Jboss para backup e copie o arquivo geplanes_bsc.war que extraiu no passo 4.1 para a pasta de deploy do Jboss. 25

26 Feito isso, a aplicaçaso do Jboss foi atualizada e o promximo passo em atualizar o banco de dados Atualização do banco de dados Abra o prompt de comando (cmd.exe) e vam atem a pasta bin do diretomrio onde foi instalado o PostgreSQL. c:\> cd "c:\program Files\PostgreSQL\8.3\bin" Antes de atualizar o banco de dados, realize uma compia de segurança do mesmo atravems do comando: pg_dump -U postgres geplanes_bsc > c:\backup\geplanes_bsc.sql * Neste comando, o backup será criado no diretório c:\backup\. Caso queira salvar em um outro local, basta alterar o caminho. Em seguida, digite o seguinte comando para executar a atualizaçaso do banco de dados: c:\program Files\PostgreSQL\8.3\bin>psql.exe -U postgres f c:\temp\geplanes3.0.3_3.0.4_to_3.0.5.sql -d geplanes_bsc * No comando acima, assume-se que o arquivo geplanes-3.0.3_3.0.4_to_3.0.5.sql esteja no diretório Temp da Unidade C. Caso esteja em outro local, basta alterar o caminho. Entre com a senha do usuamrio postgres e pronto, estam atualizado o banco de dados. O promximo passo em inciar o Jboss e executar o Geplanes. 26

27 5. Execução do Geplanes Terminado o processo de instalaçaso, o Geplanes estam pronto para ser executado. Para isso, o servidor de aplicaçaso (JBoss) deveram ser inicializado. Caso naso tenha instalado o Jboss como serviço no Windows, vam atem a pasta bin do diretomrio de instalaçaso do JBoss e execute o arquivo run.bat Assim que o JBoss terminar a inicializaçaso seram exibida a mensagem EStarted in.... Observe a umltima linha da figura abaixo: 27

28 Caso tenha instalado o Jboss como serviço, para iniciar o sistema e configura-lo para iniciar automaticamente com o Windows, acesse o Painel de Controle, procure por Ferramentas Administrativas e abra o item Serviços. Seram exibida a tela abaixo: De um duplo clique sobre o serviço para acessar suas propriedades, nesta tela em possímvel iniciar ou parar o servidor e definir o tipo de inicializaçaso se seram Automamtico (Na inicializaçaso do Windows) ou acionado manualmente. 28

29 Agora, basta abrir um navegador web (preferencialmente Google Chrome ou Mozilla Firefox) e digitar a URL: Por fim, entre com os dados de usuamrio (LOGIN/SENHA): admin/admin 29