IV96094: MEANINGLESS CLMGR ERROR MSG FOR INVALID NETWORK_FDT VALUE

PowerHA-7.2.1 SP3
PowerHA-7.2.1 SP1

APAR status

• Closed as program error.

Error description

• The maximum value for the CAA network_fdt tunable
  is limited by the CAA node_timeout - 10000 millisec.
  
  It is possible to modify the network_fdt tunable
  via clmgr command (note: clmgr uses unit sec).
  
  clmgr internally verifies if the specified
  network_fdt honors the limitation by the
  node_timeout setting. If the limitation
  is not honored, clmgr simply prints a
  general message, which is not meaningful:
  
  root@ha1clB:/ # clctrl -tune -a
  ...
      ClusterB(50ac5846-9f73-11e6-808a-4ef945334002)
  .network_fdt = 10000
  ...
      ClusterB(50ac5846-9f73-11e6-808a-4ef945334002)
  .node_timeout = 20000
  ...
  .
  root@ha1clB:/ # clmgr modify cluster \
   NETWORK_FAILURE_DETECTION_TIME=15
  .
  For more information about available options
  and syntax, try "/usr/es/sbin/cluster/utilities/
  clmgr modify cluster -h". ...
  .
  root@ha1clB:/ # echo $?
  4
  
  Even the message in clutils.log does not explain
  that network_fdt is limited by node_timeout -
  10 sec.
  
  root@ha1clB:/ # more /var/hacmp/log/clutils.log:
  ...
      KLIB_HACMP_modify_cluster()[254](4.019):
   Given Network Failure Detection TimeOut cannot
    be more than 10
      KLIB_HACMP_modify_cluster()[258](4.020):
   clctrl -tune -L network_fdt
      KLIB_HACMP_modify_cluster()[261](4.061):
    RC: 0
  CLMGR RETURN   (23137):  4
  CLMGR STDERR -- BEGIN (23137:12321148:7078220):
    2017-01-31T15:39:25.702680
  CLMGR STDERR -- BEGIN (23137:12321148:7078220):
    2017-01-31T15:39:25.702680
  For more information about available options
   and syntax, try ...
  
  CLMGR STDERR -- END   (23137:12321148:7078220):
   2017-01-31T15:39:25.792549
  CLMGR ENDED    (23137):  2017-01-31T15:39:25.851554
  CLMGR ELAPSED  (23137):  5.629
  

Local fix

Problem summary

• clmgr internally verifies if the specified
  network_fdt honors the limitation by the
  node_timeout settings. If the limitation
  is not honored, clmgr simply prints general
  message. In case of update failure of
  network_fdt parameter it does not give
  any error.
  

Problem conclusion

• Proper error message is printed for
  network_fdt updation failure.
  Added check to prevent values below
  5 seconds for the tunable parameter
  "network_fdt"
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  IV93755

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  POWERHA SYSMIR

• Fixed component ID

  5765H3900

Applicable component levels