Page 1 of 49 Installing MQ 9.1.0.3 LTS to coexist with MQ 8.0.0.9 in Linux x86 64-bit, including applying Fix Packs 8.0.0.14 and 9.1.0.4 https://www.ibm.com/support/pages/node/2800923 Date last updated: 18-Feb-2020 Angel Rivera – [email protected] IBM MQ Support +++ Objective This techdoc shows all the steps to install MQ 9.1.0.3 LTS in Linux x86 64-bit, while co-existing ("side-by-side") with MQ 8.0.0.9. Furthermore, the steps include the installation of the Fix Packs 8.0.0.14 and 9.1.0.4. None of the installations are designated as “Primary”. Therefore, you must use “setmqenv” to setup the MQ environment for the desired installation. NOTE regarding MQ 9.0: The principles discussed in this techdoc apply also to MQ 9.0. Keep in mind that the End Of Support (EOS) for MQ 8.0 is 30-Apr-2020 and for MQ 9.0 is 30-Sep-2021. At the time this tutorial was written, the EOS for MQ 9.1 has not been announced yet. An important aspect of this feature of multiple installations of MQ (multi-install) in the same host, is that this type of installation does not require that the MQ 8.0 queue managers and applications need to be stopped when doing activities with MQ 9.1. That is, the installation of MQ 9.1 does not affect the running MQ 8.0 applications. This is helpful when you try to do a staging upgrade of the MQ 8.0 queue managers to MQ 9.1. The equivalent document for Windows is: https://www.ibm.com/support/pages/node/2800929 Installing MQ 9.1.0.0 LTS to coexist with MQ 8.0.0.9 in Windows, including applying Fix Packs 8.0.0.14 and 9.1.0.4 Except for the installation chapters that use the Linux rpm command, the rest of the chapters apply to other UNIX distributions: AIX and Solaris Keep in mind that MQ 9.1 is the LAST version that provides support for Solaris. Page 2 of 49 The chapters are: Chapter 1: Summary of rpm commands: install, uninstall, querying Chapter 2: Installing MQ 9.1 LTS side-by-side to MQ 8.0 Chapter 3: Need to run setmqenv to use MQ 9.1 or MQ 8.0 commands Chapter 4: Creating a queue manager under MQ 9.1 Chapter 5: Remote access to the new MQ 9.1 queue manager Chapter 6: Migrating an MQ 8.0 queue manager to MQ 9.1 Chapter 7: Installing Fix Pack 8.0.0.14 Chapter 8: Installing Fix Pack 9.1.0.4 Chapter 9: Uninstallation +++ Using MQ 9.1 Long Term Support (LTS) for this tutorial Starting with MQ 9.0, there are 2 branches for delivering the code. Here is a SUMMARY of when to use Long Term Support (LTS) and when to use Continu- ous Delivery (CD): a) Use LTS if you want STABILITY and you are willing to sacrifice new features that may come with CD. You are not willing to tolerate the bugs that may come with the new features. You will have fix packs that can be applied on top of LTS. In our experience, customers want LTS for the PRODUCTION queue managers. b) Use CD if you want NEW FEATURES and you are willing to tolerate the bugs that may come with the new features. There are NO fix packs that can be applied on top of a CD release (but there might be interim fixes). In a sense, the next CD release, such as MQ 9.1.2, is the fix pack for MQ 9.1.1 and has new features and fixes for bugs. If you are using 9.1.1 CD, you MUST UNINSTALL 9.1.1 in order to install the new 9.1.2 CD (this action does NOT change the data of the queue manager). In our experience, customers want CD for the DEVELOPMENT queue managers. Note: For more details see: http://www-01.ibm.com/support/docview.wss?uid=swg27047919 IBM MQ FAQ for Long Term Support (LTS) and Continuous Delivery (CD) releases Page 3 of 49 +++ Hardware and software used for this tutorial Red Hat Enterprise Linux (RHEL) 7.6 on x86-64-bit Hostname: aztlan1.fyre.ibm.com Queue Managers: QM80 => Created with MQ 8.0.0. To remain at 8.0.0 QMMIG => Created with MQ 8.0.0. To be migrated to 9.1.0 QM910 => Created with MQ 9.1.0. To remain at 9.1.0 The MQ 8.0 code was installed as the only installation of MQ in the Linux host in: /opt/mqm … by following the instructions from this tutorial: http://www.ibm.com/support/docview.wss?uid=ibm10719561 Installing MQ 9.0.0.1 LTS, applying Fix Pack 9.0.0.4, Uninstalling MQ in Linux The MQ 8.0 installation is NOT designated as Primary. The *Msg* (message catalogs) filesets were NOT installed. The MQ 8.0.0.9 rebased code was downloaded from IBM Passport Advantage and it has the cumulation of MQ 8.0.0.0 + 8.0.0.1 + … + 8.0.0.9 https://www.ibm.com/support/pages/downloading-ibm-mq-version-80 Downloading IBM MQ Version 8.0 The Part Number is: CNS91ML WebSphere MQ V8.0.0.9 for Linux on x86 64-bit eImage The installation file was downloaded into a temporary directory: +++ROOT+++ aztlan1.fyre.ibm.com: /downloads/mq8009 # ls WS_MQ_V8.0.0.9_LINUX_ON_X86_64_IM.tar.gz Here is a subset of the rpm filesets that are installed: +++ROOT+++ aztlan1.fyre.ibm.com: /root # rpm -qa | grep -i mq | grep "8\.0" MQSeriesJava-8.0.0-9.x86_64 MQSeriesFTService-8.0.0-9.x86_64 MQSeriesAMS-8.0.0-9.x86_64 MQSeriesClient-8.0.0-9.x86_64 MQSeriesJRE-8.0.0-9.x86_64 MQSeriesServer-8.0.0-9.x86_64 Page 4 of 49 MQSeriesAMQP-8.0.0-9.x86_64 MQSeriesXRService-8.0.0-9.x86_64 MQSeriesGSKit-8.0.0-9.x86_64 MQSeriesMan-8.0.0-9.x86_64 MQSeriesSDK-8.0.0-9.x86_64 MQSeriesRuntime-8.0.0-9.x86_64 This is the output of dspmqver: [email protected]: /home/mqm $ dspmqver Name: WebSphere MQ Version: 8.0.0.9 Level: p800-009-180321.1 BuildType: IKAP - (Production) Platform: WebSphere MQ for Linux (x86-64 platform) Mode: 64-bit O/S: Linux 3.10.0-1062.4.1.el7.x86_64 InstName: Installation1 InstDesc: Primary: No InstPath: /opt/mqm DataPath: /var/mqm MaxCmdLevel: 802 LicenseType: Production This is the output of dspmqinst (which displays the MQ installations in the server): [email protected]: /home/mqm $ dspmqinst InstName: Installation1 InstDesc: Identifier: 1 InstPath: /opt/mqm Version: 8.0.0.9 Primary: No State: Available Display the existing MQ 8.0 queue managers and the installation, version and status: $ dspmq -o installation -s QMNAME(QM80) STATUS(Running) INSTNAME(Installation1) INSTPATH(/opt/mqm) INSTVER(8.0.0.9) QMNAME(QMMIG) STATUS(Ended immediately) INSTNAME(Installation1) INSTPATH(/opt/mqm) INSTVER(8.0.0.9) Page 5 of 49 + Customization scripts to facilitate working with multiple MQ installations The following tutorial has a zip file that has several scripts that can be installed in /usr/local/bin and that can be useful. https://www.ibm.com/support/pages/node/1402581 Customization of a Linux RHEL host or VM for using MQ For example, you could have reused the script in /usr/local/bin : set-mq-80 … and customized it as follows: # Purpose: to setup the environment to run MQ 8.0 . /opt/mqm/bin/setmqenv -n Installation1 Then, the file $HOME/bashrc.mqm for the user “mqm” could have been customized to issue the above set-mq script upon login. ## Set default MQ version: . set-mq-80 Then when user “mqm” logs in, the bashrc.mqm file is execute, which invokes the set-mq-80 script which sets the MQ environment variables for MQ 8.0. Version: 8.0.0.9 [email protected]: /home/mqm (20) The following command shows the queue managers created under MQ 8.0: [email protected]: /home/mqm (20) dspmq QMNAME(QM80) STATUS(Running) QMNAME(QMMIG) STATUS(Running) The following script from /usr/local/bin displays the queue managers created under MQ 8.0, including the InstallationName, the path and version. [email protected]: /home/mqm (21) dspmq80 QMNAME(QM80) STATUS(Running) INSTNAME(Installation1) INSTPATH(/opt/mqm) INSTVER(8.0.0.9) QMNAME(QMMIG) STATUS(Running) INSTNAME(Installation1) INSTPATH(/opt/mqm) INSTVER(8.0.0.9) Page 6 of 49 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++ Chapter 1: Summary of rpm commands: install, uninstall, querying ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Login as user: root a) Installing the MQ rpm filesets for the first installation. This is first installation in a Linux host and the default location is used (/opt/mqm) Example: MQ 8.0.0.9 in /opt/mqm * Download tar.gz file into a directory such as /downloads/mq/8.0.0.9/ * Unpack the tar.gz file, such as: tar -zxvf WS_MQ_V8.0.0.9_LINUX_ON_X86_64_IM.tar.gz cd /downloads/mq/8.0.0.9/MQServer ./mqlicense.sh -accept rpm -ivh MQ*.rpm b) Querying the installed MQ rpm filesets. Query for all the filesets. rpm -qa | grep -i mq c) Querying the installed MQ rpm filesets. Query for only the MQ 8.0 filesets. rpm -qa | grep -i mq | grep "8\.0" d) Installing (for the first time) all the MQ rpm filesets for a second installation.