doc

Gestão de Projectos de Software
Licenciatura em Engenharia Informática e Computação
Faculdade de Engenharia da Universidade do Porto
Projecto SAPIENS
Sistema de Avaliação Assistida por Computador
MANUAL DE INSTALAÇÃO
2000/12/20
AUTORIA
Luís Almeida
João Pires
REVISTO E APROVADO
Rui Filipe Andrade Pereira
Projecto SAPIENS
Manual de Instalação
GRUPO DE PROJECTO
Chefe (Gestor de Projecto)
Rui Pereira
Secretária
Sandra Oliveira
Controlo da Qualidade/Auditor
Miguel Teixeira
Analistas/Arquitectos
Artur Matos
Nuno Costa
Programadores
João Pires
Luís Almeida
GPS 2000/2001
2
Projecto SAPIENS
Manual de Instalação
Índice
1.
MANUAL DE INSTALAÇÃO ............................................................................................................. 4
1.1.
Instalação jBoss + Tomcat ............................................................................................................................... 4
1.2.
Configurar Acesso a base de dados ................................................................................................................. 5
1.3.
Configurar o Tomcat ....................................................................................................................................... 6
1.4.
Deploy Componentes........................................................................................................................................ 6
GPS 2000/2001
3
Projecto SAPIENS
Manual de Instalação
1. Manual de Instalação
O sistema por nós desenvolvido encontra-se dividido em componentes: sejam eles componentes
Enterprise Java Beans, ou componentes de interface gráfica em Servlets. Uma das principais vantagens na
utilização de uma arquitectura standard deste tipo, está na facilidade de distribuição (deployment) dos
sistemas desenvolvidos. Ao lançar ambas as normas, a ideia da Sun era unificar processos de distribuição
tipicamente muitos diversos entre software servidor de diversos competidores.
Na realidade, num mundo ideal, seria muito fácil proceder à instalação do nosso sistema: o
administrador, habituado à plataforma com que trabalha, pode utilizar os ficheiros .jar (com os EJBs) e
.war (com as Servlets) e proceder de acordo com as definições do software servidor. Não seria necessário
proceder a qualquer alteração nos componentes por nós desenvolvidos.
Infelizmente, diferentes combinações de servidores (Web e de aplicações) implicam procedimentos
ligeiramente diferentes. Inclusive, a própria norma EJB não estabelece uma forma standard para algumas
definições importantes. Por exemplo, as definições de persistência estão nesta categoria, com variados
servidores de aplicações a necessitar de diferentes ficheiros.
Como tal, vamos exemplificar uma sequência de instalação típica para o conjunto jBoss + Tomcat, a
única combinação de servidores testada. O processo a desenrolar com outros servidores deixa-se ao
cuidado do administrador assim interessado, que poderá encontrar documentação relevante nos manuais
que acompanharam o seu software.
No nosso caso, vamos apresentar os passos necessários para a instalação do pacote integrado
jBoss+Tomcat, que serviu de base para o nosso processo de desenvolvimento, e que se recomenda para a
operação. Assumimos que o administrador já possui uma JVM (Java Virtual Machine) correctamente
instalada, compatível com a especificação 1.3.
1.1. INSTALAÇÃO JBOSS + TOMCAT
1.
Obtenha a distribuição para o servidor de EJBs jBoss a partir de www.jboss.org.
Recomendámos a obtenção da última versão (à data deste manual), a partir de
http://www.jboss.org/jboss_tomcat.zip .
2.
Descompacte o ficheiro ZIP resultante para um directório à sua escolha. A partir deste
momento, este directório será referido como %jboss%. Por exemplo, poderá ser c:\jboss em
Windows.
3.
No interior deste directório deverá ter dois subdirectórios: jboss-2.0-FINAL e tomcat-
3.2-b7. Visto que este pacote de instalação é integrado, bastará arrancar o jBoss para que o
servidor de Web também esteja em funcionamento.
GPS 2000/2001
4
Projecto SAPIENS
4.
Manual de Instalação
Pode experimentar a execução dos servidores, através do script %jboss%\jboss-2.0-
FINAL\bin\run.bat (caso esteja em Windows). O servidor deverá arrancar e apresentar a
mensagem: [Default] jBoss 2.0 FINAL Started
5.
Para terminar, deve pressionar Ctrl+C na janela onde executa o servidor: este detecta a
sucessão de teclas, e termina-se automaticamente de forma correcta.
1.2. CONFIGURAR ACESSO A BASE DE DADOS
Por omissão, o jBoss possui definidas 2 fontes de dados: uma para o InstantDB e outra para o
Hypersonic SQL. Vamos apresentar agora o modo de configurar as definições de acesso a dados do
servidor de aplicações.
A configuração do sistema encontra-se em %jboss%\jboss-2.0-FINAL\conf\. Dentro deste directório,
encontraremos um outro directório por cada sistema de configuração definido. As definições standard
estão no directório default. Para criar um conjunto alternativo, copie este directório. Para activar o novo
conjunto de configurações, execute “%jboss%\jboss-2.0-FINAL\bin\run outro_nome”. Escolha se
pretende alterar a configuração por omissão, ou definir uma nova. Esta secção referir-se-á sempre a
ficheiros na configuração escolhida.
1.
Edite o ficheiro jboss.properties, e configure o carregamento do driver JDBC a utilizar.
Para tal, localize a linha do tipo:
jdbc.drivers=org.hsql.jdbcDriver,org.enhydra.instantdb.jdbc.idbDriver
Para incluir o driver pretendido, por exemplo, o POSTGRESQL use:
jdbc.drivers=org.postgresql.Driver
2.
Edite o ficheiro jboss.jcml, e adicione as definições correspondentes ao driver de JDBC
pretendido. Por exemplo, para configurar um servidor PostgreSQL, adicione algo como:
<mbean name="DefaultDomain:service=XADataSource,name=PostgresDB">
<attribute name="Properties"></attribute>
<attribute
name="URL">jdbc:postgresql://gnomo.fe.up.pt/sapiens</attribute>
<attribute name="GCMinIdleTime">1200000</attribute>
<attribute name="JDBCUser">sapiens</attribute>
<attribute name="MaxSize">0</attribute>
<attribute name="Password">l0garitmo</attribute>
<attribute name="GCEnabled">false</attribute>
<attribute name="InvalidateOnError">false</attribute>
GPS 2000/2001
5
Projecto SAPIENS
Manual de Instalação
<attribute name="TimestampUsed">false</attribute>
<attribute name="Blocking">true</attribute>
<attribute name="GCInterval">120000</attribute>
<attribute name="IdleTimeout">1800000</attribute>
<attribute name="IdleTimeoutEnabled">false</attribute>
<attribute name="LoggingEnabled">false</attribute>
<attribute name="MaxIdleTimeoutPercent">1.0</attribute>
<attribute name="MinSize">0</attribute>
</mbean>
3.
Edite o ficheiro jboss.conf, e adicione as seguintes linhas
<MLET
CODE="org.jboss.jdbc.XADataSourceLoader"
ARCHIVE="jboss.jar,jdbc7.0-
1.2.jar" CODEBASE="../lib/ext/">
<ARG TYPE="java.lang.String" VALUE="PostgresDB">
<ARG
TYPE="java.lang.String"
VALUE="org.jboss.minerva.xa.XADataSourceImpl">
</MLET>
A partir deste momento, o servidor de aplicações já se encontra devidamente configurado.
1.3. CONFIGURAR O TOMCAT
A configuração do servidor de Web Tomcat é mais simples do que o servidor de aplicações. Neste
caso, não é necessário nenhuma alteração às definições do programa, mas apenas é necessário adicionar o
caminho para o ficheiro jar com os componentes EJB à variável de ambiente CLASSPATH.
1.4. DEPLOY COMPONENTES
Para realizar o deploy dos componentes, basta agora copiar o ficheiro com extensão jar para o
directório %jboss%\jboss-2.0-FINAL\deploy, e copiar o ficheiro com extensão war para o directório
%jboss%\tomcat-3.2-b7\webapps.
Depois deste passo, basta arrancar novamente o servidor, a aplicação já deverá estar a funcionar.
GPS 2000/2001
6