Preparing to migrate from WebSphere MQ Integrator Broker Version 2.1

Before you start to migrate a WebSphere MQ Integrator Broker Version 2.1 broker domain, do the following:

  1. Make sure that Control Center users have checked in all WebSphere MQ Integrator Broker resources.

    For information about how to use the Control Center to perform this and other tasks, see WebSphere MQ Integrator Broker Version 2.1 Using the Control Center.

  2. Back up all configuration repository, message repository, and broker database tables. For information about how to do this, see the WebSphere MQ Integrator Broker Version 2.1 Administration Guide.
  3. Decide which message flows and message sets you want to migrate and use in the WebSphere Business Integration Message Broker broker domain.
    1. Using a Control Center session in which all the required message flows are visible in the workspace, export the message flows. Save the export files in a directory other than the one in which WebSphere MQ Integrator Broker is installed. The export files also contain information about the user defined nodes that are used by the message flows. For advice on how to export the message flows, see Migrating a message flow.
    2. On the system where the Configuration Manager is running, export all the required message sets using the mqsiimpexpmsgset command with the -e parameter. Save the export files in a directory other than the one in which WebSphere MQ Integrator Broker is installed.

      For information about how to use this and other WebSphere MQ Integrator Broker commands, see the WebSphere MQ Integrator Broker Version 2.1 Administration Guide.

  4. Decide how you are going to migrate the brokers:
    • Decide which brokers you no longer require after migration.
    • Decide which brokers you want to migrate from the Version 2.1 level of code to the Version 5.0 level.
    • Decide which brokers you want to preserve at the Version 2.1 level of code.

    If two or more of the brokers share the same set of database tables, and you still require these brokers after migration, you must either migrate all of the brokers at the same time or preserve them all at the Version 2.1 level of code.

  5. For each broker that you want to migrate from the Version 2.1 level of code to the Version 5.0 level, and for the associated assignments configuration data you want to preserve, record the following information:
    • The name of the broker.
    • The name of each message set that is assigned to the broker.
    • The name of each execution group within the broker.
    • For each execution group within the broker, the name of each message flow that is assigned to the execution group.
    • For each message flow assigned to an execution group, the following properties:
      • Additional instances
      • Commit count
      • Commit interval
      • Coordinated transaction
    Record this information in one of the following ways:
    • You can view the information in a Control Center session and record it manually.
    • You can export everything in the Control Center workspace by clicking File > Export All in Workspace. Save the export file in a directory other than the one in which WebSphere MQ Integrator Broker is installed. You can then extract the required information from the export file. To find out how to do this, see Assignments configuration data in an export file.
  6. Decide whether you want to preserve the following configuration data, which is stored in the configuration repository:
    • Assignments data
    • Topology data
    • Topics data
    Unless you decide that you no longer require any of your existing brokers after migration, you must preserve this configuration data.
  7. Decide which components of WebSphere Business Integration Message Broker you want to run on each of your systems after migration.
    Consider the following when making your decision:
    • A broker must run on the same system and use the same queue manager as it did before migration unless you decide that you no longer require the broker after migration.
    • The Configuration Manager must run on the same system and use the same queue manager as it did before migration unless you decide not to preserve the assignments, topology, and topics data in the configuration repository.
    • A workbench can run on any system after migration. It does not have to run on a system where Control Center sessions used to run.
    • To avoid adding unnecessary complexity into the migration process itself, run a User Name Server on the same system, and configure it to use the same queue manager, as it did before migration. If required, you can change the location of a User Name Server and the queue manager it uses after a successful migration.

    You do not need to change the configuration of a queue manager that is preserved during migration. You might, however, need to ensure that the WebSphere MQ product code is at the required release and service level to support WebSphere Business Integration Message Broker. At the same time, you might want to ensure that you have installed the other software prerequisites. See Checking software prerequisites for the details.

    If you are not able to stop a broker during migration because it is doing critical work, but you want to migrate the broker to the Version 5.0 level of code, create a new Version 2.1 broker on a system on which you are not going to install WebSphere Business Integration Message Broker. Using a Control Center session, deploy to the new broker all the configuration data that was deployed to the original broker. The new broker can then take over the work of the original broker during the migration.

    If you intend to preserve any brokers at the Version 2.1 level of code, see Coexistence with previous releases and other products for what you need to consider in this case.

  8. Decide where you are going to store the development data that is created and maintained in the workbench. You can store the data in the local file system, on a shared drive, or in a shared repository that is supported by Eclipse. The instructions for the individual migration tasks assume that you are using the local file system or a shared drive.

Related concepts
Coexistence with previous releases and other products

Related tasks
Migrating from WebSphere MQ Integrator Broker Version 2.1 to WebSphere Business Integration Message Broker Version 5.0
Migrating from WebSphere MQ Event Broker Version 2.1 and WebSphere MQ Integrator Broker Version 2.1 to WebSphere Business Integration Message Broker Version 5.0
Migrating a message flow
Checking software prerequisites

Related reference
Assignments configuration data in an export file