IBM Support

IT14157: ANS4066W NOT GENERATING A RC=8 ON VM BACKUP STATISTICS REPORT

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The backup of a VMware guest will display a rc=0 for the
    individual guest backup completion code instead of the expected
     rc=8 when the following happens :
    
    1. A VMware snapshot operation with file system quiescing fails
    as follows :
    
    ANS9365E VMware vStorage API error for virtual machine
    'vmname'.
      TSM function name : CreateSnapshot_USCORETask
      TSM file : ..\..\common\vm\vmvisdk.cpp (6365)
      API return code : 1390
      API error message : An error occurred while saving the
    snapshot: Failed to quiesce the virtual machine.
    ANS4066W Snapshot operation attempt x of y for the guest
    virtual machine 'vmname' failed using "VMware Tools" snapshot.
    Reattempting snapshot with "VMware Tools" snapshot.
    
    where x and y are specified in the data mover client option
    file with the option :
    INCLUDE.VMSNAPSHOTATTEMPTS '*' or <vmname> x y
    
    2. The guest backup ultimately can be processed successfully on
    the subsequent VMware snapshot attempts.
    
    In case the VM backup is scheduled, the schedule completion
    code will be rc=8.
    
    In the IBM Tivoli Storage Manager for Virtual Environment -
    Data Protection for VMware Web GUI, the above scenario will
    cause the schedule to display a warning while the 'show all
    VMs' report all individual guests backups as completed without
    error.
    
    Tivoli Storage Manager Versions Affected:
    IBM Tivoli Storage Manager client version 7.1.2 and higher on
    Windows and Linux
    
    Initial Impact: Medium
    
    Additional Keywords: tsm spectrum protect report statistics
    discrepancy rc=0 rc=8 yellow triangle green
    

Local fix

  • The following rule in the client option file can be used to
    avoid the ANS4066W message that triggers the rc=8 schedule
    completion code :
    INCLUDE.VMSNAPSHOTATTEMPTS <vmname> 0 y
    where 'y' is the number of attempts allowed to try a VMware
    snapshot without filesystem quiescing.
    The user must be aware that performing VMware snapshots without
    filesystem quiescing results in a crash consistent snapshot as
    compared to an application aware snapshot when a file system
    quiescing VMware snapshot can be completed.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Tivoli Storage Manager for Virtual Environments Data         *
    * Protection for VMware versions 7.1.2, 7.1.3 and 7.1.4        *
    * running on all Microsoft Windows x64 and Linux x86_64        *
    * platforms                                                    *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * This issue is projected to be fixed in the Tivoli Storage    *
    * Manager Client on Windows x64 and Linux x86_64  in level     *
    * 7.1.6                                                        *
    * 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.                                *
    * Note 2: This is subject to change at the discretion of IBM.  *
    ****************************************************************
    

Problem conclusion

  • When a snapshot retry occurs for vm and snapshot type is
    changed, e.g. from vss enabled to vss disabled, the schedule
    task status is set to Warning and VM status is set to failed
    with snapshot retry rc code.
    If snapshot type is not changed the status of schedule task and
    vm is set to successful.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT14157

  • Reported component name

    TSM FOR VE DP V

  • Reported component ID

    5725TVEVM

  • Reported release

    71W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-03-07

  • Closed date

    2016-04-07

  • Last modified date

    2016-04-07

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

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

Modules/Macros

  • dsm      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:
11 January 2022