ACOS 6.3.0

Arcfra Cloud Operating System>
CLI command>
Managing block storage services>
Managing volumes

Viewing volumes

Viewing information about all volumes in a cluster

Procedure

Run the following command on any node in the cluster to view information for all volumes in the cluster, or for all volumes within a specific storage pool:

zbs-meta volume listall [pool_name]

When pool_name is empty, information for all volumes in the cluster is displayed. When pool_name is not empty, information for all volumes in the specified storage pool is displayed.

Output example

ID                                    Name                                  Parent ID                             Pool Name                                                 Size         Perf Unique Size    Perf Shared Size    Cap Unique Size    Cap Shared Size    Logical Used Size    Creation Time                  Status         Resiliency Type    Encrypt Method      Encrypt Metadata Id      Replica Num  EC Param    Thin Provision    Read Only    Description    Alloc Even      Clone count    Prefer CID  Access Points    Is Prioritized    Downgraded PRS
------------------------------------  ------------------------------------  ------------------------------------  --------------------------------------------------------  -----------  ------------------  ------------------  -----------------  -----------------  -------------------  -----------------------------  -------------  -----------------  ------------------  ---------------------  -------------  ----------  ----------------  -----------  -------------  ------------  -------------  ------------  ---------------  ----------------  ----------------
9dd3d94c-68ed-49e7-bddc-44ead6379725  9dd3d94c-68ed-49e7-bddc-44ead6379725  74bc8b9e-4e3d-41ce-89df-985a1ace9e90  44c8861c-8d10-45e0-a933-ad32a5202d25                      1024.00 MiB  0.00 B              0.00 B              3.00 MiB           0.00 B             1024.00 KiB          2024-12-05 20:49:42.296145302  VOLUME_ONLINE  RT_REPLICA         ENCRYPT_PLAIN_TEXT  None                               3              True              False                       False                     0             0  []               False             0.00 B
192fc562-df2d-43d0-ae7e-9350addcd2ee  encrypted_volume                      e691d599-e506-42ad-aa8a-473580b15d51  encrypted_pool                                            1024.00 GiB  0.00 B              0.00 B              0.00 B             0.00 B             0.00 B               2025-01-06 15:09:07.156447863  VOLUME_ONLINE  RT_REPLICA         ENCRYPT_AES256_CTR  4260                               2              True              False                       False                     0             0  []               False             0.00 B
5847b867-bc66-4cdc-a145-7d751f219ca3  5847b867-bc66-4cdc-a145-7d751f219ca3  e2ec7cc1-b2eb-474b-bb51-4a331547e986  guyi-target-1                                             30.00 GiB    0.00 B              0.00 B              0.00 B             0.00 B             0.00 B               2024-12-31 14:32:53.274472838  VOLUME_ONLINE  RT_REPLICA         ENCRYPT_PLAIN_TEXT  None                               2              True              False                       False                     0             0  []               False             0.00 B             0  []               False             0.00 B

Output note

Parameter	Description
`Parent ID`	The pool ID of the volume.
`Size`	The volume size.
`Perf Unique Size`	The performance tier space exclusively occupied by the volume.
`Perf Shared Size`	The performance tier space of the volume shared with other volumes or snapshots.
`Cap Unique Size`	The capacity tier space exclusively occupied by the volume.
`Cap Shared Size`	The capacity tier space of the volume shared with other volumes or snapshots.
`Logical Used Size`	The allocated logical space of the volume.
`Status`	The volume status.
`Resiliency Type`	The volume redundancy mode.
`Encrypt Method`	The data encryption algorithm of the volume.
`Encrypt Metadata Id`	The encryption metadata ID of the volume.
`Replica Num`	The replication factor.
`EC Param`	The EC parameters for the volume in EC redundancy mode.
`Thin_provision`	Whether it is thin-provisioned.
`Read Only`	Whether the volume is read-only.
`Alloc Even`	Whether the volume's replication is evenly distributed.
`Clone count`	The number of times the volume is cloned.
`Prefer CID`	The I/O affinity chunk. The volume's extent tends to be stored on this chunk.
`Access Points`	The access points for volumes.
`Is Prioritized`	Whether to keep all volumes data in the performance tier.
`Downgraded PRS`	The volume space not yet promoted to the performance tier.

Viewing volume information in a datastore

Procedure

Run the following command to view volume information in a specific datastore:

