ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • system smtape status show

    Show status of SMTape sessions

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

    Description

    This command lists the status of all SMTape sessions in the cluster. By default, this command lists the following information:

    • Session

    • Type

    • Status

    • Progress

    • Path

    • Device

    • Node

    Parameters

    { [-fields <fieldname>,…​]

    Use this parameter to display additional fields about each session apart from the default entries. This parameter is optional. Any combination of the following fields is valid:

    • Session

    • Node

    • Type

    • Status

    • Path

    • Device

    • Progress

    • Start-time

    • End-time

    • Update-time

    • Backup-snapshot

    • Tape-block-size

    • Error

    | [-instance ] }

    Displays detailed information about the specified sessions.

    [-session <Sequence Number>] - Session Identifier

    Selects information about a specific SMTape session. A Session Identifier is a number that is used to identify a particular SMTape session.

    [-node {<nodename>|local}] - Node Name

    Selects information about sessions related to the specified node.

    [-type {backup|restore}] - Operation Type

    Selectsinformation about SMTape sessions of the specified operation type.

    [-status {COMPLETED|FAILED|ACTIVE|WAITING|ABORTING|UNKNOWN}] - Session Status

    Selects information about SMTape sessions having the specified status in the parameter.

    [-path <text>] - Path Name

    Selects information about SMTape sessions on a volume which is at the specified path name. This is the logical path of the volume and you must specify the path name in the following format: /vserver_name /volume_name .

    [-device <text>] - Device Name

    Selects information about the SMTape sessions on the specified tape device. You must specify the tape device name in the following format: /node_name /tape_device .

    [-progress {<integer>[KB|MB|GB|TB|PB]}] - Bytes Transferred

    Selects information about SMTape sessions in which the number of data bytes transferred in a particular session matches with the number specified in this parameter.

    [-start-time <MM/DD/YYYY HH:MM:SS>] - Start Time

    Selects information about SMTape sessions whose starting time matches the specified starting time.

    [-end-time <MM/DD/YYYY HH:MM:SS>] - End Time

    Selects information about SMTape sessions whose ending time matches the specified ending time.

    [-backup-snapshot <snapshot name>] - Snapshot Name

    Selects information about SMTape sessions that use a particular Snapshot copy name which matches the specified Snapshot copy name in the parameter in backup or restore operations.

    [-tape-block-size <integer>] - Tape Block Size

    Selects information about SMTape sessions that use a particular tape block size which matches the specified tape block size parameter in backup or restore operations.

    [-error <text>] - Error Description

    Selects information about SMTape sessions that have a particular error description which matches the specified error description in the parameter.

    Examples

    Displays default entries about the five SMTape sessions.

    cluster1::> system smtape status show
    
    Session Type    Status    Progress  Path         Device          Node
    ------- ------- --------- --------  ------------ --------------- -----------
    5       Backup  COMPLETED     50MB  /vsrvr1/vol1 /cls1-01/nrst0l cluster1-01
    4       Restore FAILED          0B  /vsrvr1/vol3 /cls1-02/nrst2l cluster1-02
    3       Backup  COMPLETED     50MB  /vsrvr1/vol3 /cls1-01/nrst0l cluster1-01
    2       Backup  COMPLETED     50MB  /vsrvr1/vol2 /cls1-03/nrst0m cluster1-03
    1       Backup  COMPLETED     50KB  /vsrvr1/vol5 /cls1-01/nrst0n cluster1-01
    5 entries were displayed.

    The following example shows the output with the -instance argument.

    cluster1::> system smtape status show -instance
    
    Session Identifier: 1
             Node Name: node1
        Operation Type: Backup
                Status: COMPLETED
             Path Name: /vs1/vol1
           Device Name: /node1/rst0a
     Bytes Transferred: 2048
            Start Time: 1/4/2012 14:26:24
              End Time: 1/4/2012 14:29:45
          Last updated: 1/4/2012 14:29:45
         Snapshot Name: vol1.snapshot
       Tape Block Size: 240
     Error Description: None
    Top of Page