Avamar - Isilon - NDMP Incremental backups completed with exceptions Error 9982

Summary: Network Data Management Protocol (NDMP) NDMP Incremental backups completed with exceptions - Error 9982

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Symptoms

Avamar - Isilon - NDMP Incremental Backups Completed with Exceptions.

Avamar backups are missing files during incremental backups. This condition could cause data to not be backed up and not be available for restore.

During NDMP incremental backup with Isilon OneFs, the backup completed with exceptions or failed with the following Avtar error:

 

 

avtar error: 2015-03-12 03:02:53 avtar Error <9982>: While processing _file_name_X or directory_name_X (inode XXXX713107), NDMP file history messages indicate the presence of a directory entry (inode:XXXX870544 name: Y) that doesn't appear in the data stream or in our previous backup of this directory.

 

  • Severity Rating: High Impact
  • Description: Avamar backups are missing files during incremental backups due to Isilon OneFs not detecting file case changes and not sending data stream for files or directories with case changes.

Cause

Root Cause of the Issue

The root cause of the issue is related to how file system scanning is performed by the NAS for changes, and not the NDMP client. It is up to the NAS to determine what has changed, and the NDMP client only receives what the NAS tells it has changed.

Avamar is sensitive during the incremental process and tries to find the previous data stream from the "file_name_X or directory_name_X" but instead finds a file or directory change case "File_Name_x or directory_name_x" and results in no valid backups.

This condition is caused because Isilon OneFs is not detecting file case changes and not sending a data stream for files or directories with case changes.

Specific Error Messages

The issue is associated with the following Avtar error:

2015-03-12 03:02:53 avtar Error <9982>: While processing _file_name_X or directory_name_X (inode XXXX713107), NDMP file history messages indicate the presence of a directory entry (inode:XXXX870544 name: Y) that doesn't appear in the data stream or in our previous backup of this directory.
📋

Resolution

Permanent Fix and Workarounds

The final resolution is underway by both teams Avamar/Isilon to resolve this from the root cause.

Permanent fix In Isilon OneFS v7.2.0.3 as listed in "Isilon OneFS Version 7.2.0.0 - 7.2.0.5 Release Notes" ID 147606.

In Isilon OneFS v7.1.1.5 as listed in "Isilon OneFS Version 7.1.1.0 - 7.1.1.8 Release Notes" ID 131843.
 

Workaround Options

  • Option 1: Perform Level 0 backups
  • Option 2: Customers to keep track of incremental backups that completed with exceptions


Option 1. Perform Level 0 backups.
               

  1. Some errors or exceptions must be tracked by customer to maintain data integrity.
  2. To avoid performance issues split the Isilon NDMP backup into multiple target directories.
    Directory "/ifs" should not be a target. If it is, only a single stream will be used to backup up all data.
     

Option 2: Track Incremental Backups

Examine the logs to find the renamed files, then touch the files so that they appear changed in the next incremental backup.

Do not allow more than 30 consecutive backups to "complete with exceptions", otherwise additional manual intervention is required for the software to find a valid base for the next incremental.

As longer it is since the last valid "successful" backup, the more data that is sent by NAS during the next incremental.

 

CAUTION: Be aware of the potential performance issues and data integrity when using these workarounds.

Affected Products

Avamar

Products

Avamar, Avamar Plug-in for NDMP
Article Properties
Article Number: 000041743
Article Type: Solution
Last Modified: 27 Aug 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.