IT44335: Migration of IBM MQ Appliance HA queue manager from MQ 9.2 to 9.3 fails if the queue manager has been manually stopped

APAR status

• Closed as program error.

Error description

• Migration of IBM MQ Appliance HA queue manager from MQ 9.2 to
  9.3 fails if the queue manager has been manually stopped before.
  High availability queue managers are reported as 'already
  migrated' when running 'sethagrp - u {QMGR}' but no HA queue
  managers could be started on the upgraded appliance.
  

Local fix

• When updating an appliance ensure all HA queue managers are
  running on the target appliance's HA partner appliance
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All IBM MQ M2002 Appliance users who upgrade the firmware from
  9.2 to 9.3.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  Migration of queue managers with a High Availability (HA)
  configuration failed when a queue manager was manually stopped
  before the firmware upgrade to 9.3 from 9.2.
  When a HA queue manager is stopped before upgrading, an internal
  attribute which manages the state of resource is set to false,
  which affects the order constraints (rules) that the appliance
  follows to start an HA queue manager's resources. This caused
  the migration process to fail, and therefore the HA components
  initialization, as it did not update an internal metadata file.
  With no metadata file available, HA resources appeared as
  unavailable.
  

Problem conclusion

• MQ migration process has been modified to check if the high
  availability queue manager was stopped manually prior to
  starting the queue manager's HA resources.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.3 LTS   9.3.0.10
  v9.x CD    9.3.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 APPLIANCE M2

• Fixed component ID

  5900ALJ00

Applicable component levels