Liferay Portal – Configuração da ligação a uma base de dados MySQL

Tal como prometido no meu último artigo, aqui ficam as instruções para configurar o Liferay Portal para aceder a 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).

Seleccionem o icon ‘New Connection Profile’ ou usem o botão direito do rato do sobre ‘Databases’ e depois seleccionem ‘New’.

Na janela ‘New Connection Profile’ seleccionem 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 ficheiro $WORKSPACE/ext/lib/development/mysql.jar ($WORKSPACE corresponde à localização da pasta do vosso workspace no sistema de ficheiros);
  • 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 seleccionem 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 vossa configuração (podem testar a ligação a partir desta janela).

3 – Criação do modelo de dados

Editem o ficheiro create-mysql.sql na pasta /sql/create do projecto ‘ext’.
Caso não tenham memoria para desperdiçar (é o meu caso) respondam afirmativamente quando o eclipse perguntar se pretendem desligar a validação de sintaxe do ficheiro.

No topo da janela de edição do ficheiro encontram a configuração do ‘Connection profile’. Seleccionem o tipo Generic JDBC_1.x, o driver ‘Liferay - Mysql‘ e a base de dados lportal.

Nota: caso o status não seja ‘Connected‘ não vão conseguir ver o nome da base de dados.
Neste caso devem aceder ao Data Source Explorer ( Window -> Show View -> Data Source Explorer), seleccionar a Database ‘Liferay – MySQL’ e fazer connect (botão direito do rato)

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 ficheiro Root.xml localizado na pasta servers/tomcat/conf/Catalina/localhost do projecto ‘ext’.

Comentem o datasource do Hypersonic e descomentem o datasource do MySQL.

Preencham os atributos username e password e, caso não estejam a usar os valores default do MySQL, editem tambem o valor do atributo url, de acordo com a vossa configuração.

Gravem as alterações.

5 – Deploy da configuração para o servidor

Copiem o ficheiro Root.xml para a pasta conf/Catalina/localhost do tomcat.

Copiem e o ficheiro mysql.jar para para a pasta lib/ext do tomcat.

Voltarei a falar sobre a forma correcta de fazer deploy destes ficheiros no meu próximo artigo.