zbs-meta volume list <pool_name>

Output example

ID                                    Name              Parent ID                             Size         Perf Unique Size    Perf Shared Size    Cap Unique Size    Cap Shared Size    Logical Used Size    Creation Time                  Status         Resiliency Type    Encrypt Method      Encrypt Metadata Id      Replica Num  EC Param    Thin Provision    Read Only    Description    Alloc Even      Clone count    Prefer CID  Access Points    Is Prioritized    Downgraded PRS
------------------------------------  ----------------  ------------------------------------  -----------  ------------------  ------------------  -----------------  -----------------  -------------------  -----------------------------  -------------  -----------------  ------------------  ---------------------  -------------  ----------  ----------------  -----------  -------------  ------------  -------------  ------------  ---------------  ----------------  ----------------
45e912c6-cb2d-4803-954c-3f402445a7f5  encrypted_volume  8a21c3e0-7324-41e2-a3b2-1bf858d851ec  1024.00 GiB  In Process          In Process          In Process         In Process         In Process           2025-01-06 15:27:14.358870889  VOLUME_ONLINE  RT_REPLICA         ENCRYPT_AES256_CTR  4261                               2              True              False                       False                     0             0  []               False             0.00 B
8d6167dd-a2c5-4a52-882b-6721946a9015  plain_volume      8a21c3e0-7324-41e2-a3b2-1bf858d851ec  1024.00 GiB  In Process          In Process          In Process         In Process         In Process           2025-01-06 15:27:27.394580981  VOLUME_ONLINE  RT_REPLICA         ENCRYPT_PLAIN_TEXT  None                               2              True              False                       False                     0             0  []               False             0.00 B

Output note

Parameter	Description
`Parent ID`	The pool ID of the volume.
`Size`	The volume size.
`Perf Unique Size`	The performance tier space exclusively occupied by the volume.
`Perf Shared Size`	The performance tier space of the volume shared with other volumes or snapshots.
`Cap Unique Size`	The capacity tier space exclusively occupied by the volume.
`Cap Shared Size`	The capacity tier space of the volume shared with other volumes or snapshots.
`Logical Used Size`	The allocated logical space of the volume.
`Status`	The volume status.
`Resiliency Type`	The volume redundancy mode.
`Encrypt Method`	The data encryption algorithm of the volume.
`Encrypt Metadata Id`	The encryption metadata ID of the volume.
`Replica Num`	The replication factor.
`EC Param`	The EC parameters for the volume in EC redundancy mode.
`Thin_provision`	Whether it is thin-provisioned.
`Read Only`	Whether the volume is read-only.
`Alloc Even`	Whether the volume's replication is evenly distributed.
`Clone count`	The number of times the volume is cloned.
`Prefer CID`	The I/O affinity chunk. The volume's extent tends to be stored on this chunk.
`Access Points`	The access points for volumes.
`Is Prioritized`	Whether to keep all volumes data in the performance tier.
`Downgraded PRS`	The volume space not yet promoted to the performance tier.

Viewing volumes with specific attributes in the cluster

Procedure

Run the following command on any node in the cluster to view volumes with specific attributes:

zbs-meta volume find <volume-status>

Parameter	Description
`volume-status`	Find volumes in a specified state: `even`: The volumes in the cluster with the even allocation policy. `need_elevate`: The cache-reserved volumes in the cluster that need to be elevated.

Output example

ID                                    Name                                                                                   Parent ID                             Size         Perf Unique Size    Perf Shared Size    Cap Unique Size    Cap Shared Size    Logical Used Size    Creation Time                  Status         Resiliency Type      Replica Num  EC Param    Thin Provision    Read Only    Description    Alloc Even      Clone count    Prefer CID  Access Points    Is Prioritized    Downgraded PRS
------------------------------------  -------------------------------------------------------------------------------------  ------------------------------------  -----------  ------------------  ------------------  -----------------  -----------------  -------------------  -----------------------------  -------------  -----------------  -------------  ----------  ----------------  -----------  -------------  ------------  -------------  ------------  ---------------  ----------------  ----------------
005fd3ad-4cb2-49f3-af81-e932938fdb78  jp-test-centos-template-1-clo4573zf02z21wud5fpjegse                                    1815f208-6062-437f-bbc3-2a773b7b16df  40.00 GiB    In Process          In Process          In Process         In Process         In Process           2023-10-24 17:46:56.637390550  VOLUME_ONLINE  RT_REPLICA                     2              True              False                       False                    10             0  []               False             0.00 B
00cc4a36-81ba-4095-a074-93c7f0cd8a2d  cloudinit_clout-init_windows7-scsi-bios_cloud-init_1_1_1-clps78hrc1hug1wud91d46n0w     8b78623c-abd3-40b5-92ec-a839c545bddc  15.00 GiB    In Process          In Process          In Process         In Process         In Process           2023-12-05 18:30:10.952332837  VOLUME_ONLINE  RT_REPLICA                     2              True              False                       False                    11             0  []               False             0.00 B

