Tutorial – Integrando o servidor de mensagens instantâneas Openfire e MySQL no Windows 7

Através do tutorial Instalando o MySQL no Windows 7 que publiquei no Sistema Básico, mais precisamente a partir de um comentário de um usuário com dúvidas sobre a integração do MySQL com o Openfire – Servidor de mensagens instantâneas (messenger) que pode ser utilizado internamente em empresas, redes corporativas. O que me levou a buscar essas informações foi por achar interessante essa busca, pois é um material que eu nunca havia tido contato e me trouxe um conhecimento a mais, mas confesso que para tirar dúvidas sobre o assunto, terei que aprender mais, enfim… vamos ver no que dá.

Openfire e banco de dados

Openfire armazena todos os dados em um back-end de banco de dados. Se você optar por não usar  o banco de dados incorporado, você deve configurar um banco de dados externo para a aplicação.

Até a data desta publicação o Openfire suporta os seguintes bancos de dados:

MySQL, Oracle, Microsoft SQL Server, PostgreSql, IBM DB2 e HSQLDB.

Este tutorial fornece instruções exclusivas para integração do Openfire com o banco de dados MySQL.

Continuando…
Drivers JDBC 2.0 são necessários para o Openfire se comunicar com o banco de dados.
Existem drivers JDBC para cada banco de dados em particular.
Todos os esquemas de banco de dados podem ser encontrados no diretório resources/database na pasta de instalação Openfire.

MYSQL

Partindo do princípio que já deve ter instalado o MySQL em seu computador sobre o sistema operacional Windows, não vou me deter a informações sobre instalação do MySQL.
Se tiver dúvidas veja como instalar o banco de dados MySQL primeiro, e terá informações detalhadas sobre como instalar o MySQL no Windows 7.

1 – Conforme mencionei acima, tenha certeza que tem instalado o MySQL 4.1 ou mais recente (5.x é recomendado). Os campos com VARCHAR maior que 255 não são suportados por versões anteriores do MySQL 4.1.18. Se você tem MySQL inferior a 4.1 e não pode atualizar  para uma versão mais recente, você vai precisar alterar os scripts de banco de dados. Em particular substituir VARCHAR(1024) por VARCHAR(255) no arquivo localizado no diretório resources/database/openfire_mysql.sql dentro do diretório de instalação do Openfire.

2 – Crie um banco de dados para as tabelas do Openfire:

mysqladmin create [databaseName]
(Sugestão: ‘databasename’ pode ser algo como ‘openfire’)

3 – Importe o arquivo do esquema a partir do diretório resources/database/ na pasta que o Openfire está intalado:

Unix/Linux: cat openfire_mysql.sql | mysql [databaseName];
Windows: type openfire_mysql.sql | mysql [databaseName];

4 – Inicie a ferramenta de configuração do Openfire e use as configurações de conexão JDBC apropriadas.
driver: com.mysql.jdbc.Driver
server: jdbc:mysql://[YOUR_HOST]/[DATABASE_NAME]

Drivers JDBC

O driver JDBC para MySQL vem com o Openfire, assim você não precisa baixar e instalar um driver separado.

Na ferramenta de configuração do Openfire, conforme o itém 4 logo acima, use os seguintes valores:

Onde está [your_host] e [DATABASE_NAME] são os valores reais para o seu servidor. Em muitos casos localhost é o valor apropriado para [YOUR_HOST] quando seu banco de dados está rodando no mesmo servidor que seu servidor web. Partindo da ideia que quando criou o seu banco de dados utilizou a sugestão de nome ‘openfire’, então em [DATABASE_NAME] obviamente será openfire ou o nome que você deu para o banco de dados que vai utilizar com o Openfire.

Problemas de codificação de caracteres

MySQL não tem suporte a Unicode adequada, o que torna os dados de apoio em linguas não-ocidentais muito  difícil. No entanto, o driver JDBC do MySQL tem uma solução que pode ser ativado adicionando ?useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8 na URL do driver JDBC. Você pode editar o arquivo conf/openfire.xml para adicionar este valor.

Nota: Se o mecanismo que você usa para configurar uma URL JDBC é XML-based, você precisará usar o caractere literal XML ‘&’ para separar os parâmetros de configuração, por que o  ampersand (&) é um caracter reservado do XML.

Finalizando

Se você precisar de ajuda para configurar o MySQL, consulte os seguintes links do manual de referência do MySQL (escolha de acordo com sua versão)
MySQL 5.5 -> http://dev.mysql.com/doc/refman/5.5/en/connector-j-reference-configuration-properties.html
MySQL 5.1 – > http://dev.mysql.com/doc/refman/5.1/en/connector-j-reference-configuration-properties.html
MySQL 5.0 ->  http://dev.mysql.com/doc/refman/5.0/en/connector-j-reference-configuration-properties.html
MySQL 4.1 ->  http://dev.mysql.com/doc/refman/4.1/en/connector-j-reference-configuration-properties.html

Tópicos relacionandos

Publicado por

Razor

Conhecedor das artes gráficas, amante de design web, amigo íntimo do desenvolvimento web, com a pretensão de aprender e ajudar à quem busca conhecimento, me faço presente. =)

Um comentário sobre “Tutorial – Integrando o servidor de mensagens instantâneas Openfire e MySQL no Windows 7”

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *