Troubleshooting
Problem
ANS1626E An unexpected error was encountered when processing a Tivoli Storage Manager operation using a hardware or snapshot function. ANS2832E Incremental by snapshot difference failed
Symptom
Snapdiff incremental backup of NetApp volume fails with RC 14500, the client log will show errors similar to the following:
09/19/2013 09:23:27 ANS1626E An unexpected error was encountered when
processing a TSM operation using a hardware or snapshot function.
TSM function name : NAHWInterface::naPerformSnapDiff
TSM function : Error invoking ONTAP API snapdiff-iter-next:
Queue results error
TSM return code : 14500
TSM file : NAHWInterface.cpp (6777)
09/19/2013 09:23:27 ANS5250E An unexpected error was encountered.
TSM function name : baPerformSnapDiff
TSM function : failed to perform snapdiff
TSM return code : 653
TSM file : backsnap.cpp (5173)
09/19/2013 09:23:27 ANS2832E Incremental by snapshot difference failed
for \\usffs\udrive$. Please see error log for details.
09/19/2013 09:23:29 ANS5283E The operation was unsuccessful.
A client trace using SERVICE SNAPSHOT SNAPSHOT_DETAIL trace flags shows the following:
09/19/2013 09:23:27.028 : ..\..\common\winnt\ntrc.cpp( 792):
TransWin32RC(): SnapshotErrMode = 0; dwWin32RC = 3
09/19/2013 09:23:27.028 : ..\..\common\winnt\ntrc.cpp( 792):
TransWin32RC(): SnapshotErrMode = 0; dwWin32RC = 2
09/19/2013 09:23:27.028 : ..\..\common\ba\backsnap.cpp(5665):
baPerformSnapDiff(): Input for PERFORM SNAP DIFF:
Filer Handle : <1>
Mount Point : <\\NAvolume1\nas_vol_43$>
Volume : <nas_vol_43>
Base Snapshot : <hourly.0>
Base Snap Create Time: <1372298432>
DB Path :
<C:\Users\sa-smapi\AppData\Local\Temp\TSM\psID_8809\TsmSnapDiff>
Create Diff Snapshot : <FALSE>
Keep DB Open : <TRUE>
Delete DB : <FALSE>
Filter Ascii Names : <off>
File Access Protocol : <CIFS>
09/19/2013 09:23:27.028 : ..\..\common\ba\DccPISnapshot.cpp(2974): s(2):
Entering...
09/19/2013 09:23:27.028 : ..\..\common\ba\DccPISnapshot.cpp(3004):
snapshotAction(2): snapState(2)
09/19/2013 09:23:27.028 : snapshotinterface.cpp(1037):
tsmSnapshotAction(): Entering...
09/19/2013 09:23:27.028 : DHdwSnapshot.cpp ( 908): snapshotAction():
Enter
09/19/2013 09:23:42.394 : DHdwSnapshot.cpp (1183): snapshotAction():
hwPerformAction() failed. rc: <14500>
Cause
For the SNAPDIFF command to work properly from Tivoli Storage Manager in Windows, the files and directories need to be created or converted to Unicode. Sometimes files which are not Unicode get created on the filer which can cause this issue.
The important thing to understand is that it is the NetApp filer which is aborting the snapdiff session with a return code of 14500.
This return code is defined as follows:
#define ESNAPDIFFINTERROR 14500
/* Unspecified error in snapdiff zapi. */
and is being returned from the ONTAP snapdiff-iter-start api call.
Resolving The Problem
There are two possible resolutions for this problem.
1) The create_ucode and convert_ucode options must be enabled on the volume.
Then, run the "attrib /s /d" command at the root directory of the volume, this will force the filer to access each file and directory. When it accesses a file which is not in Unicode, it converts it to Unicode.
Once it is in Unicode, the SNAPDIFF command can read them properly and the backups should complete successfully.
Both options (create_ucode and convert_ucode) must be enabled.
2) If the above action does not resolve the error, configuring the language for the volume to UTF-8 should be performed. NetApp support recommends that en_(US).UTF-8 be used as a default for volumes that will be mounted via CIFS.
Product Synonym
TSM
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg21650359