Block Storage

Overview

Block Storage: The block storage function provides high-performance service for important business.

Related Definitions

Block Storage Volume: A block storage volume displays the block storage device provided in a storage pool. The data of a block storage volume is distributed in multiple data disks of multiple servers based on specified replicas and has advanced characteristics such as thin provisioning and scalability.

High-performance block gateway: Manages a Vhost client that provides access to high-performance block storage. See High-Performance Block Gateway.

Snapshot: A snapshot is a point-in-time capture of data status in a block storage volume and provides data backup and recovery features for the storage system.

High-Performance Block Gateway

A high-performance block gateway manages a Vhost client that provides access to high-performance block storage. You can create, view, modify, and delete these gateways in the ZStack ZStone UI and view the client CPU, storage network, and hugepage memory configurations.

On the main menu, choose Block Storage > Block Gateway > High-Performance Block Gateway to open the gateway list.

Prerequisites

  • A high-performance storage cluster has been initialized. For instructions, see Initialize High-Performance Storage Cluster.
  • A high-performance storage server with the block storage gateway role has been added and is connected with deployment completed. For instructions, see Add a High-Performance Storage Server.
  • The selected server has no existing Vhost and has sufficient available CPU and hugepage memory resources for the selected performance mode. Only one Vhost can be created on a server.

Workflow

  1. Select a server and client settings to create a gateway. For instructions, see Create a High-Performance Block Gateway.
  2. After creation completes, check the client settings and mounted volume count in High-Performance Block Gateway Details.
  3. Modify settings as needed. Unmount all volumes before deleting a gateway. For instructions, see Manage High-Performance Block Gateways.

Create a High-Performance Block Gateway

On the main menu of ZStack ZStone, choose Block Storage > Block Gateway > High-Performance Block Gateway to open the gateway list.

  1. Click Create Block Gateway to open the creation page.
  2. Configure the following parameters.
ParameterDescription
ServerSelect a high-performance storage server with the block storage gateway role. Servers with an existing Vhost are excluded. After selection, the server Public IP is displayed and the gateway name is generated by prefixing the selected server name with vhost-.
DescriptionOptional. Enter a description of up to 256 characters.
ProtocolFixed to Vhost.
Performance ModeSelect Light, Standard, High Performance, or Extreme, corresponding to 1, 2, 4, or 6 CPU cores. The default is High Performance. CPU cores are allocated automatically during creation.
Storage NetworkSelect RDMA or TCP. RDMA is selected by default when RDMA is enabled for the cluster; otherwise TCP is selected. The RDMA option is unavailable when cluster RDMA is disabled.
Hugepage MemorySet the client hugepage memory in MiB. The default is 2048 MiB. Specify an integer of at least 512 MiB that is a multiple of 4 MiB.

CPU cores are allocated automatically during creation. To select cores manually, modify the gateway after creation completes. See Manage High-Performance Block Gateways.

Submit and Check the Result

Review the settings and submit the creation request. Creation runs as a background task. Returning to the list does not mean the task has completed.

Refresh the list to check resource state, or check the task result under Monitoring Management > Operation Log. After creation completes, click the resource name to view High-Performance Block Gateway Details. If creation fails, check the operation log details for the failure reason.

High-Performance Block Gateway Details

On the main menu of ZStack ZStone, choose Block Storage > Block Gateway > High-Performance Block Gateway, and click a resource name to open its details page.

The Overview tab contains basic information and Vhost client configuration.

Basic Information

FieldDescription
StateCurrent gateway state. Modifying or deleting the gateway also requires the corresponding action conditions to be met.
ProtocolFixed to Vhost.
UUIDUnique gateway identifier. You can copy it to locate the resource.
ServerName of the server running the Vhost client.
IP AddressIP address of the associated server. You can copy the address.
Mounted Volume CountNumber of mounted volumes. The count must be 0 before deletion.
Creation Time and Update TimeResource creation time and most recent update time.

Vhost Client Configuration

FieldDescription
Performance ModeCurrent performance mode and its CPU core count.
Storage NetworkRDMA or TCP used by the client.
NUMA NodeNUMA information for the CPU allocation. An allocation spanning nodes is shown as cross-NUMA.
CPU CoreAllocated CPU IDs or ID ranges. Distinguish these IDs from the core count of the performance mode.
Hugepage MemoryConfigured hugepage memory in MiB.
Hugepage DirectoryHugepage directory configured by the system. This is a read-only field on this page.

Manage High-Performance Block Gateways

On the main menu of ZStack ZStone, choose Block Storage > Block Gateway > High-Performance Block Gateway. Refresh the list to check resource state, or click a resource name to view High-Performance Block Gateway Details.

