IBM Support

The 'backup vm' command fails with ANS9365E API return code 18000 and 26.

Technote (troubleshooting)


Problem(Abstract)

The 'backup vm' commands fails and two ANS9365E messages are logged in dsmerror.log file. One ANS9365E is logged with API Return Code 18000, and another ANS9365E is logged with API return code 26.

Symptom

The 'backup vm' commands fails and two ANS9365E messages are logged in dsmerror.log file, as below:


    mm/dd/yyyy hh:mm:ss ANS1711W Incremental backup selected for '<VM name>', but a Full backup has not yet been performed. Performing a Full backup instead.
    mm/dd/yyyy hh:mm:ss ANS9365E VMware vStorage API error for virtual machine '<VM name>'.
       TSM function name : VixDiskLib_Open
       TSM file          : vmvddksdk.cpp (1764)
       API return code   : 18000
       API error message : Cannot connect to the host
    mm/dd/yyyy hh:mm:ss ANS1228E Sending of object '<VM name>' failed.
    mm/dd/yyyy hh:mm:ss ANS1026E The session is rejected: There was a communications protocol error.

    mm/dd/yyyy hh:mm:ss ANS9365E VMware vStorage API error for virtual machine '<VM name>'.
       TSM function name : VixDiskLib_Cleanup
       TSM file          : vmvddksdk.cpp (1714)
       API return code   : 26
       API error message : Unable to connect to the host

Cause

SSL verification for VDDK has been enabled, but it isn't set up correctly.


Diagnosing the problem

TSM Client trace shows that the SSL verification is enabled but it isn't set up correctly. as below.

    mm/dd/yyyy hh:mm:ss .mmm [005508] [788] : vmvddksdk.cpp       (1291): VixDiskLibVim: VixDiskLibIsVerifyEnabledWin SSL certificate verification is enabled.
    mm/dd/yyyy hh:mm:ss.mmm [005508] [788] : vmvddksdk.cpp       (1291): VixDiskLibVim: VixDiskLibVimAllocCbData SSL certificate verification is enabled, but the thumbprint is missing or too short.

Resolving the problem

SSL verification in VDDK in registry should be disabled, as below.

    1. Open a registry editor
    2. Go to the following registry path
    • For 32-bit Windows systems use
      HKEY_LOCAL_MACHINE\SOFTWARE\VMware, Inc.\VMware Virtual Disk Development Kit
    • For 64-bit Windows systems use
      HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\VMware, Inc.\VMware Virtual Disk Development Kit
    3. Modify the registry key as below:
      VerifySSLCertificates = 0

Related information

Virtual Disk Transport Methods

Historical Number

14154

Document information

More support for: Tivoli Storage Manager

Software version: All Supported Versions

Operating system(s): Windows

Reference #: 1970509

Modified date: 05 December 2016


Translate this page: