Geplanes Gesto de Planejamento Estratgico

Manual de Instalao - Windows

Maio de 2010

Sumrio

1. Introduo................................................................................................................3 2. Pr-Requisitos..........................................................................................................4

2.1. Instalao do Java Development Kit 6 (JDK6).................................................4 2.1.1. Download do JDK.......................................................................................4 2.1.2. Instalao do JDK .......................................................................................6 2.1.3. Configurao da varivel de ambiente JAVA_HOME ..............................6

2.2. Instalao o Banco de Dados PostgreSQL........................................................9 2.2.1. Download do PostgreSQL...........................................................................9 2.2.2. Instalao do PostgreSQL ...........................................................................9

2.3. Instalao do Servidor de Aplicao JBoss 4.0.5 GA ................................... 16 2.3.1. Download do JBoss.................................................................................. 16 2.3.2. Instalao do JBoss .................................................................................. 16

3. Instalao do Geplanes......................................................................................... 17 3.1. Criao e configurao do Banco de Dados .................................................. 17 3.2. Configurao do Servidor de Aplicao (JBoss) ........................................... 18 3.3. Deploy da aplicao Geplanes ....................................................................... 20

4. Execuo do Geplanes.......................................................................................... 22

1. Introduo

Esse manual contm instrues passo-a-passo para instalao do Geplanes com as seguintes configuraes:

Sistema Operacional: Windows

Java Development Kit: JDK1.6.0_20

Banco de Dados: PostgreSQL 8.3.10-1

Servidor de Aplicao: JBoss 4.0.5 GA

2. Pr-Requisitos 2.1. Instalao do Java Development Kit 6 (JDK6)

Caso j possua o JDK configurado na mquina onde ser instalado o Geplanes, siga para o passo 2.2.

2.1.1. Download do JDK

Para fazer o download do JDK1.6.0_20, clique no link abaixo: http://java.sun.com/javase/downloads/widget/jdk6.jsp

Se a sua verso do Windows for de 32 bits, selecione a opo Windows na caixa de seleo Plataform. Em seguida, clique no boto Download, conforme figura abaixo:

Se a sua verso do Windows for de 64 bits, selecione a opo Windows x64 na caixa de seleo Plataform. Em seguida, clique no boto Download, conforme figura abaixo:

Independente da verso escolhida, 32 ou 64 bits, aparecer uma tela para login. Como esse login opcional, clique no ltimo link Skip this Step, conforme figura abaixo:

2.1.2. Instalao do JDK

V at o local onde o arquivo jdk-6u20-windows-i586.exe (ou jdk-6u20-windows-x64.exe) foi salvo e execute-o. Concluda a instalao, caso tenha seguido a configurao padro, o JDK estar instalado no caminho C:\Program Files\Java\jdk1.6.0_20

2.1.3. Configurao da varivel de ambiente JAVA_HOME

Para acessar as variveis de ambiente, v at o Painel de Controle, clique em Sistema e, em seguida, clique no boto Variveis de Ambiente, conforme figura abaixo:

Em seguida, verifique se existe a varivel de sistema JAVA_HOME. Se existir, clique no boto Editar..., seno clique no boto Novo.... Veja figura abaixo:

Em seguida, digite o caminho onde foi instalado o JDK, conforme figura abaixo:

Aps criar/editar a varivel JAVA_HOME, necessrio alterar a varivel de sistema Path. Para isso, seleciona a varivel com o nome Path e clique no boto Editar..., conforme figura abaixo:

Em seguida, adicione no final do valor da varivel o seguinte texto: ;%JAVA_HOME%\bin conforme figura abaixo:

Finalmente, clique no boto OK de todas as telas e reinicie o computador para que as alteraes surtam efeito.

Verifique se a varivel foi setada corretamente atravs do seguinte comando no prompt:

c:\> echo %JAVA_HOME%

A sada dever ser conforme a figura abaixo:

2.2. Instalao o Banco de Dados PostgreSQL

Caso j possua o PostgreSQL instalado na mquina, siga para o passo 2.3. 2.2.1. Download do PostgreSQL

Para fazer o download da verso 8.3.10-1 do PostgreSQL, clique no link abaixo: http://wwwmaster.postgresql.org/redir/333/f/binary/v8.3.10/win32/postgresql-8.3.10-1.zip

2.2.2. Instalao do PostgreSQL

Efetuado o download, v at o local onde o arquivo postgresql-8.3.10-1.zip foi salvo e descompacte-o.

Em seguida, clique no arquivo postgresql-8.3.msi

O processo de instalao ser iniciado. Primeiramente, ser pedido para escolher a linguagem utilizada durante a instalao. Selecione Portugs Brasil e clique no boto Start, conforme figura abaixo:

A prxima tela faz uma recomendao para que todos os programas sejam fechados antes de prosseguir com a instalao. Clique no boto Prximo, conforme figura abaixo:

A prxima tela fornece informaes sobre a instalao. Clique no boto Prximo, conforme figura abaixo:

A prxima tela lista os componentes que sero instalados, bem como o local onde ser instalado o PostgreSQL. No necessrio mudar nenhuma configurao nessa tela. Clique no boto Prximo, conforme figura abaixo:

Na prxima tela devero ser configurados alguns parmetros do PostgreSQL. - Marque a opo Instalar como servio - Crie uma senha para o usurio postgres - Digite novamente a senha criada Em seguida, clique no boto Prximo, conforme figura abaixo:

Na prxima tela devero ser configurados mais alguns parmetros do PostgreSQL. As configuraes devero estar conforme a figura abaixo. Em seguida, clique no boto Prximo.

