lsspecvsnapshots

Use the lsspecvsnapshots command to display the Spectrum Virtualize snapshots for a specified session and role.

Syntax

Read syntax diagramSkip visual syntax diagramlsspecvsnapshots-help-h-?-s-l-fmtdefaultxmldelim-delimcharstanza-ponoff-hdronoff-voffon-snapshotnamesnapshot_name-rolerole_namesession_name -

Parameters

-help | -h | -?
Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.
-s | -l
Specifies the default and detailed command output, which is the same in this case. Displays the following detailed information.
Column label Details
Snapshot Name Name of the snapshot.
Snapshot Time Timestamp for when the snapshot was taken.
Session Name The name of the session.
Role The name of the role backed up.
isRecoverable Whether the snapshot is considered recoverable.
Last Result The last result of the snapshot.
Copy Sets The number of copysets in the backup.
Expiration Expiration time for the snapshot.
Safeguarded Whether the snapshot is safeguarded or not.
-fmt { default | xml | delim | stanza }
Specifies the format of the output. You can specify one of these values:
default
Specifies that the output is displayed in tabular format using spaces as delimiters between columns. This is the default value.
xml
Specifies that the output is displayed in XML format.
delim
Specifies that output is displayed in a tabular format using commas as delimiters between columns.
To use a character other than a comma as the delimiter, specify -fmt delim -delim char , where char represents the character that you want to use as the delimiter. For example, if you want to use a colon (:) as the delimiter, use the following -fmt parameter:
-fmt delim -delim :
If you use a shell metacharacter as the delimiting character, enclose the character in quotation marks or single quotation marks. A blank space is not a valid character.
stanza
Specifies that the output is displayed as one keyword-value pair per line.
-p { on | off }
Specifies whether to display one page of text at a time or all text at once.
on
Displays one page of text at a time. Pressing any key displays the next page. This is the default value when the command is run in interactive mode.
off
Displays all text at once. This is the default value when the command is run in single-shot mode.
-hdr { on | off }
Specifies whether to display the table header. You can specify one of these values:
on
Displays the table header. This is the default value.
off
Hides the table header.
-v { on | off }
Specifies whether to enable verbose mode. You can specify one of these values:
on
Enables verbose mode.
off
Disables verbose mode. This is the default value.
-snapshotname snapshot_name
Specifies the name for the snapshot. This value is used to filter the list of snapshots returned. Only the snapshot with the given name will be displayed
-role role_name
Specifies that only snapshots that are associated with the specified role name are displayed.
-session_name |-
Specifies the name of the session used to display backups.

Example: Listing snapshots for a given session

The following command lists the snapshots used for a session named MySnapshotSess and role H1.

csmcli> lsspecvsnapshots -role h1 MySnapshotSess

The following output is returned:

snapshot    snapshot                 Session          is            Last        Copy  Expiration             Safeguarded
Name        Time                     Name             Recoverable   Result      Sets   
=========================================================================================================================
snapshot1  2022-05-17 13:25:26 CDT  MySnapshotSess   Yes           IWNR2870I    5      -                       No
snapshot2  2022-05-17 13:52:25 CDT  MySnapshotSess   Yes           IWNR2870I    5      -                       No
snapshot3  2022-05-17 14:15:58 CDT  MySnapshotSess   Yes           IWNR2870I    5      -                       No
snapshot4  2022-05-17 14:35:56 CDT  MySnapshotSess   Yes           IWNR2870I    5      -                       No
snapshot5  2022-05-17 14:36:36 CDT  MySnapshotSess   Yes           IWNR2870I    5      2022-05-18 14:36:36     Yes