IBM Integration Bus, Version 9.0.0.8 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 8.0 broker on distributed operating systems

Migrate a broker on a distributed operating system to use the enhanced facilities available in IBM® Integration Bus Version 9.0 by using in-place migration.

Before you start:

Back up your broker resources by following the instructions in Backing up WebSphere Message Broker Version 8.0 resources.
For the latest details of all supported levels of hardware and software, visit the IBM Integration Bus Requirements website.
Install WebSphere® MQ and migrate your queue managers and other resources, following the instructions in the WebSphere MQ information center.
Migrate the IBM Integration Toolkit resources by following the instructions in Migrating development resources to IBM Integration Toolkit Version 9.0.
Check that you have no aggregations in progress on this broker. When you migrate a broker to Version 9.0, all live data that is being stored for aggregations in progress is lost.
If the broker runs in a locale that is not listed in Locales, check that the code page is one of the supported code pages, and that the locale is set up correctly.

You cannot use in-place migration to migrate a broker from WebSphere Message Broker Version 8.0 on a Windows x86 operating system to IBM Integration Bus 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 perform parallel broker migration instead, by associating the application logic on your Version 8.0 broker with a separate Version 9.0 broker. For more information, see Performing parallel broker migration for a Version 8.0 broker.

Migrating a Version 8.0 broker to Version 9.0

To migrate a Version 8.0 broker on a distributed operating system to Version 9.0 on the same computer, complete the following steps:

Install IBM Integration Bus Version 9.0 on the same computer as Version 8.0. Install at least the Integration Bus component; other components are optional. You must specify a new location for this installation.
Open the IBM Integration Toolkit and remove the broker from the domain configuration.
Stop all channels that are connected to the Version 8.0 broker.
Open a Version 8.0 command environment, and stop the Version 8.0 broker by using the mqsistop command.
Optional: If your message flows access user databases by using ODBC connections, update the ODBC definitions to Version 9.0 format by following the instructions in Updating ODBC definitions when migrating from WebSphere Message Broker Version 8.0.
Set up the correct Version 9.0 command environment:
- On Linux and UNIX systems, open a new shell and run the environment profile mqsiprofile for this Version 9.0 installation.
- On Windows, click Start, and open the Command Console that is associated with the Version 9.0 installation.
  On Windows 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.
Run the mqsimigratecomponents command to migrate the broker. For example:
```
mqsimigratecomponents Broker1
```
All configuration data is retrieved from the Version 8.0 broker database. If you configured a default user ID and password for your Version 8.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 9.0 broker by using the mqsisetdbparms command.
Copy all additional custom environment settings from your previous environment into your Version 9.0 environment; for example, MQSI_FILENODES_ROOT_DIRECTORY.
Start the Version 9.0 integration node (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.

bh23441_.htm |

Last updated Friday, 21 July 2017