WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Performing in-place broker migration for a Version 7.0 broker on distributed operating systems

Migrate a broker to use the enhanced facilities available in WebSphere® Message Broker Version 8.0.

Before you start:

You cannot use in-place migration to migrate a broker from WebSphere Message Broker Version 7.0 on a Windows x86 operating system to WebSphere Message Broker on a Windows x86-64 operating system. You must use parallel migration to migrate brokers between deployments on these operating systems, see Parallel broker migration

If you stop the broker, you can migrate it in-place immediately to the new version on the same computer. If you prefer not to stop the broker to avoid problems for your business applications, or if you want to reproduce the broker function on another computer, you can instead perform parallel broker migration by associating the application logic on your Version 7.0 broker with a separate Version 8.0 broker. For more information, see Performing parallel broker migration for a Version 7.0 broker.

Migrating a Version 7.0 broker to Version 8.0

To migrate a Version 7.0 broker on a distributed operating system to Version 8.0 on the same computer, complete the following steps:
  1. Install WebSphere Message Broker Version 8.0 on the same computer as Version 7.0. Install at least the Broker component; other components are optional. You must specify a new location for this installation.
  2. Stop all channels that are connected to the Version 7.0 broker.
  3. Open a Version 8.0 command environment, and stop the Version 7.0 broker by using the mqsistop command.
  4. Optional: If your message flows access user databases by using ODBC connections, update the ODBC definitions to Version 8.0 format by following the instructions in Updating ODBC definitions when migrating.
  5. Set up the correct Version 8.0 command environment:
    • Linux platformUNIX platformOn Linux and UNIX systems, open a new shell and run the environment profile mqsiprofile for this Version 8.0 installation.
    • Windows platformOn Windows, click Start, and open the Command Console that is associated with this Version 8.0 installation.

      On Windows 7 and Windows Server 2008 systems, you must open a command console with elevated privileges. To open a command console with elevated privileges, use the mqsicommandconsole command. For more information, see mqsicommandconsole command.

  6. Run the mqsimigratecomponents command to migrate the broker. For example:
    mqsimigratecomponents Broker1

    All configuration data is retrieved from the Version 7.0 broker database. If you configured a default user ID and password for your Version 7.0 broker by using the -u and -p options on the mqsicreatebroker command, these values are migrated with the broker. You can change these values for your Version 8.0 broker by using the mqsisetdbparms command.

  7. Copy all additional custom environment settings from your previous environment into your Version 8.0 environment; for example, MQSI_FILENODES_ROOT_DIRECTORY.
  8. Start the Version 8.0 broker by using the mqsistart command.

Next:

When you have completed migration, see the tasks in Perform post-migration tasks for information about tasks that you might want to complete after migration.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:09


Task topicTask topic | Version 8.0.0.7 | bh23440_