IT19453: VIRTUAL MACHINE BACKUPS FAIL WITH ANS9372E

IBM Spectrum Protectâ„¢ Client 7.1.8 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• During the Spectrum Protect for Virtual Environments backup a VM
  or VM's incorrectly report the backup failed with the message
  "ANS9372E Unable to create the virtual machine to be restored
  due to an invalid host name, datacenter name, or datastore
  name."
  
  Customer/L2 Diagnostics:
  A trace with the VM flag will show that the attempt to match the
  datastore name of the VM with one in the VMware environment will
  fail. It will also show an invalid character in the name being
  evaluated.
  
  02/16/2017 06:38:15.252 [005496] [20628] :
  ..\..\common\vm\visdkdevices.cpp(9608): visdkFindVMDatastore:
  comparing to datastore 'VM-DATASTORE-ARRAY1-lun1 ? TEST'.
  . . .
  02/16/2017 06:38:15.252 [005496] [20628] :
  ..\..\common\vm\vmbackvddk.cpp(5374):
  vmCheckDatastoreThreshold(): datastore 'VM-DATASTORE-ARRAY1-lun1
  ? TEST' not found.
  
  In this case the character is showing as a ? , it may also show
  up as a square or other unexpected character.
  
  The output from the client command, show vm all , will show that
  the datastore associated with the VM has an invalid character as
  well.
  
   resourcePool:   Resources
         VMDK[1]Label:   'Hard disk 1' (Hard Disk 1)
         VMDK[1]Name:    '[VM-DATASTORE-ARRAY1-lun1 â?? TEST]
  TEST123/TEST123-000001.vmdk'
         VMDK[1]Status:  Included
  
  
  Products affected:
  IBM Spectrum Protect Backup-Archive Client version
  7.1.4, 7.1.6 on Linux and Windows
  Note: The Backup-Archive Client is a prerequisite to using the
  Data Protection for VMware. In Data Protection for VMware
  environments, the Backup-Archive Client is also known as the
  data mover.
  
  This problem also affects IBM Spectrum Protect for Virtual
  Environments: Data Protection for VMware 8.1.0. If you are using
  Data Protection for VMware 8.1.0, refer to APAR IT19849.
  
  Initial Impact: (high/med/low)
  low
  
  Additional Keywords:
  TSMVE VE SP failure error
  

Local fix

• Rename the datastore to use valid characters only and rerun the
  backup.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect for Virtual Environments Data           *
  * Protection for VMware versions 7.1.4, 7.1.6 and 8.1.0        *
  * running on all Microsoft Windows x64 and Linux x86           *
  * platforms.                                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * This issue is projected to be fixed in the Backup-Archive    *
  * Client version 7.1.8 on all Microsoft Windows x64 and Linux  *
  * x86 platforms                                                *
  * Note 1: The Backup-Archive Client is a prerequisite to using *
  * the Data Protection for VMware. In Data Protection for       *
  * VMware environments, the Backup-Archive Client is also known *
  * as the data mover.                                           *
  * Note 2: This is subject to change at the discretion of IBM.  *
  ****************************************************************
  

Problem conclusion

• Correct message is now displayed.
  

Temporary fix

Comments

APAR Information

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

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

  IT19849

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R81W PSY

     UP

• R81L PSY

     UP