IBM Support

IT19117: BACKUP VM FAILS WITH ANS2888E AND ANS0400E.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • BACKUP VM fails with ANS2888E and ANS0400E below, although the
    license file tdp4vmw.lic is correctly located in the product
    directory.
    
    ===========================
    ANS2888E Backup VM Full VM Incremental is unable to run. A valid
    TSM for Virtual Environments license file (tdp4vmw.lic) cannot
    be located.
    ANS0400E License file could not be opened.
    ===========================
    
    This problem is not reproductive and is intermittent.  Due to a
    race condition between multiple threads, Tivoli Storage Manager
    Client incorrectly fails to detect license file.
    
    When this problem occurs, the failure of detecting license file
    can be logged in the Tivoli Storage Manager Client trace, as
    below.
    
    ===========================
    yyyy-mm-dd hh:mm:ss.mmm [pppppp] [ttttt] :
    ..\..\common\license\oemLayer.cpp(1561): =========> Entering
    checkRC()
    yyyy-mm-dd hh:mm:ss.mmm [pppppp] [ttttt] :
    ..\..\common\license\oemLayer.cpp(1590): checkVMLic():
    check_license() failed - file 'C:\Program
    Files\Tivoli\TSM\TDPVMware\tdp4vmw.lic'. rc = -1.
    yyyy-mm-dd hh:mm:ss.mmm [pppppp] [ttttt] :
    ..\..\common\license\oemLayer.cpp(1654): =========> checkRC():
    Exiting, rc = 2400
    ......
    yyyy-mm-dd hh:mm:ss.mmm [pppppp] [ttttt] :
    ..\..\common\vm\vmbackcommon.cpp(4558): ANS2888E Backup VM Full
    VM Incremental is unable to run.
    A valid TSM for Virtual Environments license file (tdp4vmw.lic)
    cannot be located.
    ===========================
    
    This issue is the same symptom as the following APARs that were
    fixed in 7.1.2, but still occurs with 7.1.6.
    IT04554: 7.1.1 VM BACKUP FAILS WITH ANS0400E LICENSE FILE COULD
    NOT BE OPENED.
    IT04723: 7.1.1 VM BACKUP FAILS WITH ANS0400E LICENSE FILE COULD
    NOT BE OPENED.
    
    | MDVPARTL 7.1.2-TIV-5698ISMCL |
    
    Tivoli Storage Manager Versions affected:
    Tivoli Storage Manager Client 6.3.0 or higher level on Windows
    and Linux platform.
    IBM Spectrum Protect Client 7.1.3 or higher level on Windows and
    Linux platform.
    
    
    Products affected:
    IBM Spectrum Protect Backup-Archive Client version
    6.3, 6.4, and 7.1 on Linux and Windows
    Note: The Backup-Archive Client is a prerequisite to using the
    Data Protection for VMware. In Data Protection for VMware
    environments, the Backup-Archive Client is also known as the
    data mover.
    
    This problem also affects IBM Spectrum Protect for Virtual
    Environments: Data Protection for VMware 8.1.0. If you are using
    Data Protection for VMware 8.1.0, refer to APAR IT19848.
    
    Initial Impact:
    Middle
    

Local fix

  • Reduce the vmmaxparallel value.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * IBM Spectrum Protect for Virtual Environments Data           *
    * Protection for VMware versions 6.3, 6.4, 7.1 and 8.1.0       *
    * running on all Microsoft Windows x64 and Linux x86           *
    * platforms.                                                   *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * This issue is projected to be fixed in the Backup-Archive    *
    * Client version 7.1.8 on all Microsoft Windows x64 and Linux  *
    * x86 platforms                                                *
    * Note 1: The Backup-Archive Client is a prerequisite to using *
    * the Data Protection for VMware. In Data Protection for       *
    * VMware environments, the Backup-Archive Client is also known *
    * as the data mover.                                           *
    * Note 2: This is subject to change at the discretion of IBM.  *
    ****************************************************************
    

Problem conclusion

  • License detection was improved.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT19117

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-02-14

  • Closed date

    2017-03-30

  • Last modified date

    2017-03-30

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

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

    IT19848

Modules/Macros

  • dsmagent
    

Fix information

  • Fixed component name

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels

  • R71W PSY

       UP

  • R71L PSY

       UP

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"71W","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
07 January 2022