IT46801: IBM MQ 9.4.0.0 upgraded to 9.4.0.5 removes the RDQM installationsetup.

APAR status

• Closed as program error.

Error description

• When upgrading IBM MQ 9.4.0.0 to 9.4.0.5 using the command:
  
    rpm -U MQSeriesRDQM-9.4.0-5.x86_64.rpm
  
  the RDQM installation setup is removed from the system.
  

Local fix

• Do not use the RPM '-U' upgrade option for the RDQM package.
  Instead remove the old RDQM package, and install the new one
  using the RPM '-i' option.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users of IBM MQ 9.4.0.0 and earlier, who are upgrading their
  installation which includes the MQSeriesRDQM package.
  
  Users are only affected if the upgrade process uses the "-U" rpm
  'upgrade' option, and if there is a file within the directory:
  
    /var/mqm/rdqm
  
  which had not been created by the MQSeriesRDQM installation
  package.
  
  
  Platforms affected:
  Linux on x86-64
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  On Red Hat Enterprise Linux, when the MQSeriesRDQM package is
  upgraded from one version to another using the:
  
    rpm -U <new MQSeriesRDQM package file name>
  
  a sequence of uninstall and install scripts are run from both
  the MQSeriesRDQM package which is being replaced and the new
  MQSeriesRDQM package which is replacing it, for which the
  relevant parts for this APAR are:
  
  (a) The '%post' (post-install) scripts of the new MQSeriesRDQM
  package runs and recreates any missing setup files and symbolic
  links associated with the MQSeriesRDQM component.
  
  (b) Then the '%postun' (post-uninstall) of the old MQSeriesRDQM
  package is run, which deletes these setup files.
  
  (c) Finally the '%posttrans' of the new package runs.  It checks
  for the existence of the directory:
  
    /var/mqm/rdqm
  
  If it is not found on the system, it then re-recreates the
  MQSeriesRDQM installation setup files.
  
  
  If the directory:
  
    /var/mqm/rdqm
  
  contains a file which was not created the MQSeriesRDQM
  installation, for example the file:
  
    /var/mqm/rdqm/myfile.txt
  
  then step (b) will remove the setup files, but will NOT delete
  the directory:
  
    /var/mqm/rdqm
  
  Subsequently the '%posttrans' phase will not recreate the setup
  files in phase (c), and the RDQM function will not perform
  correctly when used.
  
  
  You can determine if your system has been affected by this
  problem by looking for the presence of the following files and
  symbolic links:
  
    /usr/lib/ocf/resource.d/ibm/rdqm
    /usr/lib/ocf/resource.d/ibm/rdqmx
    /usr/lib/systemd/system/rdqm.service
  
    /var/mqm/rdqm/quorum-lost
    /var/mqm/rdqm/before-resync-source
    /var/mqm/rdqm/before-resync-target
    /var/mqm/rdqm/after-resync-target
    /var/mqm/rdqm/disconnected
    /var/mqm/rdqm/rdqmd
    /var/mqm/rdqm/crtmqm
    /var/mqm/rdqm/dltmqm
    /var/mqm/rdqm/rdqmadm
    /var/mqm/rdqm/rdqmalert
  
  
  If these files/symbolic links are not present on your system,
  but you have the MQSeriesRDQM component installed, then you are
  affected by this issue.
  
  The simplest resolution at this point would be to uninstall the
  MQSeriesRDQM package, and reinstall it.
  For example, if you have upgraded from IBM MQ 9.4.0.0 to
  9.4.0.5, and do not have these files present - but DO have the
  MQSeriesRDQM component installed, remove it and reinstall it
  using the commands:
  
  # rpm -e MQSeriesRDQM
  RDQMFailed to disable unit: Unit file rdqm.service does not
  exist.
  rm: cannot remove '/usr/lib/ocf/resource.d/ibm/rdqm': No such
  file or directory
  rm: cannot remove '/usr/lib/ocf/resource.d/ibm/rdqmx': No such
  file or directory
  rm: cannot remove '/usr/lib/systemd/system/rdqm.service': No
  such file or directory
  rm: cannot remove '/var/mqm/rdqm/quorum-lost': No such file or
  directory
  rm: cannot remove '/var/mqm/rdqm/before-resync-source': No such
  file or directory
  rm: cannot remove '/var/mqm/rdqm/before-resync-target': No such
  file or directory
  rm: cannot remove '/var/mqm/rdqm/after-resync-target': No such
  file or directory
  rm: cannot remove '/var/mqm/rdqm/disconnected': No such file or
  directory
  rm: cannot remove '/var/mqm/rdqm/rdqmd': No such file or
  directory
  rm: cannot remove '/var/mqm/rdqm/crtmqm': No such file or
  directory
  rm: cannot remove '/var/mqm/rdqm/dltmqm': No such file or
  directory
  rm: cannot remove '/var/mqm/rdqm/rdqmadm': No such file or
  directory
  rm: cannot remove '/var/mqm/rdqm/rdqmalert': No such file or
  directory
  mv: cannot stat '/etc/drbd.d/global_common.conf.rdqmsave': No
  such file or directory
  
  # rpm -i rpm -i Advanced/RDQM/MQSeriesRDQM-9.4.0-5.x86_64.rpm
  
  
  and the RDQM installation will be setup for use once again.
  

Problem conclusion

• As the code defect here is in the '%postun' script of the
  9.4.0.0 (and earlier) packages, this problem cannot be fixed in
  the 9.4.0.5 (and later) RPM packages if upgrading from the
  earlier versions.
  
  Once you are at the IBM MQ 9.4.0.5 (or later) versions, then the
  issue has been resolved by preventing the '%postun' phase from
  deleting the RDQM configuration if an upgrade is taking place.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.2 LTS   9.2.0.30
  v9.3 LTS   9.3.0.25
  v9.4 LTS   9.4.0.5
  v9.x CD    9.4.1
  
  The latest available maintenance and information on future
  planned maintenance can be obtained from
  'IBM MQ Recommended Fixes and Planned Maintenance release dates'
  https://ibm.biz/mqplannedmaintenance
  
  ---------------------------------------------------------------
  

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 9.4

• Fixed component ID

  5724H72A1

Applicable component levels