11 Replies Latest reply on Jul 6, 2012 1:33 AM by gaohoward

JBM to HornetQ Utility -- initial ideas

gaohoward Jun 25, 2012 12:50 AM

This utility is to help a JBM user to migrate their JBM servers to HornetQ.

This is a command-line tool written in java. It takes in JBoss Messaging deployment informations and converts/exports them to HornetQ equivalents. Because the two products have different sets of configuration parameters and there is no exact one-to-one match between the two, the conversion is only a result of best effort.

The following steps are taken to complete a conversion:

1. Collection of JBM deployment information for the conversion.

Those information are passed either as command-line options or defined in a java properties file, including:

JBoss Home : installation location of jboss 4 or 5 where JBM is deployed.

Profiles : all the names of the profiles that have JBM deployed. (for example 'default', etc)

Configurations files: including server configurations (like messaging-service.xml, remoting configs, jms destionation/factory configurations, persistent configs, bridges).

2. Performing conversion tasks

The tasks include:

Server configuration conversion -- to generate hornetq server configs based on the JBM config.

Destinations and ConnectionFactories -- to convert JMS destinations and ConnectonFactories into HornetQ's.

Bridges -- to convert JMS Bridges into HornetQ JMS bridges configuration.

Messages -- to extract messages from JBM database tables and convert them into corresponding HornetQ message journals.

Tasks can be done separately or selectively.

1. Re: JBM to HornetQ Utility -- initial ideas

gaohoward Jun 25, 2012 3:07 AM (in response to gaohoward)

I forgot to mention, that the conversion has three targets : standalone, AS5 and AS7.
AS4 is not supported. (or is it?)
Actions
2. Re: JBM to HornetQ Utility -- initial ideas

bershath27 Jun 25, 2012 3:15 AM (in response to gaohoward)

+1 for AS-4. I doubt there's much of a difference between AS-4 and AS-5 as far as the configuration files are concerned.

-Ty
Actions
3. Re: JBM to HornetQ Utility -- initial ideas

ataylor Jun 25, 2012 3:29 AM (in response to gaohoward)

Configurations files: including server configurations (like messaging-service.xml, remoting configs, jms destionation/factory configurations, persistent configs, bridges).
left blank should search for all files.

we should do this via some sort of mapping xml document that lists what can be converted for each version something like

<connection-factory-attribute src-name="failover-attempts" src-versions="1.1,1.2" dest-name="reconnectAttempts" dest-versions="2.2, 2.3,2.4"/>

then we can control multiple JBM,HQ versions, just an idea Howard.

Also +1 for as4
Actions
4. Re: JBM to HornetQ Utility -- initial ideas

gaohoward Jun 25, 2012 3:42 AM (in response to ataylor)

That's a good idea. Thanks Andy.
Actions
5. Re: JBM to HornetQ Utility -- initial ideas

gaohoward Jun 25, 2012 3:46 AM (in response to bershath27)

About AS4 support, I guess you guys are right. People who is running their applications in AS4 probably don't want to update their whole AS just because of updating their messaging engine.
Actions
6. Re: JBM to HornetQ Utility -- initial ideas

gaohoward Jun 25, 2012 4:30 AM (in response to gaohoward)

I just put my work-in-progress here:

https://github.com/gaohoward/jbm-to-hornetq.git

Howard
Actions
7. Re: JBM to HornetQ Utility -- initial ideas

jbertram Jun 25, 2012 10:23 AM (in response to gaohoward)

I wrote an XML importer/exporter for moving data from one HornetQ instance to another. See https://github.com/hornetq/hornetq/tree/master/hornetq-core/src/main/java/org/hornetq/core/persistence/impl/journal. If you use the same XML format with the JBM exporter then you won't have to write the importer. That said, this is only for message data and bindings. It doesn't import/export other general configuration details.
Actions
8. Re: JBM to HornetQ Utility -- initial ideas

clebert.suconic Jun 25, 2012 2:41 PM (in response to gaohoward)

Are you moving to this task already? I didn't see your PR on the pluggable discovery.
Actions
9. Re: JBM to HornetQ Utility -- initial ideas

gaohoward Jun 25, 2012 8:54 PM (in response to jbertram)

That's nice, it'll save quite a bit work. Thanks!

Howard
Actions
10. Re: JBM to HornetQ Utility -- initial ideas

gaohoward Jun 25, 2012 8:55 PM (in response to clebert.suconic)

Hi Clebert, I'm going to sent out the pull request for hornetq316. I just need to pass the tests before that.

Howard
Actions
11. Re: JBM to HornetQ Utility -- initial ideas

gaohoward Jul 6, 2012 1:33 AM (in response to gaohoward)

I added a sample configuration file where the user can define various migration tasks. It looks like the following:

<jbm-to-hornetq>
   <migration-config>
      <jbm-deployment jboss-home="/home/howard/tests/jboss43_CP09">
         <profile name="default" action="act1">
            <remoting-config path="....."/>
            <server-config path="..."/>
            <persistence-config path="..."/>
            <destinations>
               <path>..</path>
               <path>..</path>
            </destinations>
            <factories>
               <path>..</path>
               <path>..</path>
            </factories>
         </profile>
      </jbm-deployment>
   </migration-config>

   <actions>
      <action name="act1">
         <target type="STANDALONE" version="2.2.14.GA" location="...">
            <tasks>
               <task type="SERVER" location="...">
            </tasks>
            <param key="jboss.home" value="..."/>
          </target>
      </action>
   </actions>
</jbm-to-hornetq>
Actions

Go to original post