Migrating a queue manager to a later version on AIX and Linux

On AIX® and Linux®, follow these instructions to migrate a queue manager from an earlier version to a later version of IBM® MQ.

Before you begin

If you have installed early support program code on the server, you must delete all the queue managers created with the installation. Uninstall the code before proceeding with installing the production level code.

The upgrade from the earlier version to the latest version of the product requires a full migration of queue managers. Create a migration plan. Use the planning task, Planning to migrate IBM MQ to a later version on AIX and Linux, as a guide.
Review the IBM MQ system requirements for the later version; see System Requirements for IBM MQ.
Back up your system before you install a later version of IBM MQ over an earlier version. Once you have started a queue manager you cannot revert to the previous version. If you must restore the system, you cannot recover any work, such as changes to messages and objects, performed by the later version of IBM MQ. For more information about backing up your system, see Backing up and restoring IBM MQ queue manager data.
Review any other installed SupportPacs for their applicability to the later version.
If you are running on a server with multiple IBM MQ installations, you must identify the installation. Make sure that the commands you enter run against the correct installation; see setmqenv.

About this task

To run a command, the operating system must find the command in an IBM MQ installation. For some commands, you must run the command from the installation that is associated with the correct queue manager. IBM MQ does not switch commands to the correct installation. For other commands, such as setmqinst, you can run the command from any installation that has the latest version of the product installed.

If an earlier version of the product is installed, the command that is run is the command for that version, unless the search path is overridden by a local setting. You can override the search path by running setmqenv. If IBM WebSphere® MQ 7.0.1 is not installed, you must set the correct path to run a command. If you have set a primary installation, the command that is run is the copy in the primary installation, unless you override the selection with a local search path.

Procedure

Log in as a user in group mqm.
Stop all applications using the IBM MQ installation.
If you use the Managed File Transfer (MFT) component, ensure that any MFT agents have finished all of the file transfers that they were engaged in. There should be no incomplete transfers associated with the agents, and their SYSTEM.FTE.STATE queues should contain no messages.
End all the activity of queue managers associated with the IBM MQ installation.
1. Run the dspmq command to list the state of all the queue managers on the system.
  Run either of the following commands from the installation that you are updating:
```
dspmq -o installation -o status
dspmq -a
```
  dspmq -o installation -o status displays the installation name and status of queue managers associated with all installations of IBM MQ.
  
  dspmq -a displays the status of active queue managers associated with the installation from which the command is run.
2. Use the MQSC command DISPLAY LSSTATUS to list the status of listeners associated with a queue manager, as shown in the following example:
```
echo "DISPLAY LSSTATUS(*) STATUS" | runmqsc QmgrName
```
3. Run the endmqm command to stop each running queue manager associated with this installation.
  
  The endmqm command informs an application that the queue manager it is connected to is stopping; see Stopping a queue manager.
  
  For the maintenance to proceed, applications must respond to an endmqm command by disconnecting from the queue manager and releasing any IBM MQ libraries they have loaded. If they do not, you must find another way to force applications to release IBM MQ resources, such as by stopping the applications.
  
  You must also stop applications that are using the client libraries that are part of the installation. Client applications might be connected to a different queue manager, running a different installation of IBM MQ. The application is not informed about queue managers in the current installation being shut down.
  
  Any applications that continue to have IBM MQ shared libraries from the installation loaded prevent you applying IBM MQ maintenance. An application might disconnect from a queue manager, or be forcibly disconnected, but keep an IBM MQ shared library loaded.
  
  Note: Applying maintenance level updates to multi-instance queue managers on Linux describes how to apply maintenance to a multi-instance queue manager. A multi-instance queue manager can continue to run on one server, while maintenance is applied to another server.
4. Stop any listeners associated with the queue managers, using the command:
```
endmqlsr -m QMgrName
```
Back up the queue manager.
Take copies of all the queue manager's data and log file directories, including all subdirectories, and also the qm.ini file. For more information, see Backing up and restoring IBM MQ queue manager data.
Log in as root.
Optional: If you are doing a single stage migration, optionally uninstall the current version of the product.
Note, that you carry out this step only if you are doing a single stage migration; see Migrating on AIX and Linux: single-stage.
Install the later version of the product.
See the appropriate topic for the platform that your enterprise uses:
- Installing IBM MQ server on AIX.
- Installing the first IBM MQ installation on Linux using the rpm command.
Move the queue manager to the new IBM MQ installation.
You need to carry out this step, only if you did not uninstall your current version of the product.
See Migrating on AIX and Linux: side-by-side or Migrating on AIX and Linux: multi-stage for further information.
Start the queue manager.
```
strmqm QmgrName
```
When you first start a queue manager after migration:
- Any new attributes for existing objects are set to their default values.
- Any new default objects are created.
- Queue manager data is migrated.
Important: Do not use the -c option to start the queue manager, unless you explicitly want to reset or re-create the default system objects.

You must start IBM MQ before you start any listeners.