Tal como prometido no meu último artigo,
estão aqui as instruções para configurar o Liferay Portal para acessar uma base de dados MySQL usando o ambiente de desenvolvimento com o
eclipse.
1. Criação da Base de Dados MySQL
Criem a base de dados com o nome lportal.
Poderão fazer isto utilizando o MySQL Administrator (a ferramenta de
administração do MySQL) ou usando a seguinte linha de comando:
mysqladmin –default-character-set=utf8 create lportal
2. Configuração do acesso à base de dados com o eclipse
Abram o Data Source Explorer do eclipse (Window -> Show view -> Data Source Explorer).
Selecionem o ícone ‘New Connection Profile’ ou usem o botão direito do mouse sobre ‘Databases’ e depois selecionem ‘New’.
Na janela ‘New Connection Profile’ selecionem o tipo SQL Model-JDBC Connection.
No quadro seguinte, indiquem um nome para o perfil (ex: ‘Liferay – Mysql’).
No último quadro, usem o botão de procura (‘?’) na lista “Select a browser”.
Adicionem uma nova definição:
- Localizem o template para bases de dados MySQL na árvore (Database -> MySQL -> 5.0 -> MySQL JDBC Driver).
- Alterem as definições do driver:
– Alterem o nome para ‘Liferay MySQL Driver’;
– Removam o driver ‘default’ e adicionem um novo Jar correspondente ao arquivo $WORKSPACE/ext/lib/development/mysql.jar ($WORKSPACE corresponde à localização da pasta do seu workspace no sistema de arquivos);
– Configurem o valor das propriedades de acesso (username, password,
etc?) tendo em atenção que o valor do ‘Database Name’ e, por
consequência, o final da linha do ‘Connection URL’ deverá ser ‘lportal’. - Confirmem as alterações e selecionem agora este driver nas definições do driver (Database -> MySQL -> 5.0 -> Liferay MySQL Driver).
Voltem de novo à janela de criação do perfil e validem que todas as
informações estão de acordo com a sua configuração (podem testar a
ligação a partir desta janela).
3. Criação do modelo de dados
Editem o arquivo create-mysql.sql na pasta /sql/create do projecto ‘ext’. Caso não tenham memória para desperdiçar (é o meu caso), respondam
afirmativamente quando o eclipse perguntar se pretendem desligar a
validação de sintaxe do arquivo.
No topo da janela de edição do ficheiro está a configuração do ‘Connection profile’. Selecionem o tipo Generic JDBC_1.x, o driver ‘Liferay – Mysql’ e a base de dados lportal.
Nota: caso o status não seja ‘Connected’ , vocês não vão conseguir ver o nome da base de dados.
Neste caso devem acessar o Data Source Explorer ( Window -> Show View -> Data Source Explorer), selecionar a Database ‘Liferay – MySQL’ e fazer connect (botão direito do mouse)
Comentem as três primeiras linhas do ficheiro, uma vez que a base de dados já foi criada
- drop database if exists lportal;
- create database lportal character set utf8;
- use lportal;
Gravem e executem o sql (ctrl+alt+X ou Execute All no menu contextual).
4. Configuração do datasource no tomcat
Editem o arquivo Root.xml localizado na pasta servers/tomcat/conf/Catalina/localhost do projeto ‘ext’.
Comentem o datasource do Hypersonic e descomentem o datasource do MySQL.
Preencham os atributos username e password e, caso não estejam usando os valores default do MySQL, editem também o valor do atributo url, de acordo com a sua configuração.
Gravem as alterações.
5. Deploy da configuração para o servidor
Copiem o arquivo Root.xml para a pasta conf/Catalina/localhost do tomcat.
Copiem e o arquivo mysql.jar para para a pasta lib/ext do tomcat.
Em outra oportunidade, vou falar sobre a forma correta de fazer deploy destes arquivos. Até lá!