logo

Manual Pages


Table of Contents

NAME

na_ndmpd - manages NDMP service

SYNOPSIS

ndmpd [ on | off | status | probe [ session ] | kill [ session ] | killall | password [ username ] | debug [ level | stack | screen | file ] | version [ maxversion ] ]

DESCRIPTION

The ndmpd command controls and displays information about the daemon responsible for providing Network Data Management Protocol service.

ndmpd is supported on regular vfilers, as well as the physical filer named vfiler0. Use vfiler context or vfiler run to issue ndmpd commands on a specific vfiler. See na_vfiler(1) for details on how to issue commands on vfilers. The use of ndmp on vfilers requires a MultiStore license.

When used on a vfiler, a few restrictions apply. The vfiler must be rooted on a volume. Ndmp source and destination paths must be on volumes exclusively owned by the vfiler. Tape devices are not supported on vfilers.

Ndmp can be turned on/off on a vfiler independently. Ndmpd commands issued on a vfiler can only operate on volumes or qtrees it has exclusive ownership of.

For backward compatibility, the physical filer (vfiler0) can operate on all volumes and qtrees, even if they are owned by vfilers. It is highly recommanded that all storage units (volumes and qtrees) are backed up from either vfiler0 or the hosting vfiler, not both.

OPTIONS

One of the following options must be specified:

on
Enables NDMP request-handling by the daemon. Enabling/disabling NDMP persists across reboots. NDMP can only be enabled on vfilers which are rooted on volumes.

off
Disables NDMP request-handling by the daemon. Processing continues for requests that are already in progress. New requests are rejected. By default, NDMP service is disabled at system startup.

status
Displays the current state of NDMP service.

probe [ session ]
Displays diagnostic information about the specified session. If session is not specified, information about all sessions is displayed.

kill session
Signals the specified session to stop processing its current requests and move to an inactive state. This allows hung sessions to be cleared without the need for a reboot, since the off command waits until all sessions are inactive before turning off the NDMP service.

killall
Signals all active sessions to stop processing their current requests and move to an inactive state.

password [ username ]
Displays an NDMP specific password for any existing Data ONTAP non-root user account. Starting with Data ONTAP 6.4, NDMP allows the non-root user login to NDMP server and perform the NDMP backup and NDMPCOPY operations. In the case of a non-default vfiler the command must be run in the vfiler context and will display the NDMP specific password for all accounts on the vfiler including root. At NDMP login, the server authenticates the user name and the corresponding NDMP specific password to grant access to the user. However, the root login authentication process on the default vfiler remains the same. There is no NDMP specific password for root for the default vfiler. Based on the way we create the NDMP specific password that any change to a Data ONTAP administrative user password will invalidate the associated NDMP specific password.

debug [ level ]
The debug log provides a detailed description of the activities of all active NDMP sessions. The amount of information displayed by the debug log is determined by the debug level specified by the user. Use 0 for the level to turn the debug log off. Use a nonzero value for the level to turn the debug log on. The levels supported are: 10(displays connections being made and connections being closed); 20(displays basic information regarding the actual NDMP messages such as the message types, sequence numbers, and timestamps); 30(same as level 20 plus display of message header information and detailed information about most messages); 50(same as level 30, plus display of environment variables and any exceptions issued by the server); 70(same as level 50, plus display of tape and SCSI command descriptor blocks(CDBs) sent). If a level is not specified, the current debug level and the state of the stack, screen, and file variables are displayed.

debug stack
The stack keyword toggles the inclusion of stack trace information in the debug log when exceptions are encountered in the NDMP Server code of Data Ontap. This option is off by default. It is typically used only for advanced debugging.

debug screen
The screen keyword toggles the enablement of the display of the debug log information on the filer console. This option is on by default.

debug file
The file keyword toggles the enablement of writing the debug log information to the log files. This option is on by default.

version [ maxversion ]
Displays the maximum version that NDMP currently supports when invoked without the optional maxversion. Sets the maximum version that NDMP allows when maxversion is specified. Currently supported values of maxversion are 2,3, and 4. By default, the maximum version is set to 4 at system startup. If maxversion is changed with ndmpd version maxversion, the changed value persists across reboots.

FILES

/etc/rc
system initialization command script

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

SEE ALSO

na_rc(5), na_ndmpdlog(5), na_vfiler(1).


Table of Contents