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.

OPTIONS

One of the following options must be specified:

on
Enables NDMP request-handling by the daemon. Enabling/disabling NDMP persists across reboots.

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. 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 remains the same. There is no NDMP specific password for root. 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).


Table of Contents