ActionDescription
Create Block GatewaySelect a server and create a Vhost client. See Create a High-Performance Block Gateway.
ModifyAllowed only when the operation status is Ready. You can modify the description, performance mode, CPU allocation, storage network, and hugepage memory. The server cannot be changed.
DeleteAllowed only when the operation status is Ready or Error and the mounted volume count is 0. Unmount all Vhost volumes before deletion.

Modify a High-Performance Block Gateway

  1. Choose Modify for the gateway on its list or details page.
  2. Modify the description, performance mode, storage network, or hugepage memory as needed. For parameter definitions and limits, see Create a High-Performance Block Gateway. The server cannot be changed.
  3. Set the CPU Core allocation method:
    • Automatic Allocation: The system selects CPU cores for the performance mode.
    • Manual Selection: Select cores grouped by NUMA node and physical CPU. You can select available cores or cores already allocated to this Vhost. The count must match the 1, 2, 4, or 6 cores required by the performance mode. Only automatic allocation is available if CPU topology is unavailable.

    After changing the performance mode, review the selected cores to match the new mode.

  4. Submit the changes. If a runtime configuration confirmation dialog appears, review the service impact before continuing.
Warning: Changing the performance mode, CPU cores, storage network, or hugepage memory restarts the Vhost client. Related volumes may reconnect and services may pause. Schedule the operation during a low-traffic period.

Check task completion under Monitoring Management > Operation Log, and then verify the applied configuration on the details page.

Delete a High-Performance Block Gateway

  1. Verify that the mounted volume count is 0 and all Vhost volumes have been unmounted.
  2. Choose Delete for the gateway on its list or details page.
  3. Review the resource information and configuration cleanup notice, and confirm deletion.
  4. Check the task result in the operation log. After successful deletion, refresh the list to verify that the resource has been removed. If deletion fails, check the operation log for the failure reason.
Warning: Deletion cleans up the block gateway configuration. Unmount all related volumes before proceeding.

Block Storage Volume

Create a General Block Storage Volume

On the main menu of ZStack ZStone, choose Block Storage > Block Storage Volume. On the Block Storage Volume page, click General Block Storage Volume > Local > Create Block Storage Volume. Then, the Create Block Storage Volume page is displayed.

Set the following parameters:
  • Name: Set the name for the block storage volume.

    Naming rules: 1-128 characters long. The name can only contain Chinese characters, letters (a-z, A-Z), digits, spaces, hyphens (-), underscores (_), periods (.), parentheses (), colons (:), and plus signs (+). You cannot start or end with spaces.

  • Quantity: Set the number of block storage volumes. You can create block storage volumes in bulk.
    Note: The field requires to be a digit ranging from 1 to 100.
  • Storage Pool: Select storage pools for block storage volumes.
    The platform automatically filters available storage pools that meet the three requirements below at the same time:
    1. The type of the storage pool is Block Storage.
    2. The role of the storage pool is Data Pool.
    3. The data redundancy type is Replicas.
  • Capacity: Set the capacity for the block storage volume (MB/GB/TB).
    Note:
    • The input must be greater than 1 MB and not exceed the maximum limit of 512TB.
    • We recommend you input a capacity no more than the actual available capacity of the selected storage pool.
Figure 1. Create a General Block Storage Volume


Manage a General Block Storage Volume

Manage a Local Block Storage Volume

On the main menu of ZStack ZStone, choose Block Storage > Block Storage Volume > General Block Storage Volume. On the General Block Storage Volume page, click Local. Then, the Local page is displayed.

The following actions help to manage block storage volumes.
Action Description
Create Block Storage Volume Create block storage volumes. You can create up to 100 volumes at a time.
Set Business QoS If you enable this parameter, you can set the upper limit of the I/O requests that can be processed per second and the read/write bandwidth for the block storage volume.
  • Maximum IOPS: 0 or 100 to 2000000, integer. Entering 0 indicates no limit on the maximum IOPS.
  • Maximum Bandwidth: 0 or 2MB/s to 100GB/s, integer. Entering 0 indicates no limit on the maximum bandwidth.
Flatten Disconnect the volume with its source, creating an independent volume. Bulk action is supported. We recommend selecting fewer than 4 volumes every time to minimize the impact on I/O of the storage pool.
Expand Capacity Increases volume capacity.
  • The new capacity must be greater than the current capacity.
  • The expansion capacity must be greater than or equal to the minimum limit of 4 MB.
  • The expanded capacity must be no greater than 512 TB.
Migrate Migrate volumes to other storage pools. You can migrate up to 6 volumes at a time.
  • The system auto-deletes the source volume after it is successfully migrated.
  • Migrating a volume might affect your business I/O. We recommend that you avoid peak business hours to perform this action.
Create Snapshot Create snapshots for block storage volumes. You can create snapshots for up to 32 volumes at a time.
  • Remember to save the temporary state before critical actions so as to achieve rapid rollback in case of failures.
  • A maximum of 256 snapshots in every volume.
  • A maximum of 10,240 snapshots in every cluster.
