Migrating from one Continuous Delivery release to another

An overview of how you migrate from one Continuous Delivery (CD) release to another.

Before you begin

If you want to migrate replicated data queue managers, follow the instructions in Migrating replicated data queue managers.

Back up your existing IBM® MQ environment. This is required in case you need to revert to your current CD release of IBM MQ.
Important: Once the new installation is started, all of the existing IBM MQ objects will be migrated to the new modification level. If you do not back up your system, you cannot revert the objects to their previous level without completely uninstalling, and restoring a backup you made before you carried out the migration.

Copy the qm.ini file and the registry entries.

For more information about backing up your system, see Backing up and restoring IBM MQ queue manager data.
Use the dmpmqcfg command to save the current configuration details to a text file.

Procedure

Stop all of the IBM MQ processes for the installation being migrated.
Upgrade the existing CD installation by using one of the following methods:
- On Windows and AIX®, upgrade IBM MQ by installing the new CD installation in the same location as the existing installation.
  For more information about upgrading your CD installation on Windows, see Upgrading an IBM MQ installation on Windows.
  
  For more information about upgrading your CD installation on AIX, see Installing IBM MQ server on AIX.
- On Linux®, if your existing CD installation is at IBM MQ 9.2.1 or later, you can upgrade IBM MQ by installing the new CD installation in the same location as the existing installation.
  For more information about upgrading your CD installation on Linux, see Upgrading an IBM MQ installation on Linux.
- Uninstall the existing CD installation and then install the new CD modification level onto the same system.
  Note that uninstalling the existing installation does not remove the object definitions from the system. The object definitions remain in place.
Start the queue manager.
```
strmqm QmgrName
```
When you first start a queue manager after migration to the new CD level:
- Any new attributes for existing objects are set to their default values.
- Any new default objects are created.
- Queue manager objects are migrated to the new modification level.
Note: If you have saved your current configuration details in a text file, that file can be used to duplicate these objects in the newly created queue manager after it has been created, if you installed the new version onto a different system.
See the runmqsc command for instructions on how you can do this.