Migrating WebSphere MQ brokers
When you plan the migration of one or more WebSphere MQ brokers, you must take account of the differences between WebSphere MQ Publish/Subscribe and WebSphere Message Broker. This might mean that you have to make some changes to your applications, your topics, or both, before you start migration.
The information here tells you the steps you must take to migrate a single broker. Migrating a WebSphere MQ broker network tells you how to migrate a WebSphere MQ broker network.
These steps result in the replacement of the WebSphere MQ brokers by WebSphere Message Broker brokers.
Each replacement WebSphere Message Broker broker must be created on the same queue manager as the WebSphere MQ broker that it replaces. Because the WebSphere MQ broker shares the same name as the queue manager that supports it, you must specify the WebSphere MQ broker name as the queue manager parameter on the mqsicreatebroker command (the -q flag).
All client subscriptions are exported from all streams except SYSTEM.BROKER.ADMIN.STREAM.
All retained publications in MQRFH format are exported from all streams except SYSTEM.BROKER.ADMIN.STREAM.
Registrations for all publishers that are producing local publications are exported from all streams except SYSTEM.BROKER.ADMIN.STREAM.
If the broker is part of a multi-broker hierarchy, details of all its relations are exported. This includes the names of all streams that the broker to be migrated has in common with the relation.
On WebSphere MQ Publish/Subscribe, streams are the queues from which publications are read by a broker.
This information is exported as a series of messages that are sent from the WebSphere MQ broker to its replacement. When migration is complete, the WebSphere MQ broker is deleted automatically, and cannot be recreated.
If you are migrating a WebSphere MQ broker, you cannot fully deploy it in your WebSphere Message Broker broker domain until migration has completed successfully. You should not deploy additional execution groups or message flows until after you have successfully migrated the WebSphere MQ Publish/Subscribe broker.
Use the Broker Topology editor to define the WebSphere Message Broker broker, and deploy the topology. Create an empty .bar file and drag it onto the default execution group. You are now ready to start the migration.
If migration fails, and you want to revert to your WebSphere MQ broker, you must delete the WebSphere Message Broker. See Deleting a broker.
When you migrate a WebSphere MQ broker that is not part of a network, you are replacing it in the network and assigning all the function that was previously supported by that broker to a WebSphere Message Broker broker.
You must shutdown the WebSphere MQ broker before you start migration, and ensure that all applications that use the broker are also quiesced.
The steps used here assume you have chosen the name WBRK_BROKER for your new WebSphere Message Broker broker, and that the WebSphere MQ broker you are migrating is currently hosted by the queue manager MQPS_BROKER1.
Ensure that this backup is complete backup before you start the migration process. This allows you to retrieve the old WebSphere MQ broker after successful migration, if you should need to do so for any reason. The WebSphere MQ System Administration book describes this backup process.
Any messages generated during the migration exercise are queued and could cause performance or capacity problems. Quiescing the applications as well as the broker ensures that publish/subscribe traffic is only generated when there is a broker ready to process it.
endmqbrk MQPS_BROKER1
mqsicreatebroker WBRK_BROKER -q MQPS_BROKER1 -i mqbroker -a sample -n WBRKBKDB -m
mqsistart WBRK_BROKER
Create the new broker in the broker domain topology from the Topology view in the workbench. Save and deploy the topology. Create a default execution group and drag an empty .bar file onto the default execution group.
migmqbrk -m MQPS_BROKER1
This command is supplied as part of the WebSphere MQ Publish/Subscribe package on the Web. You must ensure you have the latest level of this command, and the WebSphere MQ Publish/Subscribe User's Guide that describes its use.
The command retrieves the persistent information (subscriptions and retained publications) from the WebSphere MQ broker, and sends it in specially constructed messages to the queue SYSTEM.BROKER.INTERBROKER.QUEUE on the new WebSphere Message Broker broker.
The message flow that services this queue (deployed when you deployed the broker and its default execution group) receives these messages and records the information. When all the messages have been processed, the message flow is terminated and cannot be re-initialized.
The migration command can only be re-invoked if the whole process of migration has not completed successfully. If any error occurs, for any reason, the WebSphere MQ broker is recoverable and can be restarted. You can then continue to use it. The WebSphere Message Broker broker also exists, but has not recorded any migration information. You can delete and create this broker to restart the migration process.
If the whole process succeeds, the WebSphere MQ broker no longer exists and cannot be recovered.
WebSphere
MQ broker has been successfully migrated
When you have successfully migrated all the WebSphere MQ brokers that you plan to migrate, delete or rename the file strmqbrk.exe. This prevents any WebSphere MQ brokers from starting accidentally.
The new WebSphere Message Broker broker is now set up to take over from the WebSphere MQ broker. You must create and deploy the message flows that it needs to activate the streams; you do not need to define the stream queues, because these are already defined to the queue manager. The queue definitions are not deleted when the migration takes place, and the same queue manager is used by the WebSphere MQ broker and the WebSphere Message Broker broker that has replaced it.
You must set the input queue name (the stream queue) property in the input node. You must also set the implicitStreamNaming property for every non-default stream queue input node.
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
aq18640_ |