IBM Support

IC96503: RESTORE VM CAN FAIL WITH 'INVALID DATASTORE PATH' WHEN PATH HAS EXACTLY 10 CHARACTERS AFTERTHE UNDERSCORE.

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Restoring a VM to the original location or an alternate
    datastore can fail with:
    ANS9365E VMware vStorage API error for virtual machine 'IBMVM1'.
       TSM function name : visdkCreateVM
       TSM file          : vmvisdk.cpp (4902)
       API return code   : 67
       API error message : Invalid datastore path
    '[XIV_1234_TIVOLI]'.
    ANS5250E An unexpected error was encountered.
       TSM function name : vmCreateNewVmMachine
       TSM function      : Can not create virtual machine
       TSM return code   : 4389
       TSM file          : ..\..\common\vm\vmcommonrestvddk.cpp
    (826)
    ANS9404E Error creating the specified Virtual Machine. See log
    files for more information.
    ANS4177E Full VM restore of VMware Virtual Machine 'IBMVM1'
    failed with RC=4389 target node name='IBM', data mover node
    name='IBM_DM'
    In this example the datastore "XIV_1234_TIVOLI" is not the
    actual datastore name. The datastore name is
    "XIV_1234_TIVOLI_DATASTORE1"
    The name is being truncated during the restore.
    Recreate:
    1) Create a Vmware datastore name such as
    "XIV_1234_TIVOLI_DATASTORE1"
    Note: To recreate this issue the datastore name must have only
    10 characters after the last underscore.
    2) Backup the VM.
    3) Restore the VM to original location.
    This will fail with the above error.
    Examples of datastore names that will exhibit this problem:
    TIVOLI_DATASTORE1
    IBM_TIVOLI_DATASTORE1
    Examples of datastore names that WILL NOT exhibit this problem:
    IBM_TIVOLI_DATASTORE01
    IBM_DATASTORE1_TIVOLI
    IBM_TIVOLI_DATASTORE_01
    Initial impact: Medium
    Platforms affected: Windows/Linux
    Additional keywords: FCM
    

Local fix

  • 1 - Restore the VM to a datastore that does not contain 10
    characters after the last underscore "_".
    2 - Rename an existing datastore so that it does not contain 10
    characters after the last underscore.
    

Problem summary

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

Problem conclusion

  • The problem has been fixed so that it no longer occurs
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC96503

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    64W

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-09-30

  • Closed date

    2013-11-11

  • Last modified date

    2013-11-11

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

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

Modules/Macros

  • DSMC
    

Fix information

  • Fixed component name

    TSM CLIENT

  • Fixed component ID

    5698ISMCL

Applicable component levels

  • R64L PSY

       UP

  • R64W PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 64W

Reference #: IC96503

Modified date: 11 November 2013