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.
Liferay Portal – Configuração da ligação a uma base de dados MySQL
>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
- 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
).
nova definição:
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.
Só para dizer que o Ricardo me está a fazer a papinha toda com esta série de artigos.
Grande série de artigos Ricardo