Estive fazendo uma pesquisa sobre ferramentas para Gerência do Ciclo de Vida de Aplicações, que fosse OpenSource e acabei esbarrando com o Endeavour.

O Endeavour (http://endeavour-mgmt.sourceforge.net/) é um sistema completo desenvolvido em J2EE que atende à maioria das necessidades para gerencia de desenvolvimento de software com altíssimo padrão de qualidade.

Neste artigo, demonstrarei como instalar e configurar o Endeavour no seguinte ambiente:

• Ubuntu 10.04;
• Tomcat Dedicado;
• Bancos de Dados MySQL;
• Hudson pata IC (Integração Contínua);
• Subversion;
• Documentação Wiki (JAMWIKI);
• OpenJDK.

Agenda:

1. Instalar e configurar dependências;
2. Instalar e configurar o Endeavour.

Pré-Requisitos:

• Ter acesso ROOT ao sistema;
• Conexão ativa com internet.

Instalar e configurar as Dependências

Instalando as dependências

$ sudo aptitude install tomcat6 openjdk-6-dbg openjdk-6-jre-headless openjdk-6-jdk openjdk-6-jre-zero mysql-server-5.1 mysql-client-5.1 apache2 libapache2-mod-php5 libapache2-mod-jk libapache2-mod-wsgi libapache2-svn subversion php5 php5-cgi php5-cli phpmyadmin php5-mysql unixodbc

Configurando

iniciar os serviços

$ sudo update-rc.d mysql enable
$ sudo service mysql start

$ sudo update-rc.d apache2 enable
$ sudo service apache2 start

$ sudo update-rc.d tomcat6 enable
$ sudo service tomcat6 start

Criando os Bancos de Dados

O comando abaixo criará os seguintes bancos de dados e usuários:

• BD endeavour
  Usuário: endeavour
  Senha @endeavour@
• BD jamwiki
  Usuário: jamwiki
  Senha: @jamwiki@

$ mysql -u root -p -e ”
CREATE USER ‘endeavour’@'%’ IDENTIFIED BY ‘@endeavour@’;
GRANT USAGE ON *.* TO ‘endeavour’@'%’ IDENTIFIED BY ‘@jamwiki@’ WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;
CREATE DATABASE IF NOT EXISTS `endeavour` ;
GRANT ALL PRIVILEGES ON `endeavour`.* TO ‘endeavour’@'%’;

CREATE USER ‘jamwiki’@'%’ IDENTIFIED BY ‘@jamwiki@’;
GRANT USAGE ON *.* TO ‘jamwiki’@'%’ IDENTIFIED BY ‘@jamwiki@’ WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;
CREATE DATABASE IF NOT EXISTS `jamwiki` ;
GRANT ALL PRIVILEGES ON `jamwiki`.* TO ‘jamwiki’@'%’;
”

Instalando o Endeavour

Faça o download da última versão estável do Endeavour no site http://sourceforge.net/projects/endeavour-mgmt/files/

Considerando que o arquivo foi salvo no diretório ~/Download, extraílo e depois mover o diretório endeavour-mgmt* para /opt/endeavour:

$ unzip ~/Download/endeavour-mgmt*.zip
$ sudo mv -r ~/Download/endeavour-mgmt*/ /opt/endeavour

Configurando o Endeavour

Alterar a porta do serviço HTTP do tomcat, de 8080 para 8888:

$ sed -i ‘s/(port=”)8080/18888/g’ /opt/endeavour/tomcat/conf/server.xml

Alterar a porta do serviço AJP do tomcat, de 8009 para 8899:

$ sed -i ‘s/(port=”)8009/188809/g’ /opt/endeavour/tomcat/conf/server.xml

Alterar o valor da directiva java.awt.headless para true na variável global CATALINA_OPTS no executável do endeavour:

$ [[ $(cat /opt/endeavour/start-endeavour.sh | grep -i "java.awt.headless=true") ]] || sed -i ‘s/(CATALINA_OPTS=”)/1-Djava.awt.headless=true /’ /opt/endeavour/start-endeavour.sh

Criar a estrutura do Banco de Dados endeavour

$ mysql -u root -p endeavour < /opt/endeavour/data/mysql/endeavour.sql

Configurar o banco de dados endeavour na aplicação

$ cp /opt/endeavour/data/mysql/hibernate.cfg.xml /opt/endeavour/tomcat/webapps/endeavour/WEB-INF/classes

Abra o arquivo com o seu editor de textos preferido e alltere o valor das seguintes TAGs:

# joe /opt/endeavour/tomcat/webapps/endeavour/WEB-INF/classes/hibernate.cfg.xml

<property name=”hibernate.connection.username”>USER_NAME_GOES_HERE</property>

para

<property name=”hibernate.connection.username”>endeavour</property>

e,

<property name=”hibernate.connection.password”>PASSWORD_GOES_HERE</property>

para

<property name=”hibernate.connection.password”>@endeavour@</property>

Adicionar permissao para execução nos scripts do Endearvour

$ find /opt/endeavour -name ‘*.sh’ -print -exec chmod +x {} ;

Iniciar o Tomcat Endeavour

$ sudo /opt/endeavour/start-endeavour.sh

Se nenhum erro foi exibido até aqui, o Endeavour está pronto para ser usado.

Parar o Tomcat Endeavour

$ sudo /opt/endeavour/stop-endeavour.sh

Usurfruindo

Para acessar o painel do endeavour, abra o seu navegador preferido e acesse a URL: http://localhost:8888/endeavour

O usuário administrador tem login Admin e senha password.

No próximo artigo, mostrarei a integração do Subversion e Hudson IC com o Endeavour.