IT26266: IBM MQ Appliance 9.1: HA queue manager does not start at preferred location.

APAR status

• Closed as program error.

Error description

• Queue manager does not start at its preferred location.
  
  Stopping and then starting the queue manager brings the queue
  manager up on the secondary appliance.
  
  Other HA queue managers are shown to be running as expected.
  
  The clearhapreferred and sethapreferred commands do not help
  to resolve the issue.
  
  The status of the queue manager is as below:
  
  On the primary appliance:
  
  mqa(mqcli)# status QM1
  QM(QM1)                           Status(Running
  elsewhere)
  HA role:                                 Secondary
  HA status:                               Normal
  HA control:                              Enabled
  HA preferred location:                   This appliance
  
  On the secondary appliance:
  
  mqa(mqcli)# status QM1
  QM(QM1)                           Status(Running)
  CPU:                                     0.00%
  Memory:                                  300MB
  Queue manager file system:               6699MB used, 63.0GB
  allocated
  [10%]
  HA role:                                 Primary
  HA status:                               Normal
  HA control:                              Enabled
  HA preferred location:                   Other appliance
  
  dsphagrp shows online/online from both appliances:
  
  mqa(mqcli)# dsphagrp
  This Appliance: Online
  Appliance mqappl1: Online
  mqa(mqcli)# dsphagrp
  This Appliance: Online
  Appliance mqappl2: Online
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  IBM MQ Appliance 9.1 users
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  If the HA queue manager resource enters a failed state then it
  needs to be cleaned up during queue manager start up.  However,
  failed actions were not detected correctly in this scenario and
  the queue manager failed to start.
  

Problem conclusion

• The code has been modified to detect failures and recover from
  the failures during HA queue manager startup.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 CD    9.1.2
  v9.1 LTS   9.1.0.2
  
  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

  IBM MQ APPL M20

• Fixed component ID

  5725Z0900

Applicable component levels