Roll Back Restore volume data to the selected snapshot point. All data from the snapshot point to the current time point will be overwritten. Note that the action is irreversible. Proceed with caution.
  • We recommend you all read and write operations on target volumes and their snapshots when rolling back a volume to ensure data consistency.
  • Only volumes in healthy or failed rollback states support rollback.
Deep Clone Create full copies including all snapshots and QoS configurations of source volumes. You can clone up to 6 volumes at a time.
Delete Remove local block storage volumes. You can delete a maximum of 20 volumes at a time.
Note:
  • Deleting a bock storage volume detaches all data from the volume. After deletion, the volume data cannot be recovered. Proceed with caution.
  • If a block storage volume has snapshots , it cannot be deleted.

Manage a Third-Party Block Storage Volume

On the main menu of ZStack ZStone, choose Block Storage > Block Storage Volume > General Block Storage Volume. On the General Block Storage Volume page, click Third Party. Then, the Third Party page is displayed.

The following actions help to manage third-party block storage volumes.
Action Description
Update You can manually update the list of third-party block storage volumes and view their details.
Set Business QoS If you enable this parameter, you can set the upper limit of the I/O requests that can be processed per second and the read/write bandwidth for the block storage volume.
  • Maximum IOPS: 0 or 100 to 2000000, integer. Entering 0 indicates no limit on the maximum IOPS.
  • Maximum Bandwidth: 0 or 2MB/s to 100GB/s, integer. Entering 0 indicates no limit on the maximum bandwidth.
Note: QoS cannot be configured for those volumes already attached to access paths.
Create Snapshot Create snapshots for block storage volumes. You can create snapshots for up to 32 volumes at a time.
  • Remember to save the temporary state before critical actions so as to achieve rapid rollback in case of failures.
  • A maximum of 256 snapshots in every volume.
  • A maximum of 10,240 snapshots in every cluster.
Deep Clone Create full copies including all snapshots and QoS configurations of source volumes. You can clone up to 6 volumes at a time.
Delete Remove the updated block storage volumes. You can delete a maximum of 20 volumes at a time.
Note: Deleting a bock storage volume detaches all data from the volume. After deletion, the volume data cannot be recovered. Proceed with caution.

Create a High-Performance Block Storage Volume

On the main menu of ZStack ZStone, choose Block Storage > Block Storage Volume. On the Block Storage Volume page, click High-Performance Block Storage Volume > Local > Create Block Storage Volume. Then, the Create Block Storage Volume page is displayed.

Set the following parameters:
  • Name: Set the name for the block storage volume.

    Naming rules: 1-128 characters long. The name can only contain Chinese characters, letters (a-z, A-Z), digits, spaces, hyphens (-), underscores (_), periods (.), parentheses (), colons (:), and plus signs (+). You cannot start or end with spaces.

  • Quantity: Set the number of block storage volumes. You can create block storage volumes in bulk.
    Note: The field requires to be a digit ranging from 1 to 100.
  • Storage Pool: Select high-performance storage pools for block storage volumes.
  • Capacity: Set the capacity for the block storage volume (MB/GB/TB).
    Note:
    • The input must be greater than 1 MB and not exceed the maximum limit of 512TB.
    • We recommend you input a capacity no more than the actual available capacity of the selected storage pool.
Figure 2. Create a High-Performance Block Storage Volume


Manage a High-Performance Block Storage Volume

Manage a Local Block Storage Volume

On the main menu of ZStack ZStone, choose Block Storage > Block Storage Volume > High-Performance Block Storage Volume. On the High-Performance Block Storage Volume page, click Local. Then, the Local page is displayed.

The following actions help to manage block storage volumes.
Action Description
Create Block Storage Volume Create block storage volumes. You can create up to 100 volumes at a time.
Delete Remove local block storage volumes. You can delete a maximum of 20 volumes at a time.
Note:
  • Deleting a bock storage volume detaches all data from the volume. After deletion, the volume data cannot be recovered. Proceed with caution.

Snapshot Management

On the main menu of ZStack ZStone, choose Block Storage > Snapshot Management. Then, the Snapshot Management page is displayed.

The following actions help to manage snapshots.
Action Description
Clone Clone block storage volumes based on selected snapshots.
  • Two type of clone are supported: Linked Clone and Independent Clone.
  • Bulk clone is supported. For Linked Clone, you can clone up to 20 volumes at a time. For Independent Clone, you can clone a maximum of 6 volumes at a time.
  • Each snapshot supports Linked Clone with a maximum of 32 volumes cloned.
Delete Delete selected snapshots. After deletion, you cannot roll back the volume to the snapshot point. Proceed with caution.
Note: If a selected snapshot connects with cloned volumes, it cannot be deleted. Only when you flatten their connection or delete the cloned volumes can you delete the selected snapshot.