Running the message migration utility

The WebSphere® Application Server message migration utility uses an XA (globally coordinated) transaction to migrate messages from the V5 embedded messaging provider on a WebSphere Application Server Version 5.1 application server to the default messaging provider (service integration) on an application server at a later version of the product.

Before you begin

  1. Ensure that you have a WebSphere Application Server Version 5.1 system that contains an embedded messaging server.

    You do not have to start the Version 5.1 server.

  2. Ensure that no applications are reading from the WebSphere Application Server Version 5.1 queue manager when you run the message migration utility.
  3. Ensure that you have not modified or deleted the message queues on the Version 5.1 application server.
  4. Ensure that the version you are migrating to is a running system that fulfills the following conditions.
    1. The system is on the same host as the WebSphere Application Server Version 5.1 system.
    2. The system contains a messaging engine on the bus to which the messages will migrate (this is automatically included for you if you upgrade your server from Version 5.1 to a later version).
    Note: These conditions are met if you run the message migration utility at the correct point in the WebSphere Application Server migration sequence. The correct point is after you have run the WASPostUpgrade command and restarted the node on the version you migrate to.

About this task

You run the message migration utility only once for a particular queue, unless a failure occurs.

If a failure occurs during message migration, it is safe to run the message migration utility again in the same direction because messages are moved rather than copied. Whether you successfully try a failing message migration again, or delete the message, the message ordering of the remaining messages is preserved on the queue on the current version of the product.

During successful migration, messages are moved from the WebSphere Application Server Version 5.1 system to the later system. No copy is left on the Version 5.1 server queue.

For more information about the XA transaction, see XA recovery.

Procedure

  1. Follow the actions indicated by the message migration utility.
  2. In the "Select the direction of migration" panel, select Migrate messages from Version 5 to later_version.
  3. Select a message reliability to apply to messages that are to be migrated. More details on the choice of reliability levels can be found in the Message Reliability Levels topic.
  4. You can migrate multiple queues during a single run of the utility.

Results

  1. If the first message migration attempt fails, run the migration utility again.
  2. If a queue has a failing message, complete one of the following operations:
    1. Try the failing message again, in case there is a transient error.
    2. Delete the failing message and go on to the next message.
    3. Stop the queue that has the failing message and move on to the next queue.

What to do next

For information about the reversal of message migration, see Reversing the migration of messages by using the message migration utility.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 1:44:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-express-dist&topic=tjnmmurun
File name: tjnmmurun.html