Skip to main content

vserver services ndmp log start

Contributors
Suggest changes

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 (privilege: advanced)

This parameter specifies the name of the Vserver.

-session-id <text> - Session Identifier (privilege: advanced)

This parameter specifies the NDMP session-id on which logging needs to be started.

-filter <text> - Level Filter (privilege: advanced)

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 ndmppmoverdata 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