IT27373: CLIENT CLUSTER PROTECTION WIZARD STOPS AT OPTION FILE SELECTION

APAR status

• Closed as program error.

Error description

• The Spectrum Protect Client Cluster Protection Wizard may stop
  at client cluster option file configuration step, where it
  should create dsm.opt file on a shared cluster disk. Instead the
   wizard does not perform any action on "Next" or "Back" button
  press.
  
  Client GUI Java trace with trace flag ALL will show the
  following:
  
  Tue Nov 13 15:45:20 EET 2018: Entering
  DcwlWizardController.NextButtonListener.actionPerformed()
  Tue Nov 13 15:45:20 EET 2018: Entering
  DcwlWizardController.NextButtonListener.commitAndUpdatePreviousT
  ask()
  Exception in thread "AWT-EventQueue-0"
  java.lang.StringIndexOutOfBoundsException
          at java.lang.String.substring(String.java:1402)
          at
  COM.ibm.storage.adsm.cadmin.comgui.wizard.view.panels.DcwpCluste
  rOptionFileName.isDriveValid(DcwpClusterOptionFileName.java:387)
          at
  COM.ibm.storage.adsm.cadmin.comgui.wizard.view.panels.DcwpCluste
  rOptionFileName.validation(DcwpClusterOptionFileName.java:467)
          at
  COM.ibm.storage.adsm.cadmin.comgui.wizard.view.panels.DcwpCluste
  rOptionFileName.commitOptionData(DcwpClusterOptionFileName.java:
  545)
          at
  COM.ibm.storage.adsm.cadmin.comgui.wizard.logic.DcwlWizardContro
  ller$NextButtonListener.commitAndUpdatePreviousTask(DcwlWizardCo
  ntroller.java:4042)
  
  
  Exception occurs in the isDriveValid() method, where client
  validates available cluster disks.
  
  
  The client SERVICE trace will show output similar to the
  following:
  
  11/13/2018 15:45:10.379 [011088] [3816] :
  ..\..\common\winnt\clusutil.cpp(4922): dsGetClusterGroups():
  look for 'DATA1' in 'FS (LOG1;DATA1)'
  11/13/2018 15:45:10.379 [011088] [3816] :
  ..\..\common\winnt\clusutil.cpp(4590): DsGetResourceInfo():
  Entry.
  11/13/2018 15:45:10.379 [011088] [3816] :
  ..\..\common\winnt\clusutil.cpp(4703): DsGetResourceInfo():
  Inserting disk E: into list...
  11/13/2018 15:45:10.379 [011088] [3816] :
  ..\..\common\winnt\clusutil.cpp(4790): DsGetResourceInfo():
  Exit.
  
  11/13/2018 15:45:10.379 [011088] [3816] :
  ..\..\common\winnt\clusutil.cpp(4922): dsGetClusterGroups():
  look for 'LOG1' in 'FS (LOG1;DATA1)'
  11/13/2018 15:45:10.379 [011088] [3816] :
  ..\..\common\winnt\clusutil.cpp(4590): DsGetResourceInfo():
  Entry.
  11/13/2018 15:45:10.395 [011088] [3816] :
  ..\..\common\winnt\clusutil.cpp(4731): DsGetResourceInfo():
  Inserting disk  into list...
  11/13/2018 15:45:10.395 [011088] [3816] :
  ..\..\common\winnt\clusutil.cpp(4790): DsGetResourceInfo():
  Exit.
  
  
  This happens when the Spectrum Protect Agent fails to identify
  drive letter or mount point for a disk volume. In this case
  DATA1 disk has assigned drive letter E: while LOG1 disk has none
  since it is used for the Microsoft Storage Replica log volume.
  
  
  Spectrum Protect Versions Affected:
  Spectrum Protect client all versions on Windows platform
  
  
  Initial Impact:
  Low
  
  
  Additional Keywords:
  Spectrum Protect; Cluster Protection Wizard; GUI; Next; cluster
  options file; isDriveValid; dsGetClusterGroups;
  DsGetResourceInfo; TS001490757
  

Local fix

• Temporarily assign a drive letter to the cluster disk volumes
  which have none
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Backup-Archive client versions 7.1.6,   *
  * 7.1.8, 8.1.0, 8.1.2, 8.1.4, 8.1.6 and 8.1.7 on Windows       *
  * Server platform.                                             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * client                                                       *
  * version 8.1.8 on all Microsoft Windows x64 platforms.        *
  * Note this is subject to change at the discretion of IBM.     *
  ****************************************************************
  

Problem conclusion

• Spectrum Protect GUI wizard has been modified to handle a
  cluster group with disk without drive letter.
  

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:

Modules/Macros

• DSM
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels