Manual Pages
Table of Contents
na_ndmpdlog - The ndmpdlog provides a detailed description
of the activities of all active NDMP sessions.
/etc/log/ndmpdlog.yyyymmdd
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.
The log files are stored in the /etc/log directory of the
vfiler's root volume.
-
/etc/log/ndmpdlog.yyyymmdd
- daily ndmpd log file
na_ndmpd(1).
Table of Contents