IT32188: NFS SHARES ARE BEING BACKED BY IBM SPECTRUM PROTECT CLIENT WHEN DOMAIN IS ALL-LOCAL

APAR status

• Closed as program error.

Error description

• Due to a timing issue with the IBM Spectrum Protect Client code,
  NFS shares may get backed up as part of  all-local domain backup
  when the following conditions
  are met:
  1) NFSTIMEOUT option is set to a non-default value i.e. to a
  non-zero value.
  2) There is a locally mounted, non-root file system (For example
  '/localmount') that has a nested NFS mount point
  ('/localmount/nfs/nfsmount').
  3) The very first statfs() system call for the nested NFS file
  system takes more than the NFSTIMEOUT option value.
  
  If the above conditions are met, the incremental backup of
  DOMAIN=all-local will incorrectly consider the nested NFS mount
  point as
  an ordinary directory located on the locally mounted parent file
  system. As a result, the incremental command will incorrectly
  traverse
  the nested NFS mount point and store its contents under the
  wrong file space on the SP server side, i.e. under the parent
  file system file
  space name.
  
  Customer/Support Diagnostics:
  =============================
  A Service trace might show the following
  03/12/20   19:46:00.658 [010372] [823433088] :
  linux/psstatfs.cpp  (1306): GetFSInfo for path
  /localmount/nfs/nfsmount
  03/12/20   19:46:00.658 [010372] [823433088] : virtstat.cpp
  ( 622): dsmNFSsyscall statfs for path /localmount/nfs/nfsmount
  .....
  03/12/20   19:46:00.658 [010372] [528475904] : virtstat.cpp
  (1144): StatFsThread: just got a tap for
  (/localmount/nfs/nfsmount)
                             main thread
  0================>
  03/12/20   19:46:01.659 [010372] [823433088] : virtstat.cpp
  (1444): tryOnTap: is timed out!
  ........
  03/12/20   19:46:01.660 [010372] [823433088] : virtstat.cpp
  ( 782): dsmNFSsyscalls: stale mount point for
  (/localmount/nfs/nfsmount)
  ..........
  03/12/20   19:46:50.686 [010372] [623499008] : unxfilio.cpp
  (2696): TS001723269: fsDevice(64779), fsName(/fmacdata),
  statBuff.st_dev(60), path(/localmount/nfs/nfsmount)
  03/12/20   19:46:50.686 [010372] [623499008] : unxfilio.cpp
  (2750): TS001723269: fsDeviceIsKnown(1), bSnapShotRoot(0),
  bSnapDiffIncr(0), fType(12), path(/localmount/nfs/nfsmount)
  
  IBM Spectrum Protect versions affected:
  All Linux and Unix  client versions 7.1.x, 8.1.x
  
  Additional Keywords:
  TS001723269
  

Local fix

• Increase the NFSTIMEOUT option value, so that the NFS mount
  point completes prior to timing out.
  

Problem summary

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

Problem conclusion

• Upon the fix, NFS file systems will be processed appropriately
  during backup or archive operation regardless whether they are
  nested under some local, non-root file system or not.
  In particular, the NFS mount points won't be traversed as part
  of the default domain 'all-local' backup operation in any case.
  

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

• dsmc
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels