3.2.7.4. Migração do seu Aplicativo para o Uso do HornetQ como o Provedor JMS

Procedimento 3.19. Antes de começar

1. Desligue o cliente e o servidor
2. Realize uma cópia de backup dos dados do JBoss Messaging. Os dados da mensagem são armazenados em um banco de dados em tabelas com o prefixo JBM_.

Procedimento 3.20. Alteração do seu provedor para HornetQ

1. Transferência de configurações

   Transfira as configurações existentes do JBoss Messaging para configuração do JBoss EAP 6. As configurações a seguir podem ser encontradas nos descritores de implantação localizados no servidor JBoss Messaging:
   • Configuração do Serviço de Fábricas de Conexões
     Esta configuração descreve as fábricas de conexões JMS implantadas com o servidor JBoss Messaging. O JBoss Messaging configura as fábricas de conexões em um arquivo nomeado connection-factories-service.xml, que está localizado no diretório de implantação do servidor do aplicativo.
   • Configuração de Destino
     Esta configuração descreve os tópicos e as filas JMS implantadas com o servidor JBoss Messaging. Por padrão, o JBoss Messaging configura os destinos em um arquivo nomeado destinations-service.xml que está localizado no diretório de implantação do servidor do aplicativo.
   • Configuração do Serviço de Ponte de Mensagens
     Esta configuração inclui os serviços de ponte implantados com o servidor JBoss Messaging. Nenhuma ponte é implantada por padrão, portanto o nome do arquivo de implantação varia, dependendo da instalação do seu JBoss Messaging.

2. Modificação do código do seu aplicativo

   Se o código do aplicativo usa o JMS padrão, não são necessárias alterações ao código. No entanto, se o aplicativo for conectar a um cluster, você deve revisar cuidadosamente a documentação HornetQ sobre a semântica do clustering. O clustering está fora do escopo da especificação JMS e HornetQ e JBoss Messaging adotaram abordagens bastante diferentes em suas respectivas implementações da funcionalidade do clustering.
   Caso o aplicativo utilize recursos específicos ao JBoss Messaging, você deve modificar o código para usar os recursos equivalentes disponíveis no HornetQ.
   Para mais informações sobre como configurar o sistema de mensagens com HornetQ, consulte Seção 3.2.7.5, “Configuração do Sistema de Mensagens com HornetQ”.

3. Migração de mensagens existentes

   Mova quaisquer mensagens do banco de dados do JBoss Messaging para o diário HornetQ usando a ponte JMS. As instruções para a configuração da ponte JMS podem ser encontradas aqui: Seção 3.2.7.2, “Configuração de uma Ponte JMS para a Migração de Mensagens JMS Existentes ao JBoss EAP 6”.