Migrating

You can install a new version of the IBM® MQ Virtual System Pattern Type that contains a new version of IBM MQ. When you want to migrate your existing pattern instances to new levels of IBM MQ, you can deploy new instances that use existing data.

Before you begin

Check the restrictions for the IBM MQ software component that is running in your operating system environment. For more information, see Restrictions for IBM MQ Virtual System Pattern Type.

About this task

This task assumes that you have an existing, deployed IBM PureApplication® System instance with a working IBM MQ installation. This task takes you through an example of installing an updated version of the IBM MQ Virtual System Pattern Type that also contains a newly available version of IBM MQ. You update the pattern and upgrade the IBM MQ version for a running instance of the pattern type. In the final step, the existing IBM MQ data is migrated to an upgraded version of IBM MQ that is running in a newly updated, deployed IBM MQ Virtual System Pattern Type instance.

Procedure

Install and enable the new IBM MQ Virtual System Pattern Type. For detailed steps, see Installing IBM MQ Virtual System Pattern Type on IBM PureApplication.
Apply the update to your deployed IBM MQ Virtual System Pattern Type. For detailed steps, see Updating a deployed pattern instance.
Upgrade the IBM MQ installation that is running in the deployed IBM MQ Virtual System Pattern Type instance, to a new fix pack level. For detailed steps, see Applying fix packs or interim fixes.
As a part of this step, your existing IBM MQ installation, including any IBM MQ queue managers and applications, is stopped, migrated, and restarted in the upgraded installation of IBM MQ.

Results

You installed and enabled a new version of the IBM MQ pattern type in your IBM PureApplication System environment. You applied an update to your deployed pattern instance and upgraded the IBM MQ version to a new fix pack level.

Note: If you updated from IBM MQ Virtual System Pattern Type version 1.0.0.2 to version 1.0.0.6, you have three new optional parameters for creating IBM MQ PureApplication System patterns. You can manually manage data to prevent data deletion when the deployed IBM MQ Virtual System Pattern Type instance is deleted, resume a queue manager from an existing data directory in a subsequently deployed instance, and you can choose not to install the advanced IBM MQ software components.

The new options are made available in the IBM MQ Virtual System Pattern but are not selected as a default. Your existing pattern instance and IBM MQ installation are not affected but you can choose these new options when you deploy future instances from the updated IBM MQ Virtual System Pattern Type.