IT24533: HSM FOR WINDOWS MANAGED FILE SERVER HANGS IF AN EXECUTABLE STUB FILE IS RECALLED LOCALLY

APAR status

• Closed as program error.

Error description

• IBM Spectrum Protect HSM for Windows recall service hangs if a
  stub file of type .exe, .dll, .bat or .cmd is recalled locally
  on the file
  server. Shutdown or reboot of the file server is not possible in
  this case, the server needs to be reset using the hardware or
  the virtualizer. Such executable stub files can be recalled from
  a remote computer without problems. The error was introduced
  with APAR fix IT17882 'HSM for Windows recall of a large file
  may cause the SMB/CIFS share to freeze'.
  
  Affected Product versions: IBM Spectrum Protect HSM for
  Windows client versions 8.1.2.0 - 8.1.4.0, 7.1.6.5 - 7.1.8.2
  
  Customer/L2 diagnostics:
  Check if an executable stub file is recalled, this may
  happen if a folder is opened that holds an executable stub
  file and an Application is scanning or caching the files in the
  folder.
  The hsmservice.log with full trace level terminated to write
  traces shortly after these
  example hsmservice.log records:
  HSMSERVICE (0D34:055C) TSMController::mf_implRestoreTSM
  18-03-29 12:35:15.902
   T: Starting file retrieval of '\\2016SRV\F$\exe\newsid.exe'
      Target path 'F:\exe\newsid.exe' ...
      Media class '16' (MEDIA_FIXED)
  HSMSERVICE (0D34:055C) TSMController::mf_implRestoreTSM
  18-03-29 12:35:15.918
   D: Retrieved first 319 byte(s) from archive='exe',
  server='tsm-server:1500'
  HSMSERVICE (0D34:055C) TSMController::mf_implRestoreTSM
  18-03-29 12:35:15.918
   T: Retrieved meta data V2 from TSM server for
  '\\2016SRV\F$\exe\newsid.exe'
  HSMSERVICE (0D34:055C) TSMController::mf_implRestoreTSM
  18-03-29 12:35:15.918
   D: Meta data size of '\\2016SRV\F$\exe\newsid.exe': 319 bytes
      First content data (retrieved together with meta data): 0
  bytes
  HSMSERVICE (0D34:055C) TSMController::mf_implRestoreTSM
  18-03-29 12:35:15.918
   D: Completer W32 attributes initialized from
  '\\2016SRV\F$\exe\newsid.exe'
  HSMSERVICE (0D34:055C) ICDriverCompleter2::mf_implOpenStr
  18-03-29 12:35:15.918
   D: File size 118784 successfully validated against
  file-attributes value
  HSMSERVICE (0D34:055C) ICDriverHandle::mf_implOpen
  18-03-29 12:35:15.918
   T: Successfully opened driver device-io-handle
  0x0000000000000AD8 (GENERIC_WRITE)
  

Local fix

• Retrieve such files using dsmclc, or dsmgui. It is recommended
  not to migrate executable files e.g. with extension .exe, .dll,
  .bat or
  .cmd.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect HSM for Windows client versions:        *
  * 8.1.2.0 ? 8.1.4.0, 7.1.6.5 ? 7.1.8.2                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * see ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. The problem is currently  *
  * projected to be fixed in version 8.1.6. Note that this is    *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• The problem has been fixed. The hsmservice does not hang, if an
  executable file is recalled locally on the file server, however
  the known limitation, that an executable file cannot be recalled
  from the local file server still applies. A new registry key has
  been implemented:
  
  HKLM\SYSTEM\CurrentControlSet\Services\ithsmdrv\Parameters\DenyS
  tubExtensionList
  
  The type of the registry key is REG_MULTI_SZ. The list is
  created by the HSM setup and consists of the 4 extensions ?exe?,
  'dll', 'bat' and ?cmd?, by default.
  
  If the HSM recall driver encounters a local recall attempt of a
  migrated stub file with an extension, that is registered in the
  list, it denies opening it and returns STATUS_FILE_IS_OFFLINE.
  
  Such files can be recalled from a remote server share. Such
  files can be retrieved using HSM for Windows GUI or dsmclc
  command.
  It is recommended not to migrate executable files.
  

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 HSM FOR WIN

• Fixed component ID

  5698ICNCL

Applicable component levels