logo

Manual Pages


Table of Contents

NAME

na_ndmpdlog - The ndmpdlog provides a detailed description of the activities of all active NDMP sessions.

SYNOPSIS

/etc/log/ndmpdlog.yyyymmdd

DESCRIPTION

The NDMP debug log provides a detailed description of the activities of all active NDMP sessions. See na_ndmpd (1) for a detailed description of how NDMP logging is enabled and disabled and the various options associated with the control of logging. All events are recorded in multi-line entries and are sent to the filer console and/or the /etc/log/ndmpdlog.yyyymmdd files depending on how logging has been configured with the ndmpd debug command.

The information in the ndmpdlog is a trace of the NDMP protocol messages as defined in the various versions of the NDMP Protocol Specification. Data ONTAP supports versions 2, 3 and 4 of the protocol. At least a cursory knowledge of the NDMP Protocol is required to analyze the ndmpdlog. Describing the protocol is beyond the scope of this manpage. Descriptions of the three supported versions of the protocol can be found at www.ndmp.org.

If logging to files is enabled, a new log file is created each day. The last part of the log file name is the date for which the log file applies. If NDMP sessions are active at the time a new daily log file is created, information for the existing sessions will continue to be logged to the file which was active at the time the sessions were created. Information for any new sessions will be logged in the new log file. Up to 9 daily log files are retained on the system. A log file for a particular day may not exist if no NDMP activity occurred on that day. Log files over 8 days old are automatically deleted by Data ONTAP.

The log has a multi-column, multi-line format.

The three columns contain:

Date
The time of the messages displayed in the timezone specified by the timezone command.

Session
The NDMP session number for the messages in [ndmpd:<session>] format.

Message
The contents of the messages.

The information for each message occupies multilple lines in the log. At a high level, there are two types of log entries: those representing request/reply pairs and those representing log/notify messages. Note that there is only one entry for a request/reply pair. Some of the information is placed in the log as the message is received by the filer and other information is placed in the log as the reply is being sent to the NDMP client. Also note that the debug level must be set to the appropriate level with the ndmpd debug command as described in na_ndmpd (1) for the following information to be displayed.

The log entry for each request/reply message begins with the following 2 lines:

NDMP message type:
The high-level message type such as

NDMP_DATA_START_BACKUP
or NDMP_TAPE_OPEN.

NDMP message replysequence:
The replysequence is the sequence number from the request message with which the reply is associated.

The log entry for each log/notify message begins with the following line:

Message <message type> sent
The high-level message type such as

NDMP_NOTIFY_DATA_ABORT
or NDMP_LOG_MESSAGE.

The above information is followed by the NDMP message header.

Message header:
The message header contains information such as sequence numbers, a numerical representation of the message type, and an error field representing the success or failure of receiving and decoding the message. The fields correspond to the fields in the NDMP message header as defined in the NDMP Protocol Specifications.

The header information is followed by the request/reply information or the log/notify information.

Request/Reply information including the Error code: Contains the remainder of the information about the request and reply for the message and possibly some other state information associated with the request/reply. An Error code: field is displayed for all reply message log entries. This is the overall status of the execution of the request and is a key piece of information when diagnosing problems. The contents of the rest of the log entry varies widely depending on the message being logged. It is beyond the scope of this manpage to describe the details for the dozens of different messages which are part of the NDMP protocol. Refer to the NDMP Protocol Specifications as well as the NDMP Extension Specifications available from NetApp to decode these fields in the logs.

Log/Notify information:
Contains the remainder of the information about the log/notify message. As for the request/reply information, see the NDMP Protocol Specifications as well as the NDMP Extension Specifications to decode these fields in the logs.

VFILER CONSIDERATIONS

The log files are stored in the /etc/log directory of the vfiler's root volume.

FILES

/etc/log/ndmpdlog.yyyymmdd
daily ndmpd log file

SEE ALSO

na_ndmpd(1).


Table of Contents