IT21624: WITH DATAREADPATH=LANFREE AND HEAVY WORKLOAD, A LAN-FREE RESTORE MAY FAIL WITH ANR0416W AND ANS0350E ON CLIENT SIDE

8.1.3.000-IBM-SPSRV-AIX
8.1.3.000-IBM-SPSRV-Linuxppc64le
8.1.3.000-IBM-SPSRV-Linuxs390x
8.1.3.000-IBM-SPSRV-Linuxx86_64
8.1.3.000-IBM-SPSRV-WindowsX64
8.1.3.000-IBM-SPOC-AIX
8.1.3.000-IBM-SPOC-LinuxPPC64le
8.1.3.000-IBM-SPOC-Linuxs390x
8.1.3.000-IBM-SPOC-Linuxx86_64
8.1.3.000-IBM-SPOC-WindowsX64
8.1.3.000-IBM-SPCMS-Linuxx86_64
8.1.3.000-IBM-SPCMS-WindowsI32
8.1.3.000-IBM-SPCMS-WindowsX64
7.1.8.000-TIV-TSMSRV-AIX
7.1.8.000-TIV-TSMSRV-HP-UX
7.1.8.000-TIV-TSMSRV-Linuxppc64
7.1.8.000-TIV-TSMSRV-Linuxs390x
7.1.8.000-TIV-TSMSRV-Linuxx86_64
7.1.8.000-TIV-TSMSRV-SolarisSPARC
7.1.8.000-TIV-TSMSRV-WIN
7.1.8.000-TIV-TSMOC-AIX
7.1.8.000-TIV-TSMOC-Linuxx64
7.1.8.000-TIV-TSMOC-Windows
7.1.8.000-TIV-TSMOC-LinuxPPC64
7.1.8.000-TIV-TSMOC-LinuxPPC64le
7.1.8.000-TIV-TSMOC-LinuxS390
IBM Spectrum Protect Server V8.1 Fix Pack 3 (V8.1.3) Downloads

APAR status

• Closed as program error.

Error description

• When the server is under heavy workload with a lot of concurrent
  LAN-FREE backup/archive/restore/retrieve,
  if the node DATAREADPATH option is intentionally forced to
  LAN-FREE,  some restore/retrieve may fail intermittently with
  errors below:
  
    - On client side :
       "ANS0350E The current client configuration does not comply
        with the value of the DATAWRITEPATH or DATAREADPATH server
        option for this node."
  
   - On server side :
        "ANR0416W Session xxxxx for node YYYY not  allowed to
        READ  using LAN data transfer path."
  
  
  Tivoli Storage Manager  / IBM Spectrum Protect Versions
  Affected:  Server V6.3.x, V7.1.x and V8.1.x on all supported
             platforms.
  
  Customer/L2 Diagnostics:
  
  - A server trace taken with "PVR NA" flags will show a lock
  conflict ( rc 1020) like in the below extract:
  
  [nautil.c][198][NaLockUniverse]:Acquiring NA universe
   lock (sLock).
  [napthcmd.c][2021][naOpenQueryPathEx]:Setting search
   bounds with srcName = STANAME
  [napthcmd.c][2484][naGetClassDirs]:admGetServerId
   returned rc = 0, ID for STANAME is 36
  [napthcmd.c][2515][naGetClassDirs]:pvrGetLibDevClasses
   returned rc = 1020 for library LIBNAME (classCount = 0)
  [napthcmd.c][2395][naGetNextPath]:naGetClassDirs returned
   rc 1020, src STANAME, dest LIBNAME_DRV00
  [smlshare.c][3946][DoLibraryPathQuery]:rc 0 from
   naTestAnyDrivePath for server STANAME library LIBNAME
   pathExists is 0
  
  or
  [nautil.c][198][NaLockUniverse]:Acquiring NA universe
   lock (sLock).
  [napthcmd.c][2021][naOpenQueryPathEx]:Setting search
   bounds with srcName = STANAME
  [napthcmd.c][2484][naGetClassDirs]:admGetServerId
   returned rc = 0, ID for STANAME is 34
  [napthcmd.c][2515][naGetClassDirs]:pvrGetLibDevClasses
   returned rc = 0 for library LIBNAME (classCount = 1)
  [napthcmd.c][2525][naGetClassDirs]:pvrGetClassDirNum
   returned rc = 1020 for library LIBNAME, devclass , numDirs is 0
  [napthcmd.c][2395][naGetNextPath]:naGetClassDirs returned
   rc 1020, src STANAME, dest LIBNAME_DRV00
  [smlshare.c][3946][DoLibraryPathQuery]:rc 0 from
   naTestAnyDrivePath for server STANAME library LIBNAME
   pathExists is 0
  
  Initial Impact: Medium
  
  Additional Keywords:  TSM LANFREE SAN GRC_LOCK_CONFLICT
  

Local fix

• Change the node DATAREADPATH option to ANY
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Tivoli Storage Manager and Spectrum Protect Storage  *
  * Manager server users of LAN-FREE with DATAREADPATH=LANFree   *
  * and DATAWRITEPATH=LANFree settings in the register node      *
  * command.                                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is projected *
  * to be fixed in level 8.1.3.                                  *
  * Note that this is subject to change at the discretion of     *
  * IBM.                                                         *
  ****************************************************************
  

Problem conclusion

• This problem was fixed.
  Affected platform: AIX, HP-UX, Linux, Solaris, and Windows.
  Fixed platform: AIX, Linux, and Windows.
  
  ANR0551E The client operation failed for session (session ID)
           for node (node name) on the (client platform) operating
  		 system because of a lock conflict.
  
  Explanation
  An operation that requires the server to lock a system resource
  
  was initiated. The operation cannot be completed because the
  resource is in use by another command or process.
  
  SystemAction
  Server operations continue, but the server does not process the
  command.
  
  UserResponse
  To resolve the issue, take one of the following actions:
  - If the failed command was run in a local area network (LAN)
    environment, run the command again later.
  - If the failed command was run in a LAN-free environment,
    run the VALIDATE LANFREE command and review the output:
    If the LAN-Free capable column displays a value of YES,
    retry the failed command.
    If the LAN-Free capable column displays a value of NO,
    correct the configuration to support LAN-free data movement
    for the storage agent and retry the failed command.
    Alternatively, retry the failed command in a LAN environment.
  

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:

Fix information

• Fixed component name

  TSM SERVER

• Fixed component ID

  5698ISMSV

Applicable component levels