WebSphere Message Brokers
File: ah23850_
Writer: Kate Hostler

Task topic

This build: July 31, 2007 21:30:38

Migrating the Message Broker Toolkit from WebSphere Business Integration Message Broker Version 5.0 to WebSphere Message Broker Version 6.1

Migrate the Message Broker Toolkit Version 5.0.

If you are using Message Broker Toolkit Version 5.1, follow the instructions in this topic, replacing all references to "Message Broker Toolkit Version 5.0" with "Message Broker Toolkit Version 5.1".

When you start using your resources in Message Broker Toolkit Version 6.1, restrictions apply to the use of these same resources again with Message Broker Toolkit Version 5.0 or Version 5.1. For more information, see Conditions for using migrated resources with previous versions of the Message Broker Toolkit.

To migrate Message Broker Toolkit Version 5.0 to Version 6.1, complete the following steps:

  1. Install WebSphere Message Broker Version 6.1 in a different location from WebSphere Business Integration Message Broker Version 5.0.
  2. Migrate any Version 5.0 mappings using the mqsimigratemfmaps command. (No migration tool is provided to migrate a mapping that is called from ESQL.)
  3. When you start the Message Broker Toolkit Version 6.1 for the first time, you are prompted to enter a workspace location. Enter the directory where theMessage Broker ToolkitVersion 5.0 workspace that you want to migrate is located. In Version 5.0, the default location is <BrokersInstallPath>/eclipse/workspace.
    • Version 5.0 message flows are converted to the Version 6.1 format automatically when you save them for the first time. Message Broker Toolkit Version 5.0 cannot read message flows that have been saved in Version 6.1 format.
    • If your message flows use MQe nodes, follow the instructions in Migrating a message flow that contains WebSphere MQ Everyplace nodes.
    • If your message flows use XML style sheets, follow the instructions in Migrating style sheets and XML files from Version 5.0.
    • Version 5.0 message sets are converted automatically to Version 6.1 format when you save them for the first time. Message Broker Toolkit Version 5.0 cannot read message sets that have been saved in Version 6.1 format.
  4. Clean and rebuild your workspace.
  5. To migrate user-defined nodes from Version 5.0, import the user-defined node project into the Version 6.1 workbench and rebuild the project. If you are migrating user-defined nodes from Version 5.0, perform the following additional steps:
    1. Modify the <requires> element in the plugin.xml file in the user-defined node project root to match the following example. Ensure that you delete all extraneous entries from the Version 5.0 plugin.xml file so that it matches the following example exactly:
      <requires>
      	<import match="greaterOrEqual" plugin="com.ibm.etools.mft.api" version="6.0.0"/>
      </requires>
    2. Modify the "org.eclipse.help.contexts" extension in the same plugin.xml file to match the following example:
      <extension point="org.eclipse.help.contexts">
      	<contexts file="HelpContexts.xml"/>
      </extension>
    3. Restart the Message Broker Toolkit.

If you have configured MCA users on the WebSphere MQ channels to the Configuration Manager, you might encounter problems when you try to connect to the migrated Configuration Manager from Message Broker Toolkit Version 6.1. To resolve these problems, configure access control lists (ACLs) for users who are running the Message Broker Toolkit Version 6.1. Follow the instructions in Considering security for the workbench.

When you have migrated the Message Broker Toolkit, ensure that you have migrated the rest of the components:

When you have completed these tasks, see Post-migration tasks for information about tasks that you might want to perform after migration.

Related concepts
Conditions for using migrated resources with previous versions of the Message Broker Toolkit
Message Brokers Toolkit
Related tasks
Migrating from WebSphere Business Integration Message Broker Version 5.0 to WebSphere Message Broker Version 6.1
Migrating a user-defined node
Related reference
Installation Guide
mqsimigratemfmaps command
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:30:38

ah23850_ This topic's URL is: