Installing an IBM MQ interim fix into a deployed pattern instance

You can install a standard IBM® MQ interim fix by using the IBM PureApplication® System instance console. You first need to package the interim fix into an archive file with extra metadata and a script that installs the interim fix. You can then add it into the PureApplication System catalog and it is available for use.

About this task

You can package a standard IBM MQ interim fix and install it in following steps:

Procedure

Download the IBM MQ interim fix from Fix Central or from the link that is provided by IBM Support.
An interim fix is a tar archive file, for example: 8.0.0.4-WS-MQ-LinuxX64-LAIT13465.tar.gz.
Extract the file contents.
Open the readme.txt file in the archive and make a note of the fix name at the top of the file.
You can use it in step 6.

Create a file, save it as service.xml, and paste in the following code:


<?xml version="1.0" encoding="UTF-8" ?>
  <rmsd:Service xmlns="https://www.w3.org/2001/XMLSchema"
   xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
   xmlns:rmsd="https://www.ibm.com/websphere/rainmaker/service/servicedescription"
   xsi:schemaLocation="https://www.ibm.com/websphere/rainmaker/service/servicedescription ./Service.xsd">
  <rmsd:PluginPrereqs>
    <rmsd:prereq pluginvrmf="20.0.0.x" pluginname="plugin.com.ibm.vsys.mq"/>
    <rmsd:prereq pluginvrmf="20.0.0.x" pluginname="plugin.com.ibm.vsys.mq"/>
  </rmsd:PluginPrereqs>
  <rmsd:Packages>
    <rmsd:Package name="FIX-NAME" type="ifix" target="APPLICATION">
      <rmsd:Command name="/bin/sh /tmp/FIX-NAME/install.sh">
         <rmsd:Location>/tmp/FIX-NAME</rmsd:Location>
      </rmsd:Command>
    </rmsd:Package>
  </rmsd:Packages>
</rmsd:Service>

Check that the <rmsd:PluginPrereqs> parent element includes a list of child elements with your versions of the IBM MQ Virtual System Pattern Type plug-in for your deployed patterns.
To check your installed plug-in versions in the Workload Console, click Catalog -> System Plug-ins and then enter plugin.com.ibm.vsys.mq in the Filter. The version is shown next to the plug-in name. Edit the service.xml file from step 4 with the version information of your pattern:
```
  <rmsd:PluginPrereqs>
    <rmsd:prereq pluginvrmf="20.0.0.2" pluginname="plugin.com.ibm.vsys.mq"/>
    <rmsd:prereq pluginvrmf="20.0.0.6" pluginname="plugin.com.ibm.vsys.mq"/>
  </rmsd:PluginPrereqs>
```

Edit the attributes in the <rmsd:Packages> element of the service.xml file to replace the value of the name attribute FIX-NAME to the value that you found at the top of the readme.txt file from step 3.

For example, if the interim fix name is 8.0.0.4-WS-MQ-LinuxX64-LAIT13465-157376, change the line 11 from:


    <rmsd:Package name="FIX-NAME" type="ifix" target="APPLICATION">

<rmsd:Package name="8.0.0.4-WS-MQ-LinuxX64-LAIT13465-157376" type="ifix" target="APPLICATION">

On line 12, change the path to the script file from:


      <rmsd:Command name="/bin/sh /tmp/FIX-NAME/install.sh">


      <rmsd:Command name="/bin/sh /tmp/8.0.0.4-WS-MQ-LinuxX64-LAIT13465-157376/install.sh">

On line 13, change the location path from:


         <rmsd:Location>/tmp/FIX-NAME</rmsd:Location>


         <rmsd:Location>/tmp/8.0.0.4-WS-MQ-LinuxX64-LAIT13465-157376</rmsd:Location>

Save the service.xml file.

Create a file, save it as install.sh, and paste in the following code:


#!/bin/sh
set -x
MQInstallDir=MQ_INST_DIR
FixName=MQ_FIX_NAME
FixPackage=MQ_FIX_ARCHIVE
echo "Unpack MQ interim fix"
cd /tmp/${FixName}
tar -xvf ${FixPackage}
echo "== Run MQ fix installer =="
cd ${FixName}
./mqfixinst.sh ${MQInstallDir} install ${FixName}

Change the value of MQInstallDir to match the directory where IBM MQ is installed.
The default location on Linux® systems is /opt/mqm and /usr/mqm on AIX® systems. For example, replace MQ_INST_DIR with /opt/mqm on line 3.
Change the value of FixName to match the name of the IBM MQ interim fix you noted in step 3.
For example, replace MQ_FIX_NAME with 8.0.0.4-WS-MQ-LinuxX64-LAIT13465-157376 on line 4.
Change the value of FixPackage to match the name of the interim fix archive you downloaded in step 1.
For example, replace the MQ_FIX_ARCHIVE with 8.0.0.4-WS-MQ-LinuxX64-LAIT13465.tar.gz on line 5.
Save the install.sh file.
Create a compressed archive file that contains the interim fix archive that you downloaded in step 1, the edited install.sh, and service.xml files you created.
The files must be in the root directory of the compressed file.
You can now upload the interim fix archive file that contains the amended service.xml file and the install.sh script to the PureApplication System catalog, as described in Adding emergency fixes to the catalog.
You can then install the interim fix, as described in Applying fix packs or interim fixes.

Note: You must stop the messaging service through the Instance Console → Operations panel before you install an IBM MQ interim fix.