IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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
    "91", 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 number

    IT37376

  • Reported component name

    MQ BASE V9.2

  • Reported component ID

    5724H7281

  • Reported release

    920

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-06-22

  • Closed date

    2021-07-21

  • Last modified date

    2021-07-21

  • 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

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"920"}]

Document Information

Modified date:
22 July 2021