Configurando o Jobsworth (ClockingIT)

O sistema de controle de projetos e chamados Jobsworth é um fork do ClockingIT. Desenvolvido em Ruby On Rails, há até bem pouco tempo se necessitava de algum conhecimento das dependências envolvidas na utilização deste framework para a instalação do pacote. A partir da versão 4.0, o Jobsworth traz a opção de usar o Tomcat como servidor web, tornando a instalação bem mais simplificada porque há disponível um arquivo com o sistema e todas as dependências que você precisará.

É neste cenário que montei um passo a passo para começar a utilizar o Jobsworth. Lá vai:



Ingredientes:
Ubuntu Server 12.04

Modo de preparo:

0. Instalar o Oracle Java. Pela minha experiência, funciona melhor que o OpenJDK.
sudo apt-add-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java7-installer


1. Agora o web server - Tomcat - e o servidor de banco de dados - MySQL - entre outras dependências.
sudo apt-get install tomcat7 mysql-server-5.5 imagemagick sendmail

O instalador do MySQL deve perguntar a senha de root do banco. Não esqueça dela.

2. Preparar o MySQL.
2.1. Chame o utilitário de linha de comando
mysql -u root -p
Aqui você precisa da senha de root do passo 1.

2.2. Agora a criação do banco propriamente dito:
create database jw;
create user jw@localhost identified by 'sua_senha_do_jobs';
grant all privileges on jw.* to jw@localhost with grant option;

2.3. O script de criação das tabelas está no link abaixo. Baixe o arquivo para o servidor e execute com o comando source do utilitário mysql.
Script de criação das tabelas

Atenção: este arquivo funciona com a versão 4.0 do Jobsworth.

3. O JW precisa de uma pasta para guardar os anexos e as imagens. A sugestão dele é a seguinte:
mkdir /var/jobsworth
mkdir /var/jobsworth/assets

4. Preparar o Tomcat. Se você utilizou o apt-get para instalá-lo, ele deve estar na /var/lib/tomcat7/ ou algo do tipo.

4.1. Copiar o MySQL jdbc driver para a pasta {TOMCAT_HOME}/server. Dependendo da instalação a pasta é a {TOMCAT_HOME}/lib. Existirá apenas uma dessas duas.


4.2. Copiar o arquivo ROOT.war para a pasta {TOMCAT_HOME}/webapps. Dá para baixar esse arquivo no site do projeto:
https://github.com/ari/jobsworth/releases
Assim que o arquivo war for copiado, o Tomcat vai extraí-lo para uma pasta no mesmo local.

4.3. Configurar o arquivo {TOMCAT_HOME}/conf/context.xml com os dados que você produziu até agora. O modelo você também baixa do site do projeto.
https://github.com/ari/jobsworth/blob/master/config/context.example.xml

Agora o Jobsworth está todo pronto para funcionar. Reinicie o Tomcat:
sudo service tomcat7 restart

e agora tente acessar pelo browser com http://nome_do_servidor:8080

Opcional

Agora convém:
1. Configurar o DNS para que os usuários não fiquem usando o IP.
2. Para melhorar a segunça, configurar o Apache como proxy reverso.
3. Para fazer o Jobsworth integrar-se ao servidor de e-mail, configurar o Sendmail.