IT41321: AFTER RECOMMISSION OF A DECOMMISSIONED VM BACKUP NODE, A VM RESTORE ENDS WITH A SUCCESS STATUS, BUT 0 BYTES ARE TRANSFERRED

APAR status

• Closed as program error.

Error description

• The "recommission node" command is introduced since IBM
  Spectrum Protect Server v8.1.10, it resets the status of a node
  that was previously decommissioned from the production
  environment. If an IBM Spectrum Protect Data Protection for
  VMware backup node is decommissioned and later
  recommissioned, VM restore operations end without error,
  but 0 bytes are transferred. The restored VM is not usable.
  
  
  Example of ending statistics:
  --------------------
  Successful full restore of VMware virtual machine '<VM_NAME>',
  mode='Full', target node name='<NODE_NAME>', data mover node
  name='<DATA_MOVER_NAME>'
  
  Total number of objects restored:       1
  Total number of objects failed:            0
  Total number of bytes transferred:     0 B
  Data transfer time:                                 0.00 sec
  Network data transfer rate:                  0.00 KB/sec
  Aggregate data transfer rate:               0.00 KB/sec
  Elapsed processing time:                       0:00:25
  --------------------
  Diagnostics:
  A data mover trace using "TRACEFLAGS VM" indicates that no CTL
  files are found. See the last message in the following example
  trace snippet:
  --------------------
  ..\..\common\vm\vmrestvddk.cpp(4978): LegacyRestoreDisk(): CDF ?
  
   looking for CTL file(s)
  ..\..\common\vm\vmrestvddk.cpp(4987): LegacyRestoreDisk(): Query
  
   for \<VMFULL-VM_NAME>\<VM_NAME>\SNAPSHOT_001000000
   20180113180143\Hard Disk 2\*\*.CTL
  ..\..\common\vm\vmquery.cpp(1408): vmVddkQueryVM():
   fs=\<VMFULL-VM_NAME>,
  
   hl=\<VM_NAME>\SNAPSHOT_001000000_20180113180143\Hard Disk 2\*,
   ll=\*.CTL, objState=1
  ..\..\common\vm\vmAPISendData.cpp(1743):  vmAPISend
  Data::beginQuery(): Performing backup query.
  ..\..\common\vm\vmAPISendData.cpp(2005):  vmAPISend
  Data::getNextQueryResp(): No matches - finished.
  ..\..\common\vm\vmquery.cpp(1563): vmVddkQueryVM():
   getNextQueryResp() returned rc = 2
  ..\..\common\vm\vmrestvddk.cpp(5009): LegacyRestoreDisk(): No
  CTL
   Files found. Quietly returning.
  --------------------
  
  The BACKUPS table on the IBM Spectrum Protect server shows that
  
  backup objects exist, including .CTL files. All objects are
  inactive versions. For example:
  
  # select * from backups where node_name='<DATA_MOVER_NAME>' and
  
  filespace_name='\<VMFULL-VM_NAME>'
  --------------------          NODE_NAME: <DATA_MOVER_NAME>
    FILESPACE_NAME: \<VMFULL-VM_NAME>
          FILESPACE_ID: 1
                        STATE: INACTIVE_VERSION
                          TYPE: FILE
                 HL_NAME: \<VM_NAME>\SNAPSHOT_001000000
                                     20180113180143\
                 LL_NAME: <VM_NAME>.ovf
               OBJECT_ID: 959430972
        BACKUP_DATE: 2018-01-13 18:02:05.000000
  DEACTIVATE_DATE: 2020-12-01 09:19:52.000000
                    OWNER:
          CLASS_NAME: <CLASS_NAME>
          ACTUAL_SIZE:
  ------         NODE_NAME: <DATA_MOVER_NAME>
   FILESPACE_NAME: \<VMFULL-VM_NAME>
         FILESPACE_ID: 1
                       STATE: INACTIVE_VERSION
                         TYPE: FILE
                HL_NAME: \<VM_NAME>\SNAPSHOT_001000000
                                   20180113180143\Hard Disk
  2\JOB001000002\
                 LL_NAME: MBLK0000.CTL
              OBJECT_ID: 959534766
        BACKUP_DATE: 2018-01-13 18:07:59.000000
  DEACTIVATE_DATE: 2020-12-01 09:19:52.000000
                   OWNER:
  
          CLASS_NAME: <CLASS_NAME>
          ACTUAL_SIZE:
  --------------------
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Data Protection for VMware level 8.1 on Linux x86 and        *
  * Windows x64 platforms                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the fixing level when available. This problem is       *
  * currently projected to be fixed in IBM Spectrum Protect Data *
  * Protection for VMware level 8.1.17 Note that this is subject *
  * to change at the discretion of IBM.                          *
  ****************************************************************
  

Problem conclusion

• Query is updated to get data for decomissioned node
  

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:

Fix information

• Fixed component name

  TSM FOR VE DP V

• Fixed component ID

  5725TVEVM

Applicable component levels