Backup of NETAPP NDMP volumes fails with an error "The length of MULTI_SUBTREE_NAMES environment variable exceeds 1024 bytes"

book

Article ID: 100046633

calendar_today

Updated On:

Description

Error Message

Job log will report the error "0xe0001309 - The NDMP server returned a backup error." and the NDMP log section in job log shows the following

NDMP Log Message: The length of MULTI_SUBTREE_NAMES environment variable exceeds 1024 bytes. The length will be trimmed to maximum allowed value of 1024 bytes.

:
:
NDMP Log Message: DUMP: Folder/Subfolder/Subfolder : No such file or directory ------- (Here the last part of string is truncated subfolder name due to which the error "No such file or directory" is reported)
NDMP Log Message: Mover encountered internal socket error.
NDMP Log Message: DUMP: DUMP IS ABORTED
NDMP Mover Halted: Internal Error
NDMP Log Message: DUMP: Deleting "/vol/Vol1/../snapshot_for_backup.450" snapshot.
NDMP Log Message: DATA: Operation terminated (for /vol/Vol1).
NDMP Data Halted: Aborted

UMI Code: V-79-57344-4873

Cause

This issue occurs if the Volume backup contains large number of Include\Excludes. All the Excludes are sent to NETAPP Filer as string value in variable "MULTI_SUBTREE_NAMES". If the string length goes beyond 1024 bytes than NETAPP Filer is unable to process this selection and hence the job fails. 

Resolution

Run a SGMON debug and NETAPP Filer NDMPD debug to confirm if the string value of "MULTI_SUBTREE_NAMES" is getting truncated.

Workaround

Reduce the number of exclude path so that the string value for the variable "MULTI_SUBTREE_NAMES" does not go beyond 1024 bytes.

Please contact NETAPP support for details regarding this limit of 1024 bytes for the "MULTI_SUBTREE_NAMES" variable.

Issue/Introduction

Backup job of NETAPP NDMP volumes may fail with an error "The length of MULTI_SUBTREE_NAMES environment variable exceeds 1024 bytes"

Additional Information

ETrack: 3986088