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 6.1 broker on distributed operating systems

Migrate a broker to use the enhanced facilities available in Version 8.0.

Before you start:

If you stop the broker, you can migrate it immediately in-place 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 associate the application logic on your Version 6.1 broker with a separate Version 8.0 broker. For more information, see Performing parallel broker migration for a Version 6.1 broker.

Migrating a Version 6.1 broker to Version 8.0

To migrate a Version 6.1 broker to Version 8.0 on the same computer on a distributed operating system, complete the following steps.
  1. Install WebSphere Message Broker Version 8.0 on the same computer as Version 6.1. Install at least the Broker component; other components are optional. You must specify a new location for this installation.
  2. Open the WebSphere Message Broker Toolkit Version 6.1, and remove the broker from the domain configuration.
  3. Stop all channels that are connected to the Version 6.1 broker.
  4. Open a Version 6.1 command environment, and stop the Version 6.1 broker by using the mqsistop command.
  5. Optional: If your message flows access user databases by using ODBC connections, update the ODBC definitions to Version 8.0 format; see Updating ODBC definitions when migrating.
  6. 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.

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

    All configuration data is retrieved from the Version 6.1 broker database. If you had set a default user ID and password for your Version 6.1 broker by using the -u and -p parameters 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.

  8. On AIX®, Linux on x86-64, and Solaris on SPARC systems, support has changed from both 32-bit and 64-bit support to 64-bit support only. 32-bit execution groups are converted to 64-bit. These systems now require 64-bit libraries and 64-bit ODBC configurations for databases.
    1. Recompile C/C++ user-defined nodes, parsers, and exits to 64-bit, if the existing ones are 32-bit only.
    2. Configure the broker to point at these recompiled extensions by using the following command:
      mqsichangebroker -l userLilPath -x userExitPath
      where userLilPath defines one or more paths to your LIL files, and userExitPath defines one or more paths to your user exit programs.
    The following changes are made to environment variables, for all systems:
    Previous version Version 8.0
    MQSI_LILPATH64 and MQSI_LILPATH32 MQSI_LILPATH
    MQSI_USER_EXIT_PATH64 and MQSI_USER_EXIT_PATH MQSI_USER_EXIT_PATH
    MQSI_SECURITY_PROVIDER_PATH64 and MQSI_SECURITY_PROVIDER_PATH32 MQSI_SECURITY_PROVIDER_PATH
    Update all custom profiles that set these environment variables.
  9. Copy all additional custom environment settings from your previous environment into your Version 8.0 environment; for example, MQSI_FILENODES_ROOT_DIRECTORY.
  10. Start the Version 8.0 broker by using the mqsistart command.

When you have completed migration, see the tasks in Perform post-migration tasks for information about tasks that you might want to perform 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 | bh23450_