Preparing to take a snapshot

Virtual Storage Platform One SDS Block Virtual Private Storage Administrator Guide

Version

1.15.x

Audience

anonymous

Part Number

MK-24VSP1SDS003-02

Run either of the following commands with the copy-source volume specified to create a volume (S-VOL) to take a snapshot of.

Preparation for taking a snapshot cannot be performed if there is a snapshot whose status is "Deleting" or "Error" on the copy-source volume.
If the copy-source volume is a snapshot, the system can be prepared for taking a snapshot only when the copy-source snapshot is in Normal state.

Note:

Preparing to take a snapshot and taking a snapshot can be performed in one step. Batch processing simplifies the operation, but if the snapshot is to be taken after I/O is stopped, the I/O stop time will be longer because I/O must also be stopped for the time it takes to prepare to take the snapshot.

Therefore, this manual separately describes the operation for preparing to take a snapshot and the operation for taking a snapshot.

To sequentially perform the operation for preparing to take a snapshot and the operation for taking a snapshot, specify PrepareAndFinalize for the operationType parameter (in the case of CLI, --operation_type) when you perform step 3.

Note that the operation for preparing to take a snapshot and the operation for taking a snapshot are sequentially performed if the operationType parameter (in the case of CLI, --operation_type) is omitted.

Required role: VpsStorage

Verify the ID of the volume for which you want to create a snapshot.

If you want to specify a volume by its name in the CLI, verify the name of the intended volume.

REST API: GET /v1/objects/volumes

CLI: volume_list
Obtain a list of S-VOL information by specifying the ID of the copy-source volume, and then confirm that there are no volumes for which snapshotStatus is "Deleting" or "Error".

If you use the CLI, you can specify the name of the volume instead of its ID.

REST API: GET /v1/objects/volumes/<id>/snapshot-volumes

CLI: snapshot_volume_list

If there are any volumes with snapshotStatus of "Deleting", wait for the respective processes to complete. If there are any volumes with "Error" snapshotStatus, delete the associated S-VOLs.
Prepare to take a snapshot.

Run either of the following commands with the ID of the copy-source volume specified and "Prepare" specified for the operationType parameter.

If you use the CLI, you can specify the name of the volume instead of its ID. The parameter is --operation_type and the specified value is "Prepare".

REST API: POST /v1/objects/volumes/actions/create-snapshot/invoke

CLI: volume_create_snapshot

Verify the job ID which is displayed after the command is run.
Verify the state of the job.

Run either of the following commands with the job ID specified.

REST API: GET /v1/objects/jobs/<jobId>

CLI: job_show

If the job state is "Succeeded", the job is completed.
Obtain a list of S-VOL information to verify that an S-VOL whose snapshotStatus is "Prepared" has been created.

Run one of the following commands with the ID of the copy-source volume specified.

If you use the CLI, you can specify a name instead of the ID of the volume.

REST API: GET /v1/objects/volumes/<id>/snapshot-volumes

CLI: snapshot_volume_list

After performing step 4, it might take approximately one minute for the snapshot status to change. When you want to verify that the snapshot status has changed, wait for approximately one minute before verification.