IT25636: Inadequate error message is reported when RDQM configuration fails due to incorrect file permission.

APAR status

• Closed as program error.

Error description

• When configuring RDQM HA using the 'rdqmadm -c' command, a
  failure occurs reporting the following errors
  
  AMQ3817E: Replicated data subsystem call '/usr/sbin/crm -c
  rdqm.17596 node list' failed with return code '1'.
  ERROR: cib.use: rdqm.17596: no such shadow CIB
  
  AMQ3817E: Replicated data subsystem call '/usr/sbin/crm cib
  delete
  rdqm.17596' failed with return code '1'.
  ERROR: cib.delete: failed to delete rdqm.17596 shadow CIB
  
  The error is not easily understandable and does not elude to the
  cause of the issue. Checking the pacemaker log will show errors
  indicating that permission to "/dev/shm" is denied.
  
  Mar 21 06:28:09 [10127] hostname.ibm.com        cib:    error:
  qb_ipcc_shm_connect:	qb_rb_open:REQUEST: No such file or
  directory (2)
  Mar 21 06:28:09 [10127] hostname.ibm.com        cib:    error:
  qb_ipcc_shm_connect:	connection failed: No such file or
  directory (2)
  Mar 21 06:28:09 [10132] hostname.ibm.com       crmd:    error:
  qb_sys_mmap_file_open:	couldn't open file
  /dev/shm/qb-cmap-request-10119-10132-25-header: Permission
  denied (13)
  

Local fix

• Change the permissions on /dev/shm from 750 to 777.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users using the Replicated Data Queue Manager (RDQM) feature in
  MQ.
  
  
  Platforms affected:
  Linux on x86-64
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  During RDQM configuration the command rdqmadm -c will fail with
  errors if there is insufficient permission on the system
  directory "/dev/shm".  However, the error message reported for
  this failure is not useful enough to understand the actual cause
  for the failure.  Only by reviewing the pacemaker.log user can
  the understand the cause of the error.
  

Problem conclusion

• A new error message AMQ3696 has been added to report the
  incorrect permission issue.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 CD    9.1.3
  v9.1 LTS   9.1.0.3
  
  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 BASE M/P

• Fixed component ID

  5724H7261

Applicable component levels