Fixes are available
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-->           496.553 /tfs1/.snapshots/snap1/tf2 [Unchanged] <== incorrect path Successful incremental backup of '/root/filel' Total number of objects inspected:            2 Total number of objects backed up:            0 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:            0  B Data transfer time:                        0,00 sec Network data transfer rate:                0,00 KB/sec Aggregate data transfer rate:              0,00 KB/sec Objects compressed by:                        0% Total data reduction ratio:              100,00% Elapsed processing time:               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