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 number
IT32867
Reported component name
TSM VE DP MS HY
Reported component ID
5725TVEHV
Reported release
81W
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2020-05-25
Closed date
2020-08-06
Last modified date
2020-08-06
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
[{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SS8TDQ","label":"Tivoli Storage Manager for Virtual Environments"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"81W"}]
Document Information
Modified date:
14 February 2021