raidcom get snapshot

Storage Advisor Embedded User Guide

Version
93-07-2x
88-08-12
Audience
anonymous
Part Number
MK-97HM85022-25

Displays the information of snapshot group and snapshot data that are defined in the device. If this option is omitted, the list of snapshot group is displayed.

Syntax

raidcom get snapshot [-ldev_id <ldev#> [-key opt] | -snapshotgroup <name> 
[-key {opt|detail}]] [-format_time] [{-check_status | -check_status_not} <string>... 
[-time <time>]]

Options and parameters

[-ldev_id <ldev#>]

Specifies the LDEV number to be displayed the snapshot data information. Specifies either one of P-VOL or S-VOL for the LDEV number.

[-snapshotgroup <name>]

Specifies the snapshot group in which you want to display the snapshot data information.

[-key opt]
Specify the -key opt option together with the -ldev_id or the -snapshotgroup option to display the following:
  • SMPP as the snapshot data status
  • (VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) SLU attribute and information of the Diff Clone pair that is being used in the VASA environment
  • (VSP 5000 series, VSP G1x00 and VSP F1500, VSP G130, G/F350, G/F370, G/F700, G/F900) Status of expansion processing of DP-VOL
  • (VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Status of the Read Only attribute of the Snapshot data.
[-key detail]
Specify the -key detail option together with the -ldev_id or the -snapshotgroup option to display the following:
  • SMPP as the snapshot data status
  • (VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) SLU attribute and information of the Diff Clone pair that is being used in the VASA environment
  • Status of expansion processing of DP-VOL
  • (VSP 5000 series, VSP G1x00 and VSP F1500, VSP G130, G/F350, G/F370, G/F700, G/F900) Status of the Read Only attribute of the Snapshot data
  • (VSP 5000 series) MODE (R) indicating snapshot data of a Thin Image Advanced pair in the snapshot group mode
Specifying this option expands the display area of MODE.
The following lists the differences in the display format depending on whether to specify this option:
  • When the -key detail option is not specified:

    MODE

    -N--

    (Displayed in a format available to display up to 4 modes.)

  • When the -key detail option is specified:

    MODE

    ---AR-------

    (Displayed in a format available to display up to 12 modes.)

[–format_time]

Specify this option to display the time when a snapshot data (SPLT-TIME) is created, with the format1 below. The time zone used in the storage system2 is displayed. Zero “0” is added to the beginning if the value of each element is shorter than the regulated length.

Format: YYYY-MM-DDThh:mm:ss

Where:

  • YYYY-MM-DD = year-month-date
  • hh = time in 24 hours, range 0-23
  • mm:ss = minute:second

For example, December 2, 2016, one o’clock p.m. is displayed as 2016-12-02T13:00:00

Notes:

  1. “T” in the format separates the date and the time.
  2. For VSP 5000 series VSP G130, G/F350, G/F370, G/F700, G/F900, VSP G200, G400, G600, G800 and VSP F400, F600, F800, the time zone set in the device is used.

    For other models, UTC+0 is used.

[-check_status <string> [-time <time>]]

Check if the snapshot group or the snapshot data is in the same state as specified in <string>. If the option contains multiple states, the OR condition check is performed and verifies that the snapshot group or snapshot data is in one of the states contained in the option.

The following strings are specified in the <string>:

  • COPY: Copy status.
  • PAIR: Pair status.
  • PSUS: Suspend status.
  • PSUE: Suspend failure status.
  • PFUL: Indicates that the Thin Image or Copy-on-Write Snapshot pool exceeds the threshold in the PAIR status.
  • PFUS: Indicates that the Thin Image or Copy-on-Write Snapshot pool exceeds the threshold in the PSUS status.
  • RCPY: Shows that the copying is in progress by resynchronization.
  • SMPP: Indicates that the pair is being deleted. When specifying SMPP, specify -key opt as well.
  • PSUP: Indicates that the pair is being split.

If "-time" is specified, the status of the snapshot group or the snapshot data is checked every three seconds until the end of the specified <time> (seconds).

When this option is specified, the returned values are as follows:

  • The snapshot group or the snapshot data is in one of the specified states: 0
  • The snapshot group or the snapshot data is in none of the specified states (without -time option): 1
  • The snapshot group or the snapshot data is in none of the specified states (when the specified <time> passed): EX_EWSTOT

Note:

When you specify -snapshotgroup <name>, and the pair is deleted, EX_ENOOBJ is returned.

[-check_status_not <string> [-time <time>]]

Check if the snapshot group or the snapshot data is not in the same state as specified in <string>. If the option contains multiple states, the OR condition check is performed and verifies that the snapshot group or snapshot data is not in any of the states contained in the option. The following strings are specified in the <string>.

  • COPY: Copy status.
  • PAIR: Pair status.
  • PSUS: Suspend status.
  • PSUE: Suspend failure status.
  • PFUL: Indicates that the Thin Image or Copy-on-Write Snapshot pool exceeds the threshold in the PAIR status.
  • PFUS: Indicates that the Thin Image or Copy-on-Write Snapshot pool exceeds the threshold in the PSUS status.
  • RCPY: Shows that the copying is in progress by resynchronization.
  • SMPP: Indicates that the pair is being deleted. When specifying SMPP, specify -key opt as well.
  • PSUP: Indicates that the pair is being split.

If "-time" is specified, the status of the snapshot group or the snapshot data is checked every three seconds until the end of the specified <time> (seconds).

When this option is specified, the returned values are as follows:

  • The snapshot group or the snapshot data is not in any of the specified states: 0
  • The snapshot group or the snapshot data is in one of the specified states (without -time option): 1
  • The snapshot group or the snapshot data is in one of the specified states (when the specified <time> passed): EX_EWSTOT
Note:

When you specify -snapshotgroup <name>, and the pair is deleted, EX_ENOOBJ is returned.

Examples

Displaying the list of snapshot groups.

# raidcom get snapshot
SnapShot_name P/S STAT Serial# LDEV# MU# P-LDEV# PID % MODE SPLT-TIME
snap1         -   -    85000098  -    -   -       -  - ----    -
snap2         -   -    85000098  -    -   -       -  - ----    -
snap3         -   -    85000098  -    -   -       -  - ----    -

Displaying the snapshot data related to the specific P-VOL (LDEV number: 14536).

# raidcom get snapshot -ldev_id 14536
SnapShot_name P/S STAT Serial# LDEV# MU# P-LDEV# PID % MODE SPLT-TIME
snap1       P-VOL PAIR 85000098 14536 1010    -    2 100 ----   -
snap2       P-VOL PAIR 85000098 14536 1011  13000  2 100 G---   -
snap3       P-VOL PAIR 85000098 14536 1012    -    2 100 ----   -

Displaying the snapshot data related to the specific P-VOL (LDEV number: 10).

# raidcom get snapshot -ldev_id 10 -key detail
SnapShot_name P/S STAT Serial# LDEV# MU# P-LDEV#
PID % MODE SPLT-TIME SLU C_LDEV# P R
snap1 P-VOL PAIR 85000098 10 0
20 0 - ---AR------- - Y - - D

Displaying the snapshot data related to the specific S-VOL (LDEV number: 13000).

# raidcom get snapshot -ldev_id 13000
SnapShot_name P/S STAT Serial# LDEV# MU# P-LDEV# PID % MODE SPLT-TIME
snap2       S-VOL PAIR 85000098 13000 1011 14536  2 100 G---  -

Displaying the snapshot data included in the specific snapshot group.

# raidcom get snapshot -snapshotgroup snap2
SnapShot_name P/S STAT Serial# LDEV# MU# P-LDEV# PID % MODE SPLT-TIME
snap2       P-VOL PAIR 85000098 14536 1011 13000  2 100 G---  -
snap2       P-VOL PAIR 85000098 14537 1011 13001  2 100 G---  -
snap2       P-VOL PAIR 85000098 14538 1011 13002  2 100 G---  -

Displaying SPLT-TIME in YYYY-MM-DDThh:mm:ss format.

# raidcom get snapshot -ldev_id 14356  -format_time
SnapShot_name   P/S STAT   Serial# LDEV#   MU# P-LDEV# PID    % MODE SPLTTIME
        snap1 P-VOL PSUS 85000098 14536 1010       -	  2 100 ---- 2016-07-22T10:18:20
        snap2 P-VOL PSUS 85000098 14536 1011   13000  2 100 G--- 2016-07-22T10:18:20
        snap3 P-VOL PSUS 85000098 14536 1012       -   2 100 ---- 2016-07-22T10:18:20

Displays the snapshot data with the SLU attribute related to the specific S-VOL (LDEV # 40960) by specifying the -key opt option.

# raidcom get snapshot -ldev_id 40960 –key opt
SnapShot_name P/S STAT Serial# LDEV# MU# P-LDEV# PID %
MODE SPLT-TIME SLU C_LDEV#  P  R
Snap2       S-VOL PAIR 85000098 40960 1012  258  2 100
A---        -    Y       -  -  D

Description of each column in output example:

SnapShot_name

Displays the name of snapshot group defined in the device.

P/S

Displays the attribute of the target LDEV. It displays P-VOL for the P-VOL and S-VOL for the S-VOL. In the list of snapshot, "-" is displayed.

STAT

Displays the following status of each snapshot data:

  • SMPP: The pair is being deleted.
  • PSUP: The pair is being suspended.
  • CPYD: The differential data is being copied.
  • Other statuses: See pairdisplay command.
Serial#

Displays the product serial number.

LDEV#

Displays the LDEV number related to the snapshot.

MU#

Displays the Mirror ID of the P-VOL for the snapshot.

P-LDEV#

Displays the LDEV number of the volume (P-VOL or S-VOL) of the pair associated with the snapshot data. If the LDEV that is paired belongs to a different virtual storage machine, "----" is displayed.

PID

Displays the pool ID.

%

When MODE is clone or cascade mode, displays one of the following according to the status of STAT:

  • When STAT is COPY, CPYP, RCPY, SMPP, or PSUP: Displays the progress rate of each processing.
  • For other statuses: Displays the concordance rate between the P-VOL and the S-VOL of a pair.

    When MODE is other than clone or cascade mode, the concordance rate between the P-VOL and the S-VOL is always displayed regardless of the STAT status.

    When MODE is R that indicates snapshot data of a Thin Image Advanced pair, a hyphen (-) is always displayed in the concordance rate.

The following shows the concordance rate for each pair status.
  • PSUS: 0% to 100%
  • RCPY: 0% to 100%1
  • PAIR: 100%
  • COPY: 0% to 100%2
  • CPYD: 0% to 100%
Note:
  1. Displays the concordance rate before changing to RCPY status. The displayed value might decrease during RCPY status because the copy works.
  2. Displays the concordance rate before changing to COPY status. The displayed value does not change during COPY status.
MODE

Displays the status of snapshot data:

  • G: The snapshot data created in CTG mode.
  • W: The status when the data are written in the secondary volume from the host in the PSUS/PFUS status.
  • C: The snapshot data created in clone mode.
  • A: The snapshot data created in cascade mode.
  • D: The snapshot data created in Diff Clone mode that is used in the VASA environment.
  • R: The snapshot data of a Thin Image Advanced pair.
SPLT-TIME

Displays the time when a snapshot data is created. When -format_time option is specified, displays in YYYY-MM-DDThh:mm:ss format. When -format_time option is not specified, indicates accumulated time in seconds from January 1, 1970 (GMT).

SLU
Displays whether the SLU attribute is set for the snapshot:
  • Y: The SLU attribute is set.
  • N: Non-SLU attribute is set.

    A hyphen (-) is displayed for unsupported DKCMAIN microcode version.

C_LDEV#

Displays the LDEV number of the diff compare volume (base volume), which is used for comparing the difference between the Diff Clone pair volumes in the VASA environment.

A hyphen (-) is displayed for unsupported microcode version.

P
Displays the status of expansion processing of DP-VOL (VSP 5000 series, VSP G1x00 and VSP F1500and VSP G130, G/F350, G/F370, G/F700, G/F900 only).
  • E: Expansion is in progress.
  • N: Not processed.
  • - (hyphen): This information is not available.

A hyphen (-) is displayed if the microcode version is not supported.

R
Displays the status of the Read Only attribute of the snapshot data (VSP 5000 seriesand VSP G130, G/F350, G/F370, G/F700, G/F900 only).
  • E: Read Only attribute is enabled.
  • D: Read Only attribute is disabled.
  • - (hyphen): This information is not available.

A hyphen (-) is displayed if the microcode version is not supported.