Skip to main content

vserver services ndmp probe

Display list of NDMP sessions

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

Description

The system services ndmp probe command displays diagnostic information about NDMP sessions belonging to a specific Vserver in the cluster. The following fields are displayed for each of the sessions:

  • Vserver
  • Session identifier
  • NDMP version
  • Session authorized
  • Data state
  • Data operation
  • Data server halt reason
  • Data server connect type
  • Data server connect address
  • Data server connect port
  • Data bytes processed
  • Mover state
  • Mover mode
  • Mover pause reason
  • Mover halt reason
  • Mover record size
  • Mover record number
  • Mover bytes moved
  • Mover seek position
  • Mover bytes left to read
  • Mover window offset
  • Mover window length
  • Mover position
  • Mover SetRecordSize flag
  • Mover SetWindow flag
  • Mover connect type
  • Mover connect address
  • Mover connect port
  • Effective host
  • NDMP client address
  • NDMP client port
  • SCSI device ID
  • SCSI hostadapter
  • SCSI target ID
  • SCSI LUN ID
  • Tape device
  • Tape mode
  • Node
  • Is Secure Control Connection
  • Data Backup Mode
  • Data Path
  • NDMP Source Address

Parameters

[-vserver <vserver name>] - Vserver
This parameter Specifies the Vserver context in which NDMP sessions are running.
[-session-id <text>] - Session Identifier
If this parameter is specified, the command displays information about a specific NDMP session. A session-id is a string used to identify a particular NDMP session.
[-ndmp-version <integer>] - NDMP Version
This parameter refers to the NDMP protocol version being used in the session.
[-session-authorized {true|false}] - Session Authorized
This parameter indicates whether an NDMP session is authenticated or not.
[-data-state <component state>] - Data State
This parameter identifies the current state of the data server's state machine.
[-data-operation <data operation>] - Data Operation
This parameter identifies the data server's current operation.
[-data-halt-reason <halt reason>] - Data Server Halt Reason
This parameter identifies the event that caused the data server state machine to enter the HALTED state.
[-data-con-addr-type <address type>] - Data Server Connect Type
This parameter specifies the type of data connection established by the data server. The data connection can be established locally within a given system or between remote networked systems.
[-data-con-addr <text>] - Data Server Connect Address
This parameter specifies the connection endpoint information for the data server's data connection.
[-data-con-port <integer>] - Data Server Connect Port
This parameter specifies the TCP/IP port that the data server will use when establishing a data connection.
[-data-bytes-processed <integer>] - Data Bytes Processed
This parameter represents the cumulative number of data stream bytes transferred between the backup or recovery method and the data connection during the current data operation.
[-mover-state <component state>] - Mover State
This parameter identifies the current state of the NDMP tape server's mover state machine.
[-mover-mode <mover mode>] - Mover Mode
This parameter identifies the direction of the mover data transfer.
[-mover-pause-reason <pause reason>] - Mover Pause Reason
This parameter identifies the event that caused the mover state machine to enter the PAUSED state.
[-mover-halt-reason <halt reason>] - Mover Halt Reason
This parameter field identifies the event that caused the mover state machine to enter the HALTED state.
[-mover-record-size <integer>] - Mover Record Size
This parameter represents the current mover record size in bytes.
[-mover-record-num <integer>] - Mover Record Number
This parameter represents the last tape record processed by the mover.
[-mover-bytes-moved <integer>] - Mover Bytes Moved
This parameter represents the cumulative number of data stream bytes written to the data connection or the number of data stream bytes read from the data connection and written to the tape subsystem, depending on the mode of mover operation.
[-mover-seek-position <integer>] - Mover Seek Position
This parameter represents the data stream offset of the first byte the DMA requested the mover to transfer to the data connection during a mover read operation.
[-mover-bytes-left-to-read <integer>] - Mover Bytes Left to Read
This parameter represents the number of data bytes remaining to be transferred to the data connection to satisfy the current NDMP_MOVER_READ request.
[-mover-window-offset <integer>] - Mover Window Offset
This parameter represents the absolute offset of the first byte of the mover window within the overall data stream.
[-mover-window-length <integer>] - Mover Window Length
This parameter represents the length of the current mover window in bytes.
[-mover-position <integer>] - Mover Position
This parameter can be used to list only those sessions, whose mover position matches a specific value. Mover-position should be an integer.
[-mover-setrecordsize-flag {true|false}] - Mover SetRecordSize Flag
This parameter is used by the DMA to establish the record size used for mover-initiated tape read and write operations.
[-mover-setwindow-flag {true|false}] - Mover SetWindow Flag
This flag represents whether a mover window has been set or not. A mover window represents the portion of the overall backup stream that is accessible to the mover without intervening DMA tape manipulation.
[-mover-con-addr-type <address type>] - Mover Connect Type
This parameter specifies the type of data connection established by the mover. The data connection can be established locally within a given system or between remote networked systems.
[-mover-con-addr <text>] - Mover Connect Address
This parameter specifies the endpoint address or addresses that the mover will use when establishing a data connection.
[-mover-con-port <integer>] - Mover Connect Port
This parameter specifies the TCP/IP port that the mover will use when establishing a data connection.
[-eff-host <host type>] - Effective Host
This parameter indicates the host context in which the NDMP session runs. The valid values are: PRIMARY or PARTNER.
[-client-addr <text>] - NDMP Client Address
This parameter specifies the client's IP address.
[-client-port <integer>] - NDMP Client Port
This parameter specifies the client's port number.
[-spt-device-id <text>] - SCSI Device ID
This parameter specifies the SCSI device ID.
[-spt-ha <integer>] - SCSI Host Adapter
This parameter specifies the SCSI host adapter.
[-spt-scsi-id <integer>] - SCSI Target ID
This parameter specifies the SCSI target.
[-spt-scsi-lun <integer>] - SCSI LUN ID
This parameter specifies the SCSI LUN ID.
[-tape-device <text>] - Tape Device
This parameter specifies the name to identify the tape device.
[-tape-mode <mover mode>] - Tape Mode
This parameter specifies the mode in which tapes are opened.
[-node {<nodename>|local}] - Node
If this parameter is specified, the command displays information about the sessions running on the specified node only. Node should be a valid node name.
[-is-secure-control-connection {true|false}] - Is Secure Control Connection
This parameter specifies whether the control connection is secure or not.
[-data-backup-mode <text>] - Data Backup Mode
This parameter specifies whether the mode of data backup is Dump or SMTape.
[-data-path <text>] - Data Path
This parameter specifies the path of data being backed up.
[-source-addr <text>] - NDMP Source Address
This parameter specifies the control connection IP address of the NDMP session.

Examples

The following example displays diagnostic information about all the sessions in the cluster:

cluster1::> vserver services ndmp probe

Vserver Name: vserver1
Session Identifier: 1000:7445
NDMP Version: 4
Session Authorized: true
Data State: IDLE
Data Operation: NOACTION
Data Server Halt Reason: NA
....
...

Vserver Name: vserver2
Session Identifier: 1000:7446
NDMP Version: 4
Session Authorized: true
Data State: IDLE
Data Operation: NOACTION
Data Server Halt Reason: NA
....
...


The following example displays diagnostic information of sessions associated with Vserver vserver1 only:

cluster1::> vserver services ndmp probe -vserver vserver1

Vserver Name: vserver1
Session Identifier: 1000:7445
NDMP Version: 4
Session Authorized: true
Data State: IDLE
Data Operation: NOACTION
Data Server Halt Reason: NA
....
...
....
...