Output note

Parameter	Description
`Parent ID`	The pool ID of the volume.
`Size`	The volume size.
`Perf Unique Size`	The performance tier space exclusively occupied by the volume.
`Perf Shared Size`	The performance tier space of the volume shared with other volumes or snapshots.
`Cap Unique Size`	The capacity tier space exclusively occupied by the volume.
`Cap Shared Size`	The capacity tier space of the volume shared with other volumes or snapshots.
`Logical Used Size`	The allocated logical space of the volume.
`Status`	The volume status.
`Resiliency Type`	The volume redundancy mode.
`Encrypt Method`	The data encryption algorithm of the volume.
`Encrypt Metadata Id`	The encryption metadata ID of the volume.
`Replica Num`	The replication factor.
`EC Param`	The EC parameters for the volume in EC redundancy mode.
`Thin Provision`	Whether it is thin-provisioned.
`Read Only`	Whether the volume is read-only.
`Alloc Even`	Whether the volume's replication is evenly distributed.
`Clone count`	The number of times the volume is cloned.
`Prefer CID`	The I/O affinity chunk. The volume's extent tends to be stored on this chunk.
`Access Points`	The access points for volumes.
`Is Prioritized`	Whether to keep all volumes data in the performance tier.
`Downgraded PRS`	The volume space not yet promoted to the performance tier.

Viewing cache-reserved volumes undergoing promotion

Currently, the block storage service performs only one promotion task at a time. Each promotion moves the data of one cache-reserved volume from the capacity tier to the performance tier.

Procedure

Run the following command on any node in the cluster:

zbs-meta elevate show

Output example

# zbs-meta elevate show
---------  ------------------------------------
Volume ID  c8b4ef94-6d7d-4898-afb8-3c92c6fb9657
---------  ------------------------------------

Running Cmds:
  LExtent ID    VExtent No
------------  ------------
           9             0
          10             1
          11             2
          12             3
          13             4
          14             5
          15             6

Pending Cmds:
  LExtent ID    VExtent No
------------  ------------
          25            16
          26            17
          27            18
          28            19

Output note

Parameter	Description
`Volume ID`	The ID of the volume to be promoted.
`Running Cmds`	The promotion commands that have been issued to nodes.
`Pending Cmds`	The promotion commands that have not been issued to nodes.

Viewing volumes actively accessed by nodes

Run the following command on any node in the cluster to view volumes actively accessed by one or all nodes:

zbs-meta volume list_access_record [--page_index PAGE_INDEX] [--page_size PAGE_SIZE] [cid]

Parameter	Description
`--page_index`	When there is a large amount of volume information, the information is paginated. This parameter specifies the starting page index. Default: `0`.
`--page_size`	When there is a large amount of volume information, the information is paginated. This parameter specifies the number of rows per page. Default: `1024`.
`cid`	Optional. The node's chunk ID. Default: `0`. When the value is `0`, only the number of volumes actively accessed by each node in the cluster is displayed. Otherwise, the active volume information for the node specified by `cid` is displayed.

Output example

zbs-meta volume list_access_record 12

Total record in all nodes is 28. Node:10.0.128.12 's volume_access_record is 1.
Cur page start at 0, cur page size is 1024.
node_ip      cids    volume_id                               last_report_s    report_count
-----------  ------  ------------------------------------  ---------------  --------------
10.0.128.12  11,12   951033b1-fed5-4bfa-a1df-2d7480c86e38            44948               1

zbs-meta volume list_access_record

Total record in all nodes is 28.
Node:10.0.128.10 's volume_access_record is 1.
Node:10.0.128.11 's volume_access_record is 1.
Node:10.0.128.12 's volume_access_record is 1.
Node:10.0.128.25 's volume_access_record is 4.
Node:10.0.128.26 's volume_access_record is 4.
Node:10.0.128.27 's volume_access_record is 17.

