Upgrade procedure

You can upgrade existing IBM® MQ for HPE NonStop V8.1 installations while preserving existing configurations and data (including queue managers, queues, and queue data).

By default, the upgrade procedure creates a backup of any files that it is about to change. The backups are located in the folder OSS_directory/opt/mqm/backup. The log files created while upgrading are located in the folder OSS_directory and begin with the string mq_.

You must end all queue managers before running an upgrade.

Fixpacks can be applied and backed out with the upgrade and restore procedure.

To upgrade, enter the following command:
installer_name.run --upgrade -i OSS_directory [-d] [-b] [-p]
  • installer_name is the name of the installation program, for example, ibm-mq-hpe-nsx64-8.0.1.
  • OSS_directory is the path to the existing installation. The path can be absolute or relative to the current working directory.
  • You specify -d to delete the back up files of the current installation.
  • You specify -b to skip making a backup of changed files during the upgrade.
  • You specify -p to recreate mqprofile and mqcstm files during the upgrade.
  • The parameter --upgrade can also be specified as -upgrade. For Fixpacks and iFixes the parameter -upgrade is optional as it is the default.
The upgrade can take 60 minutes or longer on busy machines. You can track the progress of the upgrade by entering a command to tail the upgrade log file, for example:
tail -f ~/MQ8a/mq_8010-20170926-110637-upgrade.log
Where MQ8a is the OSS directory, and mq_8010-20170926-110637-upgrade.log is the most recent log file.

By default, the upgrade process creates a backup of the currently installed release of the product. This part of the upgrade procedure consumes about 80% of the upgrade time. You can skip the backup by using the -b argument. Note that you cannot restore to previous versions without a backup created by upgrade.

If you attempt to use upgrade to restore the current release (for example, you attempt to upgrade a version 8.1 installation to version 8.1), the existing backup might act to prohibit the upgrade. In this case, specify the -d parameter to delete the backup files.

The following example shows a successful upgrade procedure:

$ ibm-mq-hpe-nsx64-8.0.1.run -upgrade -i MQ8a
MQ version installed: 8000
installer version: 8010
Checking for opened files in /home/mqm.user/MQ8a/opt/mqm
#  IBM MQ Server 8.0.1 for HPE NonStop X

#  Fixpack            :
#  Architecture       : nsx64
#  Build              : p800-L170925-182855
#  MQ Install Path    : /home/mqm.user/MQ8a
#                       $MQAS.MQ8A    (/G/mqas/mq8a)
#  MQ owner           : MQM.USER   12,34
#  System Name        : CS4
#  RVU                : L16.05
#  UNAME              : NONSTOP_KERNEL NSX-G
#  Default TCPIP      : $ZTC0
#  Locale             : C
#  Tue Sep 26 2017 11:06:37 MET DST
Checking for opened files in /home/mqm.user/MQ8a/opt/mqm               [OK]
Making backup. See log-file in the root directory for progress         [OK]
Upgrading installation                                                 [OK]
Installing SSL libraries                                               [OK]
Setting Guardian and OSS tree attributes                               [OK]
Generating message catalogs                                            [OK]
MQ upgrade successful                 [12:25 elapsed]                  [OK]
Note: Fixpack V8.1.0.5 or higher cannot be applied to an IBM MQ installation in the root directory "/" (for example, /opt/mqm and /var/mqm).
Ensure that the IBM MQ installation owner has sufficient permissions on the installation package before starting the upgrade procedure. A minimum of read and execute permission is required:
$ ls -l  8.1.0-IBM-MQ-HpeNsX64-FP0006.run
-rwxr-xr-x    1 MQM.MANAGER         MQM      8.1.0-IBM-MQ-HpeNsX64-FP0006.run