Instalando o WebAPSEE no Debian Etch

Estou testando algumas ferramentas para gerenciamento de projetos e dentre elas está o WebAPSEE. Trata-se de um sistema de gerenciamento de projetos de software desenvolvido pelo Laboratório de Engenharia de Software e Inteligência Artificial, da UFPA. Precisei instalar este software e como ele é um pouco complicado, resolvi documentar aqui e compartilhar o procedimento específico para o Debian Etch. Com algumas modificações é possível utilizá-lo em outras distribuições.

Em termos de arquitetura, o WebAPSEE foi desenvolvido como cliente-servidor, com ambas as partes possuindo subdivisões que podem ser separadas em um ou mais hosts. Toda a plataforma foi desenvolvida em Java, utilizando RMI para comunicação via rede (distribuída). Do lado do servidor é preciso possuir, além do WebAPSEE, um banco de dados MySQL e um servidor CVS, para controlar os "anexos" que poderão aparecer e serem armazenados junto à ferramenta de gerenciameto como um todo. A instalação do servidor CVS é opcional. Vamos aos passos:

  • Baixar a última versão do WebAPSEE;
  • Verificar disponibilidade de uma base de dados MySQL com privilégios de administrador dentro do banco de dados;
  • Verificar disponibilidade de servidor CVS (opcional);
  • Verificar instalação do Java Runtime Enviroment no servidor e nos clientes;
  • Instalar o WebAPSEE.

O WebAPSEE é constituído atualmente por 3 programas independentes:

  • Server: Processo que roda continuamente em background no servidor;
  • ManagerConsole Online: Interface de gerência do projeto (cliente);
  • Agenda Online: controle de tarefas dentro do projeto (cliente).

A distribuição desses softwares em servidor e cliente pode ser definida de forma bastante flexível. As escolhas acima foram feitas por mim, considerando que um servidor não deve possuir interface gráfico se isto for possível. Logo, os programas standalone devem ficar nos clientes (estações dos desenvolvedores e gerentes do projeto).

O primeiro problema ocorre com o instalador, que é só um para os três programas, e requer interface gráfica para rodar. Isto confirma que, pelo menos inicialmente, será necessário ter um X.org funcional no servidor para poder instalar as partes de software que lhe cabem.

Do início: cheque se você tem acesso apartir do servidor a uma base de dados em um MySQL, com privilégios de administrador da base de dados (root). Depois cheque o CVS, pois precisará de um repositório caso queria salvar os documentos anexos ao projeto. O MySQL e o CVS podem estar rodando no servidor local, junto ao Server do WebAPSEE (maiores informações detalhadas sobre como instalar o MySQL e o CVS estarão aqui no Hypercast muito em breve).

Teste agora o servidor gráfico e a presença do aplicativo "java", que executa programas compilados nessa linguagem na JVM. Uma vez com tudo isso pronto, inicie o servidor gráfico, caso ainda não esteja:

# /etc/init.d/gdm start

Caso tenha problema com a configuração do X.org, digite:

# dpkg-recofigure xserver-xorg

E depois tente iniciar o servidor novamente. Caso seu servidor possua somente o modo texto, instale o ambiente gráfico com:

# apt-get install x-window-system gdm gnome

Após instalar tudo, inicie o servidor gráfico com o comando anterior. Falta agora o Java JRE 5.0:

# apt-get install sun-java5-jre

Neste ponto, já dentro do ambiente gráfico, faça o download do WebAPSEE, descompacte-o e execute o instalador (note que a partir desse ponto o uso do root não é mais necessário):

$ wget -c http://ufpr.dl.sourceforge.net/sourceforge/webapsee/WebAPSEE-1.3-Open.zip

$ unzip WebAPSEE-1.3-Open.zip

$ java -jar Installer-Webapsee.jar

Agora basta seguir o instalador. A parte mais importante é na etapa de seleção de quais programas serão instalados. Caso você esteja em um ambiente de teste, pode escolher os três para serem instalados na mesma máquina, aproveitando que o ambiente gráfico já está instalado e tudo mais.

Caso esteja preparando um ambiente de produção, instale apenas o Server (além do MySQL e CVS, que já devem estar instalados e configurados a essa altura, por você, independentemente do instalador do WebAPSEE) no servidor, e nas estações de desenvolvimento, somente os outros dois (ou apenas um deles, dependendo da necessidade).

Siga a documentação para prosseguir pelas etapas do instalador. Está tudo bem explicado e detalhado. A maior quantidade de perguntas está na instalação do Server, como os endereços e credenciais de acesso aos outros serviços separados.

Já em uma estação que irá rodar os softwares standalone, algum passos ainda devem ser dados. Primeiramente os programas devem ser inicializados e configurados. Dentro do diretório de cada programa existe um script chamado Edit_NomeDoPrograma_Configurations.sh. Este arquivo deve receber privilégio de execução e ser executado. Em ambos os casos uma pequena janela se abrirá, pedindo a configuração de host do servidor, login, password e as portas utilizadas. Vamos supor que estamos na estação com o ManagerConsole e Agenda instalados. Primeiro entre no diretório onde está  instalado o Manager Console:

$ cd ~/WebAPSEE/_ManagerConsole_Online/

$ chmod +x *sh

$ ./Edit_MConsole_Configurations.sh

É este o programa que fará  as configurações iniciais, como havia dito. Depois execute o Manager Console através da execução do seguinte script (no mesmo diretório):

./Start_MConsole_OnLine.sh

Faça o mesmo para o Agenda:

$ cd ~/WebAPSEE/_Agenda_Online

$ chmod +x *sh

$ ./Edit_Agenda_Configurations.sh

$ ./Start_Agenda_OnLine.sh

Vale lembrar que a senha padrão que os configuradores sugerem para um ambiente de teste é 123456. Caso vocês tenha pulado algum passo ou confirmado algo sem querer, está é a senha que você irá usar até ter acesso novamente ao sistema e mudar  a senha. Posteriormente, você precisará apenas dos comandos de execução do software que desejar usar:

  • P/ Manager Console:

$ cd ~/WebAPSEE/_ManagerConsole_Online/ && ./Start_MConsole_OnLine.sh

  • P/ Agenda:

$ cd ~/WebAPSEE/_Agenda_Online/ && ./Start_Agenda_OnLine.sh

É isso. Espero que tenha ajudado aqueles interessados em utilizar o WebAPSEE com o processo de instalação. O MySQL e o CVS no Debian Etch ficam para a próxima. Até mais!

Artigos Relacionados:


Sobre este artigo