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 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
- Select a server and client settings to create a gateway. For instructions, see Create a High-Performance Block Gateway.
- After creation completes, check the client settings and mounted volume count in High-Performance Block Gateway Details.
- 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 to open the gateway list.
- Click Create Block Gateway to open the creation page.
- Configure the following parameters.
| Parameter | Description |
|---|---|
| Server | Select 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-. |
| Description | Optional. Enter a description of up to 256 characters. |
| Protocol | Fixed to Vhost. |
| Performance Mode | Select 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 Network | Select 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 Memory | Set 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 . 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 , and click a resource name to open its details page.
The Overview tab contains basic information and Vhost client configuration.
Basic Information
| Field | Description |
|---|---|
| State | Current gateway state. Modifying or deleting the gateway also requires the corresponding action conditions to be met. |
| Protocol | Fixed to Vhost. |
| UUID | Unique gateway identifier. You can copy it to locate the resource. |
| Server | Name of the server running the Vhost client. |
| IP Address | IP address of the associated server. You can copy the address. |
| Mounted Volume Count | Number of mounted volumes. The count must be 0 before deletion. |
| Creation Time and Update Time | Resource creation time and most recent update time. |
Vhost Client Configuration
| Field | Description |
|---|---|
| Performance Mode | Current performance mode and its CPU core count. |
| Storage Network | RDMA or TCP used by the client. |
| NUMA Node | NUMA information for the CPU allocation. An allocation spanning nodes is shown as cross-NUMA. |
| CPU Core | Allocated CPU IDs or ID ranges. Distinguish these IDs from the core count of the performance mode. |
| Hugepage Memory | Configured hugepage memory in MiB. |
| Hugepage Directory | Hugepage 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 . Refresh the list to check resource state, or click a resource name to view High-Performance Block Gateway Details.
| Action | Description |
|---|---|
| Create Block Gateway | Select a server and create a Vhost client. See Create a High-Performance Block Gateway. |
| Modify | Allowed 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. |
| Delete | Allowed 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
- Choose Modify for the gateway on its list or details page.
- 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.
- 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.
- 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 , and then verify the applied configuration on the details page.
Delete a High-Performance Block Gateway
- Verify that the mounted volume count is 0 and all Vhost volumes have been unmounted.
- Choose Delete for the gateway on its list or details page.
- Review the resource information and configuration cleanup notice, and confirm deletion.
- 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 . On the Block Storage Volume page, click . Then, the Create Block Storage Volume page is displayed.
- 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:
- The type of the storage pool is Block Storage.
- The role of the storage pool is Data Pool.
- 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.

Manage a General Block Storage Volume
Manage a Local Block Storage Volume
On the main menu of ZStack ZStone, choose . On the General Block Storage Volume page, click Local. Then, the Local page is displayed.
| 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.
|
| 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.
|
| Migrate | Migrate volumes to other storage pools. You
can migrate up to 6 volumes at a time.
|
| Create Snapshot | Create snapshots for block storage volumes.
You can create snapshots for up to 32 volumes at a time.
|
| 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.
|
| 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:
|
Manage a Third-Party Block Storage Volume
On the main menu of ZStack ZStone, choose . On the General Block Storage Volume page, click Third Party. Then, the Third Party page is displayed.
| 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.
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.
|
| 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 . On the Block Storage Volume page, click . Then, the Create Block Storage Volume page is displayed.
- 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.

Manage a High-Performance Block Storage Volume
Manage a Local Block Storage Volume
On the main menu of ZStack ZStone, choose . On the High-Performance Block Storage Volume page, click Local. Then, the Local page is displayed.
| 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:
|
Snapshot Management
On the main menu of ZStack ZStone, choose . Then, the Snapshot Management page is displayed.
| Action | Description |
|---|---|
| Clone | Clone block storage volumes based on selected
snapshots.
|
| 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. |
