IBM Support

IT21639: CLIENT INCORRECTLY PROCESSES FILELIST OF IBM SPECTRUM SCALE SNAPSHOTS WITH NESTED MOUNTPOINTS.

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Client can incorrectly process a filelist of IBM Spectrum Scale
    snapshots with mount point(s) of file system(s) under these
    snapshot.
    If the nested file system(s) are mounted and nested mount
    point(s) are a part of the IBM Spectrum Scale snapshot,
    then the client should not backup the underlying mount point(s).
    This issue applies to the global and file set based snapshots.
    mmbackup also should not backup such directories(with mounted
    file systems on them).
    
    
    Consider this example:
    
    /fs1/.mmbackupCfg/mmbackupChanged.ix.15350.7C9E8C07.1.fs1
    "/fs1/file"
    "/fs1/fs2"
    "/fs1/fs3"
    "/fs1/fs4"
    
    where
    /fs1/fs2, fs1/fs3 and /fsq/fs4 are directories with  mount
    points on them.
    
    Running the selective command as mmbackup would run it:
    
     selective
    -filelist=/fs1/.mmbackupCfg/mmbackupChanged.ix.15350.7C9E8C07.1.
    fs1
    -verbose -subdir=no -snapshotroot="/fs1/.snapshots/snap1"
    
     Selective Backup function invoked.
    
    Directory--> 262,144 /fs1/fs4 [Sent]
    Normal File--> 11 /fs1/list [Sent]
    Selective Backup processing of
    '/fs1/.mmbackupCfg/mmbackupChanged.ix.15350.7C9E8C07.1.fs1'
    finished
    without failure.
    
    
    so as can be seen one of the nested mount points (/fs1/fs4) was
    backed up
    when it shouldn't have been.
    
    
    
    
    
    Tivoli Storage Manager and IBM Spectrum Protect versions
    affected:
    Client 6.4.x, 7.1.x and 8.1.x on  all supported UNIX and Linux
    platforms that support IBM Spectrum Scale
    
    
    Initial Impact: Medium
    
    Additional Keywords:  TSM IBM Spectrum Protect mmbackup nested
    mount directories
    

Local fix

  • Do not attempt to backup directories with mount points on them
    as part of a snapshot.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Spectrum Protect backup-archive client versions 7.1.x and    *
    * 8.1.x on AIX and Linux platforms.                            *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION.                                       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is projected *
    * to be fixed in level 8.1.4. Note that this is subject to     *
    * change at the discretion of IBM.                             *
    ****************************************************************
    

Problem conclusion

  • After the fix objects with nested file systems mounted on them
    are skipped during filelist snapshot based backup.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT21639

  • Reported component name

    TSM CLIENT

  • Reported component ID

    5698ISMCL

  • Reported release

    71A

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-07-31

  • Closed date

    2017-10-09

  • Last modified date

    2017-10-09

  • 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

  • R81L PSY

       UP

  • R81A PSY

       UP



Document information

More support for: Tivoli Storage Manager

Software version: 71A

Reference #: IT21639

Modified date: 09 October 2017