vserver services ndmp log start

Start logging for the specified NDMP session

Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

Description

This command is used to start logging on an active NDMP session on a vserver.

Parameters

-vserver <vserver name> - Vserver
This parameter specifies the name of the Vserver.
-session-id <text> - Session Identifier
This parameter specifies the NDMP session-id on which logging needs to be started.
-filter <text> - Level Filter

Use this parameter to specify the filter for a particular session ID. This parameter controls the NDMP modules for which logging is to be enabled. This parameter can take five values. They are as follow : all, none, normal, backend or "filter-expression". The default value for this is none.

  • all turns on logging for all modules.
  • none disables logging for all modules.
  • normal is a short cut parameter that enables logging for all modules except verbose and io_loop. The equivalent filter string is all-verbose-io_loop
  • backend is a short cut parameter that enables logging for all modules except verbose, io_loop, ndmps and ndmpd. The equivalent filter string is all-verbose-io_loop-ndmps-ndmpp
  • (filter-expression) is a combination of one or more modules for which logs needs to be enabled. Multiple module names can be combined using following operators :
    • - to remove the given module from the list of specified modules in the filter string. For example the filter all-ndmpp will enable logging for all modules but not ndmpp.
    • ^ to add the given module or modules to the list of modules specified in the filter string. For example the filter ndmpp^mover^data will enable logging for ndmpp, mover and data.
The possible module names and a brief description is given below:
					+--------------+-------------------------------------+
					| Modules      | Description                         |
					+--------------+-------------------------------------+
					| verbose      | verbose message                     |
					| io           | I/O process loop                    |
					| io_loop      | I/O process loop verbose messages   |
					| ndmps        | NDMP service                        |
					| ndmpp        | NDMP Protocol                       |
					| rpc          | General RPC service                 |
					| fdc_rpc      | RPC to FC driver service            |
					| auth         | Authentication                      |
					| mover        | NDMP MOVER (tape I/O)               |
					| data         | NDMP DATA (backup/restore)          |
					| scsi         | NDMP SCSI (robot/tape ops)          |
					| bkup_rpc     | RPC to Backup service client        |
					| bkup_rpc_s   | RPC to Backup service server        |
					| cleaner      | Backup/Mover session cleaner        |
					| conf         | Debug configure/reconfigure         |
					| dblade       | Dblade specific messages            |
					| timer        | NDMP server timeout messages        |
					| vldb         | VLDB service                        |
					| smf          | SMF Gateway messages                |
					| vol          | VOL OPS service                     |
					| sv           | SnapVault NDMP extension            |
					| common       | NDMP common state                   |
					| ext          | NDMP extensions messages            |
					| sm           | SnapMirror NDMP extension           |
					| ndmprpc      | NDMP Mhost RPC server               |
					+--------------+-------------------------------------+
				

Examples

The following example shows how to start logging on a specific NDMP session 1000:35512, running on vserver cluster1-01 with filter all.

			cluster1::*> vserver services ndmp log start -vserver cluster1-01 -session-id 1000:35512 -filter all