IT32867: SPECTRUM PROTECT FOR VIRTUAL ENVIRONMENTS FOR HYPER-V INCORRECTLY INITIATES THE CONFIGURATION WIZARD

APAR status

• Closed as program error.

Error description

• After upgrading the IBM Spectrum Protect for Virtual
  Environments - Data Protection for Hyper-V application to
  8.1.6.x or higher, starting the user interface will initiate the
   configuration wizard.  This is incorrect behavior for an
  existing configuration.  This behavior will happen every time
  the user interface is started, even after going through the
  wizard.  This behavior of running the wizard multiple times
  results in additional configurations which are unnecessary.
  
  To diagnose this issue, review of the messages.log will show the
  following during the user interface initiation:
  
  [Date/Time Stamp] 000804ab SystemOut    O Exception caught in
  inquireConfig()
  [Date/Time Stamp] 000804ab SystemErr    R
  java.util.NoSuchElementException
  [Date/Time Stamp] 000804ab SystemErr    R  at
  java.util.StringTokenizer.nextToken(StringTokenizer.java:360)
  [Date/Time Stamp] 000804ab SystemErr    R  at
  com.ibm.flr.java.api.config.ConfigUtils.validateDsmOptFile(Confi
  gUtils.java:2676)
  [Date/Time Stamp] 000804ab SystemErr    R  at
  com.ibm.flr.java.api.config.ConfigUtils.isNodeConfigured(ConfigU
  tils.java:453)
  [Date/Time Stamp] 000804ab SystemErr    R  at
  com.ibm.flr.java.api.ConfigJavaApiDSM.inquireConfig(ConfigJavaAp
  iDSM.java:382)
  [Date/Time Stamp] 000804ab SystemErr    R  at
  com.ibm.flr.java.api.ConfigJavaApi.inquireConfig(ConfigJavaApi.j
  ava:135)
  [Date/Time Stamp] 000804ab SystemErr    R  at
  com.ibm.flr.rest.api.ConfigResource.getConfig(ConfigResource.jav
  a:164)
  
  When tracing is enabled, the TraceFm.trc will show the
  following:
  
  Fm Information: 0 : [Date/Time Stamp]    [3] : (0) Return JSON
  string: {"statusRC":-1,"statusMessage":"The action cannot be
  completed. If the problem persists, contact your
  administrator.",
  "showSupportInfo":true,"isFullyConfigured":false,"configuredBitm
  ap":0,"SPServerName":"server_name","SPServerVRMF":"8.1.8.0","SPS
  erverPlatform":"Linux/x86_64","SPServerPort":"1500","configuredP
  ort":"","SPServerSSLPort":"1542","SPAdmin":"admin","policyDomain
  ":"policy_domain","FRDomainUser":"","nodesList":[{"nodeName":"HV
  _DM","nodeType":"DMNODE"},{"nodeName":"HV_MP_WIN","nodeType":"MP
  NODE"},{"nodeName":"HV_MP_LNX","nodeType":"MPNODE"}],"nodePrefix
  ":"","nodeSuffix":"","agentRC":0,"agentError":"","errorLogLocati
  onWin":"","computerNameWin":"","platformWin":""}
  Fm Information: 0 : [Date/Time Stamp]    [3] : (0) Return JSON
  string: Fm.RestApiHyperVAgent.RestApiInquireConfigInfoResp
  Fm Information: 0 : [Date/Time Stamp]    [3] : (0) Exit
  GetInquireConfigAsync()
  Fm Information: 0 : [Date/Time Stamp]    [3] : (0) API-TIME:
  QCVM8 - GetInquireConfigInfoEx - 00:00:02.7880264
  Fm Information: 0 : [Date/Time Stamp]    [3] : (0) API-EXIT:
  GetInquireConfigInfoEx
  Fm Error:      -1 : [Date/Time Stamp]    [3] : (0) DMnode
  InquireConfig Error: The action cannot be completed. If the
  problem persists, contact your administrator.
  Fm Error:      -1 : [Date/Time Stamp]    [3] : (0) DMnode
  InquireConfig Error: The action cannot be completed. If the
  problem persists, contact your administrator.
  Fm Error:      -1 : [Date/Time Stamp]    [3] : (0) DMnode
  InquireConfig Error: The action cannot be completed. If the
  problem persists, contact your administrator.
  Fm Information: 0 : [Date/Time Stamp]    [3] : (0) Return Void
  MoveNext()
  Fm Information: 0 : [Date/Time Stamp]    [3] : (0) API-EVENT:
  Determined that the configuration wizard must be run, launching
  wizard
  
  The configuration error exception happens when the Web Server
  tries to validate the datamover option file that is used by the
  Client Acceptor Daemon (CAD) service, and the option file
  contains a string of unexpected characters; for example, either
  "*=============================" or "***********"
  
  Affected versions:
  
  IBM Spectrum Protect for Virtual Environments - Data Protection
  for Hyper-V 8.1 on all supported Microsoft Windows platforms.
  MDVREGR |8.1.6.0-TIV_5725TVEHV
  
  Initial Impact: Medium
  
  Additional Keywords: TS002562293 tsm tdp MMC launch
  

Local fix

• Review the contents of the datamover option files.  Look for
  strings of characters which would be unexpected, such as noted
  in the problem description. Remove the string of unexpected
  characters from the option file and restart the services.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Spectrum Protect for Virtual Environments Data Protection    *
  * for Microsoft Hyper-V versions 7.1.8, 8.1.2, 8.1.4, 8.1.6,   *
  * 8.1.7, 8.1.8, 8.1.9 and 8.1.10 running on                    *
  * - Windows Server 2012 R2;                                    *
  * - Windows Server 2016;                                       *
  * - Windows Server 2019;                                       *
  * - Windows 10.                                                *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Data Protection   *
  * for Microsoft Hyper-V 8.1.11 version on Windows platform.    *
  ****************************************************************
  

Problem conclusion

• Data Protection for Hyper-V failed to process option file that
  contains one-word comment or option without value. The
  corresponding subroutine has been modified to correctly handle
  the mentioned lines in the option file.
  

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

• DPHV.MSC
  

Fix information

• Fixed component name

  TSM VE DP MS HY

• Fixed component ID

  5725TVEHV

Applicable component levels