IT30614: crtmqm and mqcli commands fail after running userrestore in a new and/or a reinitialized(factory reset) appliance

APAR status

• Closed as program error.

Error description

• After replacing a failed appliance with a new one or performing
  a factory reset to an exiting appliance and then restoring
  messaging users and groups, the mqm group and an user
  will not be available.  This causes some mqcli commands failing
  with unexpected errors and FDCs.
  
  Example:
  
  mqa(mqcli)# crtmqm testqmgr
  AMQ8101S: IBM MQ Appliance error (893) has occurred.
  
  mqa(mqcli)#  prepareha -s secretkey -a 192.168.10.101
  AMQ6546E: An internal IBM MQ Appliance error has occurred.
  
  mqa(mqcli)# crthagrp  -s secretkey -a 192.168.10.102
  AMQ6546E: An internal IBM MQ Appliance error has occurred.
  
  FDCs:
  
  Probe Id     :- DP063008
  Component     :- dpcPrepareHA
  Program Name   :- mqdpcli
  Probe Description :- AMQ6125E: An internal IBM MQ Appliance
  error has
  Arith1      :- 106 (0x6a)
  Comment1     :- Failed to execute 'dp_usermanager' command
  
  MQM Function Stack
  CLI
  dpcCmd_prepareHA
  dpcPrepareHA
  xcsFFST
  
  Problem Recreate Procedure:
  - Factory reset
  - Configure the MQ appliance(no changes to user and group
  configuration)
  - Run userrestore command to restore messaging users and groups
  - mqm group and an user will not available
  

Local fix

• * Create one user and one group before running userrestore
  command.
  Procedure:
  - Factory reset
  - Configure the MQ appliance
  - Create one user and one group. The user and group that have
  been created
     can be deleted if not required.  (e.g. create tmpusr and
  tmpgrp and delete them)
  - Restore messaging users and groups
  - No problem found in users/groups
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users running the userrestore command on a new or a
  reinitialized(factory reset) MQ appliance
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  A defect in userrestore command caused an incorrect merge
  between the existing users/groups and the
  backup users/groups, resulting in mqm group and user being
  unavailable.
  

Problem conclusion

• The userrestore command has been modified to correctly merge the
  backup users/groups with the existing users/groups.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 CD    9.1.5
  v9.1 LTS   9.1.0.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

  5737H4700

Applicable component levels