8.5.2 swstsdv (Snap Data Volume Operation/Reference Command)

NAME

swstsdv - Initialize or display the Snap Data Volume

SYNOPSIS

To Initialize Snap Data Volume

/opt/FJSVswsts/bin/swstsdv init volumeName
/opt/FJSVswsts/bin/swstsdv init -G accessVolumeName luNumber

To Display Snap Data Volume Status

/opt/FJSVswsts/bin/swstsdv stat volumeName
/opt/FJSVswsts/bin/swstsdv stat -G accessVolumeName luNumber

To Display Snap Data Pool Status

/opt/FJSVswsts/bin/swstsdv poolstat -G volumeName

DESCRIPTION

Snap Data Volume initialization/status display and Snap Data Pool status display are all possible. Specify one of the following subcommands according to the contents you want to operate on, and then execute the subcommand.

Snap Data Volume Initialization

Specify "init" as the subcommand to initialize the Snap Data Volume.
Initialize the Snap Data Volume when SnapOPC and SnapOPC+ are not running.
All the data in the Snap Data Volume is destroyed in the initialization of the Snap Data Volume. For this reason, the following procedure is recommended.
(Creation of the Access volume and collection of the LU-Number must be completed before logical volume manager operations.)

If there is necessary data in the Snap Data Volume, back it up in advance using the relevant OS command.
Initialize the disk management information.
Set the target Snap Data Volume (physical disk) outside logical volume manager management when there is a logical volume manager operation.
Initialize the Snap Data Volume using this command.
Initialize the information using the Access volume when there is a logical volume manager operation.

Snap Data Volume Status Display

Specify "stat" as the subcommand to display Snap Data Volume logical capacity, physical capacity, used space capacity, and unused space capacity.

The contents that are displayed are as follows:

Title	Description
BoxID	Displays the Box ID.
LUN	Displays the logical unit number on the ETERNUS Disk storage system. The format used for the display is "<decimal>(<hexadecimal>)".
Rate	Displays the Snap Data Volume usage as a percentage (%).
Logical	Displays the Snap Data Volume logical capacity. The unit used for display is 'sector'.
Physical	Displays the Snap Data Volume physical capacity. The unit used for display is 'sector'.
Used	Displays the amount of Snap Data Volume used space. The unit used for display is 'sector'. The capacity for both Copy usage (1) and Host usage (1) is displayed.
Copy	For the space used in the Snap Data Volume, Copy usage (*1) is displayed. The unit used for display is 'sector'.
Host	For the space used in the Snap Data Volume, Host usage (*1) is displayed. The unit used for display is 'sector'.
Pool	Displays the Snap Data Pool usage allocated to the Snap Data Volume. The unit used for display is 'sector'.

*1:
Copy usage: Usage in which the update occurs while SnapOPC or SnapOPC+ is running.
Host usage: Update of Snap Data Volume while SnapOPC and SnapOPC+ are not running.

Snap Data Pool Status Display

Specify "poolstat" as the subcommand to display the Snap Data Pool total amount, used space capacity, and unused space capacity.

The contents that are displayed are as follows:

Title	Description
BoxID	Displays the Box ID.
Pool-Type	Displays the Snap Data Pool type. Normal Encrypted
Rate	Displays the Snap Data Pool usage rate (%).
Total	Displays the Snap Data Pool total amount. The unit used for display is 'sector'.
Used	Displays the Snap Data Pool used space capacity. The unit used for display is 'sector'. The capacity for both Copy usage (1) and Host usage (1) is displayed.
Copy	For the space used in the Snap Data Pool, Copy usage (*1) is displayed. The unit used for display is 'sector'.
Host	For the space used in the Snap Data Pool, Host usage (*1) is displayed. The unit used for display is 'sector'.
Free	Displays the Snap Data Pool unused space capacity. The unit used for display is 'sector'.

*1:
Copy usage: Usage in which the update occurs while SnapOPC or SnapOPC+ is running.
Host usage: Update of Snap Data Volume while SnapOPC and SnapOPC+ are not running.

OPTIONS

Options of "init" Subcommand

-G accessVolumeName: Specifies the Access volume.
For details on Access volume, refer to "Creating Access Volume".

Options of "stat" Subcommand

-G accessVolumeName: Specifies the Access volume.
For details on Access volume, refer to "Creating Access Volume".

Options of "poolstat" Subcommand

-G volumeName: Specifies the ETERNUS Disk storage system volume.
If a Snap Data Volume is specified with insufficient capacity however, an error occurs in the command. In this case, specify an Access volume for which there is sufficient capacity.
For details on Access volume, refer to "Creating Access Volume".

OPERANDS

Operands of "init" Subcommand

volumeName: Specifies the volume name (AdvancedCopy Manager device name) of the Snap Data Volume to be initialized.
If a partition (slice) has been specified, the Logical Unit (disk) on which the partition (slice) exists is initialized.

luNumber: Specifies the logical unit number in the ETERNUS Disk storage system.
This value is specified as a decimal.

Operands of "stat" Subcommand

volumeName: Specifies the Snap Data Volume volume name (AdvancedCopy Manager device name).
If a partition (slice) has been specified, the information about the Logical Unit (disk) on which the partition (slice) exists is displayed.

luNumber: Specifies the logical unit number in the ETERNUS Disk storage system.
This value is specified as a decimal.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

Snap Data Volume is initialized:

# /opt/FJSVswsts/bin/swstsdv init /dev/vg51
swstsdv init completed
#

The Snap Data Volume is initialized using the Access volume following insufficient capacity:
```
# /opt/FJSVswsts/bin/swstsdv init -G /dev/vg31 110
swstsdv init completed
#
```

The Snap Data Volume status is displayed:

# /opt/FJSVswsts/bin/swstsdv stat /dev/vg51
BoxID = 00E4000M3#####E450S20A####KD4030639004##
LUN = 201 (0xC9)
Rate Logical(sector) Physical(sector) Used(sector) Copy(sector) Host(sector) Pool(sector)
0%   8388608         1048576          0            0            0            0
#

The LU-Number (110) status is displayed using the Access volume:

# /opt/FJSVswsts/bin/swstsdv stat -G /dev/vg31 110
BoxID = 00E4000M3#####E450S20A####KD4030639004##
LUN = 110 (0x6E)
Rate Logical(sector) Physical(sector) Used(sector) Copy(sector) Host(sector) Pool(sector)
0%   8388608         1048576          0            0            0            0
#

The Snap Data Pool status is displayed by specifying the Access volume:

# /opt/FJSVswsts/bin/swstsdv poolstat -G /dev/vg31
BoxID = 00E4000M3#####E450S20A####KD4030639004##
Pool-Type Rate Total(sector) Used(sector) Copy(sector) Host(sector) Free(sector)
Normal    10%  20971520      2097152      0            2097152      18874368
Encrypted 0%   20971520      0            0            0            20971520
#

NOTES

When there is insufficient Snap Data Volume capacity, operations are possible using the Access volume and logical unit number in the ETERNUS Disk storage system.
When there is insufficient Snap Data Volume capacity, however, and "stat" is specified in the subcommand and an attempt is made to check the logical unit number of the Snap Data Volume with insufficient Snap Data Volume capacity, an access error occurs when the attempt to access the Snap Data Volume with insufficient Snap Data Volume capacity is made. In this case, an error occurs in the command and it is not possible to check the logical unit number.
For this reason, you must check the logical unit number in advance and record it.