Page 1 of 47 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 https://www.ibm.com/support/pages/node/2800929 Date last updated: 17-Apr-2020 Angel Rivera – [email protected] IBM MQ Support +++ Objective This techdoc shows all the steps to install MQ 9.1.0.0 LTS in Windows, 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. Note: The particular fix packs mentioned in this tutorial were the latest ones at the time the tutorial was written – the overall recommendation is to apply the most recent fix pack level. 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 Linux is: https://www.ibm.com/support/pages/node/2800923 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 Page 2 of 47 The chapters are: Chapter 1: Installing MQ 9.1 side-by-side to MQ 8.0 Chapter 2: Need to run setmqenv to use MQ 9.1 or MQ 8.0 commands Chapter 3: Creating a queue manager under MQ 9.1 Chapter 4: Remote access to the new MQ 9.1 queue manager Chapter 5: Migrating an MQ 8.0 queue manager to MQ 9.1 Chapter 6: Installing fix pack MQ 8.0.0.14 Chapter 7: Installing Fix Pack 9.1.0.4 Chapter 8: 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 Continuous 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 47 +++ Hardware and software used for this tutorial Windows 10 Hostname: ventanas1.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 directory: C:\Program Files\IBM\WebSphere MQ\ by following the instructions from these tutorials: http://www.ibm.com/support/docview.wss?uid=swg27050058 Installing MQ 9.0 in Windows, using only the defaults http://www.iibm.com/support/docviiew.wss?uiid=swg27050059 Installing MQ 9.0 in Windows, specifying additional components (Telemetry, AMS, MFT) The MQ 8.0 installation is NOT designated as Primary. 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: CNS92ML IBM MQ V8.0.0.9 for Windows eImage The installation file was downloaded into a temporary directory: C:\downloads\mq8009win>dir 01/15/2020 12:35 PM 554,041,438 IBM_MQ_V8.0.0.9_FOR_WIN_MUL.zip Unzip the zip file. Move to the subdirectory: MQServer As an Administrator, double click to execute the following command: Setup.exe Page 4 of 47 Follow the instructions from the tutorial. The MQ 8.0 code will be installed as Installation1 in: C:\Program Files\IBM\WebSphere MQ\ The data and recovery logs for the queue managers will be located in the default: C:\ProgramData\IBM\MQ\ For this tutorial, the “Windows Client” is a component that needs to be explicitly selected from the Features menu by using the (*) Custom option. Note that the Typical option does not install the MQ Windows Client. It is recommended that you create a batch file that will invoke the MQ utility “setmqenv” for the desired Installation. This batch file needs to be located in a directory in your PATH, such as: C:\WinTools Example, using Batch file: set-mq-80.bat Note that “SET PATH” must be in a single long line. +begin (do not include this line) REM Setup the environment to run MQ 8.0 CALL " C:\Program Files\IBM\WebSphere MQ\bin\setmqenv" -n Installation1 REM Adding Samples to the path SET PATH=%PATH%;%MQ_FILE_PATH%\Tools\c\Samples\Bin;%MQ_FILE_PATH%\Tools\c\Sampl es\Bin64;%MQ_FILE_PATH%\Tools\jms\samples;%MQ_JAVA_INSTALL_PATH%\bin\ dspmqver -f 2 +end (do not include this line) Page 5 of 47 Before you invoke setmqenv via set-mq-80 notice the default environment variables that are set by the MQ installer: C:\> set MQ MQ_FILE_PATH=C:\Program Files\IBM\WebSphere MQ MQ_JAVA_DATA_PATH=C:\ProgramData\IBM\MQ MQ_JAVA_INSTALL_PATH=C:\Program Files\IBM\WebSphere MQ\java MQ_JAVA_LIB_PATH=C:\Program Files\IBM\WebSphere MQ\java\lib64;C:\Program Files\IBM\WebSphere MQ\java\lib MQ_JRE_PATH=C:\Program Files\IBM\WebSphere MQ\java\jre Then issue: C:\> set-mq-80 Version: 8.0.0.9 Notice more environment variables (in bold): C:\> set MQ MQ_DATA_PATH=C:\ProgramData\IBM\MQ MQ_ENV_MODE=64 MQ_FILE_PATH=C:\Program Files\IBM\WebSphere MQ MQ_INSTALLATION_NAME=Installation1 MQ_INSTALLATION_PATH=C:\Program Files\IBM\WebSphere MQ MQ_JAVA_DATA_PATH=C:\ProgramData\IBM\MQ MQ_JAVA_INSTALL_PATH=C:\Program Files\IBM\WebSphere MQ\java MQ_JAVA_LIB_PATH=C:\Program Files\IBM\WebSphere MQ\java\lib64 MQ_JRE_PATH=C:\Program Files\IBM\WebSphere MQ\java\jre Now display the version-fixpack level: C:\> dspmqver Name: WebSphere MQ Version: 8.0.0.9 Level: p800-009-180321.1 BuildType: IKAP - (Production) Platform: WebSphere MQ for Windows (x64 platform) Mode: 64-bit O/S: Windows 10 Professional x64 Edition, Build 18363 InstName: Installation1 InstDesc: Primary: Yes InstPath: C:\Program Files\IBM\WebSphere MQ DataPath: C:\ProgramData\IBM\MQ MaxCmdLevel: 802 LicenseType: Production Page 6 of 47 Display the MQ installations: C:\> dspmqinst InstName: Installation1 InstDesc: Identifier: 1 InstPath: C:\Program Files\IBM\WebSphere MQ Version: 8.0.0.9 Primary: Yes State: Available MSIProdCode: {74F6B169-7CE6-4EFB-8A03-2AA7B2DBB57C} MSIMedia: 8.0 Server MSIInstanceId: 1set-mq-80 Version: 8.0.0.9 Display the queue manager together with the installation, version and status: C:\> dspmq -o installation -s QMNAME(QM80) STATUS(Running) INSTNAME(Installation1) INSTPATH(C:\Program Files\IBM\WebSphere MQ) INSTVER(8.0.0.9) + UnxUtils package The UNIX "which" command is not native to Windows, but it is used in this tutorial to show the directory where an executable file is located. Note: The Windows “where” command is a close relative to Unix “which”. The UnxUtils.zip and UnxUpdates.zip packages contain the "which" utility. These zip files can be downloaded from: http://sourceforge.net/projects/unxutils/files/ Download file: UnxUtils.zip http://unxutils.sourceforge.net/UnxUpdates.zip Download file: UnxUpdates.zip For details on the utilities that are provided in these packages, see: http://unxutils.sourceforge.net/ GNU utilities for Win32 Page 7 of 47 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +++ Chapter 1: Installing MQ 9.1 side-by-side to MQ 8.0 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ The MQ 9.1 installation will NOT be designated as Primary. ++ All queue manager data is stored in a common directory structure Even though the executable code for each version of MQ is stored in a different directory structure, the data for all the queue managers, regardless of the version, is stored in: MQ_DATA_PATH=C:\ProgramData\IBM\MQ ++ Downloading the MQ 9.1 code Download the code from IBM Passport Advantage.