IT05777: BACKUP VM DOES NOT PROCESS INCLUDE.VMDISK/EXCLUDE.VMDISK STATEMENTS WHEN THE VM NAME CONTAINS WILD CARD CHARACTERS

IBM Tivoli Storage Manager (TSM) Client 7.1.2 Downloads and READMEs
IBM Tivoli Storage Manager Client 6.4.3 Downloads and READMEs

APAR status

• Closed as program error.

Error description

• Using wild card characters such as ? and  * on the 'backup vm'
  command will result in INCLUDE.VMDISK/EXCLUDE.VMDISK statements
  not being honored.
  For example, client option to include hard disk 1 is coded in
  the option file, this should include only hard disk 1 for backup
  processing.
  INCLUDE.VMDISK COPPER-vCenter-5.5-appliance "Hard disk 1"
  Running the Backup Vm command without a wild card character in
  the vm name gives the expected result, hard disk 1 is included,
  hard disk 2 is excluded.
  1:57:51 PM: tsm> ba vm "COPPER-vCenter-5.5-appliance" -preview
  Virtual machine: 'COPPER-vCenter-5.5-appliance' disk: 'Hard disk
  1' is included by user.
    1. vmName: COPPER-vCenter-5.5-appliance
         DomainKeyword:  vm=COPPER-vCenter-5.5-appliance
         toolsRunningStatus: guestToolsRunning
  toolsVersionStatus: guestToolsUnmanaged
         consolidationNeeded: No
         VMDK[1]Label:   'Hard disk 1' (Hard Disk 1)
         VMDK[1]Name:    '[SSD:Raid-5]
  COPPER-vCenter-5.5-appliance/COPPER-vCenter-5.5-appliance.vmdk'
         VMDK[1]Status:  Included
         VMDK[2]Label:   'Hard disk 2' (Hard Disk 2)
         VMDK[2]Name:    '[SSD:Raid-5]
  COPPER-vCenter-5.5-appliance/COPPER-vCenter-5.5-appliance_1.vmdk
  '
         VMDK[2]Status:  Excluded - User
  Running the Backup Vm command with a wild card character in the
  vm name gives an unexpected result, all disks are included.
  tsm> ba vm "COPPER-vCenter-5.5-*" -preview
    1. vmName: COPPER-vCenter-5.5-appliance
         DomainKeyword:  vm=COPPER-vCenter-5.5-*
         toolsRunningStatus: guestToolsRunning
  toolsVersionStatus: guestToolsUnmanaged
         consolidationNeeded: No
         VMDK[1]Label:   'Hard disk 1' (Hard Disk 1)
         VMDK[1]Name:    '[SSD:Raid-5]
  COPPER-vCenter-5.5-appliance/COPPER-vCenter-5.5-appliance.vmdk'
         VMDK[1]Status:  Included
         VMDK[2]Label:   'Hard disk 2' (Hard Disk 2)
         VMDK[2]Name:    '[SSD:Raid-5]
  COPPER-vCenter-5.5-appliance/COPPER-vCenter-5.5-appliance_1.vmdk
  '
         VMDK[2]Status:  Included
  Tivoli Storage Manager Versions Affected:
  
  Additional Keywords: wildcard honor
  

Local fix

• Do not use wild card characters in the vm name on the Backup VM
  command.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Tivoli Storage Manager for Virtual Environments versions 6.4 *
  * and 7.1 running on all Microsoft Windows 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 and Linux x86_64  in levels 6.4.3  *
  * and 7.1.2                                                    *
  * 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

• The problem has been fixed and no longer occurs.
  

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:

Modules/Macros

• dsmagent
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R71W PSY

     UP

• R71L PSY

     UP

• R64W PSY

     UP

• R64L PSY

     UP