IBM Support

IT05597: ANS9365E AND API MESSAGE "A SPECIFIED PARAMETER WAS NOT CORRECT"ABOUT EXTRA KEY "GUESTINFO.VF.WS.CLIENTLICENSESTATE"

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • During the restore of a VMware virtual machine, the restore
    might display the following message:
    
    ANS9365E VMware vStorage API error for virtual machine 'vmname'.
       TSM function name : CreateVM_USCORETask
       TSM file          : vmvisdk.cpp (5259)
       API return code   : 57
       API error message : A specified parameter was not correct.
    config.extraConfig["guestinfo.vf.ws.clientLicenseState"]
    
    and will be unsuccessful if the client version is lower than
    6.4.2.0.
    If the client version is above 6.4.2.0, the restore continues
    resulting in a target VM guest with minimal configuration
    settings.
    This means the configuration of the VM guest will have to be
    edited to match the previous settings (assigned memory amount,
    network settings, etc.) or adapted to the current needs.
    
    Tivoli Storage Manager Versions Affected:
    Tivoli Storage Manager clients 6.3, 6.4 and 7.1 on Windows and
    Linux.
    
    | MDVPARTL 6.4.2.0-TIV_5698MCL | (IC96734)
    
    Initial Impact: Medium
    
    Additional Keywords: IC96734 restore VM CreateVM_USCORETask
    ANS4177E
    

Local fix

  • For clients at a version lower than 6.4.2.0, a restore to the
    minimal configuration can be forced by adding the following line
    in the dsm.opt file of the datamover node :
    testflag VMRESTORE_MIN_CONFIG
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Tivoli Storage Manager for Virtual Environments: Data        *
    * Protection for VMware versions 6.3, 6.4, 7.1 on Microsoft    *
    * Windows and Linux x86_64 platforms.                          *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This issue is projected   *
    * to be fixed in the Tivoli Storage Manager Client on          *
    * Microsoft Windows and Linux x86_64 platforms in versions     *
    * 6.4.3 and 7.1.2.                                             *
    *                                                              *
    * Note 1: The Tivoli Storage Manager (TSM) Client is a         *
    * prerequisite to using the Data Protection for VMware.        *
    * In Data Protection for VMware environments, the TSM Client   *
    * is also known as the data mover.                             *
    * Until a Data Protection for VMware packaged fix of a fixing  *
    * TSM Client level is available,                               *
    * Data Protection for VMware customers can install and use a   *
    * fixed level of the the TSM Client in their environment.      *
    *                                                              *
    * Note 2: This is subject to change at the discretion of IBM.  *
    ****************************************************************
    

Problem conclusion

  • The problem has been fixed and no longer occurs.
    

Temporary fix

  • A fix for this problem is currently targeted for Tivoli Storage
    Manager Client on Windows for interim fix package 6.3.2.4
    
    Note1: Until a Data Protection for VMware packaged fix of a
    fixing Tivoli Storage Manager Client level is available, Data
    Protection for VMware customers can install an use a fixed level
    of the the Tivoli Storage Manager Client in their environment.
    
    Note 2: This is subject to change at the discretion of IBM.
    

Comments

APAR Information

  • APAR number

    IT05597

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-11-19

  • Closed date

    2015-01-29

  • Last modified date

    2015-11-10

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

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

Modules/Macros

  • dsmagent
    

Fix information

  • Fixed component name

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels

  • R71W PSY

       UP

  • R71L PSY

       UP

  • R64W PSY

       UP

  • R64L PSY

       UP

  • R63W PSY

       UP

  • R63L 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:
10 January 2022