Manual de Instalação do Geplanes - JBoss4

1. Orientações Gerais

2. Instalação do Geplanes - Versão 3.0.3

2.1. Pré-Requisitos

2.2. Criação e configuração do Banco de Dados

Inicialmente, crie um banco de dados com o nome geplanes_bsc. Para isso, proceda da seguinte forma:

Abra o prompt de comando (cmd.exe) e vá até a pasta bin do diretório 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_bsc

Entre com a senha do usuário postgres e pronto. Está criado o banco de dados. Veja figura abaixo:

 

O próximo passo é executar o script para criação das tabelas do geplanes. Para isso, basta executar o seguinte comando:

c:\Program Files\PostgreSQL\8.3\bin>psql.exe -U pos tgres -f c:\Temp\geplanes-3.0.3_new.sql -d geplanes _bsc

2.3. Deploy da Versão 3.0.3

Faça o download do arquivo geplanes-3.0.3.war.rar (http://www.softwarepublico.gov.br/dotlrn/clubs/geplanes/file-storage/view/metodologia-bsc/vers-es/geplanes-3-0-3/geplanes_bsc-3%2e0%2e3%2ewar%2erar), descompacte-o e copie a pasta geplanes_bsc.war para dentro do diretório server/default/deploy , localizado dentro do diretório de instalação do JBoss.

2.4. Configuração do Servidor de Aplicação (JBoss) para acesso ao banco de dados

Faça o download do arquivo geplanes_bsc_postgresql-ds.xml.rar (http://www.softwarepublico.gov.br/dotlrn/clubs/geplanes/file-storage/view/metodologia-bsc/vers-es/geplanes-3-0-3/geplanes_bsc_postgresql-ds%2exml%2erar), descompacte-o e configure (via bloco de notas ou qualquer outro editor de texto) os parâmetros de acesso ao banco de dados. Posteriormente, copie esse arquivo para a pasta server/default/deploy do diretório de instalação do JBoss.

Caso o Geplanes seja acessado via rede, você precisará criar pelo menos mais um bloco de configuração de acesso ao banco de dados dentro do arquivo geplanes _bsc_postgresql-ds.xml. Imagine que o Geplanes tenha sido instalado na máquina cujo IP seja 192.168.1.54 e cujo nome seja srv54.

Para que o Geplanes seja acessado pela URL http://192.168.1.54:8080/geplanes_bsc é necessária a criação do seguinte bloco de código dentro do arquivo geplanes_bsc_postgresql-ds.xml:

<local-tx-datasource>
   <jndi-name>192.168.1.54_geplanes_bsc_PostgreSQLDS</jndi-name>
   <connection-url>jdbc:postgresql://localhost/geplanes_bsc</connection-url>
   <driver-class>org.postgresql.Driver</driver-class>
   <user-name>postgres</user-name>
   <password>postgres</password>
   <metadata>
      <type-mapping>PostgreSQL 7.2</type-mapping>
   </metadata>
</local-tx-datasource>

Para que o Geplanes seja acessado pela URL http://srv54:8080/geplanes_bsc é necessária a criação do seguinte bloco de código dentro do arquivo geplanes_bsc_postgresql-ds.xml:

<local-tx-datasource>
   <jndi-name>srv54_geplanes_bsc_PostgreSQLDS</jndi-name>
   <connection-url>jdbc:postgresql://localhost/geplanes_bsc</connection-url>
   <driver-class>org.postgresql.Driver</driver-class>
   <user-name>postgres</user-name>
   <password>postgres</password>
   <metadata>
      <type-mapping>PostgreSQL 7.2</type-mapping>
   </metadata>
</local-tx-datasource>

Lembrando que, caso necessário, os parâmetros de acesso tais como nome e senha do usuário devem ser alterados.

Por fim, para que seja possível o Geplanes acessar as informações do banco de dados PostgreSQL, é necessário que o driver JDBC correspondente esteja disponível para o JBoss. Sendo assim, copie o arquivo postgresql-8.3-603.jdbc4.jar (http://www.softwarepublico.gov.br/dotlrn/clubs/geplanes/file-storage/view/bibliotecas/postgresql-8%2e3-603%2ejdbc4%2ejar) para a pasta server/default/lib do diretório de instalação do JBoss.

2.5. Execução da Aplicação

3.Atualização da Versão 3.0 para a Versão 3.0.3

3.1. Pré-Requisitos

3.2. Undeploy da Versão anterior

3.3. Atualização do Banco de Dados

Faça o download do arquivo geplanes-3.0_to-3.0.3.sql.rar (http://www.softwarepublico.gov.br/dotlrn/clubs/geplanes/file-storage/view/metodologia-bsc/vers-es/geplanes-3-0-3/geplanes-3%2e0_to-3%2e0%2e3%2esql%2erar), descompacte-o e execute o script SQL no(s) banco(s) de dados do Geplanes.

3.4. Deploy da Versão 3.0.3

Faça o download do arquivo geplanes-3.0.3.war.rar (http://www.softwarepublico.gov.br/dotlrn/clubs/geplanes/file-storage/view/metodologia-bsc/vers-es/geplanes-3-0-3/geplanes_bsc-3%2e0%2e3%2ewar%2erar), descompacte-o e copie a pasta geplanes_bsc.war para dentro do diretório server/default/deploy, localizado dentro do diretório deinstalação do JBoss.

3.5. Execução da Aplicação

4.Atualização da Versão 3.0.1 para a Versão 3.0.3

4.1. Pré-Requisitos

4.2. Undeploy da Versão anterior

4.3. Atualização do Banco de Dados

Faça o download do arquivo geplanes-3.0.1_to-3.0.3.sql.rar (http://www.softwarepublico.gov.br/dotlrn/clubs/geplanes/file-storage/view/metodologia-bsc/vers-es/geplanes-3-0-3/geplanes-3%2e0%2e1_to-3%2e0%2e3%2esql%2erar), descompacte-o e execute o script SQL no(s) banco(s) de dados do Geplanes.

4.4. Deploy da Versão 3.0.3

Faça o download do arquivo geplanes-3.0.3.war.rar (http://www.softwarepublico.gov.br/dotlrn/clubs/geplanes/file-storage/view/metodologia-bsc/vers-es/geplanes-3-0-3/geplanes_bsc-3%2e0%2e3%2ewar%2erar), descompacte-o e copie a pasta geplanes_bsc.war para dentro do diretório server/default/deploy, localizado dentro do diretório de instalação do JBoss.

4.5. Execução da Aplicação

5. Atualização da Versão 3.0.2 para a Versão 3.0.3

5.1. Pré-Requisitos

5.2. Undeploy da Versão anterior

5.3. Atualização do Banco de Dados

5.4. Deploy da Versão 3.0.3

Faça o download do arquivo geplanes-3.0.3.war.rar (http://www.softwarepublico.gov.br/dotlrn/clubs/geplanes/file-storage/view/metodologia-bsc/vers-es/geplanes-3-0-3/geplanes_bsc-3%2e0%2e3%2ewar%2erar), descompacte-o e copie a pasta geplanes_bsc.war para dentro do diretório server/default/deploy, localizado dentro do diretório de instalação do JBoss.

5.5. Execução da Aplicação