Instruções para instalar a aplicação de referência

1) Importando para o Eclipse:

A aplicação de referência utiliza o Maven2. Com o maven é bastante fácil importar um projeto Java qualquer para dentro do Eclipse. Siga os passos abaixo:

Caso ainda não tenha, instale o SVN na sua máquina: http://subversion.tigris.org/

Caso ainda não tenha, instale o Maven 2.x.x na sua máquina: http://maven.apache.org

Utilize o comando abaixo para fazer o checkout da aplicação de referência. O diretório 'Menta' será criado com a aplicação.

svn co svn://saoj-la.dyndns.org/menta/trunk Menta

Vá para dentro do diretório Menta e execute 'mvn clean install'. Os testes deverão ser executados e o WAR da aplicação gerado.

Ainda dentro do diretório Menta, execute 'mvn eclipse:eclipse -Dwtpversion=2.0'. Feito isso o seu projeto está pronto para ser importado para dentro do Eclipse.

Utilize a função Import... do Eclipse para importar o diretório Menta. Um novo projeto será criado no Eclipse.

OBS: Para os testes unitários o banco H2 é utilizado, logo não é necessário instalar ou configurar nenhum banco de dados.

2) Configurando o banco de dados: (para rodar a aplicação no TOMCAT)

Caso ainda não tenha, instale o MYSQL na sua máquina: http://www.mysql.org

Crie um database com o nome 'Menta'

Conceda permissões para o usuário 'menta' acessá-lo do localhost:

grant all privileges on Menta.* to 'menta'@'localhost' identified by 'menta';

3) Inicializando o banco de dados:

Execute o script 'WEB-INF/db/menta.sql' para a inicialização do banco de dados, tomando cuidado com o charset que deve ser UTF-8:

Vá para o diretório 'WEB-INF/db' onde está o script menta.sql

Acesse o seu banco de dados utilizando o mysql client:

mysql -u menta -p Menta

Ative o charset UTF-8:

SET NAMES utf8;

Execute o script menta.sql:

source menta.sql;

4) Rodando no Tomcat:

Para executar a aplicação você pode utilizar o SYSDEO (plugin do Tomcat para Eclipse) ou o WTP (integração do Eclipse com o Tomcat). Caso utilize o SYSDEO você precisará configurá-lo para reconhecer um projeto Maven. Siga os passos abaixo:

Vá em propriedades do seu projeto e selecione Tomcat

Coloque 'src/main/webapp' como "Subdirectory to set as web application root (optional)"

Ative o DevLoader e selecione os jars que deverão ser utilizados pelo Tomcat. Veja imagem no final desse post.

5) Deployando o WAR em um Tomcat standalone:

Copie o menta.war para dentro do webapps do seu Tomcat.

Restarte o seu tomcat

Um diretório menta deverá ser criado no webapps com sua aplicação.

6) Problemas de permissão com o Tomcat:

A aplicação utiliza o método System.getenv() para acessar uma variável de ambiente. É possível que o Tomcat não permita essa operação devido ao seu SecurityManager. Isso ocorreu comigo no tomcat6 rodando em um Ubuntu Server, mas não no meu tomcat6 rodando no Mac. Para resolver isso você pode desativar o SecurityManager assim:

Abra o arquivo /etc/default/tomcat6

Adicione a seguinte linha:

TOMCAT6_SECURITY=no

Reinicie o seu Tomcat

OBS: Você também pode tentar fazer um ajuste fino no SecurityManager do Tomcat dentro do diretório 'policy-d'.

Ativando o DevLoader para o Sysdeo: