IBM Support

IC96114: ANS9365E ERROR ON BACKUP VM AND RESTORE VM

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as Vendor Solution.

Error description

  • A VMware Virtual Disk Development Kit known issue about using
    UTF-16 characters in the path name of the temporary directory
    location, can cause permission failures for any client operation
    requiring a connection to the VMware environment.
    
    The detail of the defect can be consulted in the Virtual Disk
    Development Kit version 5.1.0 release notes :
    http://www.vmware.com/support/developer/vddk/VDDK-510-ReleaseNot
    es.html
    
    In the "Known Issues and Workarounds" section :
    
    Problem using UTF-16 characters in a pathname.
    
    "VDDK supports only UTF-8 locales. When VixDiskLib_Open() is
    given a pathname containing UTF-16 characters, the virtual disk
    library fails to find the file. On Windows 2008 for example, the
    pathname Temp\vmware-systハme\*vm* contains ハ as a UTF-16
    character, whereas VixDiskLib expects UTF-8. One workaround is
    to override the Temp pathname in the configuration file by
    setting the tmpDirectory key, using a non-UTF-16 pathname. For
    details, see documentation for VixDiskLib_InitEx().
    Alternatively, software can be modified to use library routines
    such as iconv() for transcoding UTF-16 to UTF-8 and vice versa."
    
    Most commonly the following error will be seen when using the
    'BACKUP VM' and 'RESTORE VM' commands :
    
    ANS9365E VMware vStorage API error for virtual machine 'vmname'.
       TSM function name : VixDiskLib_Open
       TSM file          : vmvddksdk.cpp (1764)
       API return code   : 13
       API error message : You do not have access rights to this
                           file
    
    Tivoli Storage Manager Versions Affected:
    Tivoli Storage Manager Client 6.3 and 6.4 on Windows or Linux
    
    Initial Impact: Medium
    
    Additional Keywords: zztsm vmware permission backup VM vddk
    

Local fix

  • Locate the dsmvddk.opt file in the client installation directory
    C:\Program files\Tivoli\TSM\baclient
    and add the following line to specify a temporary directory with
    only ASCII characters in its path specification :
    
    tmpDirectory = "<temp dir path>"
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Backup-archive client versions 6.2, 6.3      *
    *                 and 6.4 running on all Microsoft Windows     *
    *                 and Linux platforms.                         *
    *                                                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: See ERROR DESCRIPTION                   *
    *                                                              *
    ****************************************************************
    * RECOMMENDATION: Apply fixing level when available. This      *
    *                 problem is currently projected to be fixed   *
    *                 in levels 6.3.2 and 6.4.2. Note that until   *
    *                 the fixing levels are available, this        *
    *                 information is subject to change at the      *
    *                 discretion of IBM.                           *
    ****************************************************************
    

Problem conclusion

  • tmpDirectory option was added to dsmvddk.opt to specify the
    correct directory. The option is commented out by default, so
    if an issue occurs, uncomment it and modify according to
    environment, e.g. for Windows
    
    tmpDirectory = C:\mnt\vmwaretmp
    
    for Linux
    
    tmpDirectory = /mnt/vmwaretmp
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC96114

  • Reported component name

    TSM FOR VE DP V

  • Reported component ID

    5725TVEVM

  • Reported release

    64W

  • Status

    CLOSED ISV

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-09-20

  • Closed date

    2013-12-11

  • Last modified date

    2013-12-11

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

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

Modules/Macros

  • DSM
    

Fix information

  • Fixed component name

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels



Document information

More support for: Tivoli Storage Manager

Software version: 64W

Reference #: IC96114

Modified date: 11 December 2013