Skip to main content

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