manual de instalação - windows
TRANSCRIPT
-
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