Na prxima tela sero listadas as opes de linguagens procedurais que podero ser instaladas no PostgreSQL. Habilite somente a opo PL/pgsql. Em seguida, clique no boto Prximo, conforme figura abaixo:

Na prxima tela sero listados mdulos adicionais que podero ser instalados. Marque somente a opo Adminpack., conforme figura abaixo. Em seguida, clique no boto Prximo.

A prxima tela s para indicar que o PostgreSQL est pronto para ser instalado. Clique no boto Prximo, conforme figura abaixo:

A prxima tela informar o trmino do processo de instalao. Desmarque a opo Launch Stack Builder at exit, conforme figura abaixo. Em seguida, clique no boto Concluir.

Pronto. O PostgreSQL 8.3.10-1 j est instalado ser iniciado automaticamente todas as vezes que o Windows for iniciado. Para verificar se o PostgreSQL est em execuo no momento, v at o prompt e digite:

c:\> psql U postgres

Caso o comando no seja reconhecido, h duas opes possveis: colocar o caminho completo da instalao do PostgreSQL na varivel de ambiente PATH (conforme feito para a configurao do JDK) ou acessar diretamente o diretrio de instalao do PostrgreSQL antes de executar o comando acima (para a instalao padro, o PostgreSQL est localizado em "c:\Program Files\PostgreSQL\8.3\bin".

Em seguida, digite a senha criada para o usurio postgres durante o processo de instalao.

A sada dever ser conforme a figura abaixo:

Caso ocorra algum erro na conexo com o servidor de banco de dados, conforme figura abaixo, verifique na tela de servios do Windows se o servio PostgreSQL Database Server 8.3 est em execuo.

2.3. Instalao do Servidor de Aplicao JBoss 4.0.5 GA

Caso j possua o Jboss 4.0.5 ou superior instalado na mquina, siga para o passo 3.

2.3.1. Download do JBoss

Clique no link abaixo para efetuar o download da verso 4.0.5 GA do JBoss: http://sourceforge.net/projects/jboss/files/JBoss/JBoss-4.0.5.GA/jboss-4.0.5.GA.zip/download

2.3.2. Instalao do JBoss

A instalao do JBoss bem simples. Basta ir at o local onde o arquivo jboss-4.0.5.GA.zip foi salvo e descompact-lo.

3. Instalao do Geplanes 3.1. Criao e configurao do Banco de Dados

Inicialmente, dever ser criado um banco de dados com o nome geplanes. Para isso, proceda da seguinte forma:

Abra o prompt de comando (cmd.exe) e v at a pasta bin do diretrio 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.exe -U postgres geplanes

Entre com a senha do usurio postgres e pronto. Est criado o banco de dados.

Veja figura abaixo:

O prximo passo executar o script para criao das tabelas do geplanes. Para isso, basta executar o seguinte comando:

c:\Program Files\PostgreSQL\8.3\bin>psql.exe -U postgres -f c:\Temp\geplanes-1.0.0.sql -d geplanes

* Aqui, assume-se que o arquivo geplanes-1.0.0.sql (baixado do Portal do Software Pblico) esteja no diretrio Temp da Unidade C. Caso esteja em outro local, basta alterar o caminho acima.

3.2. Configurao do Servidor de Aplicao (JBoss)

Para efetuar a autenticao dos usurios no Geplanes ser necessrio configurar o mdulo de login no JBoss. Para isso, v at o diretrio de instalao do JBoss e abra o arquivo login-config.xml localizado na pasta server/default/conf.

Aberto o arquivo, inclua dentro da tag o seguinte bloco de cdigo:

guest MD5 hex java:/geplanes_PostgreSQLDS SELECT senha FROM usuario WHERE login = ? SELECT papel.nome, 'Roles' FROM usuario JOIN usuariopapel on usuario.id = usuariopapel.usuario_id JOIN papel on papel.id = usuariopapel.papel_id WHERE usuario.login = ?

Em seguida, abra o arquivo geplanes_postgresql-ds.xml (baixado do Portal do Software Pblico) e configure os parmetros de acesso ao banco de dados. Posteriormente, copie esse arquivo para a pasta server/default/deploy do diretrio de instalao do JBoss.

Por fim, para que seja possvel o Geplanes acessar as informaes do banco de dados PostgreSQL, necessrio que o driver JDBC correspondente esteja disponvel para o JBoss. Sendo assim, copie o arquivo postgresql-8.3-603.jdbc4.jar (baixado do Portal do Software Pblico) para a pasta server/default/lib do diretrio de instalao do JBoss.

3.3. Deploy da aplicao Geplanes

A ltima coisa a ser feita copiar o Geplanes para dentro do servidor de aplicao. Para isso, descompacte o arquivo geplanes-1.0.0.war.rar (baixado do Portal do Software Pblico) e copie a pasta geplanes.war para dentro da pasta server/default/deploy do diretrio de instalao do JBoss.

* Aps a descompactao, verifique se o arquivo geplanes-1.0.0.war.rar est na pasta server/default/deploy do diretrio de instalao do JBoss. Se estiver, REMOVA-O.

4. Execuo do Geplanes

Terminado o processo de instalao, o Geplanes est pronto para ser executado. Para isso, o servidor de aplicao (JBoss) dever ser inicializado. Portanto, v at a pasta bin do diretrio de instalao do JBoss e execute o arquivo run.bat

Assim que o JBoss terminar a inicializao ser exibida a mensagem Started in .... Observe a ltima linha da figura abaixo:

Agora, basta abrir um navegador web (preferencialmente IE7 ou Firefox 3) e digitar a URL: http://localhost:8080/geplanes

Por fim, entre com os dados de usurio (LOGIN/SENHA): admin/admin