Viewing the information about virtual volumes associated with a virtual machine

Procedure

Run the following command on any node to view information about the ABS volume associated with a virtual machine.

zbs-tool elf show_vol_by_vm_id <elf_vm_uuid>

Parameter	Description
`elf_vm_uuid`	The virtual machine UUID.

Output example

zbs-tool get_zbs_vol_by_elf_vol_uuid f796cef6-1b19-4f0e-b46d-9dbc8099609c
AVE Volume UUID                       Volume ID                             Size        Perf Unique Size    Perf Shared Size    Cap Unique Size    Cap Shared Size      Prefer CID
------------------------------------  ------------------------------------  ----------  ------------------  ------------------  -----------------  -----------------  ------------
f796cef6-1b19-4f0e-b46d-9dbc8099609c  035b26a8-baf0-410e-93ac-b8bc5fd7ea5c  400.00 GiB  4.02 GiB            43.54 GiB           0.00 B             11.50 GiB                     0
f796cef6-1b19-4f0e-b46d-9dbc8099609d  035b26a8-baf0-410e-93ac-b8bc5fd7ea5d  400.00 GiB  4.02 GiB            43.54 GiB           0.00 B             11.50 GiB                     0
f796cef6-1b19-4f0e-b46d-9dbc8099609e  035b26a8-baf0-410e-93ac-b8bc5fd7ea5e  400.00 GiB  4.02 GiB            43.54 GiB           0.00 B             11.50 GiB                     0
f796cef6-1b19-4f0e-b46d-9dbc8099609f  035b26a8-baf0-410e-93ac-b8bc5fd7ea5f  400.00 GiB  4.02 GiB            43.54 GiB           0.00 B             11.50 GiB                     0

Output note

Parameter	Description
`AVE Volume UUID`	The virtual volume UUID.
`Volume ID`	The ABS volume ID corresponding to the virtual volume.
`Size`	The volume size.
`Perf Unique Size`	The performance tier space exclusively occupied by the volume.
`Perf Shared Size`	The performance tier space of the volume shared with other volumes or snapshots.
`Cap Unique Size`	The capacity tier space exclusively occupied by the volume.
`Cap Shared Size`	The capacity tier space of the volume shared with other volumes or snapshots.
`Prefer CID`	The I/O affinity chunk. The volume's extent tends to be stored on this chunk.

Viewing the ABS volume ID corresponding to a virtual volume ID

Procedure

Run the following command on any node to view the ABS volume ID associated with a virtual volume.

zbs-tool elf get_zbs_vol_by_elf_vol_uuid <elf_vol_uuid>

Parameter	Description
`elf_vol_uuid`	The virtual volume UUID.

Output example

zbs-tool elf get_zbs_vol_by_elf_vol_uuid f796cef6-1b19-4f0e-b46d-9dbc8099609c
-------------  ------------------------------------
Volume UUID    f796cef6-1b19-4f0e-b46d-9dbc8099609c
Zbs Volume ID  035b26a8-baf0-410e-93ac-b8bc5fd7ea5c
-------------  ------------------------------------

Output note

Parameter	Description
`Volume UUID`	The virtual volume UUID.
`Zbs Volume ID`	The ABS volume ID corresponding to the virtual volume.

Viewing the volume data distribution on the cache partition and data partition

Procedure

Run the following command on any node in the cluster to view the volume data distribution with the specified name on the cache partition and data partition:

zbs-tool volume show_dist <pool_name> <volume_name>
Run the following command on any node in the cluster to view the volume data distribution with the specified ID on the cache partition and data partition:

zbs-tool volume show_dist_by_id <volume_id>

Output example

Volume used performance cache size: 1024.00 MiB
Volume used read cache size: 1024.00 KiB
Volume used partition size: 1024.00 MiB

In this article

Viewing information about all volumes in a cluster
Viewing volume information in a datastore
Viewing volumes with specific attributes in the cluster
Viewing cache-reserved volumes undergoing promotion
Viewing volumes actively accessed by nodes
Viewing the information about virtual volumes associated with a virtual machine
Viewing the ABS volume ID corresponding to a virtual volume ID
Viewing the volume data distribution on the cache partition and data partition