IT37376: Unable to install IBM MQ 9.2.0.2 rpm components for Linux when there are multiple installations

APAR status

• Closed as program error.

Error description

• The rpm components for MQ 9.2.0.2 fix pack are unable to be
  installed on Linux when there are multiple installations on the
  machine.  For example, when attempting to install
  MQSeriesServer 9.2.0.2 rpm component, you will get the
  following error:
  
  + echo 'ERROR: Installation path for this package "/opt/mqm" '
  ERROR: Installation path for this package "/opt/mqm"
  + echo '       does not match that for "MQSeriesServer".'
         does not match that for "MQSeriesServer".
  + exit 255
  D: %pre(MQSeriesServer-U9202-9.2.0-2.x86_64): waitpid(29113) rc
  29113 status ff00
  error: %pre(MQSeriesServer-U9202-9.2.0-2.x86_64) scriptlet
  failed, exit status 255
  error: MQSeriesServer-U9202-9.2.0-2.x86_64: install failed
  
  If verbose output is collected by adding the -vv flag to the rpm
  command, the following error is visible.  In this example,
  /opt/mqm is the directory to which fix pack 9.2.0.2 is being
  installed:
  
  ERROR: Installation path for this package "/opt/mqm"
         does not match that for "MQSeriesRuntime".
  

Local fix

• Remove the existing 9.2.0.0 or 9.2.0.1 installation then
  install the MQ 9.2.0.2 manufacturing refresh from Passport
  Advantage.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Any users who have installed multiple versions of IBM MQ on an
  RPM-based Linux system without using the crtmqpkg program to add
  a unique suffix to the RPM names for each instance.
  
  
  Platforms affected:
  Linux on zSeries, Linux on x86-64
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The IBM MQ Documentation for installing IBM MQ 9.1 and earlier
  on RPM-based Linux states, "If this installation is not the only
  installation of IBM MQ on the system, you must run the crtmqpkg
  command to create a unique set of packages to install on the
  system" while the IBM MQ 9.2 documentation states, "The crtmqpkg
  command is required only if this is not the first installation
  of IBM MQ on the system."  The crtmqpkg command modifies the
  name of the IBM MQ installation RPMs by adding a suffix such as
  "92", for example MQSeriesRuntime --> MQSeriesRuntime_92,
  MQSeriesServer --> MQSeriesServer_92, and so on.
  
  This issue affects deployments where the crtmqpkg command was
  not used, and there were multiple versions of IBM MQ on the
  system under the normal RPM names without any suffix, using the
  rpm --prefix option to change the installation directory.
  Changes to the IBM MQ RPM preinstallation script in fix pack
  9.2.0.2 attempted to confirm that the fix pack was being
  installed to the same directory as the original IBM MQ
  installation, to catch cases where the user forgot to use rpm
  --prefix, or gave the wrong directory name.  This change
  detected the same RPM name installed to multiple  directories
  and cancelled the fix pack installation with a message like
  this:
  
  error: %pre(MQSeriesServer-U9202-9.2.0-2.x86_64) scriptlet
  failed, exit status 255
  error: MQSeriesServer-U9202-9.2.0-2.x86_64: install failed
  
  
  
  This problem does not affect non-RPM based installations of IBM
  MQ on Ubuntu systems.
  

Problem conclusion

• IBM recommends using the crtmqpkg command to ensure every IBM MQ
  installation has unique RPM names, and the corresponding crtmqfp
  command to update fix pack RPMs with the same names.  In order
  to accommodate those users who have multiple installations with
  the same RPM names, fix pack 9.2.0.3 has been updated to check
  only that the target location (rpm --prefix directory) contains
  a valid IBM MQ RPM installation, ignoring any other RPM
  installations elsewhere on the system.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.2 LTS   9.2.0.3
  v9.x CD    9.2.4
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  MQ BASE V9.2

• Fixed component ID

  5724H7281

Applicable component levels