IT37553: "CTGGA2268 FAILED TO INDEX FILES" FOR EXCLUDED DISKS EVEN WHEN DISK.ENABLEUUID PROPERTY IS ENABLED IN THE VM OPTIONS

APAR status

• Closed as program error.

Error description

• A File indexing warning for excluded guest file systems with
  IBM Spectrum protect Plus can be seen in the following job log
  example :
  
  SUMMARY,<timestamp>CTGGA2399,Starting job for policy BACKUP
                     with job name <SLAName> (ID:<SLAId>). id ->
                     <JobId>. IBM Spectrum Protect Plus version
                     10.1.7-3102.
  ...
   DETAIL,<timestamp>,,[<GuestIP>] Paths excluded from file
                       discovery: /mnt/spp; /tmp; /usr/bin;
                       /bin; /sbin
  ...
   DETAIL,<timestamp>,CTGGA4002,[<GuestIP>] Discovered files and
                      directories from 25 mounted volume(s) on 6
                      disk(s) in 8m 21s.
     INFO,<timestamp>,CTGGA2219,[<GuestIP>] Discovery on Host
                      <GuestName>  completed with status success
     WARN,<timestamp>,CTGGA2268,Failed to index files under one
                      or more disks in the VM because the virtual
                      disks could not be identified.
                      Ensure that the disk.enableUUID property is
                      enabled in the VM options.
                      See documentation for detailed requirements
     INFO,<timestamp>,CTGGA0101,Inventorying protected objects
     INFO,<timestamp>,CTGGA0526,Number of virtual disks found 6
     INFO,<timestamp>,CTGGA0661,Volume /dev/mapper/local-tmp not
                      file indexed by Agent
     INFO,<timestamp>,CTGGA0256,Copying discovery results for Vm
                      <GuestName>.
     INFO,<timestamp>,CTGGA0257,Saving File catalog data into
                      Data2 dir for vm <GuestName>
     INFO,<timestamp>,CTGGA0562,Skipping file catalog volume file
                      Index null ::: /dev/mapper/local-tmp
  
  The message is misleading as the disk.enableUUID property is
  enabled as required in the VM options.
  Linux guests default file indexing exclusions are
  "/mnt/spp; /tmp; /usr/bin; /bin; /sbin"
  The problem happens when the excluded file system is mounted on
  its own device.
  Example for the above warning for /tmp :
  df -h
  Filesystem              Size  Used Avail Use% Mounted on
  /dev/mapper/local-tmp  10G   2GB  8G    25% /tmp
  
  If the /tmp directory would have been included in the file
  system for root '/', the warning would not be seen.
  The issue affects any excluded from file indexing directory
  having its own file system.
  This warning does not affect file indexing completion for the
  eligible other file systems.
  
  IBM Spectrum Protect Plus Versions Affected:
  IBM Spectrum Protect Plus 10.1.x
  
  Additional Keywords: SPP, SPPLUS, TS005899842, UUID, exclusion
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus level 10.1.7 and 10.1.8            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the fixing level when available. This problem is       *
  * currently projected to be fixed in IBM Spectrum Protect Plus *
  * level 10.1.8 ifix2 and 10.1.9. Note that this is subject to  *
  * change at the discretion of IBM.                             *
  ****************************************************************
  

Problem conclusion

• The fix for this issue is to suppress the file indexing warnings
  on excluded volumes.
  

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

• Hypervis
  

Fix information

• Fixed component name

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels