IBM Support

IT19067: INCREMENTAL FILELIST BACKUP OF A IBM SPECTRUM SCALE FILESYSTEM WITH A SNAPSHOT DISPLAYS THE WRONG PATH FOR INSPECTED FILES.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Incremental filelist backup of a IBM Spectrum Scale file system,
    with a snapshot, displays the wrong path for inspected but not
    backed up files
    when the "detailed" and "snapshotroot" parameters are specified.
    Instead of the path of the files in the file list, the path of
    the snapshot file is displayed.
    
    Steps to recreate:
    1. create some files in an IBM Spectrum Scale file system:
    find /var > /tfs1/tf1
    find /var > /tfs1/tf2
    2. create a snapshot:
    mmcrsnapshot gpfs1 snap1
    # here gpfs1 is the device name of /tfs1
    3. create a file list with the files above:
    echo /tfs1/tf1 > filel
    echo /tfs1/tf2 >> filel
    4. incrementally backup the IBM Spectrum Scale file system by
    specifying the file list, the "snapshotroot" and "detail"
    parameters
    dsmc inc -filel=filel -detail
    -snapshotroot=/tfs1/.snapshotroot/snap1
    5. repeat step 4
    
    Expected result:
    In step 5 the path of the files in the file list is displayed on
    the terminal
    
    Actual result:
    In step 5 the path of the files in the snapshot is displayed
    
    
    Terminal output:
    First inc backup, output is correct:
    
    dsmc inc -filel=filel  -detail 
    -snapshotroot=/tfs1/.snapshots/snap1
    
    
    Incremental backup of volume 'filel'
    Normal File-->           496.553 /tfs1/tf1 [Sent]
    Normal File-->           496.553 /tfs1/tf2 [Sent]
    Successful incremental backup of '/root/filel'
    
    
    Total number of objects inspected:            2
    Total number of objects backed up:            2
    Total number of objects updated:              0
    Total number of objects rebound:              0
    Total number of objects deleted:              0
    Total number of objects expired:              0
    Total number of objects failed:               0
    Total number of objects encrypted:            0
    Total number of objects grew:                 0
    Total number of retries:                      0
    Total number of bytes inspected:         969,83 KB
    Total number of bytes transferred:       970,87 KB
    Data transfer time:                        0,01 sec
    Network data transfer rate:           58.282,68 KB/sec
    Aggregate data transfer rate:            922,81 KB/sec
    Objects compressed by:                        0%
    Total data reduction ratio:                0,00%
    Elapsed processing time:               00:00:01
    
    
    Second inc backup of unchanged files. The path is wrong:
    
     dsmc inc -filel=filel  -detail
    -snapshotroot=/tfs1/.snapshots/snap1
    
    
    Incremental backup of volume 'filel'
    Normal File-->           496.553 /tfs1/.snapshots/snap1/tf1
    [Unchanged]   <== incorrect path
    Normal File-->&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 496.553 /tfs1/.snapshots/snap1/tf2
    [Unchanged]   <== incorrect path
    Successful incremental backup of '/root/filel'
    
    
    
    Total number of objects inspected:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 2
    Total number of objects backed up:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of objects updated:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of objects rebound:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of objects deleted:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of objects expired:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of objects failed:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of objects encrypted:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of objects grew:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of retries:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0
    Total number of bytes inspected:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 969,83 KB
    Total number of bytes transferred:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0&#160; B
    Data transfer time:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0,00 sec
    Network data transfer rate:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0,00 KB/sec
    Aggregate data transfer rate:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0,00 KB/sec
    Objects compressed by:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 0%
    Total data reduction ratio:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 100,00%
    Elapsed processing time:&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160; 00:00:01
    
    This can also be seen when running 'mmbackup' command against an
    IBM Spectrum Scale file system snapshot (-S 'gpfssnap'), and
    files are reported as skipped and ends with RC 1 in mmbackup due
    to IBM Spectrum Protect client RC 4.
    
    IBM Spectrum Protect versions affected:
    Client 7.1.1.x and higher and 8.1.x on AIX and Linux platforms
    with IBM Spectrum Scale file systems
    
    
    
    Initial Impact: Medium
    
    Additional Keywords:  TSM IBM Spectrum Protect 134591 GPFS
    snapshot output
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * Backup-archive client versions 7.1.1, 7.1.2, 7.1.3, 7.1.4,   *
    * 7.1.6 and 8.1.0 running on all UNIX GPFS platforms           *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is currently *
    * projected to be fixed in level 7.1.6.5  and 8.1.2 Note that  *
    * this is subject to change at the discretion of IBM.          *
    ****************************************************************
    

Problem conclusion

  • Customer makes backups of a GPFS filesystem with mmbackup to a
    TSM server. Customer create snapshot and do mmbackup command of
    it using snapshot root option. Before fixing the issue the
    unchanged files were skipped from mmbackup processing. With the
    fix the mmbackup command also process unchanged files.
    

Temporary fix

  • 7.1.6.5
    

Comments

APAR Information

  • APAR number

    IT19067

  • 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-02-02

  • Closed date

    2017-03-10

  • Last modified date

    2017-03-10

  • 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

  • R71L PSY

       UP

  • R71A PSY

       UP

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"71A","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
11 January 2022